popen(3)

NAZWA
popen, pclose - strumieniuje potok do lub z procesu

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

SKŁADNIA
#include <stdio.h>

FILE *popen(const char *command, const char *type);
int pclose(FILE *stream);

    Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

popen(), pclose():
    _POSIX_C_SOURCE >= 2
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

OPIS
Funkcja popen() otwiera proces, tworząc potok, rozwidlając się przez fork() i wywołując powłokę. Ponieważ potok jest z definicji jednokierunkowy, argument type może określać tylko odczyt albo tylko zapis, nie oba naraz. Otrzymany w wyniku tego strumień będzie tylko do odczytu albo tylko do zapisu.

Argument command jest wskaźnikiem do zakończonego znakiem NUL łańcucha, zawierającego wiersz poleceń powłoki. Polecenie to jest przekazywane do /bin/sh przy użyciu opcji -c; wszelka interpretacja jest dokonywana przez powłokę.

Argument type jest wskaźnikiem do łańcucha zakończonego znakiem null, który musi zawierać albo literę „r” (do odczytu), albo literę „w” (do zapisu). Od glibc 2.9, argument ten może dodatkowo obejmować literę „e”, co powoduje ustawienie znacznika zamknięcia przy wykonaniu (FD_CLOEXEC) na przedmiotowym deskryptorze pliku; powody, dla których może być to użyteczne opisano przy znaczniku O_CLOEXEC w podręczniku open(2).

Wartość zwracana przez popen() to normalny strumień wejścia/wyjścia, lecz powinien on być zamykany przy użyciu pclose() zamiast fclose(3). Zapisywanie do takiego strumienia powoduje pisanie na standardowe wejście polecenia. Standardowe wyjście polecenia jest takie samo, jak procesu, który wywołał popen(), chyba że zostało to zmienione przez polecenie. Podobnie, odczyt z tak otwartego strumienia powoduje odczyt ze standardowego wyjścia polecenia, a standardowe wejście polecenia jest wtedy tożsame z wejściem procesu, który wywołał popen().

Należy zauważyć, że strumienie wyjściowe powstałe z popen() są domyślnie w pełni buforowane.

Funkcja pclose() oczekuje na zakończenie stowarzyszonego procesu i zwraca jego kod zakończenia, podobnie jak to czyni wait4(2).

WARTOŚĆ ZWRACANA
popen: przy powodzeniu zwraca wskaźnik do otwartego strumienia, który może służyć do odczytu lub zapisu do potoku; jeśli nie powiodły się wywołania fork(2) lub pipe(2), lub jeśli nie udało się przydzielić pamięci, zwracane jest NULL.

pclose: przy powodzeniu zwraca status zakończenia polecenia; jeśli wait4 zwróci błąd lub zostały wykryte jakieś inne błędy, zwracane jest -1.

W przypadku błędu, obie funkcje ustawiają errno, wskazując błąd.

BŁĘDY
Funkcja popen() nie ustawia errno, jeżeli nie uda się przydzielić pamięci. Jeżeli nie powiodą się wywoływane przez nią fork(2) lub pipe(2), to ustawione będzie errno, wskazując błąd. Jeżeli argument type będzie nieprawidłowy i zostanie to wykryte, to errno zostanie ustawione na EINVAL.

Jeżeli nie będzie możliwe otrzymanie kodu zakończenia procesu potomnego przez pclose(), to errno zostanie ustawione na ECHILD.

ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
Interfejs | Atrybut | Wartość
popen(), pclose() | Bezpieczeństwo wątkowe | MT-bezpieczne

WERSJE
Wartość „e” dla type jest rozszerzeniem systemu Linux.

STANDARDY
POSIX.1-2008.

HISTORIA
POSIX.1-2001.

ZASTRZEŻENIA
Proszę dokładnie zapoznać się z Zastrzeżeniami w podręczniku system(3).

USTERKI
Przesunięcie standardowego wejścia polecenia otwartego do odczytu jest takie samo dla tego polecenia i dla procesu, który wywołał popen(), zatem jeśli oryginalny proces wykona buforowany odczyt, to pozycja na wejściu polecenia może być inna niż oczekiwano. Podobnie, wyjście polecenia otwartego dla zapisu może zostać wymieszane z wyjściem procesu oryginalnego. Temu ostatniemu można zapobiec, wołając przed popen() funkcję fflush(3).

Błąd w wywołaniu powłoki jest nieodróżnialny od błędu powłoki przy wywoływaniu polecenia, czy od natychmiastowego zakończenia polecenia. Jedynym śladem jest kod zakończenia równy 127.

ZOBACZ TAKŻE
sh(1), fork(2), pipe(2), wait4(2), fclose(3), fflush(3), fopen(3), stdio(3), system(3)

TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika: Przemek Borys <pborys@dione.ids.pl>, Jarosław Beczek <bexx@poczta.onet.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 (https://www.gnu.org/licenses/gpl-3.0.html) lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.