Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dup(2)			      System Calls Manual			dup(2)

NAME
       dup - duplicate an open file descriptor

SYNOPSIS
DESCRIPTION
       fildes  is a file descriptor obtained from a or system call.  returns a
       new file	descriptor having the following	in common with the original:

	      o	 Same open file	(or pipe).

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

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

	      o	 Same file status flags	(see fcntl(2),

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

       The file	descriptor returned is the lowest one available.

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

ERRORS
       fails if	one or more of the following is	true:

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

       [EMFILE]			Request	violates the maximum  number  of  open
				file descriptors.

AUTHOR
       was developed by	AT&T and HP.

SEE ALSO
       close(2), creat(2), dup2(2), exec(2), fcntl(2), open(2),	pipe(2).

STANDARDS CONFORMANCE
									dup(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | AUTHOR | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dup&sektion=2&manpath=HP-UX+11.22>

home | help