t_free(3N)                                                t_free(3N)


       NAME
             t_free - free a library data structure

       SYNOPSIS
             cc [options] file -lnsl
             #include <xti.h>
             int t_free(char *ptr, int struct_type);

          Parameters
             ptr         points to the structure referenced by t_alloc.

             struct_type identifies the type of structure.

       DESCRIPTION
             This function is a TLI/XTI local management routine used to
             free memory previously allocated by t_alloc.  This function
             will free memory for the specified structure, and will also
             free memory for buffers referenced by the structure.

             ptr points to the structure, previously referenced by t_alloc,
             which may be one of six types described by struct_type.  One
             of the following types of structures may be specified:

                         T_BIND         /* struct t_bind    */
                         T_OPTMGMT      /* struct t_optmgmt */
                         T_CALL         /* struct t_call    */
                         T_DIS          /* struct t_discon  */
                         T_UNITDATA     /* struct t_unitdata*/
                         T_UDERROR      /* struct t_uderr   */
                         T_INFO         /* struct t_info    */

             where each of these structures is used as an argument  to  one
             or more transport functions.

             t_free will check the addr, opt, and udata fields of the given
             structure (as appropriate), and free the buffers pointed to by
             the buf field of the netbuf [see intro(3)] structure.

          Return Values
             t_free returns 0 on success and -1 on failure and t_errno is
             set to indicate the error.

          Errors
             On failure, t_errno may be set to the following:




                           Copyright 1994 Novell, Inc.               Page 1

      t_free(3N)                                                t_free(3N)


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

            TNOSTRUCTYPE
                      The argument that specifies struct_type is invalid,
                      for example, because the type of structure requested
                      in inconsistent with the transport provider
                      (connection mode or connectionless).

            TPROTO    A communication problem has been detected with the
                      transport provider and there is no other value of
                      t_errno to describe the error condition.

         State Transitions
            t_free may be issued from any valid state except T_UNINIT and
            has no effect on the state.

         Files
            /usr/lib/libxti.so
                              X/Open Transport Interface Library (shared
                              object)
            /usr/lib/libnsl.so
                              Network Services Library (shared object)

      USAGE
            After all buffers are freed, t_free will free the memory
            associated with the structure pointed to by ptr.

            If buf is NULL, t_free will not attempt to free memory.

         Warnings
            Undefined results will occur if ptr or any of the buf pointers
            points to a block of memory that was not previously allocated
            by t_alloc.

      REFERENCES
            intro(3), t_alloc(3N)











                          Copyright 1994 Novell, Inc.               Page 2