Provided by: libsmi2-dev_0.4.8+dfsg2-16.1build1_amd64 bug

NAME

       smiGetModule,    smiGetFirstModule,    smiGetNextModule,   smiGetModuleIdentityNode,   smiGetFirstImport,
       smiGetNextImport,  smiIsImported,  smiGetFirstRevision,  smiGetNextRevision  -  SMI  module   information
       routines

SYNOPSIS

       #include <time.h>
       #include <smi.h>

       SmiModule *smiGetModule(char *module);

       SmiModule *smiGetFirstModule();

       SmiModule *smiGetNextModule(SmiModule *smiModulePtr);

       SmiNode *smiGetModuleIdentityNode(SmiModule *smiModulePtr);

       SmiImport *smiGetFirstImport(SmiModule *smiModulePtr);

       SmiImport *smiGetNextImport(SmiImport *smiImportPtr);

       int smiIsImported(SmiModule *smiModulePtr, SmiModule *importedModulePtr, char *importedName);

       SmiRevision *smiGetFirstRevision(SmiModule *smiModulePtr);

       SmiRevision *smiGetNextRevision(SmiRevision *smiRevisionPtr);

       typedef struct SmiModule {
           SmiIdentifier       name;
           char                *path;
           char                *organization;
           char                *contactinfo;
           char                *description;
           char                *reference;
           SmiLanguage         language;
           int                 conformance;
       } SmiModule;

       typedef struct SmiRevision {
           time_t              date;
           char                *description;
       } SmiRevision;

       typedef struct SmiImport {
           SmiIdentifier       module;
           SmiIdentifier       name;
       } SmiImport;

DESCRIPTION

       These  functions  retrieve  various  meta  information  on  MIB  modules. Other functions to retrieve the
       definitions within a module are documented in smi_type(3), smi_node(3), and smi_macro(3).

       The smiGetModule() function retrieves a struct SmiModule that represents the  SMI  module  named  module.
       Elements  not  available  or  not  present  for  this  module  contain  NULL. If the module is not found,
       smiGetModule() returns NULL.

       The smiGetFirstModule()  and  smiGetNextModule()  functions  are  used  to  iteratively  retrieve  struct
       SmiModules  of  all known modules.  smiGetFirstModule() returns the first known module.  Subsequent calls
       to smiGetNextModule() return the following ones.  If there are no more modules NULL is returned.

       The smiGetModuleIdentityNode() function retrieves a struct SmiNode that represents the node that is  used
       to identify the containing MIB module specified by smiModulePtr.  If there is no such identity node, i.e.
       if this is not an SMIv2 or SMIng module converted from SMIv2, smiGetModuleIdentityNode() returns NULL.

       The  smiGetFirstImport()  and  smiGetNextImport()  functions  are  used  to  iteratively  retrieve struct
       SmiImports of a given module.  smiGetFirstImport() returns the first identifier imported  by  the  module
       specified  by  smiModulePtr.  Subsequent calls to smiGetNextImport() return the following ones.  If there
       are no more imported identifiers NULL is returned.

       The smiIsImported() function returns a positive value if  the  identifier  importedName  defined  in  the
       module  specified  by  importedModulePtr  is  imported  in  the module specified by smiModulePtr, or zero
       otherwise.

       The smiGetFirstRevision() and smiGetNextRevision() functions are  used  to  iteratively  retrieve  struct
       SmiRevisions  of  a  given module. smiGetFirstRevision() returns the first (that is most recent) revision
       information of the module specified by smiModulePtr. Subsequent calls to smiGetNextRevision() return  the
       revision after (timely before) that one. If there are no more revisions NULL is returned.

FILES

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

SEE ALSO

       libsmi(3), smi_config(3), smi_node(3), smi.h

AUTHOR

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

IBR                                              August 16, 2001                                   smi_module(3)