Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

genders_handle_destroy (3)

Name

genders_handle_destroy - destroys a genders handle

Synopsis

#include <genders.h>

int genders_handle_destroy(genders_t handle);

Description

GENDERS_HANDLE_DESTROY(3)         LIBGENDERS         GENDERS_HANDLE_DESTROY(3)



NAME
       genders_handle_destroy - destroys a genders handle

SYNOPSIS
       #include <genders.h>

       int genders_handle_destroy(genders_t handle);

DESCRIPTION
       genders_handle_destroy() destroys the genders handle pointed to by han-
       dle and frees all allocated memory associated with it.

RETURN VALUES
       On success, 0 is returned.  On error, -1 is returned, and an error code
       is  returned  in  handle.   The  error  code  can be retrieved via gen-
       ders_errnum(3) , and a description of the error code can  be  retrieved
       via genders_strerror(3).  Error codes are defined in genders.h.

ERRORS
       GENDERS_ERR_NULLHANDLE
              The  handle  parameter is NULL.  The genders handle must be cre-
              ated with genders_handle_create(3).

       GENDERS_ERR_MAGIC
              handle has an incorrect magic number.  handle does not point  to
              a genders handle or handle has already been destroyed.

FILES
       /usr/include/genders.h


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | library/libgenders    |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+
SEE ALSO
       libgenders(3),   genders_handle_create(3),  genders_load_data(3),  gen-
       ders_errnum(3), genders_strerror(3)



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source     was      downloaded      from       http://downloads.source-
       forge.net/project/genders/genders/1.22-1/genders-1.22.tar.gz

       Further information about this software can be found on the open source
       community website at https://github.com/chaos/genders.



LLNL                              August 2003        GENDERS_HANDLE_DESTROY(3)