NAME

smiGetMacro, smiGetFirstMacro, smiGetNextMacro, smiGetMacroModule - SMI macro and extension information routines

SYNOPSIS

#include <smi.h>

SmiMacro *smiGetMacro(SmiModule *smiModulePtr, char *macro);

SmiMacro *smiGetFirstMacro(SmiModule *smiModulePtr);

SmiMacro *smiGetNextMacro(SmiMacro *smiMacroPtr);

SmiModule *smiGetMacroModule(SmiMacro *smiMacroPtr);


typedef struct SmiMacro {


    SmiIdentifier       name;


    SmiDecl             decl;


    SmiStatus           status;


    char                *description;


    char                *reference;
} SmiMacro;

DESCRIPTION

These functions retrieve information on an extension statement definition (SMIng) or a macro (SMIv1/v2).

The smiGetMacro() function retrieves a struct SmiMacro that represents an extension or macro definition. Macro may be either a fully qualified descriptor or a simple macro or extension name. If smiModulePtr is not NULL it used to limit the search to the given module. If the macro is not found, smiGetMacro() returns NULL.

The smiGetFirstMacro() and smiGetNextMacro() functions are used to iteratively retrieve struct SmiMacros. smiGetFirstMacro() returns the first one defined in the module specified by smiModulePtr. Subsequent calls to smiGetNextMacro() return the following ones. If there are no more extension or macro definitions in the module, NULL is returned.

The smiGetMacroModule() function returns the module that defines the macro or extension given by struct SmiMacroPtr.

FILES

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

SEE ALSO

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

AUTHOR

(C) 1999-2001 Frank Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de>