STREAMS Modules timod(7M)
NAME
timod - Transport Interface cooperating STREAMS module
SYNOPSIS
#include
ioctl(fildes, ISTR, &mystrioctl);
DESCRIPTION
timod is a STREAMS module for use with the Transport Inter-
face ("TI") functions of the Network Services library. The
timod module converts a set of ioctl(2) calls into STREAMS
messages that may be consumed by a transport protocol pro-
vider that supports the Transport Interface. This allows a
user to initiate certain TI functions as atomic operations.
The timod module must be pushed onto only a stream ter-
minated by a transport protocol provider that supports the
TI.
All STREAMS messages, with the exception of the message
types generated from the ioctl commands described below,
will be transparently passed to the neighboring module or
driver. The messages generated from the following ioctl com-
mands are recognized and processed by the timod module. The
format of the ioctl call is:
#include
-
-
struct strioctl mystrioctl;
-
-
strioctl.iccmd = cmd;
strioctl.ictimout = INFTIM;
strioctl.iclen = size;
strioctl.icdp = (char *)buf
ioctl(fildes, ISTR, &mystrioctl);
On issuance, size is the size of the appropriate TI message
to be sent to the transport provider and on return size is
the size of the appropriate TI message from the transport
provider in response to the issued TI message. buf is a
pointer to a buffer large enough to hold the contents of the
appropriate TI messages. The TI message types are defined in
. The possible values for the cmd field are:
SunOS 5.11 Last change: 26 Mar 1993 1
STREAMS Modules timod(7M)
TIBIND Bind an address to the underlying transport
protocol provider. The message issued to the
TIBIND ioctl is equivalent to the TI message
type TBINDREQ and the message returned by
the successful completion of the ioctl is
equivalent to the TI message type TBINDACK.
TIUNBIND Unbind an address from the underlying tran-
sport protocol provider. The message issued
to the TIUNBIND ioctl is equivalent to the
TI message type TUNBINDREQ and the message
returned by the successful completion of the
ioctl is equivalent to the TI message type
TOKACK.
TIGETINFO Get the TI protocol specific information from
the transport protocol provider. The message
issued to the TIGETINFO ioctl is equivalent
to the TI message type TINFOREQ and the
message returned by the successful completion
of the ioctl is equivalent to the TI message
type TINFOACK.
TIOPTMGMT Get, set, or negotiate protocol specific
options with the transport protocol provider.
The message issued to the TIOPTMGMT ioctl
is equivalent to the TI message type
TOPTMGMTREQ and the message returned by the
successful completion of the ioctl is
equivalent to the TI message type
TOPTMGMTACK.
FILES
ioctl definitions
TLI interface declaration and structure
file
TPI declarations and user-level code
system error messages file. Please see
errno(3C).
SunOS 5.11 Last change: 26 Mar 1993 2
STREAMS Modules timod(7M)
SEE ALSO
Intro(3), ioctl(2), errno(3C), tirdwr(7M)
STREAMS Programming Guide
DIAGNOSTICS
If the ioctl returns with a value greater than 0, the lower
8 bits of the return value will be one of the TI error codes
as defined in . If the TI error is of type
TSYSER, then the next 8 bits of the return value will con-
tain an error as defined in (see Intro(3)).
SunOS 5.11 Last change: 26 Mar 1993 3
|
