From owner-svn-doc-all@FreeBSD.ORG Mon Mar 24 20:55:36 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E7859882; Mon, 24 Mar 2014 20:55:36 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id D34789E6; Mon, 24 Mar 2014 20:55:36 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2OKtaOS091715; Mon, 24 Mar 2014 20:55:36 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2OKtael091714; Mon, 24 Mar 2014 20:55:36 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403242055.s2OKtael091714@svn.freebsd.org> From: Dru Lavigne Date: Mon, 24 Mar 2014 20:55:36 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44345 - head/en_US.ISO8859-1/books/handbook/config X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Mar 2014 20:55:37 -0000 Author: dru Date: Mon Mar 24 20:55:36 2014 New Revision: 44345 URL: http://svnweb.freebsd.org/changeset/doc/44345 Log: Finish editorial review of logging chapter. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/config/chapter.xml Mon Mar 24 16:53:46 2014 (r44344) +++ head/en_US.ISO8859-1/books/handbook/config/chapter.xml Mon Mar 24 20:55:36 2014 (r44345) @@ -1345,8 +1345,8 @@ cron.* - Line 33 is an example usage of a program - specification. This makes the rules + Line 33 is an example usage of a program + specification. This makes the rules following it only valid for the specified program. In this case, only the messages generated by ppp are @@ -1395,24 +1395,24 @@ cron.* log rotation log management - Log files tend to grow quickly and accumulate steadily. - This leads to the files being full of less immediately useful - information while filling up the hard drive. Log management - attempts to mitigate this. In &os;, &man.newsyslog.8; is used - to manage log files. This program periodically rotates and + Log files can grow quickly, taking up disk space and + making it more difficult to locate useful + information. Log management + attempts to mitigate this. In &os;, newsyslog is used + to manage log files. This built-in program periodically rotates and compresses log files, and optionally creates missing log files and signals programs when log files are moved. The log files - are not necessarily generated by &man.syslogd.8; as - &man.newsyslog.8; works with any logs written from any - program. While &man.newsyslog.8; is normally run from + may be generated by syslogd or + by any other program which generates log files. + While syslogd is normally run from &man.cron.8;, it is not a system daemon. In the default - configuration, it is run every hour. + configuration, it runs every hour. - To know which actions to take, &man.newsyslog.8; reads - its configuration file, by default + To know which actions to take, newsyslog reads + its configuration file, /etc/newsyslog.conf. This - configuration file contains one line for each file that - &man.newsyslog.8; manages. Each line states the file + file contains one line for each log file that + newsyslog manages. Each line states the file owner, permissions, when to rotate that file, optional flags that affect log rotation, such as compression, and programs to signal when the log is rotated. Here is the default @@ -1451,36 +1451,39 @@ cron.* /var/log/monthly.log 640 12 * $M1D0 JN /var/log/pflog 600 3 100 * JB /var/run/pflogd.pid /var/log/ppp.log root:network 640 3 100 * JC +/var/log/devd.log 644 3 100 * JC /var/log/security 600 10 100 * JC /var/log/sendmail.st 640 10 * 168 B /var/log/utx.log 644 3 * @01T05 B /var/log/weekly.log 640 5 1 $W6D0 JN /var/log/xferlog 600 7 100 * JC - Each line starts with the name of the file to be + Each line starts with the name of the log to be rotated, optionally followed by an owner and group for both rotated and newly created files. The mode field sets the permissions on the log file and count denotes how many rotated log files should be kept. The size and when fields - tell &man.newsyslog.8; when to rotate the file. A log + tell newsyslog when to rotate the file. A log file is rotated when either its size is larger than the - size field, or when the time in the + size field or when the time in the when filed has passed. - * means that this field is ignored. The + An asterisk (*) means that this field is ignored. The flags field gives - &man.newsyslog.8; further instructions, such as how to + further instructions, such as how to compress the rotated file or to create the log file if it - is missing. The last two fields are optional, and - specify the - PID file of a + is missing. The last two fields are optional and + specify the name of the Process ID + (PID) file of a process and a signal number to send to that process when the - file is rotated. For more information on all fields, valid + file is rotated. + + For more information on all fields, valid flags, and how to specify the rotation time, refer to - &man.newsyslog.conf.5;. Since &man.newsyslog.8; is run from + &man.newsyslog.conf.5;. Since newsyslog is run from &man.cron.8;, it can not rotate files more often than it is - run from &man.cron.8;. + scheduled to run from &man.cron.8;. @@ -1503,9 +1506,9 @@ cron.* increases. Configuring centralized logging can reduce some of the administrative burden of log file administration. - Centralized log file aggregation, merging, and rotation can - be configured using &os; native tools, such as &man.syslogd.8; - and &man.newsyslog.8;. This section demonstrates an example + In &os;, centralized log file aggregation, merging, and rotation can + be configured using syslogd + andnewsyslog. This section demonstrates an example configuration, where host A, named logserv.example.com, will @@ -1722,7 +1725,7 @@ Logging to FILE /var/log/messagesnewsyslog, supports setting permissions on newly created and rotated log files. Setting log files to mode 600 should prevent unwanted access by local users. Refer to