Open System Services System Calls Reference Manual (G06.28+, H06.05+)

lseek64(2) OSS System Calls Reference Manual
If the lseek64() function fails, the file offset remains unchanged, the value -1 cast to the type
off_t is returned, and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the file offset remains unchanged, and the lseek64() function
sets errno to the corresponding value:
[EBADF] The filedes parameter is not an open file descriptor.
[EINVAL] One of these conditions exists:
• The whence parameter is an invalid value, or the resulting file offset
would be an invalid value (that is, a value less than 0 [zero]).
• The filedes parameter refers to a file (other than a pipe, FIFO, or direc-
tory) on which seeking cannot be performed.
[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 attempted to set the file offset beyond the maximum file offset
supported for the file.
[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), open(2), open64(2), read(2), write(2).
STANDARDS CONFORMANCE
This function is an HP extension to the XPG4 Version 2 specification.
4−28 Hewlett-Packard Company 527186-007