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>