toptmgmt(3)                        CLIX                        toptmgmt(3)



  NAME

    t_optmgmt - Manages options for a transport endpoint

  LIBRARY

    The Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_optmgmt(
      int fd ,
      struct t_optmgmt *req ,
      struct t_optmgmt *ret );

  DESCRIPTION

    The t_optmgmt() function enables a transport user to retrieve, verify, or
    negotiate protocol options with the transport provider.  The variable fd
    identifies a bound transport endpoint.

    The req and ret arguments point to a t_optmgmt structure containing the
    following members:

    struct netbuf opt;
    long flags;

    The opt field identifies protocol options and the flags field is used to
    specify the action to take with those options.

    The options are represented by a netbuf [see intro; also for len, buf and
    maxlen] t_bind.  The variable req is used to request a specific action of
    the provider and to send options to the provider.  Variable len specifies
    the number of bytes in the options, buf points to the options buffer, and
    maxlen has no meaning for the req argument.  The transport provider may
    return options and flag values to the user through ret.  For ret, maxlen
    specifies the maximum size of the options buffer and buf points to the
    buffer where the options are to be placed.  On return, len specifies the
    number of bytes of options returned.  The maxlen member has no meaning for
    the req structure, but must be set in the ret structure to specify the
    maximum number of bytes the options buffer can hold.  The actual structure
    and content of the options is imposed by the transport provider.

    The flags field of req can specify one of the following actions:

    T_NEGOTIATE
           This action enables the user to negotiate the values of the options
           specified in req with the transport provider.  The provider will
           evaluate the requested options and negotiate the values, returning



  2/94 - Intergraph Corporation                                              1

  toptmgmt(3)                        CLIX                        toptmgmt(3)



           the negotiated values through ret.

    T_CHECK
           This action enables the user to verify whether the options
           specified in req are supported by the transport provider.  On
           return, the flags field of ret will have either T_SUCCESS or
           T_FAILURE set to indicate to the user whether the options are
           supported.  These flags are only meaningful for the T_CHECK
           request.

    T_DEFAULT
           This action enables a user to retrieve the default options
           supported by the transport provider into the opt field of ret.  In
           req, the len field of opt must be zero and the buf field may be
           NULL.

    If issued as part of the connectionless-mode service, t_optmgmt() may
    block due to flow control constraints.  The function will not complete
    until the transport provider has processed all previously sent data units.

  ERRORS

    On failure, t_errno may be set to one of the following:

    [TBADF]
           The specified file descriptor does not refer to a transport
           endpoint.

    [TOUTSTATE]
           The function was issued in the wrong sequence.

    [TACCES]
           The user does not have permission to negotiate the specified
           options.

    [TBADOPT]
           The specified protocol options were in an incorrect format or
           contained illegal information.

    [TBADFLAG]
           An invalid flag was specified.

    [TBUFOVFLW]
           The number of bytes allowed for an incoming argument is not
           sufficient to store the value of that argument.  The information to
           be returned in ret will be discarded.

    [TSYSERR]
           A system error has occurred during execution of this function.

  RETURN VALUES



  2                                              Intergraph Corporation - 2/94

  toptmgmt(3)                        CLIX                        toptmgmt(3)



    The t_optmgmt function returns 0 on success and -1 on failure and t_errno
    is set to indicate the error.

  RELATED INFORMATION

    Functions:  t_getinfo(3), t_open(3), intro(3)

    AT&T UNIX System V Network Programmer's Guide














































  2/94 - Intergraph Corporation                                              3