From nobody@FreeBSD.org  Tue Feb 25 15:05:13 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id 6C38BA3C
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 25 Feb 2014 15:05:13 +0000 (UTC)
Received: from newred.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 3199D1326
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 25 Feb 2014 15:05:13 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by newred.freebsd.org (8.14.7/8.14.7) with ESMTP id s1PF5C3V031749
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 25 Feb 2014 15:05:12 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.7/8.14.7/Submit) id s1PF5C5u031733;
	Tue, 25 Feb 2014 15:05:12 GMT
	(envelope-from nobody)
Message-Id: <201402251505.s1PF5C5u031733@cgiserv.freebsd.org>
Date: Tue, 25 Feb 2014 15:05:12 GMT
From: Bjrn Heidotting <b.heidotting@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Minor fixes for bsnmpget(1) manpage
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         187035
>Category:       docs
>Synopsis:       [patch] Minor fixes for bsnmpget(1) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 25 15:10:00 UTC 2014
>Closed-Date:    Wed Mar 05 14:30:32 CET 2014
>Last-Modified:  Wed Mar 05 14:30:32 CET 2014
>Originator:     Bjrn Heidotting
>Release:        10.0-RELEASE
>Organization:
>Environment:
>Description:
Minor fixes for bsnmpget(1):
- New sentence should start on a new line
- Grammar fix
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- bsnmpget.1	2013-04-11 21:05:24.000000000 +0200
+++ bsnmpget.1.work	2014-02-25 15:31:18.000000000 +0100
@@ -151,7 +151,8 @@
 The context name. Default is "" (empty).
 .It Cm context-engine=engine-id
 The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as
-binary octet string. By default, this is set to the Engine ID of the SNMP agent.
+binary octet string.
+By default, this is set to the Engine ID of the SNMP agent.
 .El
 .It Fl D
 Perform SNMP USM Engine Discovery, rather than sending a request for the value
@@ -211,8 +212,9 @@
 will be searched.
 .It Fl K
 Calculate and display the localized authentication and privacy keys
-corresponding to a plain text password. The password is obtain via the
-environment. Additionally, if one or more OIDs are specified, the calculated
+corresponding to a plain text password.
+The password is obtained via the environment.
+Additionally, if one or more OIDs are specified, the calculated
 keys are used when processing the SNMPv3 requests.
 .It Fl l Ar filename
 The path of the posix local (unix domain) socket if local
@@ -317,12 +319,12 @@
 If any of the above is not specified, SNMP USM Engine Discovery is attempted.
 This is also the default behavior.
 .It Cm name=username
-The USM user name to include in the SNMPv3 PDUs. By default, the user name is
-obtain via the environment
+The USM user name to include in the SNMPv3 PDUs.
+By default, the user name is obtained via the environment.
 .El
 .It Fl v Ar version
-The SNMP protocol version to use when sending requests. SNMP versions 1, 2 and
-3 are supported.
+The SNMP protocol version to use when sending requests.
+SNMP versions 1, 2 and 3 are supported.
 If no version option is provided
 .Nm bsnmpget ,
 .Nm bsnmpwalk
@@ -417,8 +419,9 @@
 Specifies a default SNMP USM user name.
 .It Ev SNMPPASSWD
 Specifies the SNMP USM plain text password to use when calculating localized
-authentication and privacy keys. If this variable exists in the environment,
-SMNPv3 is the default version to use for outgoing requests.
+authentication and privacy keys.
+If this variable exists in the environment, SMNPv3 is the
+default version to use for outgoing requests.
 .El
 .Sh SEE ALSO
 .Xr gensnmpdef 1


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: brueffer 
State-Changed-When: Tue Feb 25 22:02:15 CET 2014 
State-Changed-Why:  
I took the opportunity to expand your patch into a bigger cleanup run, 
thanks for the submission! 


Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Tue Feb 25 22:02:15 CET 2014 
Responsible-Changed-Why:  
MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=187035 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/187035: commit references a PR
Date: Tue, 25 Feb 2014 21:02:03 +0000 (UTC)

 Author: brueffer
 Date: Tue Feb 25 21:01:55 2014
 New Revision: 262494
 URL: http://svnweb.freebsd.org/changeset/base/262494
 
 Log:
   Rough cleanup (new sentence -> new line, grammar, spelling, mdoc).
   This could use more work.
   
   PR:		187035 (in part)
   Submitted by:	Bjorn Heidotting
   MFC after:	1 week
 
 Modified:
   head/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 
 Modified: head/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 ==============================================================================
 --- head/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Tue Feb 25 20:27:51 2014	(r262493)
 +++ head/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Tue Feb 25 21:01:55 2014	(r262494)
 @@ -106,18 +106,18 @@ management information to a Simple Netwo
  .Pp
  Depending on the options
  .Nm bsnmpget
 -constructs either a SMNP GetRequest, GetNextRequest
 +constructs either a SNMP GetRequest, GetNextRequest
  or a GetBulkRequest packet, fills in the object identifiers (OIDs) of the
  objects whose values will be retrieved, waits for a response and prints it if
  received successfully.
  .Pp
  .Nm Bsnmpwalk
 -queries an agent with ether SMNP GetNextRequest or GetBulkRequest packets,
 +queries an agent with ether SNMP GetNextRequest or GetBulkRequest packets,
  asking for values of OID instances that are a part of the object subtree
  rooted at the provided OIDs.
  .Pp
  .Nm Bsnmpset
 -constructs a SMNP SetRequest packet, fills in the OIDs (object identifiers),
 +constructs a SNMP SetRequest packet, fills in the OIDs (object identifiers),
  syntaxes and values of the objects whose values are to be set and waits for a
  response from server.
  .Sh OPTIONS
 @@ -151,7 +151,8 @@ The context to query with SNMPv3 PDUs.
  The context name. Default is "" (empty).
  .It Cm context-engine=engine-id
  The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as
 -binary octet string. By default, this is set to the Engine ID of the SNMP agent.
 +binary octet string.
 +By default, this is set to the Engine ID of the SNMP agent.
  .El
  .It Fl D
  Perform SNMP USM Engine Discovery, rather than sending a request for the value
 @@ -177,7 +178,8 @@ Specifies the initial OID that was cut b
  .Xr gensnmpdef 1
  when producing the MIB description file.
  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
 +.Pa /usr/share/snmp/defs .
  Use this only if you generated your own files, providing a
  .Fl c
  option to
 @@ -198,7 +200,8 @@ If using spaces make sure the entire opt
  example using quotes.
  .It Fl i Ar filelist
  List of MIB description files produced by
 -.Xr gensnmpdef 1 which
 +.Xr gensnmpdef 1
 +which
  .Nm bsnmpget ,
  .Nm bsnmpwalk
  or
 @@ -207,12 +210,13 @@ will search to translate numerical OIDs 
  Multiple files can be provided either giving this option multiple times
  or a comma separated list of file names.
  If a filename begins with a letter the default directory,
 -/usr/share/snmp/defs,
 +.Pa /usr/share/snmp/defs ,
  will be searched.
  .It Fl K
  Calculate and display the localized authentication and privacy keys
 -corresponding to a plain text password. The password is obtain via the
 -environment. Additionally, if one or more OIDs are specified, the calculated
 +corresponding to a plain text password.
 +The password is obtained via the environment.
 +Additionally, if one or more OIDs are specified, the calculated
  keys are used when processing the SNMPv3 requests.
  .It Fl l Ar filename
  The path of the posix local (unix domain) socket if local
 @@ -242,9 +246,9 @@ In addition to the short output verbose 
  Privacy options to use with SNMPv3 PDUs
  .Bl -tag -width \&
  .It Cm proto=[aes|des]
 -The protocol to use when encypting/decrypting SNMPv3 PDU data.
 +The protocol to use when encrypting/decrypting SNMPv3 PDU data.
  .It Cm key=privkey
 -A binary localized privacy key to use when encypting/decrypting SNMPv3 PDU data.
 +A binary localized privacy key to use when encrypting/decrypting SNMPv3 PDU data.
  .El
  .Pp
  By default plain text SNMPv3 PDUs are sent.
 @@ -267,14 +271,14 @@ not respond after the first try.
  Default is 3.
  .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
 -has to be provided if
 +has to be provided if the
  .Ar s
  option is used.
  The server specification is constructed in the following manner:
  .Bl -tag -width \&
  .It Cm trans::
  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
  is the most common.
  Stream stands for a posix local stream socket and a posix local datagram
  socket will be used if dgram is specified.
 @@ -317,11 +321,13 @@ The value of the snmpEngineTime of the S
  If any of the above is not specified, SNMP USM Engine Discovery is attempted.
  This is also the default behavior.
  .It Cm name=username
 -The USM user name to include in the SNMPv3 PDUs. By default, the user name is
 -obtain via the environment
 +The USM user name to include in the SNMPv3 PDUs.
 +By default, the user name is
 +obtained via the environment.
  .El
  .It Fl v Ar version
 -The SNMP protocol version to use when sending requests. SNMP versions 1, 2 and
 +The SNMP protocol version to use when sending requests.
 +SNMP versions 1, 2 and
  3 are supported.
  If no version option is provided
  .Nm bsnmpget ,
 @@ -330,7 +336,7 @@ and
  .Nm bsnmpset
  will use version 2.
  Note that GetBulkRequest-PDUs were introduced in SNMPv2 thus setting the
 -version to 1 is incompatiable with sending a GetBulk PDU.
 +version to 1 is incompatible with sending a GetBulk PDU.
  .It OID
  The object identifier whose value to retrieve.
  At least one OID should be provided for
 @@ -355,7 +361,7 @@ is valid as input OID:
  .It ifRcvAddressStatus.2.6.255.255.255.255.255.255
  .It ifRcvAddressType[2,ff:ff:ff:ff:ff:ff]
  .It ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]
 -(requires
 +(requires the
  .Fl o Ar verbose
  option)
  .El
 @@ -373,14 +379,14 @@ to be able to send a request.
  .It Cm OID
  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
 -if
 +if the
  .Ar n
 -options is used - and in such case a syntax is required for every value,
 +option 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
  corresponding indexes.
 -Any of formats used to print a single variable by
 -.Nm bsnmpset is
 -valid for inpit OID as well:
 +Any of the formats used to print a single variable by
 +.Nm bsnmpset
 +is valid as input OID as well:
  .Bl -tag -width \&
  .It 1.3.6.1.2.1.25.1.1.0=TimeTicks:537615486
  .It sysLocation=OctetString:"@ Home" (with Fl o Ar verbose No option)
 @@ -389,17 +395,17 @@ valid for inpit OID as well:
  .It ifPhysAddress.1="00:02:b3:1d:1c:a3"
  .It ifRcvAddressStatus.1.6.255.255.255.255.255.255=1
  .It "ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]=Integer:1"
 -(with
 +(with the
  .Fl o Ar verbose
  option)
  .El
  .It Cm syntax
 -where syntax string is one of:
 +where the syntax string is one of:
  Integer, OctetString, OID, IpAddress, Counter32, Gauge, TimeTicks, Counter64.
  .It Cm value
  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
 -contain any special characters or spaces, all other numeric types don't.
 +contain any special characters or spaces, all other numeric types do not.
  .El
  .El
  .Sh ENVIRONMENT
 @@ -417,8 +423,9 @@ Specifies a default SNMP USM privacy pro
  Specifies a default SNMP USM user name.
  .It Ev SNMPPASSWD
  Specifies the SNMP USM plain text password to use when calculating localized
 -authentication and privacy keys. If this variable exists in the environment,
 -SMNPv3 is the default version to use for outgoing requests.
 +authentication and privacy keys.
 +If this variable exists in the environment,
 +SNMPv3 is the default version to use for outgoing requests.
  .El
  .Sh SEE ALSO
  .Xr gensnmpdef 1
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/187035: commit references a PR
Date: Wed,  5 Mar 2014 13:25:09 +0000 (UTC)

 Author: brueffer
 Date: Wed Mar  5 13:25:01 2014
 New Revision: 262783
 URL: http://svnweb.freebsd.org/changeset/base/262783
 
 Log:
   MFC: r262494
   
   Rough cleanup (new sentence -> new line, grammar, spelling, mdoc).
   This could use more work.
   
   PR:		187035 (in part)
   Submitted by:	Bjorn Heidotting
 
 Modified:
   stable/10/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 Directory Properties:
   stable/10/   (props changed)
 
 Modified: stable/10/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 ==============================================================================
 --- stable/10/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Wed Mar  5 12:02:29 2014	(r262782)
 +++ stable/10/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Wed Mar  5 13:25:01 2014	(r262783)
 @@ -106,18 +106,18 @@ management information to a Simple Netwo
  .Pp
  Depending on the options
  .Nm bsnmpget
 -constructs either a SMNP GetRequest, GetNextRequest
 +constructs either a SNMP GetRequest, GetNextRequest
  or a GetBulkRequest packet, fills in the object identifiers (OIDs) of the
  objects whose values will be retrieved, waits for a response and prints it if
  received successfully.
  .Pp
  .Nm Bsnmpwalk
 -queries an agent with ether SMNP GetNextRequest or GetBulkRequest packets,
 +queries an agent with ether SNMP GetNextRequest or GetBulkRequest packets,
  asking for values of OID instances that are a part of the object subtree
  rooted at the provided OIDs.
  .Pp
  .Nm Bsnmpset
 -constructs a SMNP SetRequest packet, fills in the OIDs (object identifiers),
 +constructs a SNMP SetRequest packet, fills in the OIDs (object identifiers),
  syntaxes and values of the objects whose values are to be set and waits for a
  response from server.
  .Sh OPTIONS
 @@ -151,7 +151,8 @@ The context to query with SNMPv3 PDUs.
  The context name. Default is "" (empty).
  .It Cm context-engine=engine-id
  The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as
 -binary octet string. By default, this is set to the Engine ID of the SNMP agent.
 +binary octet string.
 +By default, this is set to the Engine ID of the SNMP agent.
  .El
  .It Fl D
  Perform SNMP USM Engine Discovery, rather than sending a request for the value
 @@ -177,7 +178,8 @@ Specifies the initial OID that was cut b
  .Xr gensnmpdef 1
  when producing the MIB description file.
  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
 +.Pa /usr/share/snmp/defs .
  Use this only if you generated your own files, providing a
  .Fl c
  option to
 @@ -198,7 +200,8 @@ If using spaces make sure the entire opt
  example using quotes.
  .It Fl i Ar filelist
  List of MIB description files produced by
 -.Xr gensnmpdef 1 which
 +.Xr gensnmpdef 1
 +which
  .Nm bsnmpget ,
  .Nm bsnmpwalk
  or
 @@ -207,12 +210,13 @@ will search to translate numerical OIDs 
  Multiple files can be provided either giving this option multiple times
  or a comma separated list of file names.
  If a filename begins with a letter the default directory,
 -/usr/share/snmp/defs,
 +.Pa /usr/share/snmp/defs ,
  will be searched.
  .It Fl K
  Calculate and display the localized authentication and privacy keys
 -corresponding to a plain text password. The password is obtain via the
 -environment. Additionally, if one or more OIDs are specified, the calculated
 +corresponding to a plain text password.
 +The password is obtained via the environment.
 +Additionally, if one or more OIDs are specified, the calculated
  keys are used when processing the SNMPv3 requests.
  .It Fl l Ar filename
  The path of the posix local (unix domain) socket if local
 @@ -242,9 +246,9 @@ In addition to the short output verbose 
  Privacy options to use with SNMPv3 PDUs
  .Bl -tag -width \&
  .It Cm proto=[aes|des]
 -The protocol to use when encypting/decrypting SNMPv3 PDU data.
 +The protocol to use when encrypting/decrypting SNMPv3 PDU data.
  .It Cm key=privkey
 -A binary localized privacy key to use when encypting/decrypting SNMPv3 PDU data.
 +A binary localized privacy key to use when encrypting/decrypting SNMPv3 PDU data.
  .El
  .Pp
  By default plain text SNMPv3 PDUs are sent.
 @@ -267,14 +271,14 @@ not respond after the first try.
  Default is 3.
  .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
 -has to be provided if
 +has to be provided if the
  .Ar s
  option is used.
  The server specification is constructed in the following manner:
  .Bl -tag -width \&
  .It Cm trans::
  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
  is the most common.
  Stream stands for a posix local stream socket and a posix local datagram
  socket will be used if dgram is specified.
 @@ -317,11 +321,13 @@ The value of the snmpEngineTime of the S
  If any of the above is not specified, SNMP USM Engine Discovery is attempted.
  This is also the default behavior.
  .It Cm name=username
 -The USM user name to include in the SNMPv3 PDUs. By default, the user name is
 -obtain via the environment
 +The USM user name to include in the SNMPv3 PDUs.
 +By default, the user name is
 +obtained via the environment.
  .El
  .It Fl v Ar version
 -The SNMP protocol version to use when sending requests. SNMP versions 1, 2 and
 +The SNMP protocol version to use when sending requests.
 +SNMP versions 1, 2 and
  3 are supported.
  If no version option is provided
  .Nm bsnmpget ,
 @@ -330,7 +336,7 @@ and
  .Nm bsnmpset
  will use version 2.
  Note that GetBulkRequest-PDUs were introduced in SNMPv2 thus setting the
 -version to 1 is incompatiable with sending a GetBulk PDU.
 +version to 1 is incompatible with sending a GetBulk PDU.
  .It OID
  The object identifier whose value to retrieve.
  At least one OID should be provided for
 @@ -355,7 +361,7 @@ is valid as input OID:
  .It ifRcvAddressStatus.2.6.255.255.255.255.255.255
  .It ifRcvAddressType[2,ff:ff:ff:ff:ff:ff]
  .It ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]
 -(requires
 +(requires the
  .Fl o Ar verbose
  option)
  .El
 @@ -373,14 +379,14 @@ to be able to send a request.
  .It Cm OID
  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
 -if
 +if the
  .Ar n
 -options is used - and in such case a syntax is required for every value,
 +option 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
  corresponding indexes.
 -Any of formats used to print a single variable by
 -.Nm bsnmpset is
 -valid for inpit OID as well:
 +Any of the formats used to print a single variable by
 +.Nm bsnmpset
 +is valid as input OID as well:
  .Bl -tag -width \&
  .It 1.3.6.1.2.1.25.1.1.0=TimeTicks:537615486
  .It sysLocation=OctetString:"@ Home" (with Fl o Ar verbose No option)
 @@ -389,17 +395,17 @@ valid for inpit OID as well:
  .It ifPhysAddress.1="00:02:b3:1d:1c:a3"
  .It ifRcvAddressStatus.1.6.255.255.255.255.255.255=1
  .It "ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]=Integer:1"
 -(with
 +(with the
  .Fl o Ar verbose
  option)
  .El
  .It Cm syntax
 -where syntax string is one of:
 +where the syntax string is one of:
  Integer, OctetString, OID, IpAddress, Counter32, Gauge, TimeTicks, Counter64.
  .It Cm value
  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
 -contain any special characters or spaces, all other numeric types don't.
 +contain any special characters or spaces, all other numeric types do not.
  .El
  .El
  .Sh ENVIRONMENT
 @@ -417,8 +423,9 @@ Specifies a default SNMP USM privacy pro
  Specifies a default SNMP USM user name.
  .It Ev SNMPPASSWD
  Specifies the SNMP USM plain text password to use when calculating localized
 -authentication and privacy keys. If this variable exists in the environment,
 -SMNPv3 is the default version to use for outgoing requests.
 +authentication and privacy keys.
 +If this variable exists in the environment,
 +SNMPv3 is the default version to use for outgoing requests.
  .El
  .Sh SEE ALSO
  .Xr gensnmpdef 1
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/187035: commit references a PR
Date: Wed,  5 Mar 2014 13:28:10 +0000 (UTC)

 Author: brueffer
 Date: Wed Mar  5 13:28:02 2014
 New Revision: 262784
 URL: http://svnweb.freebsd.org/changeset/base/262784
 
 Log:
   MFC: r262494
   
   Rough cleanup (new sentence -> new line, grammar, spelling, mdoc).
   This could use more work.
   
   PR:             187035 (in part)
   Submitted by:   Bjorn Heidotting
 
 Modified:
   stable/9/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 Directory Properties:
   stable/9/usr.sbin/bsnmpd/tools/bsnmptools/   (props changed)
 
 Modified: stable/9/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1
 ==============================================================================
 --- stable/9/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Wed Mar  5 13:25:01 2014	(r262783)
 +++ stable/9/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1	Wed Mar  5 13:28:02 2014	(r262784)
 @@ -106,18 +106,18 @@ management information to a Simple Netwo
  .Pp
  Depending on the options
  .Nm bsnmpget
 -constructs either a SMNP GetRequest, GetNextRequest
 +constructs either a SNMP GetRequest, GetNextRequest
  or a GetBulkRequest packet, fills in the object identifiers (OIDs) of the
  objects whose values will be retrived, waits for a response and prints it if
  received successfully.
  .Pp
  .Nm Bsnmpwalk
 -queries an agent with ether SMNP GetNextRequest or GetBulkRequest packets,
 +queries an agent with ether SNMP GetNextRequest or GetBulkRequest packets,
  asking for values of OID instances that are a part of the object subtree
  rooted at the provided OIDs.
  .Pp
  .Nm Bsnmpset
 -constructs a SMNP SetRequest packet, fills in the OIDs (object identifiers),
 +constructs a SNMP SetRequest packet, fills in the OIDs (object identifiers),
  syntaxes and values of the objects whose values are to be set and waits for a
  response from server.
  .Sh OPTIONS
 @@ -151,7 +151,8 @@ The context to query with SNMPv3 PDUs.
  The context name. Default is "" (empty).
  .It Cm context-engine=engine-id
  The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as
 -binary octet string. By default, this is set to the Engine ID of the SNMP agent.
 +binary octet string.
 +By default, this is set to the Engine ID of the SNMP agent.
  .El
  .It Fl D
  Perform SNMP USM Engine Discovery, rather than sending a request for the value
 @@ -177,7 +178,8 @@ Specifies the initial OID that was cut b
  .Xr gensnmpdef 1
  when producing the MIB description file.
  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
 +.Pa /usr/share/snmp/defs .
  Use this only if you generated your own files, providing a
  .Fl c
  option to
 @@ -198,7 +200,8 @@ If using spaces make sure the entire opt
  example using quotes.
  .It Fl i Ar filelist
  List of MIB description files produced by
 -.Xr gensnmpdef 1 which
 +.Xr gensnmpdef 1
 +which
  .Nm bsnmpget ,
  .Nm bsnmpwalk
  or
 @@ -207,12 +210,13 @@ will search to translate numerical OIDs 
  Multiple files can be provided either giving this option multiple times
  or a comma separated list of file names.
  If a filename begins with a letter the default directory,
 -/usr/share/snmp/defs,
 +.Pa /usr/share/snmp/defs ,
  will be searched.
  .It Fl K
  Calculate and display the localized authentication and privacy keys
 -corresponding to a plain text password. The password is obtain via the
 -environment. Additionally, if one or more OIDs are specified, the calculated
 +corresponding to a plain text password.
 +The password is obtained via the environment.
 +Additionally, if one or more OIDs are specified, the calculated
  keys are used when processing the SNMPv3 requests.
  .It Fl l Ar filename
  The path of the posix local (unix domain) socket if local
 @@ -242,9 +246,9 @@ In addition to the short output verbose 
  Privacy options to use with SNMPv3 PDUs
  .Bl -tag -width \&
  .It Cm proto=[aes|des]
 -The protocol to use when encypting/decrypting SNMPv3 PDU data.
 +The protocol to use when encrypting/decrypting SNMPv3 PDU data.
  .It Cm key=privkey
 -A binary localized privacy key to use when encypting/decrypting SNMPv3 PDU data.
 +A binary localized privacy key to use when encrypting/decrypting SNMPv3 PDU data.
  .El
  .Pp
  By default plain text SNMPv3 PDUs are sent.
 @@ -267,14 +271,14 @@ not respond after the first try.
  Default is 3.
  .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
 -has to be provided if
 +has to be provided if the
  .Ar s
  option is used.
  The server specification is constructed in the following manner:
  .Bl -tag -width \&
  .It Cm trans::
  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
  is the most common.
  Stream stands for a posix local stream socket and a posix local datagram
  socket will be used if dgram is specified.
 @@ -317,11 +321,13 @@ The value of the snmpEngineTime of the S
  If any of the above is not specified, SNMP USM Engine Discovery is attempted.
  This is also the default behavior.
  .It Cm name=username
 -The USM user name to include in the SNMPv3 PDUs. By default, the user name is
 -obtain via the environment
 +The USM user name to include in the SNMPv3 PDUs.
 +By default, the user name is
 +obtained via the environment.
  .El
  .It Fl v Ar version
 -The SNMP protocol version to use when sending requests. SNMP versions 1, 2 and
 +The SNMP protocol version to use when sending requests.
 +SNMP versions 1, 2 and
  3 are supported.
  If no version option is provided
  .Nm bsnmpget ,
 @@ -330,7 +336,7 @@ and
  .Nm bsnmpset
  will use version 2.
  Note that GetBulkRequest-PDUs were introduced in SNMPv2 thus setting the
 -version to 1 is incompatiable with sending a GetBulk PDU.
 +version to 1 is incompatible with sending a GetBulk PDU.
  .It OID
  The object identifier whose value to retrive.
  At least one OID should be provided for
 @@ -355,7 +361,7 @@ is valid as input OID:
  .It ifRcvAddressStatus.2.6.255.255.255.255.255.255
  .It ifRcvAddressType[2,ff:ff:ff:ff:ff:ff]
  .It ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]
 -(requires
 +(requires the
  .Fl o Ar verbose
  option)
  .El
 @@ -373,14 +379,14 @@ to be able to send a request.
  .It Cm OID
  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
 -if
 +if the
  .Ar n
 -options is used - and in such case a syntax is required for every value,
 +option 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
  corresponding indexes.
 -Any of formats used to print a single variable by
 -.Nm bsnmpset is
 -valid for inpit OID as well:
 +Any of the formats used to print a single variable by
 +.Nm bsnmpset
 +is valid as input OID as well:
  .Bl -tag -width \&
  .It 1.3.6.1.2.1.25.1.1.0=TimeTicks:537615486
  .It sysLocation=OctetString:"@ Home" (with Fl o Ar verbose No option)
 @@ -389,17 +395,17 @@ valid for inpit OID as well:
  .It ifPhysAddress.1="00:02:b3:1d:1c:a3"
  .It ifRcvAddressStatus.1.6.255.255.255.255.255.255=1
  .It "ifRcvAddressStatus[Integer:1,OctetString:ff:ff:ff:ff:ff:ff]=Integer:1"
 -(with
 +(with the
  .Fl o Ar verbose
  option)
  .El
  .It Cm syntax
 -where syntax string is one of:
 +where the syntax string is one of:
  Integer, OctetString, OID, IpAddress, Counter32, Gauge, TimeTicks, Counter64.
  .It Cm value
  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
 -contain any special characters or spaces, all other numeric types don't.
 +contain any special characters or spaces, all other numeric types do not.
  .El
  .El
  .Sh ENVIRONMENT
 @@ -417,8 +423,9 @@ Specifies a default SNMP USM privacy pro
  Specifies a default SNMP USM user name.
  .It Ev SNMPPASSWD
  Specifies the SNMP USM plain text password to use when calculating localized
 -authentication and privacy keys. If this variable exists in the environment,
 -SMNPv3 is the default version to use for outgoing requests.
 +authentication and privacy keys.
 +If this variable exists in the environment,
 +SNMPv3 is the default version to use for outgoing requests.
  .El
  .Sh SEE ALSO
  .Xr gensnmpdef 1
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: brueffer 
State-Changed-When: Wed Mar 5 14:30:09 CET 2014 
State-Changed-Why:  
Merges to stable branches done. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=187035 
>Unformatted:
