T_FREE(3N)           INTERACTIVE UNIX System           T_FREE(3N)



          NAME
               t_free - free a library structure

          SYNOPSIS
               #include <tiuser.h>

               int t_free(ptr, struct_type)
               char *ptr;
               int struct_type;

          DESCRIPTION
               The t_free function frees 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 one of the six structure types described for
               t_alloc, and struct_type identifies the type of that struc-
               ture which can be one of the following:

               T_BIND           struct t_bind

               T_CALL           struct t_call

               T_OPTMGMT        struct t_optmgmt

               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.

               The t_free function 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.  If buf is NULL, t_free will not
               attempt to free memory.  After all buffers are freed, t_free
               will free the memory associated with the structure pointed
               to by ptr.

               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.

               On failure, t_errno may be set to the following:

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


          Rev. Networking Support Utilities                          Page 1

          T_FREE(3N)           INTERACTIVE UNIX System           T_FREE(3N)



          SEE ALSO
               intro(3), t_alloc(3N).
               Programmer's Guide.

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
















































          Rev. Networking Support Utilities                          Page 2