[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 2
timod Module
Purpose
Converts a set of streamio operations into STREAMS messages.
Description
The timod module is a STREAMS
module for use with the Transport Interface (TI) functions of the Network
Services Library. The timod module converts a set of streamio operations into STREAMS messages that may be consumed
by a transport protocol provider that supports the Transport Interface. This
allows a user to initiate certain TI functions as atomic operations.
The timod module must only be
pushed (see "Pushable Modules" in AIX 5L Version 5.2 Communications Programming Concepts)
onto a stream terminated by a transport protocol provider that supports the
TI.
All STREAMS messages, with the exception of the message
types generated from the streamio operations described
below as values for the cmd field, will be transparently
passed to the neighboring STREAMS module or driver. The messages generated
from the following streamio operations are recognized
and processed by the timod module.
This module is part of STREAMS Kernel Extensions.
Fields
The fields are described as follows:
Field |
Description |
cmd |
Specifies the command to be carried out. The possible values for
this field are:
- TI_BIND
- Binds an address to the underlying transport protocol provider. The
message issued to the TI_BIND operation is equivalent
to the TI message type T_BIND_REQ, and the message returned
by the successful completion of the operation is equivalent to the TI message
type T_BIND_ACK.
- TI_UNBIND
- Unbinds an address from the underlying transport protocol provider.
The message issued to the TI_UNBIND operation is equivalent
to the TI message type T_UNBIND_REQ, and the message
returned by the successful completion of the operation is equivalent to the
TI message type T_OK_ACK.
- TI_GETINFO
- Gets the TI protocol-specific information from the transport protocol
provider. The message issued to the TI_GETINFO operation
is equivalent to the TI message type T_INFO_REQ, and
the message returned by the successful completion of the operation is equivalent
to the TI message type T_INFO_ACK.
- TI_OPTMGMT
- Gets, sets, or negotiates protocol-specific options with the transport
protocol provider. The message issued to the TI_OPTMGMT
ioctl operation is equivalent to the TI message type T_OPTMGMT_REQ, and the message returned by the successful completion of the ioctl
operation is equivalent to the TI message type T_OPTMGMT_ACK.
|
len |
(On issuance) Specifies the size of the appropriate TI message to
be sent to the transport provider.
(On return) Specifies
the size of the appropriate TI message from the transport provider in response
to the issued TI message. |
dp |
Specifies a pointer to a buffer large enough to hold the contents
of the appropriate TI messages. The TI message types are defined in the sys/tihdr.h file. |
Examples
The following is an example of how to use the timod module:
#include <sys/stropts.h>
-
-
struct strioctl strioctl;
strucu t_info info;
-
-
strioctl.ic_cmd = TI_GETINFO;
strioctl.ic_timeout = INFTIM;
strioctl.ic_len = sizeof (info);
strioctl.ic_dp = (char *)&info;
ioctl(fildes, I_STR, &strioctl);
Related Information
The tirdwr module.
The streamio operations.
Benefits and Features of
STREAMS, Building STREAMS, Pushable Modules, Understanding STREAMS Drivers
and Modules, Understanding STREAMS Messages, Using STREAMS in AIX 5L Version 5.2 Communications Programming Concepts.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]