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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

301

302

303

304

305

306

307

308

309

310

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

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

maximum ﬁ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 control-

ling 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 associ-

ated 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

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