timod(7)timod(7)NAMEtimod - STREAMS module for converting ioctl() calls into TI messages
DESCRIPTION
The timod module is a STREAMS module that converts ioctl() calls from a
transport user supporting the Transport Interface (TI) into messages
that a transport protocol provider supporting TI can consume. This
allows the user to initiate TI functions as atomic operations.
The user places and removes the timod module on a device stream by
calling the STREAMS I_PUSH ioctl() and I_POP ioctl() functions.
The timod module recognizes and processes STREAMS messages generated by
I_STR ioctl() calls containing the following TI commands: This TI com‐
mand binds an address to the transport protocol provider. The STREAMS
message that the module issues to the TI_BIND ioctl() call is equiva‐
lent to the TI message type T_BIND_REQ. The STREAMS message that the
module returns in response to the successful completion of the TI_BIND
ioctl() call is equivalent to the TI message type TI_BIND_ACK. This TI
command unbinds an address from the transport protocol provider. The
STREAMS message that the module issues to the TI_UNBIND ioctl() call is
equivalent to the TI message type T_UNBIND_REQ. The STREAMS message
that the module returns in response to the successful completion of the
TI_UNBIND ioctl() call is equivalent to the TI message type TI_OK_ACK.
This TI command gets the TI protocol-specific information from the
transport protocol provider. The STREAMS message that the module
issues to the TI_GETINFO ioctl() call is equivalent to the TI message
type T_INFO_REQ. The STREAMS message that the module returns in
response to the successful completion of the TI_GETINFO ioctl() call is
equivalent to the TI message type TI_INFO_ACK. This TI command gets,
sets, or negotiates TI protocol-specific options with the transport
protocol provider. The STREAMS message that the module issues to the
TI_OPTMGMT ioctl() call is equivalent to the TI message type T_OPT‐
MGMT_REQ. The STREAMS message that the module returns in response to
the successful completion of the TI_OPTMGMT ioctl() call is equivalent
to the TI message type TI_OPTMGMT_ACK.
The timod module transparently passes any STREAMS messages that are not
generated by the ioctl() calls previously described to the neighboring
module or driver.
RETURN VALUES
If the timod module returns an error for an ioctl() call, the lower 8
bits of the return value will be one of the TI error codes defined in
the sys/tiusr.h header file. If the TI error is of the type TSYERR,
then the second 8 bits of the return value will contain an error as
defined in the sys/errno.h header file.
FILES
Defines the error codes for TI functions. Defines the message types
for TI. Defines the error codes for system errors.
SEE ALSO
Functions: intro(2), ioctl(2)
Interfaces: streamio(7)timod(7)