NAME    [Toc]    [Back]

       timod  -  STREAMS module for converting ioctl() calls into
       TI messages

DESCRIPTION    [Toc]    [Back]

       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  command  binds  an  address  to  the
       transport  protocol provider. The STREAMS message that the
       module issues to the TI_BIND ioctl() call is equivalent 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_OPTMGMT_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    [Toc]    [Back]
       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    [Toc]    [Back]

       Defines  the  error  codes  for TI functions.  Defines the
       message types for TI.  Defines the error codes for  system
       errors.

SEE ALSO    [Toc]    [Back]

       Functions: intro(2), ioctl(2)

       Interfaces: streamio(7)



                                                         timod(7)