HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

441

442

443

444

445

446

447

448

449

450

fseek(3S) fseek(3S)

ERRORS

fseek(), fseeko(), fseek_unlocked()

, ftell(), ftello()

, ftell_unlocked(),

rewind() and rewind_unlocked()

fail if the stream is unbuffered or the buffered data needs to be

ﬂushed, or if any of the following conditions are encountered:

[EAGAIN]

The

O_NONBLOCK ﬂag is set for the ﬁle descriptor and the process would be delayed in the

write operation.

[EBADF] The stream is NULL.

[EBADF] The underlying ﬁle is not open for writing.

[EFBIG] An attempt was made to write a ﬁle that exceeds the process’s ﬁle size limit or the max-

imum ﬁle size. See ulimit(2).

[EINVAL]

The ﬁle offset cannot be represented correctly in an object of type

long or size off_t in

this environment.

[EINTR] A signal was caught during the write operation.

[EIO] The process is in a background process group and is attempting to write to its controlling

terminal,

TOSTOP is set, the process is neither ignoring nor blocking the SIGTTOU signal,

and the process group of the process is orphaned.

[ENOSPC]

There was no free space remaining on the device containing the ﬁle.

[EPIPE] An attempt was made to write to a pipe that is not open for reading by any process. A

SIGPIPE signal is also sent to the process.

[ESPIPE] A seek operation was attempted and the ﬁle descriptor underlying stream is associated with

a pipe.

fseek() and fseek_unlocked()

also fail if:

[EINVAL] The whence argument is invalid, or the ﬁle-position indicator would be set to a nega-

tive value.

Additional

errno values may be set by the underlying write() and lseek() functions (see write(2)

and lseek(2)).

WARNINGS

On HP-UX systems, the offset returned by

ftell() or ftell_unlocked()

is measured in bytes and

it is permissible to seek to positions relative to that offset. However, when porting to non-HP-UX systems,

fseek() should be used directly without relying on any offset obtained from ftell() because arith-

metic cannot meaningfully be performed on such an offset if it is not measured in bytes on a particular

operating system.

fseek(), fseek_unlocked()

, rewind(), and rewind_unlocked() have no effect on streams

that have been opened in append mode (see fopen(3S)).

fseek_unlocked(), ftell_unlocked() and

rewind_unlocked() are obsolescent interfaces

supported for compatibility with existing DCE applications. New multithreaded applications should use

fseek(), ftell() and rewind().