July 31, 1992 -- readme.txt for SNMP MIB compiler, SMIC


Welcome to the SNMP MIB compiler called SMIC.  This compiler is being made
"freely available", not "public domain", by SynOptics Communications, Inc.

This compiler is a tool to help develop and use SNMP MIBs. It is the
front-end in a system of tools. Other tools, the back-ends, may become
available over time as the documentation for them is completed.

SMIC has been built on MS-DOS with the Microsoft C compiler versions 5.1,
6.0a, and 7.0. It has also been built on several different versions of Unix
including SunOS 4.1.  SMIC is provided in executable form for MS-DOS and
SunOS 4.1.  The source and makefiles are provided so that it can be
compiled on other systems.

Also supplied is a complete collection of MIBs extracted from RFCs. These
have been corrected so that they will compile without errors. The OSPF MIB
does, however, generate warning messages with the default switch settings
for SMIC.

The files that make up this package are the following:

    mibs.tar.Z - compressed and tar'ed directory of MIBs
    bin.tar.Z - compressed and tar'ed directory of executables
    src.tar.Z - compressed and tar'ed directory of sources
    smicug.txt - the user's guide for using SMIC
    readme.txt - this file

    (Note: remember to use binary mode to get the compressed files.)

Also
   bin/ - directory containing MS-DOS and SunOS 4.1 executables
   mibs/ - directory containing MIBs
   src/ - directory containing sources

The mibs, bin, and src directories are available so that the files can be
retrieved directly if the tar and uncompress programs are not available
to unwrap these files.

Note: SMIC uses a parser generated through YACC which is generally available
under Unix. On MS-DOS, YACC is not part of the Microsoft C compiler package.
The PC version of YACC that was used was from MKS. Other PC versions of YACC
should work if the parser needs to be regenerated.

The user's guide should be reviewed to determine how to setup and run SMIC.
It also contains descriptions of some interesting uses of SMIC. The copyright
message and the rights to use message are in the user's guide. These messages
are also in each source file.

I hope that this SNMP MIB compiler will help you. Please send comments and
questions to dperkins@synoptics.com.

Enjoy,
/dave perkins, SynOptics, (408) 764-1516

P.S. We are working on getting out information on the back-ends.  The plans
include common sources and a few complete examples.  Following release of the
back-ends, which should be in the fall, we plan to write a version of SMIC to
compile SMP MIBs.