HP-UX Reference (11i v3 07/02) - 7 Device (Special) Files, 9 General Information, Index (vol 10)

streamio(7) streamio(7)

I_STR

[EINVAL] The

ic_len ﬁeld is less than 0 (zero) bytes or larger than the maximum allowable

size of the data part of a message (

ic_dp).

[EINVAL] The

ic_timout ﬁeld is less than −1.

[EFAULT] arg points, or the buffer area speciﬁed by

ic_dp or ic_len is, outside the allocated

address space.

[ENOSR] Buffers could not be allocated for the

ioctl request because of a lack of STREAMS

memory resources.

[ENXIO] A hangup was received on the stream referred to by ﬁldes.

[ETIME] The

ioctl request timed out before an acknowledgement was received.

The I_STR ioctl can also fail if the stream head receives a message indicating an error

(M_ERROR) or a hangup (

M_HANGUP). In addition, an error can be returned in an M_IOCACK

or M_IOCNAK message. In these cases, the

ioctl fails with errno set to the error value in

the message.

I_SWROPT

[EINVAL] The arg parameter is an illegal value.

I_UNLINK

[ENXIO] A hangup was received on ﬁldes.

[ETIME] A timeout occurred before an acknowledgement message was received at the stream

head.

[EINVAL] arg is an invalid multiplexor ID number, or ﬁldes is already linked under a multiplex-

ing driver.

I_UNLINK ioctl can also fail if it is waiting for the multiplexor to acknowledge the unlink

request and an error (M_ERROR) message, or hangup (M_HANGUP ) is received at the stream

head for ﬁldes. In addition, an error can be returned in M_IOCACK or M_IOCNAK

message.

When this occurs, the

I_UNLINK ioctl fails with errno set to the value in the message.