TFREE(3N-SVR4)     RISC/os Reference Manual      TFREE(3N-SVR4)



NAME
     t_free - 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
     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.

     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 t_alloc.

     On failure, t_errno may be set to the following:

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



                        Printed 11/19/92                   Page 1

TFREE(3N-SVR4)     RISC/os Reference Manual      TFREE(3N-SVR4)



SEE ALSO
     intro(3), t_alloc(3N).

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

















































 Page 2                 Printed 11/19/92