#include <unistd.h>

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

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 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 (FD_CLOEXEC ; voir fcntl(2)) pour le descripteur dupliqué n'est pas positionné.  

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.

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.  

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 6 juin 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.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION