From owner-freebsd-doc@FreeBSD.ORG Wed Apr 6 05:34:42 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 66F2E1065670 for ; Wed, 6 Apr 2011 05:34:42 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (DMZ-MAILSEC-SCANNER-4.MIT.EDU [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 18B0B8FC08 for ; Wed, 6 Apr 2011 05:34:41 +0000 (UTC) X-AuditID: 1209190f-b7cf3ae0000046b8-f5-4d9bf7e672fe Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 66.EE.18104.6E7FB9D4; Wed, 6 Apr 2011 01:19:34 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id p365JdZN009644; Wed, 6 Apr 2011 01:19:39 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p365Jc5K028312 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 6 Apr 2011 01:19:39 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p365JbOX015764; Wed, 6 Apr 2011 01:19:37 -0400 (EDT) Date: Wed, 6 Apr 2011 01:19:36 -0400 (EDT) From: Benjamin Kaduk To: Mark Meyer In-Reply-To: <201104042156.p34LukIJ003940@red.freebsd.org> Message-ID: References: <201104042156.p34LukIJ003940@red.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixCmqrfvs+2xfg+2ztS1OnelitWh5sprd 4t7s+0wOzB4zPs1n8dg56y57AFMUl01Kak5mWWqRvl0CV8ahrSYFneoVMxd0MzYwnpDrYuTk kBAwkfh1agEThC0mceHeerYuRi4OIYF9jBJtWyZBOesZJc7/X8wK4exnkriwazsjSIuQQL3E gjlb2UBsFgEtib031oHZbAIqEjPfbASyOThEBBQlPp0zAQkzC9hK7JnwhBnEFhYwkHi/+z/Y Zk4BK4nZDyexgti8Ao4SrdPvskOMt5ToOr4MrF5UQEdi9f4pLBA1ghInZz5hgZhpKXHuz3W2 CYyCs5CkZiFJLWBkWsUom5JbpZubmJlTnJqsW5ycmJeXWqRropebWaKXmlK6iREcsJL8Oxi/ HVQ6xCjAwajEw7ti8WxfIdbEsuLK3EOMkhxMSqK8S74AhfiS8lMqMxKLM+KLSnNSiw8xSnAw K4nwmr6e5SvEm5JYWZValA+TkuZgURLnnSWp7iskkJ5YkpqdmlqQWgSTleHgUJLgtQNGppBg UWp6akVaZk4JQpqJgxNkOA/Q8InfgGp4iwsSc4sz0yHypxgVpcR5o0CaBUASGaV5cL2whPKK URzoFWFea5AqHmAygut+BTSYCWjw1ilgg0sSEVJSDYyJjyzKPmVJFsxgLY5veOu25PH3HL5q xsNL17w+viRNt0F/Q2K3ofpP59qQivxrgrtm1FzqEpQRXq3R0l0wp2bpMucXEzYHarlt2WtR N8vZS6NzgnaLSMgmxQ8Gtxq2pm5ythHZLvn5i0mw7/S3k6csk6muDeE+dX3vevcndSmC0/nP bcuU3aXEUpyRaKjFXFScCAC3YQ7RAwMAAA== Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/156187: Add bsnmpd to handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Apr 2011 05:34:42 -0000 On Mon, 4 Apr 2011, Mark Meyer wrote: > > Patch attached with submission follows: > > ? bsnmpd.diff > Index: network-servers/chapter.sgml > =================================================================== > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v > retrieving revision 1.129 > diff -u -r1.129 chapter.sgml > --- network-servers/chapter.sgml 4 Apr 2011 05:23:33 -0000 1.129 > +++ network-servers/chapter.sgml 4 Apr 2011 21:40:56 -0000 > @@ -5383,6 +5383,125 @@ > by local users. > > > + > + > + > + > + > + Mark > + Meyer > + Contributed by > + > + > + > + > + Updated by > + The &os; Documentation Project > + > + > + > + > + The <application>bsnmpd</application> Server > + > + > + Overview > + > + With your first installation of FreeBSD, bsnmpd is It's not clear that the ordinality of the installation is relevant. > + provided as the default software implementing SNMPv2. For the > + purpose of testing we will assume you're trying to connect to > + this service from your local system. > + > + NTo run the tests in this section you will additionally Spurious 'N'. > + need net-mgmt/bsnmptools, > + which you can install via the bsnmptools package or > + port. > + > + > + > + > + Configuring <application>bsnmpd</application> > + > + The bsnmpd configuration resides in /etc/bsnmpd.config and > + is already in a runnable state. By default bsnmpd allows I think "the default configuration is runnable" is more clear. > + anybody to read any variable using the community "public". If > + you don't want everybody to read your SNMP variables, choose a > + different read community and edit the configuration setting > + accordingly: > + > + read := "superprivate" > + > + Choose the community string wisely. Everybody able to I have a general preference for "everyone" over "everybody" that I cannot really justify to this audience and will refrain from noting all occurrences. However, here I think "anyone" or "everyone" is preferable. > + guess it, will be able to read from your systems management no comma. > + data. The community will however be transferred in plain text > + over the wire, thus potentially leaking an otherwise secure > + password to an attacker. "thus" is perhaps spurious; the whole sentence could probably be reworded to make it more clear that valuable passwords should not be used as they are sent in cleartext. > + > + The variables "location" and "contact" can be set. They > + are intended to reflect the physical location and system > + administration contact respectively: > + > + location := "Room 200" > +contact := "sysmeister@example.com" > + > + If you want to send SNMP traps to a specific port, set > + both "traphost" and "trapport" variables: > + > + traphost := monitor.example.com > +trapport := 162 > + > + > + > + > + Running <application>bsnmpd</application> > + > + To run bsnmpd at system startup, add the following to your > + /etc/rc.conf: > + > + bsnmpd_enabl="YES" "enable" > + > + Doing a Can you reword to avoid the awkwardness of treating the screenshot as part of the sentence? > + > + &prompt.root; /etc/rc.d/bsnmpd start > + > + will start bsnmpd > + immediately. To test your setup, run > + an bsnmpget from the machine you > + installed on. "machine you installed on" is a somewhat awkward phrase. > + > + &prompt.root; /usr/local/bin/bsnmpget -s superprivate@localhost sysContact > +sysContact.0 = sysmeister@example.com > + > + The command should dump the value you entered in your s/dump/print/, I think (having not tried running the command) > + configuration. Maybe name bsnmpd.config explicitly? -Ben Kaduk