MAN dup 2

Материал из Gentoo Linux Wiki

Вернуться в раздел мануалов

[править] Имя

dup, dup2 - создать дубликат файлового дескриптора

[править] Обзор

#include <unistd.h>
int dup(int oldfd ); int dup2(int oldfd , int newfd );

[править] Описание

dup и dup2 создают копию файлового дескриптора oldfd . Старый и новый дескрипторы можно использовать друг вместо друга. Они имеют общие блокировки, указатель позиции в файле и флаги; например, если позиция в файле была изменена с помощью lseek , на одном из дескрипторов, то эта позиция также меняется и на втором.

Два дескриптора, однако, каждый имеют свой собственный флаг закрыть-при-exec.

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

dup2

"делает " newfd " копией " oldfd ", закрывая " newfd , если требуется.

[править] Возвращаемое значение

dup и dup2 возвращают новый дескриптор или -1, если произошла ошибка (в этом случае errno устанавливается должным образом).

[править] Ошибки

EBADF oldfd не является открытым файловым дескриптором, или же newfd находится вне допустимого диапазона файловых дескрипторов.

EMFILE Процесс уже открыл максимальное количество файлов и пытается открыть еще один.

EINTR Вызов dup2 был прерван каким-либо сигналом.

EBUSY (Только в Linux) Может случиться в dup2 во время при условии состязательных вызовов open() и dup().

[править] Внимание

Ошибка, которую возвращает dup2 , отличается от той, что возвращает fcntl( ..., F_DUPFD , ... ) , когда newfd находится вне допустимых пределов. На некоторых системах dup2 также иногда возвращает EINVAL , как F_DUPFD .

[править] Ошибки

Если newfd был открыт, любые ошибки, которые могли бы случиться во время close () , теряются. Осторожный программист не будет использовать dup2 не закрыв сперва newfd .

[править] Соответствие стандартам

SVr4, SVID, POSIX, X/OPEN, BSD 4.3. SVr4 документирует дополнительные коды ошибки EINTR и ENOLINK. POSIX.1 добавляет EINTR. Ошибка EBUSY является специфичной для Linux.

[править] Смотри также

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

[править] Перевод

Copyright (C) Alexey Mahotkin <alexm@hsys.msk.ru> 1999, Виктор Вислобоков <corochoone@perm.ru> 2003

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

This manpage is Copyright (C) 1992 Drew Eckhardt;
1993 Michael Haardt, Ian Jackson.

Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one

Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.

Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.

Modified 1993-07-21, Rik Faith <faith@cs.unc.edu>
Modified 1994-08-21, Michael Chastain <mec@shell.portal.com>:
Fixed typoes.
Modified Fri Jan 31 16:23:46 1997 by Eric S. Raymond <esr@thyrsus.com>
Modified 1997-01-31, Eric S. Raymond <esr@thyrsus.com>
Modified 2002-09-28, aeb

Дата последней коррекции перевода 12.12.2003
Оригинальный перевод Алексея Махоткина <alexm@hsys.msk.ru> 1999-2001
Дополнения и правки перевода сделал Виктор Вислобоков <corochoone@perm.ru>
http://www.linuxshare.ru/projects/trans/mans.html