DUP

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 12 janvier 2008
Index Menu principal

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.

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, mais veuillez noter ceci :

*: Si oldfd n'est pas un descripteur de fichier valide, l'appel échoue et newfd n'est pas fermé.
*: Si oldfd est un descripteur de fichier valide et si newfd a la même valeur que oldfd, dup2() ne fait rien et renvoie newfd.

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 attributs. 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 attributs du descripteur de fichier (l'attribut close-on-exec). L'attribut close-on-exec (FD_CLOEXEC ; voir fcntl(2)) pour le descripteur dupliqué n'est pas positionné.

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 de fichier ouvert, 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 ; voir signal(7).
EMFILE: Le processus dispose déjà du nombre maximum de descripteurs de fichier 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 17 juillet 2008.

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.

Dernière mise à jour : 17 juillet 2008