dup(2)                        System Calls Manual                       dup(2)

NUME
       dup, dup2, dup3 - duplica un descriptor de fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

       int dup(int oldfd);
       int dup2(int oldfd, int newfd);

       #define _GNU_SOURCE             /* Consulta<?>i feature_test_macros(7) */
       #include <fcntl.h>              /* Definirea constantelor O_* */
       #include <unistd.h>

       int dup3(int oldfd, int newfd, int flags);

DESCRIERE
       Apelul de sistem dup() aloca un nou descriptor de fi<?>ier care se
       refera la aceea<?>i descriere de fi<?>ier deschis ca descriptorul oldfd
       (pentru o explica<?>ie a descrierilor de fi<?>iere deschise,
       consulta<?>i open(2)). Numarul noului descriptor de fi<?>ier este
       garantat a fi cel mai mic descriptor de fi<?>ier care nu a fost
       utilizat in procesul apelant.

       Dupa o returnare reu<?>ita, descriptorii de fi<?>ier vechi <?>i nou pot
       fi utiliza<?>i in mod interschimbabil.  Deoarece cei doi descriptori de
       fi<?>ier se refera la aceea<?>i descriere de fi<?>ier deschis,
       ace<?>tia au in comun indicatorii de pozi<?>ie <?>i de stare a
       fi<?>ierului; de exemplu, daca pozi<?>ia fi<?>ierului este modificata
       prin utilizarea lseek(2) pe unul dintre descriptorii de fi<?>ier,
       pozi<?>ia este modificata <?>i pentru celalalt descriptor de fi<?>ier.

       Cei doi descriptori de fi<?>ier nu au in comun fanioanele
       descriptorului de fi<?>ier (fanionul close-on-exec).  Fanionul
       close-on-exec (FD_CLOEXEC; a se vedea fcntl(2)) pentru descriptorul
       duplicat este dezactivat.

   dup2()
       Apelul de sistem dup2() indepline<?>te aceea<?>i sarcina ca <?>i dup(),
       dar in loc sa utilizeze descriptorul de fi<?>ier neutilizat cu cel mai
       mic numar, utilizeaza numarul descriptorului de fi<?>ier specificat in
       newfd.  Cu alte cuvinte, descriptorul de fi<?>ier newfd este ajustat
       astfel incat sa se refere acum la aceea<?>i descriere de fi<?>ier
       deschis ca oldfd.

       In cazul in care descriptorul de fi<?>ier newfd a fost deschis
       anterior, acesta este inchis inainte de a fi reutilizat; inchiderea
       este efectuata in mod silen<?>ios (de exemplu, eventualele erori din
       timpul inchiderii nu sunt raportate de dup2()).

       Etapele de inchidere <?>i reutilizare a descriptorului de fi<?>ier
       newfd sunt efectuate atomic.  Acest lucru este important, deoarece
       incercarea de a pune in aplicare o func<?>ionalitate echivalenta
       folosind close(2) <?>i dup() ar fi supusa unor condi<?>ii de cursa,
       prin care newfd ar putea fi reutilizat intre cele doua etape. O astfel
       de reutilizare ar putea avea loc deoarece programul principal este
       intrerupt de un gestionar de semnal care aloca un descriptor de
       fi<?>ier sau deoarece un fir paralel aloca un descriptor de fi<?>ier.

       Re<?>ine<?>i urmatoarele puncte:

       o  Daca oldfd nu este un descriptor de fi<?>ier valid, apelul
          e<?>ueaza, iar newfd nu este inchis.

       o  Daca oldfd este un descriptor de fi<?>ier valid, iar newfd are
          aceea<?>i valoare ca oldfd, atunci dup2() nu face nimic <?>i
          returneaza newfd.

   dup3()
       dup3() este la fel ca dup2(), cu excep<?>ia faptului ca:

       o  Apelantul poate for<?>a activarea indicatorului close-on-exec pentru
          noul descriptor de fi<?>ier prin specificarea O_CLOEXEC in flags.  A
          se vedea descrierea aceluia<?>i fanion in open(2) pentru motivele
          pentru care acest lucru poate fi util.

       o  Daca oldfd este egal cu newfd, atunci dup3() e<?>ueaza cu eroarea
          EINVAL.

VALOAREA RETURNATA
       In caz de succes, aceste apeluri de sistem returneaza noul descriptor
       de fi<?>ier.  In caz de eroare, este returnat -1, iar errno este
       configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EBADF  oldfd nu este un descriptor de fi<?>ier deschis.

       EBADF  newfd este in afara intervalului permis pentru descriptorii de
              fi<?>iere (a se vedea discu<?>ia despre RLIMIT_NOFILE in
              getrlimit(2)).

       EBUSY  (Numai Linux) Aceasta poate fi returnata de dup2() sau dup3() in
              timpul unei condi<?>ii de cursa cu open(2) <?>i dup().

       EINTR  Apelul dup2() sau dup3() a fost intrerupt de un semnal;
              consulta<?>i signal(7).

       EINVAL (dup3()) flags con<?>ine o valoare nevalida.

       EINVAL (dup3()) oldfd a fost egal cu newfd.

       EMFILE A fost atinsa limita per-proces privind numarul de descriptoare
              de fi<?>iere deschise (a se vedea discu<?>ia despre
              RLIMIT_NOFILE in getrlimit(2)).

       ENOMEM Nu a fost disponibila suficienta memorie pentru nucleu.

STANDARDE
       dup()
       dup2() POSIX.1-2008.

       dup3() Linux.

ISTORIC
       dup()
       dup2() POSIX.1-2001, SVr4, 4.3BSD.

       dup3() Linux 2.6.27, glibc 2.9.

NOTE
       Eroarea returnata de dup2() este diferita de cea returnata de
       fcntl(..., F_DUPFD, ...) atunci cand newfd iese din interval.  Pe unele
       sisteme, dup2() returneaza uneori <?>i EINVAL ca F_DUPFD.

       Daca newfd a fost deschis, orice erori care ar fi fost raportate la
       momentul close(2) sunt pierdute.  Daca acest lucru va ingrijoreaza,
       atunci [em]cu excep<?>ia cazului in care programul este cu un singur
       fir <?>i nu aloca descriptori de fi<?>ier in gestionarii de semnal
       [em]abordarea corecta este sa nu inchide<?>i newfd inainte de a apela
       dup2(), din cauza condi<?>iei de cursa descrisa mai sus. In schimb, ar
       putea fi utilizat un cod asemanator cu urmatorul:

           /* Ob<?>ine un duplicat al 'newfd' care poate fi utilizat
              ulterior pentru a verifica erorile close(); o eroare EBADF
              inseamna ca 'newfd' nu a fost deschis. */

           tmpfd = dup(newfd);
           if (tmpfd == -1 && errno != EBADF) {
               /* Gestioneaza eroarea nea<?>teptata dup(). */
           }

           /* Duplicarea atomica a 'oldfd' pe 'newfd'. */

           if (dup2(oldfd, newfd) == -1) {
               /* Gestioneaza eroarea dup2(). */
           }

           /* Acum verifica daca exista erori close() in fi<?>ierul men<?>ionat
              ini<?>ial de 'newfd'. */

           if (tmpfd != -1) {
               if (close(tmpfd) == -1) {
                   /* Gestioneaza erorile de la inchidere. */
               }
           }

CONSULTA<?>I <?>I
       close(2), fcntl(2), open(2), pidfd_getfd(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.15    17 mai 2025                           dup(2)