t_free(NET)

t_free -- free a library data structure

Synopsis

cc [options] file -lnsl

#include <xti.h>

int t_free(char *ptr, int struct_type);

Description

This function is a TLI/XTI local management routine used to free 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 the structure, previously referenced by t_alloc, which may be one of six types described by struct_type. One of the following types of structures may be specified:

   T_BIND          /* struct t_bind        */
   T_OPTMGMT       /* struct t_optmgmt     */
   T_CALL          /* struct t_call        */
   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.

t_free 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(NET)) structure.

Parameters

ptr: points to the structure referenced by t_alloc.
struct_type: identifies the type of structure.

State transitions

t_free may be issued from any valid state except T_UNINIT and has no effect on the state.

Files

/usr/lib/libxti.so: X/Open^® Transport Interface Library (shared object)
/usr/lib/libnsl.so: Network Services Library (shared object)

Usage

After all buffers are freed, t_free will free the memory associated with the structure pointed to by ptr.

If buf is NULL, t_free will not attempt to free memory.

Return values

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.
TNOSTRUCTYPE: The argument that specifies struct_type is invalid, for example, because the type of structure requested in inconsistent with the transport provider (connection mode or connectionless).
TPROTO: A communication problem has been detected with the transport provider and there is no other value of t_errno to describe the error condition.

Warnings

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.

References

intro(NET), t_alloc(NET)