Technical data

SunOS 5.5 Ioctl Requests streamio(7I)
EBADF arg is not a valid, open file descriptor.
EINVAL fildes does not support multiplexing.
EINVAL arg is not a stream or is already linked under a multi-
plexor.
EINVAL The specified linkoperation would cause a ‘‘cycle’’ in
the resulting configuration; that is, if a driver would be
linked into the multiplexing configuration in more than
one place.
EINVAL fildes is the file descriptor of a pipe or FIFO.
An I_PLINK can also fail while waiting for the multiplexing driver to
acknowledge the link request, if a message indicating an error on a
hangup is received at the stream head of fildes. In addition, an error
code can be returned in the positive or negative acknowledgement mes-
sage. For these cases, I_PLINK will fail with errno set to the value in the
message.
I_PUNLINK Disconnects the two streams specified by fildes and arg that are con-
nected with a persistent link. fildes is the file descriptor of the stream
connected to the multiplexingdriver. arg is the multiplexorID number
that was returned byI_PLINK when a stream was linked below the mul-
tiplexing driver. If arg is MUXID_ALL then all streams that are persistent
links to fildes are disconnected. As in I_PLINK, this command requires
the multiplexingdriver to acknowledge the unlink. On failure, errno is
set to one of the following values:
ENXIO Hangup received on fildes.
ETIME Time out before acknowledgement message was
received at the stream head.
EAGAIN Unable to allocate buffers for the acknowledgement
message.
EINVAL Invalid multiplexorID number.
EINVAL fildes is the file descriptor of a pipe or FIFO.
An I_PUNLINK can also fail while waiting for the multiplexing driver to
acknowledge the link request if a message indicating an error or a
hangup is received at the stream head of fildes. In addition, an error
code can be returned in the positive or negative acknowledgement mes-
sage. For these cases, I_PUNLINK will fail with errno set to the value in
the message.
RETURN VALUES Unless specified otherwise above, the return value from ioctl is 0 upon success and −1
upon failure with errno set as indicated.
modified 24 Jan 1995 7I-339