t_free(3N)              NETWORK FUNCTIONS              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 struc-
     ture, 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.




            Last change: Networking Support Utilities           1

t_free(3N)              NETWORK FUNCTIONS              t_free(3N)



SEE ALSO
     intro(3), talloc(3N).
     UNIX System V Network Programmer's Guide.

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
















































            Last change: Networking Support Utilities           2