POPEN(3)

NAZWA
popen, pclose - pipe stream to or from a process

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 versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

OPIS
Funkcja popen() otwiera proces, tworząc łącze, rozwidlając się przez fork() i wywołując powłokę. Ponieważ łącze jest z definicji jednokierunkowe, 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ę.

The type argument is a pointer to a null-terminated string which must contain either the letter 'r' for reading or the letter 'w' for writing. Since glibc 2.9, this argument can additionally include the letter 'e', which causes the close-on-exec flag (FD_CLOEXEC) to be set on the underlying file descriptor; see the description of the O_CLOEXEC flag in open(2) for reasons why this may be useful.

The return value from popen() is a normal standard I/O stream in all respects save that it must be closed with pclose() rather than fclose(3). Writing to such a stream writes to the standard input of the command; the command's standard output is the same as that of the process that called popen(), unless this is altered by the command itself. Conversely, reading from the stream reads the command's standard output, and the command's standard input is the same as that of the process that called 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(): on success, returns a pointer to an open stream that can be used to read or write to the pipe; if the fork(2) or pipe(2) calls fail, or if the function cannot allocate memory, NULL is returned.

pclose(): on success, returns the exit status of the command; if wait4(2) returns an error, or some other error is detected, -1 is returned.

Both functions set errno to an appropriate value in the case of an error.

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 errno będzie odpowiednio ustawione. 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-Safe

ZGODNE Z
POSIX.1-2001, POSIX.1-2008.

The 'e' value for type is a Linux extension.

UWAGI
Note: carefully read Caveats in system(3).

BŁĘDY
Ponieważ offset standardowego wejścia polecenia otwartego dla odczytu jest taki sam dla tego polecenia i dla procesu, który wywołał popen(), więc 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)

O STRONIE
Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

T◈UMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Jarosław Beczek <bexx@poczta.onet.pl> i Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>

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.