Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

dup2(2) OSS System Calls Reference Manual
• The filedes parameter is not a valid open file descriptor.
• The new parameter file descriptor is negative or greater than the max-
imum number of opens permitted.
[EISGUARDIAN]
The value used for the filedes parameter is appropriate only in the Guardian
environment.
[EWRONGID] One of these conditions occurred:
• The process attempted an operation on an input/output process (such as a
terminal server process) that has failed or is in the down state.
• The processor for the disk process of the specified file failed during an
input or output operation, and takeover by the backup process occurred.
• The open file descriptor has migrated to a new processor, but the new
processor lacks a resource or system process needed for using the file
descriptor.
The file descriptor specified by the filedes parameter can only be closed.
For all other error conditions, errno is set to the appropriate Guardian file-system error number.
See the Guardian Procedure Errors and Messages Manual for more information about a specific
Guardian file-system error.
RELATED INFORMATION
Functions: close(2), dup(2), exec(2), fcntl(2), open(2), read(2), spt_dup2x(2), tdm_execve(2),
tdm_execvep(2), write(2).
STANDARDS CONFORMANCE
The dup2( ) function does not return the errno value [EINTR].
HP extensions to the XPG4 Version 2 specification are:
• The errno values [EISGUARDIAN] and [EWRONGID] can be returned.
The use of this function with the POSIX User Thread Model library conforms to the following
industry standards:
• IEEE Std 1003.1-2004, POSIX System Application Program Interface
1−62 Hewlett-Packard Company 527186-023