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)