NAME

       smiGetIdentity,     smiGetFirstIdentity,     smiGetNextIdentity,     smiGetParentIdentity,
       smiGetIdentityModule - SMI identity information routines

SYNOPSIS

       #include <smi.h>

       SmiIdentity *smiGetIdentity(SmiModule *smiModulePtr, char *name);

       SmiIdentity *smiGetFirstIdentity(SmiModule *smiModulePtr);

       SmiIdentity *smiGetNextIdentity(SmiIdentity *smiIdentityPtr);

       SmiIdentity *smiGetParentIdentity(SmiIdentity *smiIdentityPtr);

       SmiModule *smiGetIdentityModule(SmiType *smiIdentityPtr);

       typedef struct SmiIdentity {
           SmiIdentifier       name;
           SmiDecl             decl;
           SmiStatus           status;
           char                *description;
           char                *reference;
       } SmiIdentity;

DESCRIPTION

       These functions retrieve information on a SMIng identity definition (SMIng).

       smiGetIdentity(SmiModule *smiModulePtr,char *name) returns a pointer to struct SmiIdentity
       for  the  identity  with  the given name in the given module(smiModulePtr), or NULL if the
       idenity with the given name does not exist

       smiGetFirstIdentity(SmiModule    *smiModulePtr)     and     smiGetNextIdentity(SmiIdentity
       *smiIdentityPtr)  are  used  to  iterate  through  the  identities  of the module given by
       smiModulePtr. They return a pointer to struct SmiIdentity hat represents  an  identity  or
       NULL if there are no identities left in the module, or error has occurred.

       smiGetIdentityModule(SmiIdentity  *smiIdentityPtr)  returns a pointer to struct SmiModule,
       of the module containing the given identity.

       smiGetParentIdentity(SmiIdentity *smiIdentityPtr) returns a pointer to struct  SmiIdentity
       pointing  to  the  parent  of  the  given  smiIdentityPtr,  or NULL if the Identity is not
       derived.

FILES

       ${prefix}/include/smi.h    SMI library header file

SEE ALSO

       libsmi(3), smi_module(3), smi.h

AUTHOR

       (C) 2007 Kaloyan Kanev, Jacobs University, Germany <k.kanev@jacobs-university.de>

                                        February 10, 2007                         smi_identity(3)