1 files changed, 73 insertions, 0 deletions
diff --git a/contrib/bsnmp/gensnmpdef/gensnmpdef.1 b/contrib/bsnmp/gensnmpdef/gensnmpdef.1
new file mode 100644
index 0000000..2bcb440
--- /dev/null
+++ b/contrib/bsnmp/gensnmpdef/gensnmpdef.1
@@ -0,0 +1,73 @@
+.\"
+.\" Copyright (c) 2004
+.\"	Hartmut Brandt
+.\"	All rights reserved.
+.\"
+.\" Redistribution of this software and documentation and use in source and
+.\" binary forms, with or without modification, are permitted provided that
+.\" the following conditions are met:
+.\"
+.\" 1. Redistributions of source code or documentation must retain the above
+.\"    copyright notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. Neither the name of the author nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE AND DOCUMENTATION IS PROVIDED BY THE AUTHOR
+.\" AND ITS CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+.\" FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
+.\" THE AUTHOR OR ITS CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+.\" OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" $Begemot: bsnmp/gensnmpdef/gensnmpdef.1,v 1.1 2004/04/14 09:54:51 novo Exp $
+.\"
+.\" Author: Harti Brandt <harti@freebsd.org>
+.\"
+.Dd April 14, 2004
+.Dt gensnmpdef 1
+.Os
+.Sh NAME
+.Nm gensnmpdef
+.Nd "generate a MIB description file from MIBs"
+.Sh SYNOPSIS
+.Nm
+.Op Fl h
+.Op Fl c Ar cut
+.Ar name Op Ar ...
+.Sh DESCRIPTION
+The
+.Nm
+utility is used to create an initial MIB description file from
+one or more MIBs. The description file must be edited to be actually useful
+for feeding it into
+.Xr gensnmptree 1 .
+.Pp
+The
+.Fl c
+option specifies the number of initial sub-oids that should be omitted
+from the tree.
+.Xr gensnmptree 1
+automatically adds 1.3.6 in front of all OIDs so the default value
+of 3 is just correct in most cases.
+.Pp
+.Nm
+does no attempt on sorting the OID tree so in case of complex and
+non-standard MIBs it is necessay to sort the tree in the resulting definition
+file by hand.
+.Sh SEE ALSO
+.Xr snmpd 1
+.Sh BUGS
+The utility is by no means bullet-proof and may fail for complex
+or non-standard MIBs.
+Its output is expected to be edited by hand.
+.Sh AUTHORS
+.An Hartmut Brandt Aq harti@freebsd.org