smiGetNextMacro(3) SMI macro and extension information routines

Other Alias

smiGetMacro, smiGetFirstMacro, smiGetMacroModule


#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;


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.


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


(C) 1999-2001 Frank Strauss, TU Braunschweig, Germany <[email protected]>