d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix broken mdoc.

Browse Source 
Found by:	manlint
Approved by:	re (kib)
This commit is contained in:
Ulrich Spörlein 2011-08-01 22:21:18 +00:00
parent 1f85519928
commit f0720ed5f8
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=224584
3 changed files with 41 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
contrib/bsnmp/snmp_usm/snmp_usm.3
View File

@ -115,7 +115,7 @@ allowed.
This column is used to create new USM user entries or delete existing ones from This column is used to create new USM user entries or delete existing ones from
the table. the table.
.El .El
.EL .El
.Sh FILES .Sh FILES
.Bl -tag -width "XXXXXXXXX" .Bl -tag -width "XXXXXXXXX"
.It Pa /usr/share/snmp/defs/usm_tree.def .It Pa /usr/share/snmp/defs/usm_tree.def

2
usr.bin/unzip/unzip.1
View File

@ -112,7 +112,7 @@ and
.Fl u .Fl u
may be specified. may be specified.
If specified filename is If specified filename is
.Va Qq - , .Qq - ,
then data is read from then data is read from
.Va stdin . .Va stdin .
.Sh ENVIRONMENT .Sh ENVIRONMENT

61
usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
View File

@ -126,7 +126,7 @@ The options are as follows (not all apply to all three programs):
.Bl -tag -width ".It Fl D Ar options" .Bl -tag -width ".It Fl D Ar options"
.It Fl A Ar options .It Fl A Ar options
Authentication options to use with SNMPv3 PDUs Authentication options to use with SNMPv3 PDUs
.Bl -tag -width .Bl -tag -width \&
.It Cm proto=[md5|sha] .It Cm proto=[md5|sha]
The protocol to use when calculating the PDU message digest. The protocol to use when calculating the PDU message digest.
.It Cm key=authkey .It Cm key=authkey
@ -147,7 +147,7 @@ The maximum allowed length is 65535 according to the Structure of Management
Information (SMIv2). Information (SMIv2).
.It Fl C Ar options .It Fl C Ar options
The context to query with SNMPv3 PDUs. The context to query with SNMPv3 PDUs.
.Bl -tag -width .Bl -tag -width \&
.It Cm context=name .It Cm context=name
The context name. Default is "" (empty). The context name. Default is "" (empty).
.It Cm context-engine=engine-id .It Cm context-engine=engine-id
@ -172,19 +172,21 @@ Print a short help text with default values for various options.
Load each MIB description file from the given list to translate symbolic Load each MIB description file from the given list to translate symbolic
object names to their numerical representation and vice versa. object names to their numerical representation and vice versa.
Use the other options to obtain a non-default behaviour: Use the other options to obtain a non-default behaviour:
.Bl -tag -width .Bl -tag -width \&
.It Cm cut=OID .It Cm cut=OID
Specifies the initial OID that was cut by Specifies the initial OID that was cut by
.Xr gensnmpdef 1 .Xr gensnmpdef 1
when producing the MIB description file. when producing the MIB description file.
The default value is .iso(1).org(3).dod(6) which is what should have been The default value is .iso(1).org(3).dod(6) which is what should have been
used for all the files installed under /usr/share/snmp/defs/ . used for all the files installed under /usr/share/snmp/defs.
Use this only if you generated your own files, providing a '-c' option to Use this only if you generated your own files, providing a
.Fl c
option to
.Xr gensnmpdef 1 . .Xr gensnmpdef 1 .
.It Cm path=filedir .It Cm path=filedir
The directory where files in the list will be searched. The directory where files in the list will be searched.
The default is The default is
.Pa /usr/share/snmp/defs/ . .Pa /usr/share/snmp/defs Ns .
.It Cm file=filelist .It Cm file=filelist
A comma separated list of files to which the two options above will apply. A comma separated list of files to which the two options above will apply.
.El .El
@ -206,7 +208,7 @@ will search to translate numerical OIDs to their symbolic object names.
Multiple files can be provided either giving this option multiple times Multiple files can be provided either giving this option multiple times
or a comma separated list of file names. or a comma separated list of file names.
If a filename begins with a letter the default directory, If a filename begins with a letter the default directory,
/usr/share/snmp/defs/ , /usr/share/snmp/defs,
will be searched. will be searched.
.It Fl K .It Fl K
Calculate and display the localized authentication and privacy keys Calculate and display the localized authentication and privacy keys
@ -239,7 +241,7 @@ representation and the value.
In addition to the short output verbose prints the type before the value. In addition to the short output verbose prints the type before the value.
.It Fl P Ar options .It Fl P Ar options
Privacy options to use with SNMPv3 PDUs Privacy options to use with SNMPv3 PDUs
.Bl -tag -width .Bl -tag -width \&
.It Cm proto=[aes|des] .It Cm proto=[aes|des]
The protocol to use when encypting/decrypting SNMPv3 PDU data. The protocol to use when encypting/decrypting SNMPv3 PDU data.
.It Cm key=privkey .It Cm key=privkey
@ -257,9 +259,11 @@ not respond after the first try.
Default is 3. Default is 3.
.It Fl s Ar [trans::] Ns Ar [community@] Ns Ar [server] Ns Ar [:port] .It Fl s Ar [trans::] Ns Ar [community@] Ns Ar [server] Ns Ar [:port]
Each of the server specification components is optional but at least one Each of the server specification components is optional but at least one
has to be provided if '-s' option is used. has to be provided if
.Ar s
option is used.
The server specification is constructed in the following manner: The server specification is constructed in the following manner:
.Bl -tag -width .Bl -tag -width \&
.It Cm trans:: .It Cm trans::
Transport type may be one of udp, stream or dgram. Transport type may be one of udp, stream or dgram.
If this option is not provided an udp inet/inet6 socket will be used, which If this option is not provided an udp inet/inet6 socket will be used, which
@ -277,11 +281,16 @@ and the default "private" community string will be used for
.It Cm server .It Cm server
This might be either the IP address or the hostname where the agent is This might be either the IP address or the hostname where the agent is
listening. listening.
The default is 'localhost'. The default is
.Qq localhost .
.It Cm port .It Cm port
The destination port to send the requests to. The destination port to send the requests to.
This is useful if the SNMP agent listens on a non-default port. This is useful if the SNMP agent listens on a non-default port.
Default is given by the 'snmp' entry in /etc/services, port 161. Default is given by the
.Qq snmp
entry in
.Pa /etc/services ,
port 161.
.El .El
.It Fl t Ar timeout .It Fl t Ar timeout
Number of seconds before resending a request packet if the agent does Number of seconds before resending a request packet if the agent does
@ -289,7 +298,7 @@ not respond.
The default value is 3 seconds. The default value is 3 seconds.
.It Fl U Ar options .It Fl U Ar options
User credentials when sending SNMPv3 PDUs. User credentials when sending SNMPv3 PDUs.
.Bl -tag -width .Bl -tag -width \&
.It Cm engine=id .It Cm engine=id
The Engine ID of the SNMP agent represented as a binary octet string. The Engine ID of the SNMP agent represented as a binary octet string.
.It Cm engine-boots=value .It Cm engine-boots=value
@ -331,14 +340,16 @@ at .iso(1).org(3).dod(6).internet(1).mgmt(2).mib2(1) .
.Pp .Pp
Any of the formats used to print a single variable Any of the formats used to print a single variable
is valid as input OID: is valid as input OID:
.Bl -tag -width .Bl -tag -width \&
.It 1.3.6.1.2.1.25.1.1.0 .It 1.3.6.1.2.1.25.1.1.0
.It sysDescr .It sysDescr
.It ifPhysAddress.1 .It ifPhysAddress.1
.It ifRcvAddressStatus.2.6.255.255.255.255.255.255 .It ifRcvAddressStatus.2.6.255.255.255.255.255.255
.It ifRcvAddressType[2,ff:ff:ff:ff:ff:ff] .It ifRcvAddressType[2,ff:ff:ff:ff:ff:ff]
.It ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff] .It ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]
(requires '-o verbose' option) (requires
.Fl o Ar verbose
option)
.El .El
.Pp .Pp
Square brackets are used to denote an entry's indexes. Square brackets are used to denote an entry's indexes.
@ -350,34 +361,39 @@ The object identifier with its syntax type and value that is to be set.
At least one such string OID=[syntax:]value should be provided to At least one such string OID=[syntax:]value should be provided to
.Nm bsnmpset .Nm bsnmpset
to be able to send a request. to be able to send a request.
.Bl -tag -width .Bl -tag -width \&
.It Cm OID .It Cm OID
OID may be input as a string, a string followed by a random number of integers OID may be input as a string, a string followed by a random number of integers
(suboids) separated by dots, a sequence of integers separated by dots - that is (suboids) separated by dots, a sequence of integers separated by dots - that is
if '-n' options is used - and in such case a syntax is required for every value, if
.Ar n
options is used - and in such case a syntax is required for every value,
or a string followed by square brackets (used to denote an entry's indexes) and or a string followed by square brackets (used to denote an entry's indexes) and
corresponding indexes. corresponding indexes.
Any of formats used to print a single variable by Any of formats used to print a single variable by
.Nm bsnmpset is .Nm bsnmpset is
valid for inpit OID as well: valid for inpit OID as well:
.Bl -tag -width .Bl -tag -width \&
.It 1.3.6.1.2.1.25.1.1.0=TimeTicks:537615486 .It 1.3.6.1.2.1.25.1.1.0=TimeTicks:537615486
.It sysLocation=OctetString:"@ Home" (with '-o verbose' option) .It sysLocation=OctetString:"@ Home" (with Fl o Ar verbose No option)
.It sysLocation.0="@ Home" .It sysLocation.0="@ Home"
.It 1.3.6.1.2.1.2.2.1.6.1=OctetString:ffffffffffff .It 1.3.6.1.2.1.2.2.1.6.1=OctetString:ffffffffffff
.It ifPhysAddress.1="00:02:b3:1d:1c:a3" .It ifPhysAddress.1="00:02:b3:1d:1c:a3"
.It ifRcvAddressStatus.1.6.255.255.255.255.255.255=1 .It ifRcvAddressStatus.1.6.255.255.255.255.255.255=1
.It "ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]=Integer:1" .It "ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]=Integer:1"
(with '-o verbose' option) (with
.Fl o Ar verbose
option)
.El .El
.It Cm syntax .It Cm syntax
where syntax string is one of : where syntax string is one of:
Integer, OctetString, OID, IpAddress, Counter32, Gauge, TimeTicks, Counter64. Integer, OctetString, OID, IpAddress, Counter32, Gauge, TimeTicks, Counter64.
.It Cm value .It Cm value
The value to be set - IP address in form of u.u.u.u - for example The value to be set - IP address in form of u.u.u.u - for example
1.3.1.6.1.2.0=IpAddress:192.168.0.1, strings require inverted-commas if they 1.3.1.6.1.2.0=IpAddress:192.168.0.1, strings require inverted-commas if they
contain any special characters or spaces, all other numeric types don't. contain any special characters or spaces, all other numeric types don't.
.El .El
.El
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Nm , .Nm ,
.Nm bsnmpwalk .Nm bsnmpwalk
@ -395,6 +411,7 @@ Specifies a default SNMP USM user name.
Specifies the SNMP USM plain text password to use when calculating localized Specifies the SNMP USM plain text password to use when calculating localized
authentication and privacy keys. If this variable exists in the environment, authentication and privacy keys. If this variable exists in the environment,
SMNPv3 is the default version to use for outgoing requests. SMNPv3 is the default version to use for outgoing requests.
.El
.Sh SEE ALSO .Sh SEE ALSO
.Xr gensnmpdef 1 .Xr gensnmpdef 1
.Sh AUTHORS .Sh AUTHORS