popen(3)                   Library Functions Manual                   popen(3)

NUME
       popen, pclose - flux de conducta catre sau de la un proces

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdio.h>

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

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

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

DESCRIERE
       Func<?>ia popen() deschide un proces prin crearea unei conducte, prin
       bifurcare <?>i prin invocarea shell-ului. Deoarece o conducta este,
       prin defini<?>ie, unidirec<?>ionala, argumentul type poate specifica
       numai citire sau scriere, nu ambele; fluxul rezultat este, in
       consecin<?>a, numai-pentru-citire sau numai-pentru-scriere.

       Argumentul command este un indicator la un <?>ir de caractere cu
       termina<?>ie nula care con<?>ine o linie de comanda de tip shell.
       Aceasta comanda este transmisa catre /bin/sh folosind op<?>iunea -c;
       interpretarea, daca este cazul, este efectuata de catre shell.

       Argumentul type este un indicator catre un <?>ir de caractere cu
       termina<?>ie nula care trebuie sa con<?>ina fie litera ,,r" pentru
       citire, fie litera ,,w" pentru scriere. Incepand cu glibc 2.9, acest
       argument poate include, de asemenea, litera ,,e", care determina
       activarea fanionului ,,close-on-exec" (FD_CLOEXEC) pe descriptorul de
       fi<?>ier subiacent; a se vedea descrierea fanionului O_CLOEXEC in
       open(2) pentru motivele pentru care acest lucru poate fi util.

       Valoarea returnata de popen() este un flux de intrare/ie<?>ire standard
       normal in toate privin<?>ele, cu excep<?>ia faptului ca trebuie inchis
       cu pclose() in loc de fclose(3). Scrierea pe un astfel de flux se scrie
       in intrarea standard a comenzii; ie<?>irea standard a comenzii este
       aceea<?>i cu cea a procesului care a apelat popen(), cu excep<?>ia
       cazului in care aceasta este modificata de comanda insa<?>i. In schimb,
       citirea de pe flux cite<?>te ie<?>irea standard a comenzii, iar
       intrarea standard a comenzii este aceea<?>i cu cea a procesului care a
       apelat popen().

       Re<?>ine<?>i ca fluxurile de ie<?>ire popen() sunt stocate in bloc in
       mod implicit.

       Func<?>ia pclose() a<?>teapta ca procesul asociat sa se incheie <?>i
       returneaza starea de ie<?>ire a comenzii, a<?>a cum este returnata de
       wait4(2).

VALOAREA RETURNATA
       popen(): in caz de succes, returneaza un indicator catre un flux
       deschis care poate fi utilizat pentru a citi sau a scrie in conducta;
       daca apelurile fork(2) sau pipe(2) e<?>ueaza sau daca func<?>ia nu
       poate aloca memorie, se returneaza NULL.

       pclose(): in caz de succes, returneaza starea de ie<?>ire a comenzii;
       daca wait4(2) returneaza o eroare sau daca este detectata o alta
       eroare, se returneaza -1.

       In caz de e<?>ec, ambele func<?>ii configureaza errno pentru a indica
       eroarea.

ERORI-IE<?>IRE
       Func<?>ia popen() nu configureaza errno daca alocarea memoriei
       e<?>ueaza. In cazul in care func<?>ia fork(2) sau pipe(2) subiacenta
       e<?>ueaza, errno este configurata pentru a indica eroarea. In cazul in
       care argumentul type nu este valid, iar aceasta condi<?>ie este
       detectata, errno este stabilita la EINVAL.

       Daca pclose() nu poate ob<?>ine starea copilului, errno este stabilita
       la ECHILD.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |popen(), pclose()                     | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
       Valoarea ,,e" pentru type este o extensie Linux.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

AVERTISMENTE
       Citi<?>i cu aten<?>ie Avertismentele din system(3).

ERORI
       Deoarece intrarea standard a unei comenzi deschise pentru citire i<?>i
       imparte pozi<?>ia de cautare cu procesul care a apelat popen(), in
       cazul in care procesul original a efectuat o citire in memoria tampon,
       este posibil ca pozi<?>ia de intrare a comenzii sa nu fie cea
       a<?>teptata. In mod similar, ie<?>irea unei comenzi deschise pentru
       scriere se poate amesteca cu cea a procesului original. Aceasta din
       urma poate fi evitata prin apelarea fflush(3) inainte de popen().

       E<?>ecul executarii shell-ului nu se deosebe<?>te de e<?>ecul
       executarii comenzii shell-ului sau de ie<?>irea imediata a comenzii.
       Singurul indiciu este o stare de ie<?>ire de 127.

CONSULTA<?>I <?>I
       sh(1), fork(2), pipe(2), wait4(2), fclose(3), fflush(3), fopen(3),
       stdio(3), system(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                      popen(3)