*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> t_free (3)              



NAME    [Toc]    [Back]

       t_free - Free a library structure

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       int t_free(
               char *ptr,
               int struct_type );

LIBRARY    [Toc]    [Back]

       XTI Library (libxti.a)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       t_free():  XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       The  following  table  summarizes  the  relevance of input
       parameter data before and after t_free() is called:

       Parameters    Before Call   After Call
       ptr           y             n
       struct_type   y             n

       Notes to table: This is a meaningful parameter.   This  is
       not  a  meaningful  parameter.  Points to one of the seven
       structure types described for structures previously  named
       by  the  struct_type  parameter of the t_alloc() function,
       listed below.  Specifies the structure type for  functions
       for  which memory was previously allocated. This parameter
       must be one of the symbolic names listed in the  following

              Symbolic Name   Structure           Using Function
              T_BIND          struct t_bind       t_bind()
              T_CALL          struct t_call       t_accept(),    t_connect(),
              T_OPTMGMT       struct t_optmgmt    t_optmgmt()
              T_DIS           struct t_discon     t_rcvdis()
              T_UNITDATA      struct t_unitdata   t_rcvudata(), t_sndudata()

              T_UDERROR       struct t_uderr      t_rcvuderr()
              T_INFO          struct t_info       t_info()

              Any structure symbolic name listed in the preceding
              table may be used as an argument to deallocate previously
  reserved  memory.  Each of the structures,
              except t_info, contains at least one member of type
              struct  netbuf  structure,  which is defined in the
              xti.h include file.

              This function checks all members of a netbuf structure
  and  deallocates those buffers. When a netbuf
              structure buf parameter is a null pointer, no  memory
  is deallocated.  After all buffers are deallocated,
 this function frees all memory referenced by
              the ptr parameter.

DESCRIPTION    [Toc]    [Back]

       The  t_free()  function is an XTI general utility function
       used to deallocate  memory  buffers  previously  allocated
       with the t_alloc() function. When executed, t_free() deallocates
 memory for the named structure and for any buffers
       referenced  by  the named structure. When t_free() is executed,
  undefined  results  are  obtained  when  structure
       pointers  or  buffer  pointers  point to memory blocks not
       previously allocated with the t_alloc() function.

ERRORS    [Toc]    [Back]

       If the t_free() function fails, t_errno may be set to  the
       following  value: A system error occurred during execution
       of  this  function.   Unsupported  struct_type  requested.
       This error indicates that a communication problem has been
       detected between XTI and the transport provider for  which
       there is no other suitable XTI(t_errno).

VALID STATES    [Toc]    [Back]

       The  t_free()  function  can  be  called  in all transport
       provider states.

RETURN VALUE    [Toc]    [Back]

       Upon  successful  completion,  a  value  of  0  (zero)  is
       returned. Otherwise, a value of -1 is returned and t_errno
       is set to indicate the error.

SEE ALSO    [Toc]    [Back]

       Functions: t_alloc(3)

       Standards: standards(5)

       Network Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
SSL_free Tru64 Free an allocated SSL structure
SSL_free NetBSD free an allocated SSL structure
SSL_free OpenBSD free an allocated SSL structure
SSL_SESSION_free NetBSD free an allocated SSL_SESSION structure
CSSM_DeleteContext Tru64 Free the context structure (CDSA)
SSL_SESSION_free Tru64 Free an allocated SSL_SESSION structure
SSL_SESSION_free OpenBSD free an allocated SSL_SESSION structure
CSSM_FreeContext Tru64 Free memory associated with the context structure (CDSA)
freeaddrinfo Tru64 Free system resources used by an address information structure
t_alloc Tru64 Allocate a library structure
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service