.\"

.\" $Id: smixlate.1.in 1676 2004-08-10 10:58:12Z strauss $

.\"

.TH smixlate 1  "June 18, 2006" "IUB" "SMI Tools"

.SH NAME

smixlate \- translate SMI/SPPI identifiers

.SH SYNOPSIS

.B smixlate

[

.B "-Vhm"

] [

.BI "-c " file

] [

.BI "-p " module

] [

.BI "-l " level

]

.I "module(s)"

.SH DESCRIPTION

The \fBsmixlate\fP program is used to translate identifiers and

especially OIDs into a more human readable format.

.SH OPTIONS

.TP

\fB-V, --version\fP

Show the smixlate version and exit.

.TP

\fB-h, --help\fP

Show a help text and exit.

.TP

\fB-r, --recursive\fP

Report errors and warnings also for recursively imported modules. 

.TP

\fB-c \fIfile\fB, --config=\fIfile\fP

Read \fIfile\fP instead of any other (global and user)

configuration file.

.TP

\fB-p \fImodule\fB, --preload=\fImodule\fP

Preload the module \fImodule\fP before reading the main

module(s). This may be helpful if an incomplete main module misses to

import some definitions.

.TP

\fB-l \fIlevel\fB, --level=\fIlevel\fP

Report errors and warnings up to the given severity \fIlevel\fP. See

the smilint(1) manual page for a description of the error levels. The

default error level is 3.

.TP

\fB-a, --all\fP

Replace all OIDs including OID prefixes. Without this option, smixlate

will only translate OIDs with a corresponding notification, scalar,

column, row, or table definition.

.TP

\fB-f, --format\fP

Preserve the input format as much as possible by inserting/removing

white space characters.

.TP

.I module(s)

These are the modules to be loaded for the subsequent translation. If

a module argument represents a path name (identified by containing at

least one dot or slash character), this is assumed to be the exact

file to read. Otherwise, if a module is identified by its plain module

name, it is searched according to libsmi internal rules. See

\fBsmi_config(3)\fP for more details.

.SH "EXAMPLE"

This example translates numeric OIDs in the input text into a more

human readable format.

.nf

  $ echo "what is this oid? 1.3.6.1.2.1.2.2.1.3" | \    

    ./smixlate -l 0 /usr/local/share/mibs/ietf/*

  what is this oid? ifType

  $

.fi

.SH "SEE ALSO"

The 

.BR libsmi (3)

project is documented at

.BR "http://www.ibr.cs.tu-bs.de/projects/libsmi/" "."

.SH "AUTHORS"

(C) 2006-2006 J. Schoenwaelder, International University Bremen, Germany

.br

and contributions by many other people.

.br