NOME

       dup, dup2 - duplica um descritor de arquivos

SINOPSE

       #include <unistd.h>

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

DESCRIÇÃO

       dup e dup2 criam uma cópia do descritor de arquivos oldfd.

       Depois  do  retorno  bem  sucedido  de  dup  ou  dup2,  o velho e o novo descritores podem ser usados sem
       distinção. Eles compartilham travamento,  posicionamento  do  arquivo,  ponteiros  e  sinalizadores;  por
       exemplo, se a posição do arquivo é modificada usando-se lseek em um dos descritores, a posição é, também,
       alterada para o outro.

       De qualquer forma, Os dois descritores não dividem o sinalizador close-on-exec.

       dup usa o mais baixo número não usado de descritor para o novo descritor.

       dup2 makes newfd ser a cópia de oldfd, closing newfd primeiro se necesário.

VALORES RETORNADOS

       dup e dup2 retorna o novo descritor, ou -1  se  um  erro  occurrido  (neste  caso,  errno  é  selecionado
       adequadamente).

ERROS

       EBADF  oldfd  não  é  um  descritor  de  arquivo  aberto,  ou newfd está fora do intervalo permitido para
              descritores de arquivos.

       EMFILE O processo tem um número máximo de descritores de arquivos abertos e tenta abrir um novo.

ADVERTÊNCIA

       O erro retornado por dup2 é diferente que aquele retornado por fcntl(...,  F_DUPFD,  ...)   quando  newfd
       está fora do intervalo. Em muitos sistemas dup2 também retorna às vezes EINVAL como F_DUPFD.

DE ACORDO COM

       SVr4, SVID, POSIX, X/OPEN, BSD 4.3. SVr4 documenta condições de erros adicionais EINTR e ENOLINK. POSIX.1
       adiciona EINTR.

VEJA TAMBÉM

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