.\"
.\" $Id: libsmi.3.in 4432 2006-05-29 16:21:11Z strauss $
.\"
.TH libsmi 3  "August 16, 2001" "IBR" "SMI Management Information Library"
.SH NAME
libsmi \- library to access SMI management information
.SH DESCRIPTION
This library contains functions that allow access to SMI management
information stored in repositories that are managed by \fBlibsmi\fP,
currently directories containing SMIv1/v2 and SMIng MIB module files.
.PP
The libsmi API is defined in \fBsmi.h\fP. Functions are
documented in \fBsmi_config\fP(3), \fBsmi_module\fP(3),
\fBsmi_node\fP(3), \fBsmi_type\fP(3), and \fBsmi_macro\fP(3).
.PP
The purpose of libsmi is to separate the weird parsing and handling of
MIB modules from management applications. MIB modules conforming to
SMIv1, SMIv2 and SMIng - a new language for management information,
developed at the Technical University of Braunschweig, Germany - can
be handled by libsmi.
.PP
NOTE: SMIng support in the current release of libsmi is neither stable
nor representing the work done in the IETF SMING working group. It is
based research efforts at TU Braunschweig and within the IRTF in 1999-2000.
.PP
.SH "EXAMPLE"
.nf
#include <stdio.h>
#include <string.h>
#include <smi.h>
 
int main(int argc, char *argv[])
{
    SmiNode *smiNode;
    int oidlen, first = 1;
    
    if (argc != 2) {
        fprintf(stderr, "Usage: smisubtree oid\\n");
        exit(1);
    }
 
    smiInit(NULL);
 
    for((smiNode = smiGetNode(NULL, argv[1])) &&
            (oidlen = smiNode->oidlen);
        smiNode && (first || smiNode->oidlen > oidlen);
        smiNode = smiGetNextNode(smiNode, SMI_NODEKIND_ANY),
            first = 0) {
 
        printf("%*s%-32s\\n",
               (smiNode->oidlen - oidlen + 1) * 2, " ",
               smiNode->name);
        
    };
    
    exit(0);
}
.fi
.SH "FILES"
.nf
${prefix}/include/smi.h    SMI library header file
.fi
.SH "SEE ALSO"
.BR "RFCs 2578-2580"
specify the SMIv2 standard [STD 58].  The (obsolete) SMIng specification
has been a working document of the IRTF
Network Management Working Group (NMRG) (draft-irtf-nmrg-sming-02).
.PP
.BR smi.h ", "
.BR smi_config "(3), "
.BR smi_module "(3), "
.BR smi_node "(3), "
.BR smi_type "(3), "
.BR smi_macro "(3), "
.SH "AUTHOR"
(C) 1999-2001 Frank Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de>
.br