NAME

dup − duplicate an open file descriptor

SYNOPSIS

int dup (fildes)
int fildes;

HP-UX COMPATIBILITY

Level: HP-UX/RUN ONLY

Origin: System V

DESCRIPTION

Fildes is a file descriptor obtained from a creat, open, dup, fcntl, or pipe system call.  Dup returns a new file descriptor having the following in common with the original:

Same open file (or pipe). 

Same file pointer (i.e., both file descriptors share one file pointer). 

Same access mode (read, write or read/write). 

Same file status flags (see fcntl(2), F_DUPFD). 

The new file descriptor is set to remain open across exec system calls.  See fcntl(2).

The file descriptor returned is the lowest one available. 

Dup will fail if one or more of the following are true:

[EBADF] Fildes is not a valid open file descriptor. 

­[EMFILE] The maximum number of file descriptors (defined by _NFILE) are currently open. 

RETURN VALUE

Upon successful completion a non-negative integer, namely the file descriptor, is returned.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

HARDWARE DEPENDENCIES

Integral PC:
_NFILE is equal to 20. 

SEE ALSO

close(2), creat(2), exec(2), fcntl(2), open(2), pipe(2). 

Hewlett-Packard  —  last mod. May 11, 2021