pidfd_getfd(2)                System Calls Manual               pidfd_getfd(2)

NUME
       pidfd_getfd - ob<?>ine un duplicat al descriptorului de fi<?>ier al
       unui alt proces

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <sys/syscall.h>      /* Definirea constantelor SYS_* */
       #include <unistd.h>

       int syscall(SYS_pidfd_getfd, int pidfd, int targetfd,
                   unsigned int flags);

       Nota: glibc nu ofera nici o func<?>ie de invaluire pentru
       pidfd_getfd(), fiind necesara utilizarea syscall(2).

DESCRIERE
       Apelul de sistem pidfd_getfd() aloca un nou descriptor de fi<?>ier in
       procesul apelant.  Acest nou descriptor de fi<?>ier este un duplicat al
       unui descriptor de fi<?>ier existent, targetfd, in procesul la care se
       face referire prin descriptorul de fi<?>ier PID pidfd.

       Descriptorul de fi<?>ier duplicat se refera la aceea<?>i descriere de
       fi<?>ier deschis (a se vedea open(2)) ca <?>i descriptorul de fi<?>ier
       original in procesul la care se refera pidfd.  Astfel, cei doi
       descriptori de fi<?>iere au in comun fanioanele de stare a fi<?>ierului
       <?>i pozi<?>ia fi<?>ierului.  In plus, opera<?>iile asupra obiectului
       de fi<?>ier subiacent (de exemplu, atribuirea unei adrese unui obiect
       soclu utilizand bind(2)) pot fi efectuate in mod egal prin intermediul
       descriptorului de fi<?>ier duplicat.

       Fanionul close-on-exec (FD_CLOEXEC; a se vedea fcntl(2)) este activat
       pe descriptorul de fi<?>ier returnat de pidfd_getfd().

       Argumentul flags este rezervat pentru utilizare viitoare.  In prezent,
       acesta trebuie sa fie specificat ca fiind 0.

       Permisiunea de a duplica descriptorul de fi<?>ier al unui alt proces
       este guvernata de o verificare PTRACE_MODE_ATTACH_REALCREDS a modului
       de acces ptrace (a se vedea ptrace(2)).

VALOAREA RETURNATA
       In caz de reu<?>ita, pidfd_getfd() returneaza un descriptor de fi<?>ier
       (un numar intreg nenegativ).  In caz de eroare, se returneaza -1, iar
       errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EBADF  pidfd nu este un descriptor de fi<?>ier PID valid.

       EBADF  targetfd nu este un descriptor de fi<?>ier deschis in procesul
              la care face referire pidfd.

       EINVAL fanioane nu este 0.

       EMFILE A fost atinsa limita per-proces a numarului de descriptori de
              fi<?>iere deschise (a se vedea descrierea lui RLIMIT_NOFILE in
              getrlimit(2)).

       ENFILE Limita la nivel de sistem a numarului total de fi<?>iere
              deschise a fost atinsa.

       EPERM  Procesul apelant nu a avut permisiuni
              PTRACE_MODE_ATTACH_REALCREDS (a se vedea ptrace(2)) asupra
              procesului la care se face referire prin pidfd.

       ESRCH  Procesul la care se face referire prin pidfd nu exista (adica
              s-a incheiat <?>i a fost a<?>teptat).

STANDARDE
       Linux.

ISTORIC
       Linux 5.6.

NOTE
       Pentru o descriere a descriptorilor de fi<?>iere PID, a se vedea
       pidfd_open(2).

       Efectul pidfd_getfd() este similar cu utilizarea mesajelor SCM_RIGHTS
       descrise in unix(7), dar difera in urmatoarele privin<?>e:

       o  Pentru a transmite un descriptor de fi<?>ier utilizand un mesaj
          SCM_RIGHTS, cele doua procese trebuie sa stabileasca mai intai o
          conexiune de tip soclu de domeniu UNIX.

       o  Utilizarea lui SCM_RIGHTS necesita cooperare din partea procesului
          al carui descriptor de fi<?>ier este copiat.  In schimb, o astfel de
          cooperare nu este necesara atunci cand se utilizeaza pidfd_getfd().

       o  Capacitatea de a utiliza pidfd_getfd() este restric<?>ionata de o
          verificare a modului de acces la ptrace
          PTRACE_MODE_ATTACH_REALCREDS.

CONSULTA<?>I <?>I
       clone3(2), dup(2), kcmp(2), pidfd_open(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                pidfd_getfd(2)