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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

391

392

393

394

395

396

397

398

399

400

fseek(3S) fseek(3S)

ﬂ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 sig-

nal, 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

negative 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 sys-

tems,

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

arithmetic cannot meaningfully be performed on such an offset if it is not measured in bytes on a particu-

lar 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().