doc/html/ref/net-snmp-mib-compiler.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >MIB Compiler </TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="SNMP for eCos"
  23 HREF="net-snmp-ecos-port.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Unimplemented features"
  26 HREF="net-snmp-unimplemented-features.html"><LINK
  27 REL="NEXT"
  28 TITLE="snmpd.conf"
  29 HREF="net-snmp-agent-manpages-snmpd.conf.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="net-snmp-unimplemented-features.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 47. SNMP for <SPAN
  66 CLASS="emphasis"
  67 ><I
  68 CLASS="EMPHASIS"
  69 >eCos</I
  70 ></SPAN
  71 ></TD
  72 ><TD
  73 WIDTH="10%"
  74 ALIGN="right"
  75 VALIGN="bottom"
  76 ><A
  77 HREF="net-snmp-agent-manpages-snmpd.conf.html"
  78 ACCESSKEY="N"
  79 >Next</A
  80 ></TD
  81 ></TR
  82 ></TABLE
  83 ><HR
  84 ALIGN="LEFT"
  85 WIDTH="100%"></DIV
  86 ><DIV
  87 CLASS="SECT1"
  88 ><H1
  89 CLASS="SECT1"
  90 ><A
  91 NAME="NET-SNMP-MIB-COMPILER">MIB Compiler</H1
  92 ><P
  93 >In the directory
  94           <TT
  95 CLASS="FILENAME"
  96 >/snmp/agent/VERSION/utils/mib2c</TT
  97 >,
  98 there are the following files:</P
  99 ><TABLE
 100 BORDER="5"
 101 BGCOLOR="#E0E0F0"
 102 WIDTH="70%"
 103 ><TR
 104 ><TD
 105 ><PRE
 106 CLASS="PROGRAMLISTING"
 107 >README-eCos             notes about running with a nonstandard
 108                         perl path.
 109 README.mib2c            the README from UCD; full instructions on
 110                         using mib2c
 111 mib2c                   the perl program
 112 mib2c.conf              a configuration file altered to include the
 113                         eCos/UCD
 114 mib2c.conf-ORIG         copyright and better #include paths; and
 115                         the ORIGinal.
 116 mib2c.storage.conf      other config files, not modified.
 117 mib2c.vartypes.conf</PRE
 118 ></TD
 119 ></TR
 120 ></TABLE
 121 ><P
 122 >mib2c is provided BUT it requires the SNMP perl package SNMP-3.1.0,
 123 and that in turn requires perl nsPerl5.005_03 (part of
 124 Red Hat Linux from 6.0, April 1999).</P
 125 ><P
 126 >These are available from the CPAN (&#8220;the Comprehensive
 127 Perl Archive Network&#8221;) as usual;
 128 <A
 129 HREF="http://www.cpan.org/"
 130 TARGET="_top"
 131 >http://www.cpan.org/</A
 132 >
 133 and links from there. Specifically:</P
 134 ><P
 135 ></P
 136 ><UL
 137 ><LI
 138 ><P
 139 >PERL itself:
 140 <A
 141 HREF="http://people.netscape.com/kristian/nsPerl/"
 142 TARGET="_top"
 143 >http://people.netscape.com/kristian/nsPerl/</A
 144 ></P
 145 ></LI
 146 ><LI
 147 ><P
 148 ><A
 149 HREF="http://people.netscape.com/richm/nsPerl/nsPerl5.005_03-11-i686-linux.tar.gz"
 150 TARGET="_top"
 151 >http://people.netscape.com/richm/nsPerl/nsPerl5.005_03-11-i686-linux.tar.gz</A
 152 ></P
 153 ></LI
 154 ><LI
 155 ><P
 156 >SNMP.pl
 157 <A
 158 HREF="http://www.cpan.org/modules/01modules.index.html"
 159 TARGET="_top"
 160 >http://www.cpan.org/modules/01modules.index.html</A
 161 ></P
 162 ></LI
 163 ><LI
 164 ><P
 165 ><A
 166 HREF="http://cpan.valueclick.com/modules/by-category/05_Networking_Devices_IPC/SNMP/"
 167 TARGET="_top"
 168 >http://cpan.valueclick.com/modules/by-category/05_Networking_Devices_IPC/SNMP/</A
 169 ></P
 170 ></LI
 171 ><LI
 172 ><P
 173 ><A
 174 HREF="http://www.cpan.org/authors/id/G/GS/GSM/SNMP.tar.gz"
 175 TARGET="_top"
 176 >http://www.cpan.org/authors/id/G/GS/GSM/SNMP.tar.gz</A
 177 ></P
 178 ></LI
 179 ></UL
 180 ><P
 181 >(note that the .tar.gz files are not browsable)</P
 182 ><P
 183 >For documentation on the files produced, see the documentation
 184 available at
 185 <A
 186 HREF="http://ucd-snmp.ucdavis.edu/"
 187 TARGET="_top"
 188 >http://ucd-snmp.ucdavis.edu/</A
 189 >
 190 in general, and file <TT
 191 CLASS="FILENAME"
 192 >AGENT.txt</TT
 193 > in particular.</P
 194 ><P
 195 >It is likely that the output of mib2c will be further customized
 196 depending on eCos customer needs; it&#8217;s easy to do this
 197 by editing the mib2c.conf file to add or remove whatever you need
 198 with the resulting C sources.</P
 199 ><P
 200 >The UCD autoconf-style configuration does not apply to eCos.
 201  So if you add a completely new MIB to the agent, and support it
 202 using mib2c so that the my_new_mib.c file contains
 203 a init_my_new_mib() routine to register
 204 the MIB handler, you will also need to edit a couple of control
 205 files; these claim to be auto-generated, but in the eCos release,
 206 they&#8217;re not, don&#8217;t worry.</P
 207 ><TABLE
 208 BORDER="5"
 209 BGCOLOR="#E0E0F0"
 210 WIDTH="70%"
 211 ><TR
 212 ><TD
 213 ><PRE
 214 CLASS="PROGRAMLISTING"
 215 >PACKAGES/net/snmp/agent/VERSION/include/mib_module_includes.h</PRE
 216 ></TD
 217 ></TR
 218 ></TABLE
 219 ><P
 220 >contains a number of lines like</P
 221 ><TABLE
 222 BORDER="5"
 223 BGCOLOR="#E0E0F0"
 224 WIDTH="70%"
 225 ><TR
 226 ><TD
 227 ><PRE
 228 CLASS="PROGRAMLISTING"
 229 >#include &#8220;mibgroup/mibII/interfaces.h&#8221;</PRE
 230 ></TD
 231 ></TR
 232 ></TABLE
 233 ><P
 234 >so add your new MIB thus:</P
 235 ><TABLE
 236 BORDER="5"
 237 BGCOLOR="#E0E0F0"
 238 WIDTH="70%"
 239 ><TR
 240 ><TD
 241 ><PRE
 242 CLASS="PROGRAMLISTING"
 243 >#include &#8220;mibgroup/mibII/my_new_mib.h&#8221;</PRE
 244 ></TD
 245 ></TR
 246 ></TABLE
 247 ><TABLE
 248 BORDER="5"
 249 BGCOLOR="#E0E0F0"
 250 WIDTH="70%"
 251 ><TR
 252 ><TD
 253 ><PRE
 254 CLASS="PROGRAMLISTING"
 255 >PACKAGES/net/snmp/agent/VERSION/include/mib_module_inits.h </PRE
 256 ></TD
 257 ></TR
 258 ></TABLE
 259 ><P
 260 >contains a number of lines like</P
 261 ><TABLE
 262 BORDER="5"
 263 BGCOLOR="#E0E0F0"
 264 WIDTH="70%"
 265 ><TR
 266 ><TD
 267 ><PRE
 268 CLASS="PROGRAMLISTING"
 269 >init_interfaces();
 270 init_dot3(); </PRE
 271 ></TD
 272 ></TR
 273 ></TABLE
 274 ><P
 275 >and so on; add your new MIB as follows:</P
 276 ><TABLE
 277 BORDER="5"
 278 BGCOLOR="#E0E0F0"
 279 WIDTH="70%"
 280 ><TR
 281 ><TD
 282 ><PRE
 283 CLASS="PROGRAMLISTING"
 284 >init_my_new_mib(); </PRE
 285 ></TD
 286 ></TR
 287 ></TABLE
 288 ><P
 289 >and this should work correctly.</P
 290 ></DIV
 291 ><DIV
 292 CLASS="NAVFOOTER"
 293 ><HR
 294 ALIGN="LEFT"
 295 WIDTH="100%"><TABLE
 296 SUMMARY="Footer navigation table"
 297 WIDTH="100%"
 298 BORDER="0"
 299 CELLPADDING="0"
 300 CELLSPACING="0"
 301 ><TR
 302 ><TD
 303 WIDTH="33%"
 304 ALIGN="left"
 305 VALIGN="top"
 306 ><A
 307 HREF="net-snmp-unimplemented-features.html"
 308 ACCESSKEY="P"
 309 >Prev</A
 310 ></TD
 311 ><TD
 312 WIDTH="34%"
 313 ALIGN="center"
 314 VALIGN="top"
 315 ><A
 316 HREF="ecos-ref.html"
 317 ACCESSKEY="H"
 318 >Home</A
 319 ></TD
 320 ><TD
 321 WIDTH="33%"
 322 ALIGN="right"
 323 VALIGN="top"
 324 ><A
 325 HREF="net-snmp-agent-manpages-snmpd.conf.html"
 326 ACCESSKEY="N"
 327 >Next</A
 328 ></TD
 329 ></TR
 330 ><TR
 331 ><TD
 332 WIDTH="33%"
 333 ALIGN="left"
 334 VALIGN="top"
 335 >Unimplemented features</TD
 336 ><TD
 337 WIDTH="34%"
 338 ALIGN="center"
 339 VALIGN="top"
 340 ><A
 341 HREF="net-snmp-ecos-port.html"
 342 ACCESSKEY="U"
 343 >Up</A
 344 ></TD
 345 ><TD
 346 WIDTH="33%"
 347 ALIGN="right"
 348 VALIGN="top"
 349 >snmpd.conf</TD
 350 ></TR
 351 ></TABLE
 352 ></DIV
 353 ></BODY
 354 ></HTML
 355 >