t_free(3)                           CLIX                           t_free(3)



  NAME

    t_free - Frees a library structure

  LIBRARY

    The Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_free(
      char *ptr; ,
      int struct_type;

  PARAMETERS

    ptr           A pointer to a structure type

    struct_type   A structure type

  DESCRIPTION

    The t_free() function frees memory previously allocated by t_alloc().
    This function frees memory for the specified structure, and also frees
    memory for buffers referenced by the structure.

    The ptr parameter points to one of the six structure types described for
    t_alloc(), and struct_type identifies the type of that structure 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 checks the addr, opt, and udata fields of the given
    structure (as appropriate), and free the buffers pointed to by the buf



  2/94 - Intergraph Corporation                                              1

  t_free(3)                           CLIX                           t_free(3)



    field of the netbuf [see intro] structure.  If buf is NULL, t_free() will
    not attempt to free memory.  After all buffers are freed, t_free() frees
    the memory associated with the structure pointed to by ptr.

    Undefined results occur if ptr or any of the buf pointers point to a block
    of memory that was not previously allocated by t_alloc().

  RETURN VALUES

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

  ERRORS

    On failure, t_errno may be set to the following:

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

  RELATED INFORMATION

    Functions:  t_alloc(3)

    Miscellany:  intro(4)

    AT&T UNIX System V Network Programmer's Guide





























  2                                              Intergraph Corporation - 2/94