streamio.7 (2010 09)

s
streamio(7) streamio(7)
I_SETCLTIME
Lets the user process set the time that the stream head delays when the stream is
closing and the write queues contain data. The arg parameter contains a pointer to
the number of milliseconds to delay, rounded up to the nearest legal value on the
system. The default time is 15 seconds.
Before STREAMS modules and drivers are closed, the stream head delays for the
specified amount of time. This allows the data on the write queues to drain. If data
is still present on the writes queues after the delay, the queues are flushed.
I_SETSIG Informs the stream head that the user wants the kernel to issue the
SIGPOLL sig-
nal (see signal (2)) when a particular event has occurred on the stream associated
with fildes.
I_SETSIG supports an asynchronous processing capability in
STREAMS. The value of arg is a bitmask that specifies the events for which the
user should be signaled. It is the bitwise-OR of any combination, except where
noted, of the following constants:
S_BANDURG When used in conjunction with S_RDBAND,
SIGURG is gen-
erated instead of
SIGPOLL when a priority message reaches
the front of the stream head read queue.
S_ERROR An M_ERROR message has reached the stream head.
S_HANGUP An M_HANGUP message has reached the stream head.
S_HIPRI A high priority message is present on the stream head read
queue. This is set even if the message is of zero length.
S_INPUT Any message other than an M_PCPROTO has arrived on a
stream head read queue. This event is maintained for compa-
tibility with prior releases. This is set even if the message is
of zero length.
S_MSG A STREAMS signal message that contains the SIGPOLL sig-
nal has reached the front of the stream head read queue.
S_OUTPUT The write queue just below the stream head is no longer full.
This notifies the user that there is room on the queue for send-
ing (or writing) data downstream.
S_RDBAND A priority band message (band > 0) has arrived on a stream
head read queue. This is set even if the message is of zero-
length.
S_RDNORM An ordinary (non-priority) message has arrived on a stream
head read queue. This is set even if the message is of zero-
length.
S_WRBAND A priority band greater than 0 of a queue downstream exists
and is writable. This notifies the user that there is room on
the queue for sending (or writing) priority data downstream.
S_WRNORM This event is the same as S_OUTPUT.
A user process may choose to be signaled only of high priority messages by setting
arg bitmask to the value
S_HIPRI.
Processes that want to receive
SIGPOLL signals must explicitly register to receive
them using I_SETSIG. If several processes register to receive the signal for the
same event on the same stream, each process will be signaled when the event
occurs.
If the value of arg is zero, the calling process will be unregistered and will not
receive further
SIGPOLL signals.
I_SRDOPT Sets the read mode (see read (2)) using the value of the argument arg. Valid arg
values are:
RNORM Byte-stream mode (default).
RMSGD Message-discard mode.
HP-UX 11i Version 3: September 2010 − 5 − Hewlett-Packard Company 5