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

blmode(3C) blmode(3C)

(TO BE OBSOLETED)

blread()

[EDEADLK] A resource deadlock would occur as a result of this operation (see lockf(2)).

[EFAULT]

buf points outside the allocated address space. The reliable detection of this error is

implementation dependent.

[EINTR] A signal was caught during the

read system call.

[EIO] An I/O error occurred during block-mode data transmissions.

[ENOTTY] No previous

blopen has been issued for the speciﬁed ﬁle descriptor.

blget()

[ENOTTY] No previous

blopen has been issued for the speciﬁed ﬁle descriptor.

blset()

[EINVAL] An illegal value was speciﬁed in the structure passed to the system.

[ENOTTY] No previous

blopen has been issued for the speciﬁed ﬁle descriptor.

WARNINGS

blopen(), blclose() , blread(), blget() and blset() are not thread-safe.

Once blopen has been called with a ﬁle descriptor and returned successfully, that ﬁle descriptor should

not subsequently be used as a parameter to the following system calls: close(), dup(),

dup2(),

fcntl(), ioctl(), read(),orselect() until a blclose is called with the same ﬁle descriptor as

its parameter. Additionally, scanf(),

fscanf(), getc(), getchar(), fgetc(), and fgetw()

should not be called for a stream associated with a ﬁle descriptor that has been used in a

blopen() call

but has not been used in a

blclose() call. These functions call read(), and calling these routines

results in unpredictable behavior.

Obsolescent Interfaces

blopen(), blclose() , blread(), blget(), and blset() are to be obsoleted at a future date.

AUTHOR

blopen(), blclose() , blread(), blget(), and blset() were developed by HP.