added files
[bcm963xx.git] / userapps / opensource / net-snmp / mibs / README.mibs
1 About the MIBS distributed with Net-SNMP.
2
3 This directory contains a very basic set of MIB files, ready for use.
4 In addition, there are some scripts and table files to help you get a
5 fuller collection of MIB files.
6
7 smistrip - a script that can extract a MIB file from an RFC (or I-D)
8 mibfetch - a script that will fetch an RFC file from a mirror, and extract
9         the hosted MIB from it. It assumes that you have wget installed.
10 rfclist - a list of RFC numbers and corresponding MIB name(s)
11 ianalist - a list of files at the IANA server that holds IANA maintained
12         MIBs
13 Makefile.mib - rules for extracting current MIB files from RFC and IANA
14         files.
15 rfcmibs.diff - a set of required patches for MIB files extracted from RFCs
16
17 The file Makefile.mib holds rules that fetch and extract MIB files from
18 their hosting RFCs. Make will use wget to retrieve the RFC files, and,
19 as I am located in Denmark, use the RFC mirror at NORDUnet. You may change
20 that at the top of Makefile.mib.
21
22 Makefile.mib also holds rules that will collect all the current IETF MIB
23 definitions, using the lists in rfclist and ianalist. To get them all,
24 use
25         make -f Makefile.mib allmibs
26
27 Note, that there are a few fatal syntactic errors in some of the RFC
28 definitions. To make them all parse successfully with the Net-SNMP parser,
29 you should apply the patches in the file rfcmibs.diff. These patches are
30 typical for the problems that are commonly seen with MIB files from various
31 sources:
32
33 - forgetting to import enterprises/mib-2/transmission from SNMPv2-SMI
34 - thinking that a -- comment ends at end-of-line, not at the next --
35 - using _ in identifiers. A - may be used in its place
36 - various misspellings
37
38 DISCLAIMER: The patches provided here for the IETF standard MIB files
39 are not endorsed by anyone, and I don't guarantee that they bring them
40 accordance with what the authors intended. All I will promise, is that
41 the MIB files can be parsed.