Linux Certif

Toute la documentation sur la certification Linux LPI

dup

NOM

dup, dup2 - Dupliquer un descripteur de fichier

SYNOPSIS

 #include <unistd.h>
 
 int dup(int oldfd);
 int dup2(int oldfd, int newfd);
 

DESCRIPTION

dup() et dup2() créent une copie du descripteur de fichier oldfd.

Après un appel réussi à dup() ou dup2(), l'ancien et le nouveau descripteurs peuvent être utilisés de manière interchangeable. Ils font référence à la même description de fichier ouvert (voir open(2)) et ainsi partagent les pointeurs de position et les drapeaux. Par exemple, si le pointeur de position est modifié en utilisant lseek (2) sur l'un des descripteurs, la position est également changée pour l'autre.

Les deux descripteurs ne partagent toutefois pas les drapeaux du descripteur de fichier (le drapeau close-on-exec). Le drapeau close-on-exec RB ( FD_CLOEXEC " ;" voir fcntl(2)) pour le descripteur dupliqué n'est pas positionné.

dup() utilise le plus petit numéro inutilisé pour le nouveau descripteur.

dup2() transforme newfd en une copie de oldfd, fermant auparavant newfd si besoin est.

VALEUR RENVOYÉE

dup() et dup2() renvoient le nouveau descripteur, ou -1 s'ils échouent, auquel cas errno contient le code d'erreur.

ERREURS

EBADF

oldfd n'est pas un descripteur valide, ou newfd n'est pas dans les valeurs autorisées pour un descripteur.

EBUSY

(Linux seulement) Cette valeur peut être retournée par dup2() lors d'une concurrence critique avec open(2) et dup().

EINTR

L'appel dup2() a été interrompu par un signal.

EMFILE

Le processus dispose déjà du nombre maximum de descripteurs de fichiers autorisés simultanément, et tente d'en ouvrir un nouveau.

CONFORMITÉ

SVr4, BSD 4.3, POSIX.1-2001.

NOTES

Les erreurs renvoyées par dup2() sont différentes de celles retournées par fcntl(...,F_DUPFD,...) si newfd n'est pas dans les valeurs autorisées. Sur certains systèmes dup2() retourne aussi parfois EINVAL comme F_DUPFD.

Si newfd était ouvert, toutes les erreurs susceptibles d'être rapportées par close(2) sont perdues. Un programmeur soigneux n'utilisera pas dup2() sans fermer newfd d'abord.

VOIR AUSSI

close(2), fcntl(2), open(2)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 9 octobre 1996 et révisée le 22 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 dup ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.