Blame mibs/README.mibs

Packit fcad23
About the MIBS distributed with Net-SNMP.
Packit fcad23
Packit fcad23
This directory contains a very basic set of MIB files, ready for use.
Packit fcad23
In addition, there are some scripts and table files to help you get a
Packit fcad23
fuller collection of MIB files.
Packit fcad23
Packit fcad23
smistrip - a script that can extract a MIB file from an RFC (or I-D)
Packit fcad23
mibfetch - a script that will fetch an RFC file from a mirror, and extract
Packit fcad23
	the hosted MIB from it. It assumes that you have wget installed.
Packit fcad23
rfclist - a list of RFC numbers and corresponding MIB name(s)
Packit fcad23
ianalist - a list of files at the IANA server that holds IANA maintained
Packit fcad23
	MIBs
Packit fcad23
Makefile.mib - rules for extracting current MIB files from RFC and IANA
Packit fcad23
	files.
Packit fcad23
rfcmibs.diff - a set of required patches for MIB files extracted from RFCs
Packit fcad23
Packit fcad23
The file Makefile.mib holds rules that fetch and extract MIB files from
Packit fcad23
their hosting RFCs. Make will use wget to retrieve the RFC files, and,
Packit fcad23
as I am located in Denmark, use the RFC mirror at NORDUnet. You may change
Packit fcad23
that at the top of Makefile.mib.
Packit fcad23
Packit fcad23
Makefile.mib also holds rules that will collect all the current IETF MIB
Packit fcad23
definitions, using the lists in rfclist and ianalist. To get them all,
Packit fcad23
use
Packit fcad23
	make -f Makefile.mib allmibs
Packit fcad23
Packit fcad23
Note, that there are a few fatal syntactic errors in some of the RFC
Packit fcad23
definitions. To make them all parse successfully with the Net-SNMP parser,
Packit fcad23
you should apply the patches in the file rfcmibs.diff. These patches are
Packit fcad23
typical for the problems that are commonly seen with MIB files from various
Packit fcad23
sources:
Packit fcad23
Packit fcad23
- forgetting to import enterprises/mib-2/transmission from SNMPv2-SMI
Packit fcad23
- thinking that a -- comment ends at end-of-line, not at the next --
Packit fcad23
- using _ in identifiers. A - may be used in its place
Packit fcad23
- various misspellings
Packit fcad23
Packit fcad23
There is a short-cut rule
Packit fcad23
	make -f Makefile.mib rfc
Packit fcad23
that will also apply the patches. Note that Makefile.mib and smistrip has
Packit fcad23
configurable versions of awk and patch. If you are running Solaris you
Packit fcad23
must set these to nawk and gpatch respectively.
Packit fcad23
Packit fcad23
DISCLAIMER: The patches provided here for the IETF standard MIB files
Packit fcad23
are not endorsed by anyone, and I don't guarantee that they bring them
Packit fcad23
accordance with what the authors intended. All I will promise, is that
Packit fcad23
the MIB files can be parsed.