From owner-svn-src-all@freebsd.org Thu Mar 2 18:07:20 2017 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id BA6B6CF47FE; Thu, 2 Mar 2017 18:07:20 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7B3F6F7F; Thu, 2 Mar 2017 18:07:20 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v22I7JcU016058; Thu, 2 Mar 2017 18:07:19 GMT (envelope-from ngie@FreeBSD.org) Received: (from ngie@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v22I7Jeg016057; Thu, 2 Mar 2017 18:07:19 GMT (envelope-from ngie@FreeBSD.org) Message-Id: <201703021807.v22I7Jeg016057@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: ngie set sender to ngie@FreeBSD.org using -f From: Ngie Cooper Date: Thu, 2 Mar 2017 18:07:19 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r314563 - head/usr.sbin/syslogd X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Mar 2017 18:07:20 -0000 Author: ngie Date: Thu Mar 2 18:07:19 2017 New Revision: 314563 URL: https://svnweb.freebsd.org/changeset/base/314563 Log: Wordsmith syslogd(8) - Clarify -p/-S options by using appropriate subject-verb modifiers (verb and modifiers suggested that the subject should have been singular). - Simplify/correct -a description: -- Be more terse when describing IPv4 (the "usual dotted notation" isn't necessarily well understood by the reader). Being blunt and saying "IPv4 address" with an optional netmask is. -- prefixlen is the appropriate terminology for IPv6. -- mask/prefixlen is optional, not required (as noted later on in the section). -- split up IPv4/IPv6 use so to clarify both forms. -- Fix wordiness when describing the optional "service" specifier. - -T: Use "cannot" instead of "can't" [*]. Bump .Dd for the changes. MFC after: 1 month Reported by: igor [*] Reviewed by: hrs Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9855 Modified: head/usr.sbin/syslogd/syslogd.8 Modified: head/usr.sbin/syslogd/syslogd.8 ============================================================================== --- head/usr.sbin/syslogd/syslogd.8 Thu Mar 2 17:35:13 2017 (r314562) +++ head/usr.sbin/syslogd/syslogd.8 Thu Mar 2 18:07:19 2017 (r314563) @@ -28,7 +28,7 @@ .\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd December 21, 2016 +.Dd March 2, 2017 .Dt SYSLOGD 8 .Os .Sh NAME @@ -102,21 +102,23 @@ options may be specified. The .Ar allowed_peer option may be any of the following: -.Bl -tag -width "ipaddr/masklen[:service]XX" +.Bl -tag -width "ipaddr[/prefixlen][:service]XX" .It Xo .Sm off .Ar ipaddr -.No / Ar masklen +.Op / Ar masklen +.Op \&: Ar service +.Pp +.Ar ipaddr +.Op / Ar prefixlen .Op \&: Ar service .Sm on .Xc Accept datagrams from +.Ar ipaddr , .Ar ipaddr -(in the usual dotted quad notation) with -.Ar masklen -bits being taken into account when doing the address comparison. -.Ar ipaddr -can be also IPv6 address by enclosing the address with +can be specified as an IPv4 address or as an IPv6 +address enclosed with .Ql \&[ and .Ql \&] . @@ -129,7 +131,7 @@ A .Ar service of .Ql \&* -allows packets being sent from any UDP port. +allows packets to be sent from any UDP port. The default .Ar service is @@ -265,7 +267,7 @@ the default is .Pa /var/run/log . When a single .Fl p -options are specified, +option is specified, the default pathname is replaced with the specified one. When two or more .Fl p @@ -282,7 +284,7 @@ the default is .Pa /var/run/logpriv . When a single .Fl S -options are specified, +option is specified, the default pathname is replaced with the specified one. When two or more .Fl S @@ -309,7 +311,7 @@ which also disables logging to remote ma .It Fl T Always use the local time and date for messages received from the network, instead of the timestamp field supplied in the message by the remote host. -This is useful if some of the originating hosts can't keep time properly +This is useful if some of the originating hosts cannot keep time properly or are unable to generate a correct timestamp. .It Fl u Unique priority logging.