From owner-freebsd-doc@FreeBSD.ORG Wed Apr 6 05:20:11 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 843471065672 for ; Wed, 6 Apr 2011 05:20:11 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 588AA8FC0A for ; Wed, 6 Apr 2011 05:20:11 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p365KBdl061885 for ; Wed, 6 Apr 2011 05:20:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p365KBcY061884; Wed, 6 Apr 2011 05:20:11 GMT (envelope-from gnats) Date: Wed, 6 Apr 2011 05:20:11 GMT Message-Id: <201104060520.p365KBcY061884@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/156187: Add bsnmpd to handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Apr 2011 05:20:11 -0000 The following reply was made to PR docs/156187; it has been noted by GNATS. From: Benjamin Kaduk To: Mark Meyer Cc: freebsd-gnats-submit@freebsd.org, freebsd-doc@freebsd.org Subject: Re: docs/156187: Add bsnmpd to handbook Date: Wed, 6 Apr 2011 01:19:36 -0400 (EDT) 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