dup, dup2 − Dupliquer un descripteur de fichier.

#include <unistd.h>

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

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.

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

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() 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.

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() sont perdues. Un programmeur soigneux n’utilisera pas dup2() sans fermer newfd d’abord.

SVr4, BSD 4.3, POSIX.1-2001.

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

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 14 août 2006.

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.