From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 11:40:01 2008 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 AEF061065675 for ; Wed, 31 Dec 2008 11:40:01 +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 7BDBD8FC0C for ; Wed, 31 Dec 2008 11:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBVBe1EU035466 for ; Wed, 31 Dec 2008 11:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBVBe1cn035465; Wed, 31 Dec 2008 11:40:01 GMT (envelope-from gnats) Resent-Date: Wed, 31 Dec 2008 11:40:01 GMT Resent-Message-Id: <200812311140.mBVBe1cn035465@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Gavin Atkinson Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BFEE51065670 for ; Wed, 31 Dec 2008 11:39:46 +0000 (UTC) (envelope-from ga9@buffy.york.ac.uk) Received: from mail-gw1.york.ac.uk (mail-gw1.york.ac.uk [144.32.128.246]) by mx1.freebsd.org (Postfix) with ESMTP id 6E0A78FC13 for ; Wed, 31 Dec 2008 11:39:45 +0000 (UTC) (envelope-from ga9@buffy.york.ac.uk) Received: from mail-gw7.york.ac.uk (mail-gw7.york.ac.uk [144.32.129.30]) by mail-gw1.york.ac.uk (8.13.6/8.13.6) with ESMTP id mBVBde3l021735 for ; Wed, 31 Dec 2008 11:39:40 GMT Received: from buffy-128.york.ac.uk ([144.32.128.160] helo=buffy.york.ac.uk) by mail-gw7.york.ac.uk with esmtps (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1LHzQK-0003S8-Pg for FreeBSD-gnats-submit@freebsd.org; Wed, 31 Dec 2008 11:39:40 +0000 Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.14.2/8.14.2) with ESMTP id mBVBdebh024044 for ; Wed, 31 Dec 2008 11:39:40 GMT (envelope-from ga9@buffy.york.ac.uk) Received: (from ga9@localhost) by buffy.york.ac.uk (8.14.2/8.14.2/Submit) id mBVBdeS5024043; Wed, 31 Dec 2008 11:39:40 GMT (envelope-from ga9) Message-Id: <200812311139.mBVBdeS5024043@buffy.york.ac.uk> Date: Wed, 31 Dec 2008 11:39:40 GMT From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/130075: [patch] Changes to handbook syslogd section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Dec 2008 11:40:01 -0000 >Number: 130075 >Category: docs >Synopsis: [patch] Changes to handbook syslogd section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Dec 31 11:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 7.0-STABLE amd64 >Organization: >Environment: System: FreeBSD buffy.york.ac.uk 7.0-STABLE FreeBSD 7.0-STABLE #3: Fri Jun 20 09:21:51 UTC 2008 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/GENERIC amd64 >Description: I've made a few changes to the new syslogd chapter. Firstly, there is some confusion in the current article between the client and server sections - there is talk about how to configure the server in the client section. This also contains incorrect info - the rc.conf settings in the client section, for example, are really the ones that should be used on the server. Also, where info is relevant to both the server and client configuration, I've moved the details into the server section as it comes first. As it was, various details were only explained the second time they came up. Lastly, I've just clarified a couple of bits, and added further info. >How-To-Repeat: N/A >Fix: --- handbook-syslog.diff begins here --- Index: doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v retrieving revision 1.113 diff -u -r1.113 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml 26 Dec 2008 03:19:02 -0000 1.113 +++ doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml 30 Dec 2008 14:37:15 -0000 @@ -5040,6 +5040,26 @@ be logged to the file specified previously, /var/log/logclient.log. + The server machine must also have the following listing + placed inside /etc/rc.conf: + + syslogd_enable="YES" +syslogd_flags="-a logclient.example.com -vv" + + The first option will enable the syslogd + daemon on boot up, and the second option allows data from the + specified client to be accepted on this server. The latter + part, using , will increase the verbosity + of logged messages. This is extremely useful for tweaking + facilities as administrators are able to see what type of + messages are being logged under which facility. + + Multiple options may be specified to + allow logging from multiple clients. IP + addresses and whole netblocks may also be specified, see the + &man.syslog.3; manual page for a full list of possible + options. + Finally, the log file should be created. The method used does not matter, but &man.touch.1; works great for situations such as this: @@ -5066,7 +5086,7 @@ to a logging server in addition to keeping local copies. Similar to log servers, clients must also meet a few minimum - requirements. + requirements: @@ -5088,20 +5108,18 @@ Client configuration is a bit more relaxed when compared - to that of the servers. The client machine must also have the + to that of the servers. The client machine must have the following listing placed inside /etc/rc.conf: syslogd_enable="YES" -syslogd_flags="-a logclient.example.com -vv" +syslogd_flags="-s -vv" - The first option will enable the syslogd - daemon on boot up, and the second line allows data from the - client to be accepted on this server. The latter part, using - , will increase the verbosity of logged - messages. This is extremely useful for tweaking facilities as - administrators are able to see what type of messages are being - logged under which facility. + As before, these entries will enable the + syslogd daemon on boot up, and increases + the verbosity of logged messages. The + option prevents logs from being accepted by this client from + other hosts. Facilities describe the system part for which a message is generated. For an example, ftp and @@ -5128,14 +5146,15 @@ &prompt.root; /etc/rc.d/syslogd restart To test that log messages are being sent across the network, - use &man.logger.1; to send a message to + use &man.logger.1; on the client to send a message to syslogd: &prompt.root; logger "Test message from logclient" - This message should now exist in - /var/log/messages on both the client - and the server. + This message should now exist both in + /var/log/messages on the client, and + /var/log/logclient.log on the + log server. --- handbook-syslog.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: