NAME

build_oid - build Object Identifier Database

SYNOPSIS

build_oid [ dir1 dir2 ... dirN ]

DESCRIPTION

build_oid builds the Object Identifier Database. The console uses the database to interpret object identifiers.

One of the data types supported by SunNet Manager is an object identifier. Since object identifiers are numeric (i.e., 1.2.3.4.5), a database is provided so the console can display the object identifier using a more meaningful string. The Object Identifier Database provides the information required for this mapping.

OPTIONS

build_oid has no options but may take directory names as arguments. Instead, it uses the environment variable SNMHOME to locate the SunNet Manager supplied schema files. If SNMHOME is undefined, /opt/SUNWconn/snm for Solaris 2.x or /usr/snm for Solaris 1.x will be used as the default product directory.

The output file oid.dbase is written to the directory specified by the SNMDBDIR environment variable. If SNMDBDIR is undefined, /var/opt/snm for Solaris 2.x or /var/adm/snm for Solaris 1.x is used as the default database directory

USAGE

build_oid should be run any time the object indentifier database needs to be built. Examples include at installation of the SUNWsnmct package (when the installation script automatically runs build_oid) and whenever new object identifiers need to be added to the database.

Input to the database

Input to the database consists of multiple ASCII files. The files consist of lines containing a descriptive name, followed by its object identifier. If the descriptive name contains special characters, it must be enclosed in double quotes. Comment lines may be included by beginning them with a pound sign (#).

FILES

oid.dbase

This file contains the object identifier database. It is written into the directory specified by the SNMDBDIR environment variable. This file is written to /var/opt/snm for Solaris 2.x and /var/adm/snm for Solaris 1.x if SNMDBDIR is not defined.

enterprises.oid

One of the input files supplied with the SunNet Manager product, it contains the mappings for enterprise identifiers. It is normally found in the directory SNMHOME, or in /opt/SUNWconn/snm for Solaris 2.x and /usr/snm for Solaris 1.x if SNMHOME is undefined.

snmp.oid

One of the input files supplied with the SunNet Manager product, it contains the mappings for object identifiers for MIB-I of the SNMP protocol. It is normally found in the directory SNMHOME/agents, or /opt/SUNWconn/snm/agents for Solaris 2.x and SNMHOME/agents, or /usr/snm/agents for Solaris 1.x if

SNMHOME is undefined.