Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

genders_getnumnodes (3)

Name

genders_getnumnodes - ders_getmaxnodelen, genders_getmaxattrlen, genders_getmaxvallen - gen- ders statistics routines

Synopsis

#include <genders.h>

int genders_getnumnodes(genders_t handle);

int genders_getnumattrs(genders_t handle);

int genders_getmaxattrs(genders_t handle);

int genders_getmaxnodelen(genders_t handle);

int genders_getmaxattrlen(genders_t handle);

int genders_getmaxvallen(genders_t handle);

Description

GENDERS_GETNUMNODES(3)            LIBGENDERS            GENDERS_GETNUMNODES(3)



NAME
       genders_getnumnodes,   genders_getnumattrs,  genders_getmaxattrs,  gen-
       ders_getmaxnodelen, genders_getmaxattrlen, genders_getmaxvallen -  gen-
       ders statistics routines

SYNOPSIS
       #include <genders.h>

       int genders_getnumnodes(genders_t handle);

       int genders_getnumattrs(genders_t handle);

       int genders_getmaxattrs(genders_t handle);

       int genders_getmaxnodelen(genders_t handle);

       int genders_getmaxattrlen(genders_t handle);

       int genders_getmaxvallen(genders_t handle);

DESCRIPTION
       genders_getnumnodes(),   genders_getnumattrs(),  genders_getmaxattrs(),
       genders_getmaxnodelen(), genders_getmaxattrlen(),  and  genders_getmax-
       vallen() get statistics about the genders file associated with handle.

       genders_getnumnodes() returns the number of nodes stored in the genders
       file.

       genders_getnumattrs() returns the number of attributes  listed  in  the
       genders file.

       genders_getmaxattrs()  returns  the maximum number of attributes listed
       with a node in the genders file.

       genders_getmaxnodelen() returns the maximum length of any  node  listed
       in the genders file.

       genders_getmaxattrlen()  returns  the  maximum  length of any attribute
       listed in the genders file.

       genders_getmaxvallen() returns the  maximum  length  of  any  attribute
       value listed in the genders file.

       In  general, genders_getnumnodes(), genders_getnumattrs(), genders_get-
       maxattrs(), genders_getmaxnodelen(), genders_getmaxattrlen(), and  gen-
       ders_getmaxvallen() are used so a programmer can dynamically allocate a
       proper amount of memory to store genders file information in.

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_NOTLOADED
              genders_load_data(3) has not been called to load genders data.

       GENDERS_ERR_MAGIC
              handle has an incorrect magic number.  handle does not point  to
              a  genders  handle  or handle has been destroyed by genders_han-
              dle_destroy(3).

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_GETNUMNODES(3)