t_free(3N)            (Networking Support Utilities)             t_free(3N)


   NAME
         tfree - free a library structure

   SYNOPSIS
         #include <tiuser.h>

         int tfree(ptr, structtype)
         char *ptr;
         int structtype;

   DESCRIPTION
         The tfree function frees memory previously allocated by talloc.
         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 talloc,
         and structtype identifies the type of that structure, which can be
         one of the following:

         TBIND           struct tbind

         TCALL           struct tcall

         TOPTMGMT        struct toptmgmt

         TDIS            struct tdiscon

         TUNITDATA       struct tunitdata

         TUDERROR        struct tuderr

         TINFO           struct tinfo

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

         tfree 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,
         tfree will not attempt to free memory.  After all buffers are freed,
         tfree 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 talloc.

         On failure, terrno may be set to the following:

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



   7/91                                                                 Page 1

   t_free(3N)            (Networking Support Utilities)             t_free(3N)


   SEE ALSO
         intro(3), talloc(3N).
         Programmer's Guide: Networking Interfaces.

   DIAGNOSTICS
         tfree returns 0 on success and -1 on failure and terrno is set to
         indicate the error.














































   Page 2                                                                 7/91