fexecve(3)                 Library Functions Manual                 fexecve(3)

NUME
       fexecve - executa programul specificat prin intermediul descriptorului
       de fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <unistd.h>

       int fexecve(int fd, char *const argv[], char *const envp[]);

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

       fexecve():
           Incepand cu glibc 2.10
               _POSIX_C_SOURCE >= 200809L
           Inainte de glibc 2.10:
               _GNU_SOURCE

DESCRIERE
       fexecve() indepline<?>te aceea<?>i sarcina ca <?>i execve(2), cu
       diferen<?>a ca fi<?>ierul care urmeaza sa fie executat este specificat
       printr-un descriptor de fi<?>ier, fd, mai degraba decat printr-un nume
       de ruta.  Descriptorul de fi<?>ier fd trebuie sa fie deschis
       numai-pentru-citire (O_RDONLY) sau cu fanionul O_PATH, iar apelantul
       trebuie sa aiba permisiunea de a executa fi<?>ierul la care se refera.

VALOAREA RETURNATA
       Un apel reu<?>it la fexecve() nu returneaza niciodata.  In caz de
       eroare, func<?>ia returneaza, cu o valoare a rezultatului de -1, iar
       errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       Erorile sunt ca pentru execve(2), cu urmatoarele adaugiri:

       EINVAL fd nu este un descriptor de fi<?>ier valid, sau argv este NULL,
              sau envp este NULL.

       ENOENT Fanionul close-on-exec este activat in fd, iar fd se refera la
              un script.  A se vedea ERORI.

       ENOSYS Nucleul nu ofera apelul de sistem execveat(2), <?>i sistemul de
              fi<?>iere /proc nu a putut fi accesat.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |fexecve()                             | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.3.2.

       In Linux cu versiunile glibc 2.26 <?>i anterioare, fexecve() este
       implementata utilizand sistemul de fi<?>iere proc(5), astfel incat
       /proc trebuie sa fie montat <?>i disponibil in momentul apelului.
       Incepand cu glibc 2.27, in cazul in care nucleul subiacent accepta
       apelul de sistem execveat(2), atunci fexecve() este implementata
       utilizand acest apel de sistem, cu avantajul ca /proc nu trebuie sa fie
       montat.

NOTE
       Ideea din spatele fexecve() este de a permite apelantului sa verifice
       (suma de control) con<?>inutul unui executabil inainte de a-l executa.
       Simpla deschidere a fi<?>ierului, verificarea sumei de control a
       con<?>inutului <?>i apoi efectuarea unui execve(2) nu ar fi suficienta,
       deoarece, intre cele doua etape, numele fi<?>ierului sau un prefix de
       director al numelui rutei ar fi putut fi schimbat (de exemplu, prin
       modificarea <?>intei unei legaturi simbolice).  fexecve() nu atenueaza
       problema ca con<?>inutul unui fi<?>ier ar putea fi modificat intre
       verificarea sumei de control <?>i apelul la fexecve(); pentru aceasta,
       solu<?>ia este de a se asigura ca permisiunile asupra fi<?>ierului
       impiedica modificarea acestuia de catre utilizatorii rau
       inten<?>iona<?>i.

       Modul firesc de utilizare a fexecve() este de a activa fanionul
       ,,close-on-exec" in fd, astfel incat descriptorul de fi<?>ier sa nu
       ajunga la programul care este executat.  Aceasta abordare este fireasca
       din doua motive.  In primul rand, previne consumarea inutila a
       descriptorilor de fi<?>iere (in mod normal, programul executat nu are
       nevoie de un descriptor de fi<?>ier care se refera la programul
       insu<?>i).  In al doilea rand, in cazul in care fexecve() este
       utilizata in mod recursiv, utilizarea fanionului ,,closed-on-exec"
       previne epuizarea descriptorului de fi<?>ier care ar rezulta din faptul
       ca fiecare pas in recursivitate ar face ca inca un descriptor de
       fi<?>ier sa fie transmis catre noul program (dar vede<?>i sec<?>iunea
       Erori).

ERORI
       Daca fd se refera la un script (adica este un fi<?>ier text executabil
       care nume<?>te un interpret de script cu o prima linie care incepe cu
       caracterele #!) <?>i daca pentru fd a fost activat fanionul
       ,,close-on-exec", atunci fexecve() e<?>ueaza cu eroarea ENOENT.
       Aceasta eroare apare deoarece, in momentul in care este executat
       interpretul scriptului, fd a fost deja inchis din cauza fanionului
       ,,close-on-exec".  Astfel, fanionul ,,close-on-exec" nu poate fi
       activat in fd daca acesta se refera la un script, ceea ce duce la
       problemele descrise in NOTE.

CONSULTA<?>I <?>I
       execve(2), execveat(2)

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                    fexecve(3)