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 системной библиотеки