Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > D

dup(2)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

dup — duplicate an open file descriptor

SYNOPSIS

#include <unistd.h>

int dup(int fildes);

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.

RETURN VALUE

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

ERRORS

dup() 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

dup() was developed by AT&T and HP.

STANDARDS CONFORMANCE

dup(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.