|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
LIBSMI -- A LIBRARY FOR SMI MANAGEMENT INFORMATION
|
|
Packit Service |
9ccfef |
==================================================
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Copyright (c) 1999-2008 Frank Strauss, Technical University of Braunschweig.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
See the file "COPYING" for information on usage and redistribution
|
|
Packit Service |
9ccfef |
of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
@(#) $Id: README 7795 2008-02-27 10:23:25Z strauss $
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
This project has been started as part of Frank Strauss' master's
|
|
Packit Service |
9ccfef |
thesis at the Technical University of Braunschweig, Germany in 1999.
|
|
Packit Service |
9ccfef |
Since then numerous people applied very major improvements, fixes, and
|
|
Packit Service |
9ccfef |
new features, namely Juergen Schoenwaelder who also initiated the
|
|
Packit Service |
9ccfef |
whole project and supervised my thesis work, as well as Torsten Klie,
|
|
Packit Service |
9ccfef |
Andreas Mueller, Moritz Bunkus, Jens Mueller, and Klaus Sperner. Many
|
|
Packit Service |
9ccfef |
others contributed lots of patches, improvements, and feature requests.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
This software comprises
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
- a library to parse and maintain MIB and PIB modules,
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
- a set of tools based on the library to check, convert, and compare
|
|
Packit Service |
9ccfef |
MIB and PIB modules.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
- a collection of all published IETF and IANA Standards Track MIB
|
|
Packit Service |
9ccfef |
and PIB modules and some more.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Please read the manual pages and the project's web pages for further
|
|
Packit Service |
9ccfef |
information.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
MANIFEST
|
|
Packit Service |
9ccfef |
========
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
README this file
|
|
Packit Service |
9ccfef |
COPYING the libsmi lincense terms
|
|
Packit Service |
9ccfef |
ChangeLog a rough history of changes
|
|
Packit Service |
9ccfef |
TODO incomplete list of things to be done
|
|
Packit Service |
9ccfef |
THANKS a list of people who contributed
|
|
Packit Service |
9ccfef |
configure configure script
|
|
Packit Service |
9ccfef |
lib/ library source code
|
|
Packit Service |
9ccfef |
tools/ tools source code
|
|
Packit Service |
9ccfef |
doc/ some related documents
|
|
Packit Service |
9ccfef |
mibs/ MIB modules to be installed
|
|
Packit Service |
9ccfef |
pibs/ PIB modules to be installed
|
|
Packit Service |
9ccfef |
test/ some test patterns
|
|
Packit Service |
9ccfef |
win/ Win32 port source code
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
INSTALLATION
|
|
Packit Service |
9ccfef |
============
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Requirements: GNU make, gcc, flex, bison, and other things most UNIX
|
|
Packit Service |
9ccfef |
systems have on board. The compiler has to support `long long' types.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
To configure libsmi, first check
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
./configure --help
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
output to see, what options are available. Then run
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
./configure [options]
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
with the options of your choice. Choose mibdir, pibdir and smipath
|
|
Packit Service |
9ccfef |
values appripriate for your environment so that users can live without
|
|
Packit Service |
9ccfef |
an SMIPATH environment variable and without configuration files.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
On HP-UX platforms the build process is reported to require gcc
|
|
Packit Service |
9ccfef |
and the --disable-shared configure option.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
To build libsmi and the tools, run
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
make
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
This should build the library libsmi in lib/ and the tools, namely
|
|
Packit Service |
9ccfef |
tools/smilint, tools/smidump, tools/smiquery, tools/smidiff,
|
|
Packit Service |
9ccfef |
tools/smixlate and the shell script tools/smistrip.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Now, you may run some checks by
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
make check
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Note that some tests of this test suite may fail, if GNU diff was not
|
|
Packit Service |
9ccfef |
found.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
If you wish to install the library, the MIB and PIB modules, the tools
|
|
Packit Service |
9ccfef |
and the man pages, run
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
make install
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
To use libsmi applications you might want to configure its behaviour.
|
|
Packit Service |
9ccfef |
Detailed library options, including per-application options, can
|
|
Packit Service |
9ccfef |
be configured through a global and a user level configuration file.
|
|
Packit Service |
9ccfef |
Additionally the SMIPATH environment variable can be used to configure
|
|
Packit Service |
9ccfef |
paths of module locations. See the smi_config(3) man page.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
DEBUGGING
|
|
Packit Service |
9ccfef |
=========
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
If you encounter any crashes or feel for any other reasons the need to
|
|
Packit Service |
9ccfef |
debug the libsmi tools, you should link the tools statically. This is
|
|
Packit Service |
9ccfef |
the easiest way to get around the problems when your debugger claims to
|
|
Packit Service |
9ccfef |
be unable to read the libsmi binary files, since they are built using
|
|
Packit Service |
9ccfef |
libtool. You can build the libsmi tools statically by
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
make clean
|
|
Packit Service |
9ccfef |
./configure --enable-static --disable-shared
|
|
Packit Service |
9ccfef |
make
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
FURTHER READING
|
|
Packit Service |
9ccfef |
===============
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Read the man pages for library concepts and usage and for the tools.
|
|
Packit Service |
9ccfef |
Please note that SMIng is currently in a quite inconsistent and
|
|
Packit Service |
9ccfef |
outdated state. It does *not* reflect what is being specified in RFCs
|
|
Packit Service |
9ccfef |
3780/3781. Therefore, SMIng is not enabled by default. See the old
|
|
Packit Service |
9ccfef |
specs in doc/draft-irtf-nmrg-sming-02.txt for details on SMIng as it
|
|
Packit Service |
9ccfef |
is implemented.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
You may find further information online, along with the subscription
|
|
Packit Service |
9ccfef |
information on the libsmi mailing list at
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
http://www.ibr.cs.tu-bs.de/projects/libsmi/.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Frank Strauss <strauss@ibr.cs.tu-bs.de>
|