timod(7)               DEVICES AND MODULES               timod(7)



NAME
     timod - Transport Interface cooperating STREAMS module

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 which 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 which 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  STREAMS
     module or driver.  The messages generated from the following
     ioctl commands are recognized and  processed  by  the  timod
     module.  The format of the ioctl call is:

          #include <sys/stropts.h>
                    -
                    -
          struct strioctl strioctl;
                    -
                    -
          strioctl.iccmd = cmd;
          strioctl.ictimeout = INFTIM;
          strioctl.iclen = size;
          strioctl.icdp = (char *)buf
          ioctl(fildes, ISTR, &strioctl);

     Where, 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  con-
     tents  of the appropriate TI messages.  The TI message types
     are defined in <sys/tihdr.h>.  The possible values  for  the
     cmd field are:

     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



                                                                1

timod(7)               DEVICES AND MODULES               timod(7)



                    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
     <sys/timod.h>
     <sys/tiuser.h>
     <sys/tihdr.h>
     <sys/errno.h>

SEE ALSO
     tirdwr(7).
     Programmer's Guide: STREAMS.
     Programmer's Guide: Networking Interfaces.

DIAGNOSTICS
     If the ioctl system call 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  <sys/tiuser.h>.   If  the  TI
     error is of type TSYSERR, then the next 8 bits of the return
     value will contain an error as defined in <sys/errno.h> [see
     intro(2)].














                                                                2