|
Packit |
022b05 |
.\"
|
|
Packit |
022b05 |
.\" $Id: smidump.1.in 7608 2008-01-22 13:05:41Z schoenw $
|
|
Packit |
022b05 |
.\"
|
|
Packit |
022b05 |
.TH smidump 1 "August 10, 2004" "IBR" "SMI Tools"
|
|
Packit |
022b05 |
.SH NAME
|
|
Packit |
022b05 |
smidump \- dump SMI or SPPI modules in various formats
|
|
Packit |
022b05 |
.SH SYNOPSIS
|
|
Packit |
022b05 |
.B smidump
|
|
Packit |
022b05 |
[
|
|
Packit |
022b05 |
.B "-Vhqusmk"
|
|
Packit |
022b05 |
] [
|
|
Packit |
022b05 |
.BI "-c " file
|
|
Packit |
022b05 |
] [
|
|
Packit |
022b05 |
.BI "-o " name
|
|
Packit |
022b05 |
] [
|
|
Packit |
022b05 |
.BI "-p " module
|
|
Packit |
022b05 |
] [
|
|
Packit |
022b05 |
.BI "-l " level
|
|
Packit |
022b05 |
] [
|
|
Packit |
022b05 |
.BI "-f " format
|
|
Packit |
022b05 |
]
|
|
Packit |
022b05 |
.I "module(s)"
|
|
Packit |
022b05 |
.SH DESCRIPTION
|
|
Packit |
022b05 |
The \fBsmidump\fP program is used to dump the contents of a single MIB
|
|
Packit |
022b05 |
or PIB
|
|
Packit |
022b05 |
module or a collection of modules to stdout in a selectable output
|
|
Packit |
022b05 |
format. This format may be a simple tree of nodes, types or imported
|
|
Packit |
022b05 |
modules, but also a format fully compliant to SMIv1, SMIv2, SPPI or SMIng or
|
|
Packit |
022b05 |
CORBA IDL or C source code. Smidump can thus be used to convert
|
|
Packit |
022b05 |
modules from SMIv2 to SMIng and from SMIng to SMIv2, or to develop
|
|
Packit |
022b05 |
template based agent code.
|
|
Packit |
022b05 |
.SH OPTIONS
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-V, --version\fP
|
|
Packit |
022b05 |
Show the smidump version and exit.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-h, --help\fP
|
|
Packit |
022b05 |
Show a help text and exit. The help text contains a list of all
|
|
Packit |
022b05 |
supported output formats.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-c \fIfile\fB, --config=\fIfile\fP
|
|
Packit |
022b05 |
Read \fIfile\fP instead of any other (global and user)
|
|
Packit |
022b05 |
configuration file.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-f \fIformat\fB, --format=\fIformat\fP
|
|
Packit |
022b05 |
Use \fIformat\fP when dumping a module. Supported output formats are described
|
|
Packit |
022b05 |
below. The default output format is SMIng. The \fIformat\fP argument is
|
|
Packit |
022b05 |
case insensitive.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-l \fIlevel\fB, --level=\fIlevel\fP
|
|
Packit |
022b05 |
Report errors and warnings up to the given severity \fIlevel\fP. See
|
|
Packit |
022b05 |
the smilint(1) manual page for a description of the error levels. The
|
|
Packit |
022b05 |
default error level is 3.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-s, --severity\fP
|
|
Packit |
022b05 |
Show the error severity in brackets before error messages.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-m, --error-names\fP
|
|
Packit |
022b05 |
Show the error names in braces before error messages.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-o \fIname\fB, --output=\fIname\fB
|
|
Packit |
022b05 |
Write the output in one or multiple files instead of stdout. The file
|
|
Packit |
022b05 |
name(s) are derived from the \fIname\fP argument. Not all format
|
|
Packit |
022b05 |
support this option.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-p \fImodule\fB, --preload=\fImodule\fP
|
|
Packit |
022b05 |
Preload the module \fImodule\fP before reading the main module(s). This may
|
|
Packit |
022b05 |
be helpful if an incomplete main module misses to import some definitions.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-q, --quiet\fP
|
|
Packit |
022b05 |
Suppress comments from dumped modules. What kind of information
|
|
Packit |
022b05 |
gets suppressed depends on the output format.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-u, --unified\fP
|
|
Packit |
022b05 |
Dump a unified output in case of multiple \fImodule(s)\fP instead of
|
|
Packit |
022b05 |
multiple concatenated output sections. This is not supported for all
|
|
Packit |
022b05 |
output formats.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
\fB-k, --keep-going\fP
|
|
Packit |
022b05 |
Continue as much as possible after serious parse errors. Note that
|
|
Packit |
022b05 |
the output generated after serious parse errors may be incomplete
|
|
Packit |
022b05 |
and should be used with care.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
.I module(s)
|
|
Packit |
022b05 |
These are the module(s) to be dumped. If a module argument represents a
|
|
Packit |
022b05 |
path name (identified by containing at least one dot or slash character),
|
|
Packit |
022b05 |
this is assumed to be the exact file to read. Otherwise, if a module is
|
|
Packit |
022b05 |
identified by its plain module name, it is searched according to libsmi
|
|
Packit |
022b05 |
internal rules. See \fBsmi_config(3)\fP for more details.
|
|
Packit |
022b05 |
.SH "OUTPUT FORMATS"
|
|
Packit |
022b05 |
The \fBsmidump\fP program supports the following output formats:
|
|
Packit |
022b05 |
.TP 12
|
|
Packit |
022b05 |
sming
|
|
Packit |
022b05 |
SMIng compliant format as defined in the SMIng Internet-Draft.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
smiv2
|
|
Packit |
022b05 |
SMIv2 compliant format as defined in RFC 2578, RFC 2579, RFC 2580.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
smiv1
|
|
Packit |
022b05 |
SMIv2 compliant format as defined in RFC 1155, RFC 1212, RFC 1215.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
sppi
|
|
Packit |
022b05 |
SPPI compliant format as defined in RFC 3159. If the underlying module
|
|
Packit |
022b05 |
is not SPPI, there might be some mandatory information missing.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
mosy
|
|
Packit |
022b05 |
Format generated by the mosy compiler.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
imports
|
|
Packit |
022b05 |
Import hierarchy of a module.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
types
|
|
Packit |
022b05 |
Types defined in a module.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
tree
|
|
Packit |
022b05 |
OID registration tree structure of a module.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
metrics
|
|
Packit |
022b05 |
Metrics derived from a module (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
identifiers
|
|
Packit |
022b05 |
List of identifiers defined in a module.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
compliances
|
|
Packit |
022b05 |
Compliance definitions with all included objects and notifications.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
corba
|
|
Packit |
022b05 |
CORBA IDL and OID definitions following the JIDM specification translation
|
|
Packit |
022b05 |
rules.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
netsnmp
|
|
Packit |
022b05 |
C source code files for usage within the net-snmp package (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
scli
|
|
Packit |
022b05 |
ANSI C manager stubs for usage within the scli package (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
cm
|
|
Packit |
022b05 |
Reverse engineered conceptual model in DIA XML file format (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
svg
|
|
Packit |
022b05 |
SVG diagram of a module (experimental). Use with \fB-u\fP when dumping multiple \fImodules\fP.
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
jax
|
|
Packit |
022b05 |
Java AgentX sub-agent classes in separate files (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
perl
|
|
Packit |
022b05 |
Perl represention of the MIB module
|
|
Packit |
022b05 |
(contributed by Martin Schulz <schulz@videotron.ca>).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
python
|
|
Packit |
022b05 |
Python dictionaries represention of the MIB module
|
|
Packit |
022b05 |
(contributed by Pat Knight <pat@ktgroup.co.uk>).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
xml
|
|
Packit |
022b05 |
SMI in XML format (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
xsd
|
|
Packit |
022b05 |
SMI in XML schema format (experimental).
|
|
Packit |
022b05 |
.TP
|
|
Packit |
022b05 |
sizes
|
|
Packit |
022b05 |
SNMP best case / worst case RFC 3416 PDU sizes for typical PDUs
|
|
Packit |
022b05 |
excluding SNMP message and transport headers (experimental).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
.SH "EXAMPLE"
|
|
Packit |
022b05 |
This example converts the SMIv2 module IF-MIB in the current directory
|
|
Packit |
022b05 |
to IF-MIB.sming in SMIng format. Note that the ./ prefix is used to
|
|
Packit |
022b05 |
ensure reading the module from the current directory and not from a
|
|
Packit |
022b05 |
place that libsmi guesses on its own.
|
|
Packit |
022b05 |
.nf
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
$ smidump -f sming ./IF-MIB > IF-MIB.sming
|
|
Packit |
022b05 |
.fi
|
|
Packit |
022b05 |
.SH "SEE ALSO"
|
|
Packit |
022b05 |
The
|
|
Packit |
022b05 |
.BR libsmi (3)
|
|
Packit |
022b05 |
project is documented at
|
|
Packit |
022b05 |
.BR "http://www.ibr.cs.tu-bs.de/projects/libsmi/" "."
|
|
Packit |
022b05 |
.PP
|
|
Packit |
022b05 |
.BR smilint "(1)"
|
|
Packit |
022b05 |
.SH "AUTHORS"
|
|
Packit |
022b05 |
(C) 1999-2004 F. Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de>
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
(C) 1999-2002 J. Schoenwaelder, TU Braunschweig, Germany <schoenw@ibr.cs.tu-bs.de>
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
(C) 2002-2003 J. Schoenwaelder, University of Osnabrueck, Germany
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
(C) 2003-2004 J. Schoenwaelder, International University Bremen, Germany
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
(C) 2001-2002 T. Klie, TU Braunschweig, Germany <tklie@ibr.cs.tu-bs.de>
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
(C) 2002 M. Bunkus, TU Braunschweig, Germany <bunkus@ibr.cs.tu-bs.de>
|
|
Packit |
022b05 |
.br
|
|
Packit |
022b05 |
and contributions by many other people.
|
|
Packit |
022b05 |
.br
|