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

  man pages->HP-UX 11i man pages -> csa_free (3)              


 csa_free(library call)                               csa_free(library call)

 NAME    [Toc]    [Back]
      csa_free - free memory allocated by the calendaring service

 SYNOPSIS    [Toc]    [Back]
      #include <xcsa.h>
      CSA_return_code csa_free(
      CSA_buffer memory);

 DESCRIPTION    [Toc]    [Back]
      The csa_free function frees memory allocated by the calendaring
      service.  After the call, the pointer memory will be invalid and
      should not be referenced again.  When any CSA function allocates and
      returns a buffer to the application, the application will free that
      memory with this call when it is finished with the memory.  When a CSA
      function returns a base pointer to a complex structure containing
      several levels of pointers, all the application will do to free the
      entire structure or array of structures is call this routine with the
      base pointer returned by the CSA function.  The CSA functions that
      return structures of this form are csa_list_calendars(3),
      csa_look_up(3), csa_query_configuration(3),
      csa_list_calendar_attributes(3), csa_read_calendar_attributes(3),
      csa_free_time_search(3), csa_add_entry(3), csa_list_entries(3),
      csa_list_entry_attributes(3), csa_list_entry_sequence(3),
      csa_read_entry_attributes(3), and csa_read_next_reminder(3),
      csa_update_entry_attributes(3). The behavior of csa_free(3) is
      undefined when called with a pointer to a memory block not allocated
      by the calendaring service, a pointer to a memory block that has
      already been freed, or a pointer contained in a structure returned by
      the CSA implementation.  In some situations, the extensions specified
      for a function may be a combination of input and output extensions.
      In this case, the memory returned in the output extensions must be
      freed one at a time using csa_free(3).

 ARGUMENTS    [Toc]    [Back]
    Memory (Buffer)
      A pointer to memory allocated by the calendaring service.  A value of
      NULL will be ignored, but will return the return code CSA_SUCCESS.

 RETURN VALUE    [Toc]    [Back]
      Whether the function succeeded or not, and, if not, why.  It may be
      success or one of the values listed under ERRORS below.

 ERRORS    [Toc]    [Back]
      The csa_free function returns the following error values:

                There was a general failure that does not fit the
                description of any other error code.

                A function parameter was invalid.

                                    - 1 -       Formatted:  January 24, 2005

 csa_free(library call)                               csa_free(library call)

 SEE ALSO    [Toc]    [Back]
      csa/csa.h - csacsa(5), csa_add_calendar(3), csa_add_entry(3),
      csa_call_callbacks(3), csa_delete_calendar(3), csa_delete_entry(3),
      csa_free_time_search(3), csa_list_calendar_attributes(3),
      csa_list_calendars(3), csa_list_entries(3),
      csa_list_entry_attributes(3), csa_list_entry_sequence(3),
      csa_logoff(3), csa_logon(3), csa_look_up(3),
      csa_query_configuration(3), csa_read_calendar_attributes(3),
      csa_read_entry_attributes(3), csa_read_next_reminder(3),
      csa_register_callback(3), csa_unregister_callback(3),
      csa_update_calendar_attributes(3), csa_update_entry_attributes(3).

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
msen_free IRIX free allocated memory
mint_free IRIX free allocated memory
mac_free IRIX free allocated memory
acl_free IRIX free allocated memory
cfree FreeBSD free up allocated memory
ufmFree IRIX free an area of memory that was allocated by UFM
if_freenameindex Tru64 Free dynamic memory allocated to the array of interface names and indexes
SSL_free OpenBSD free an allocated SSL structure
cap_free IRIX free allocated capability
SSL_free Tru64 Free an allocated SSL structure
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service