smi_macro(3)						SMI Management Information Library					      smi_macro(3)

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 quali-
       fied 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>

IBR
								  August 16, 2001						      smi_macro(3)