dup()

Продублировать файловый дескриптор

Прототип:

#include <unistd.h>
                                       
int dup( int filedes );

Аргументы:

filedes

Файловый дескриптор, который необходимо продублировать.

Библиотека:

libc

Описание:

Функция dup() дублирует файловый дескриптор, определяемый filedes. Новый файловый дескриптор ссылается на оригинальный файловый дескриптор и имеет те же блокировки. Новый файловый дескриптор также:

• ссылается на тот же файл или устройство
• имеет тот же режим открытия (чтение и/или запись)
• имеет идентичную с оригиналом файловую позицию (изменение позиции с помощью одного файлового дескриптора влечет за собой изменение позициии в другом файловом дескрипторе).

Изменение позиции с помощью одного файлового дескриптора влечет за собой изменение позициии в другом файловом дескрипторе.

Вызов:

dup_filedes = dup( filedes );

аналогичен:

dup_filedes = fcntl( filedes, F_DUPFD, 0 );

Возвращаемое значение:

Новый файловый дескриптор в случае успеха.

Если возникла ошибка, функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EBADF

Файловый дескриптор filedes не является допустимым.

EMFILE

На данный момент уже используется OPEN_MAX файловых дескрипторов.

ENOSYS

Функция dup() не реализована для файловой системы, определяемой filedes.

Примеры:

#include <fcntl.h>
#include <unistd.h>
#include <sys/stat.h>
#include <stdlib.h>
                                       
int main( void )
{
    int filedes, dup_filedes;
                                       
    filedes = open( "file", O_WRONLY | O_CREAT | O_TRUNC,
                            S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP );
    if ( filedes != -1 )
    {
        dup_filedes = dup( filedes );
        if ( dup_filedes != -1 )
        {
            /* process file */
            /* ... */
                                       
            close( dup_filedes );
        }
        close( filedes );
            
        return (EXIT_SUCCESS);
    }
        
    return (EXIT_FAILURE);
}

Классификация:

POSIX 1003.1

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

chsize(), close(), creat(), dup2(), eof(), errno, execl(), execle(), execlp(), execlpe(), execv(), execve(), execvp(), execvpe(), fcntl(), fileno(), fstat(), isatty(), lseek(), open(), read(), sopen(), stat(), tell(), umask(), write()

Предыдущий раздел: Описание API системной библиотеки