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

lseek(2) OSS System Calls Reference Manual
[EISDIR] The filedes parameter refers to an OSS directory.
[EISGUARDIAN]
The value used for the filedes parameter is appropriate only in the Guardian
environment.
[EOVERFLOW]
The application was compiled in a regular compilation environment or was com-
piled using the #define _LARGEFILE64_SOURCE 1 feature test macro (or an
equivalent compiler command option), and the application attempted to set the
pointer location at a position between 2 gigabytes minus 1 byte and the max-
imum file offset established when the file was opened.
[ESPIPE] The filedes parameter refers to a pipe, FIFO, or socket.
[EWRONGID] One of these conditions occurred:
• The process attempted an operation through an operating system
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 the backup process took over.
• 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.
For more information about a specific Guardian file-system error, see the Guardian Procedure
Errors and Messages Manual.
RELATED INFORMATION
Functions: fcntl(2), fseek(3), lseek64(2), open(2), open64(2), read(2), spt_lseekz(2), write(2).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. These features
are affected in the HP implementation:
• If the lseek() function is called for a pipe or FIFO, the errno value [ESPIPE] is returned.
• If the lseek() function is called for a character special file, no errno value is returned.
• If the lseek() function is called for any other device on which seeking cannot be per-
formed, the operation fails, and errno is set to [EINVAL].
HP extensions to the XPG4 Version 2 specification are:
• The errno values [EINVAL], [EISDIR], [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
4−24 Hewlett-Packard Company 527186-023