csa_free man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

csa_free(library call)					csa_free(library call)

       csa_free — free memory allocated by the calendaring service

       #include <xcsa.h>
       CSA_return_code csa_free(
       CSA_buffer memory);

       The  csa_free  function	frees memory allocated by the calendaring ser‐
       vice.  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_con‐
       figuration(3),	  csa_list_calendar_attributes(3),     csa_read_calen‐
       dar_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	struc‐
       ture  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).

   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.

       Whether	the  function  succeeded  or not, and, if not, why.  It may be
       success or one of the values listed under ERRORS below.

       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.

       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_cal‐
       endars(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_calen‐
       dar_attributes(3),			 csa_read_entry_attributes(3),
       csa_read_next_reminder(3),    csa_register_callback(3),	  csa_unregis‐
       ter_callback(3),			    csa_update_calendar_attributes(3),

							csa_free(library call)

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net