t_free(3xti)t_free(3xti)Namet_free - free a library structure
Syntax
#include <xti.h>
int t_free(ptr, struct_type)
char *ptr;
int struct_type;
Arguments
ptr Points to one of the seven structure types described for
struct_type
Identifies the type of that structure, which must be one of
the following:
T_BIND_STR struct t_bind;
T_CALL_STR struct t_call
T_OPTMGMT_STR struct t_optmgmt
T_DIS_STR struct t_discon
T_UNITDATA_STR struct t_unitdata
T_UDERROR_STR struct t_uderr
T_INFO_STR struct t_info
Each of these structures is used as an argument to one or
more transport functions.
Description
The function frees memory previously allocated by This function frees
memory for the specified structure and also frees memory for buffers
referenced by the structure.
───────────────────────────────────────
Parameters Before Call After Call
───────────────────────────────────────
ptr x /
struct_type x /
───────────────────────────────────────
The function checks the addr, opt, and udata fields of the given struc‐
ture (as appropriate) and free the buffers pointed to by the buf field
of the netbuf structure. If buf is NULL, does not attempt to free mem‐
ory. After all buffers are freed, frees the memory associated with the
structure pointed to by ptr.
Results are undefined if ptr or any of the buf pointers points to a
block of memory not previously allocated by
Return Values
Upon successful completion, a value of 0 is returned. On failure, a
value of -1 is returned, and t_errno is set to indicate the error.
Diagnostics
On failure, t_errno is set to one of the following:
[TNOTSUPPORT] This function is not supported by the current
implementation of XTI.
[TSYSERR] A system error has occurred during execution of
this function.
See Alsot_alloc(3xti)t_free(3xti)