t_free(3N)                        SDK R4.11                       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.

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.


Licensed material--property of copyright holder(s)