mib2c.conf(5)
NAME
mib2c.conf - How to write mib2c.conf files to do ANYTHING based on MIB input.
SYNOPSIS
% cat > mib2c.test.conf << EOF @foreach $t table@
Starting table $t
@foreach $c column@
echo $t has column $c which has a syntax of $c.syntax
@end@
@end@ EOF
% mib2c -c mib2c.test.conf internet
DESCRIPTION
The mib2c.conf script language is a MIB-particular language designed to easily process MIB nodes in ways that you want. mib2c is a misnomer (for historical purposes), because you can produce anything (not just C code). Look in the Net-SNMP "local" directory for a bunch of example mib2c.*.conf files and behold the power before you.
COMMANDS
All commands within mib2c.conf files are embraced by @ signs. Anything
with an @ sign at the front and back of the line is generally supposed
to be a mib2c specific command. These are detailed here:
@open FILE@
writes generated output to FILE note that for file
specifications, opening '-' will print to stdout.
@append FILE@
appends the given FILE
@close FILE@
closes the given FILE
@push@ save the current outputs, then clear outputs. Use with @open@
and @pop@ to write to a new file without interfering with
current outputs.
@pop@ pop up the process() stack one level. Use after a @push@ to
return to the previous set of open files.
@foreach $VAR scalar@
repeat iterate over code until @end@ setting $VAR to all known
scalars
@foreach $VAR table@
repeat iterate over code until @end@ setting $VAR to all known
tables
@foreach $VAR column@
repeat iterate over code until @end@ setting $VAR to all known
columns within a given table. Obviously this must be called
within a foreach-table clause.
@foreach $VAR nonindex@
repeat iterate over code until @end@ setting $VAR to all known
non-index columns within a given table. Obviously this must be
called within a foreach-table clause.
@foreach $VAR internalindex@
repeat iterate over code until @end@ setting $VAR to all known
internal index columns within a given table. Obviously this
must be called within a foreach-table clause.
@foreach $VAR externalindex@
repeat iterate over code until @end@ setting $VAR to all known
external index columns within a given table. Obviously this
must be called within a foreach-table clause.
@foreach $VAR index@
repeat iterate over code until @end@ setting $VAR to all known
indexes within a given table. Obviously this must be called
within a foreach-table clause.
@foreach $VAR notifications@
repeat iterate over code until @end@ setting $VAR to all known
notifications
@foreach $VAR varbinds@
repeat iterate over code until @end@ setting $VAR to all known
varbinds Obviously this must be called within a foreach-
notifications clause.
@foreach $LABEL, $VALUE enum@
repeat iterate over code until @end@ setting $LABEL and $VALUE
to the label and values from the enum list.
@foreach $RANGE_START, $RANGE_END range NODE@
repeat iterate over code until @end@ setting $RANGE_START and
$RANGE_END to the legal accepted range set for a given mib NODE.
@foreach $var stuff a b c d@
repeat iterate over values a, b, c, d as assigned generically
(ie, the values are taken straight from the list with no mib-
expansion, etc).
@while expression@
repeat iterate over code until the expression is false
@eval $VAR = expression@
evaluates expression and assigns the results to $VAR. This is
not a full perl eval, but sort of a ""psuedo"" eval useful for
simple expressions while keeping the same variable name space.
See below for a full-blown export to perl.
@perleval STUFF@
evaluates STUFF directly in perl. Note that all mib2c variables
interpereted within .conf files are in $vars{NAME} and that a
warning will be printed if STUFF does not return 0. (adding a
'return 0;' at the end of STUFF is a workaround.
@startperl@
@endperl@
treats everything between these tags as perl code, and evaluates
it.
@next@ restart foreach; should only be used inside a conditional.
skips out of current conditional, then continues to skip to end
for the current foreach clause.
@if expression@
evaluates expression, and if expression is true processes
contained part until appropriate @end@ is reached. If the
expression is false, the next @elsif expression@ expression (if
it exists) will be evaluated, until an expression is true. If no
such expression exists and an @else@ clause is found, it will be
evaluated.
@ifconf file@
If the specified file can be found in the conf file search path,
and if found processes contained part until an appropriate @end@
is found. As with a regular @if expression@, @elsif expression@
and @else@ can be used.
@ifdir dir@
If the specified directory exists, process contained part until
an appropriate @end@ is found. As with a regular @if
expression@, @elsif expression@ and @else@ can be used.
@define NAME@
@enddefine@
Memorizes ""stuff"" between the define and enddefine tags for
later calling as NAME by @calldefine NAME@.
@calldefine NAME@
Executes stuff previously memorized as NAME.
@printf "expression" stuff1, stuff2, ...@
Like all the other printf's you know and love.
@run FILE@
Sources the contents of FILE as a mib2c file, but does not
affect current files opened.
@include FILE@
Sources the contents of FILE as a mib2c file and appends its
output to the current output.
@prompt $var QUESTION@
Presents the user with QUESTION, expects a response and puts it
in $var
@print STUFF@
Prints stuff directly to the users screen (ie, not to where
normal mib2c output goes)
@quit@ Bail out (silently)
@exit@ Bail out!
VARIABLES
Variables in the mib2c language look very similar to perl variables, in
that they start with a "$". They can be used for anything you want,
but most typically they'll hold mib node names being processed by
@foreach ...@ clauses.
They also have a special properties when they are a mib node, such that
adding special suffixes to them will allow them to be interpreted in
some fashion. The easiest way to understand this is through an
example. If the variable 'x' contained the word 'ifType' then some
magical things happen. In mib2c output, anytime $x is seen it is
replaced with "ifType". Additional suffixes can be used to get other
aspects of that mib node though. If $x.objectID is seen, it'll be
replaced by the OID for ifType: ".1.3.6.1.2.1.2.2.1.3". Other suffixes
that can appear after a dot are listed below.
One last thing: you can use things like $vartext immediately ending in
some other text, you can use {}s to get proper expansion of only part
of the mib2c input. IE, $xtext will produce "$xtext", but ${x}text
will produce "ifTypetext" instead.
$var.uc
all upper case version of $var
$var.objectID
dotted, fully-qualified, and numeric OID
$var.commaoid
comma separated numeric OID for array initialization
$var.oidlength
length of the oid
$var.subid
last number component of oid
$var.module
MIB name that the object comes from
$var.parent
contains the label of the parent node of $var.
$var.isscalar
returns 1 if var contains the name of a scalar
$var.iscolumn
returns 1 if var contains the name of a column
$var.children
returns 1 if var has children
$var.perltype
node's perl SYNTAX ($SNMP::MIB{node}{'syntax'})
$var.type
node's ASN_XXX type (Net-SNMP specific #define)
$var.decl
C data type (char, u_long, ...)
$var.readable
1 if an object is readable, 0 if not
$var.settable
1 if an object is writable, 0 if not
$var.creatable
1 if a column object can be created as part of a new row, 0 if
not
$var.noaccess
1 if not-accessible, 0 if not
$var.accessible
1 if accessible, 0 if not
$var.storagetype
1 if an object is a StorageType object, 0 if not
$var.rowstatus
1 if an object is a RowStatus object, 0 if not 'settable',
'creatable', 'lastchange', 'storagetype' and 'rowstatus' can
also be used with table variables to indicate whether it
contains writable, creatable, LastChange, StorageType or
RowStatus column objects
$var.hasdefval
returns 1 if var has a DEFVAL clause
$var.defval
node's DEFVAL
$var.hashint
returns 1 if var has a HINT clause
$var.hint
node's HINT
$var.ranges
returns 1 if var has a value range defined
$var.enums
returns 1 if var has enums defined for it.
$var.access
node's access type
$var.status
node's status
$var.syntax
node's syntax
$var.reference
node's reference
$var.description
node's description
SEE ALSO
mib2c(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
