home | help
smi_identity(3)        SMI Management Information Library	 smi_identity(3)

NAME
     smiGetIdentity,  smiGetFirstIdentity, smiGetNextIdentity, smiGetParentIden-
     tity, 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  mod-
     ule(smiModulePtr),  or NULL if the idenity with the given name does not ex-
     ist

     smiGetFirstIdentity(SmiModule  *smiModulePtr)  and  smiGetNextIdentity(Smi-
     Identity *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-univer-
     sity.de>

				February 10, 2007		 smi_identity(3)

home | help