Date: Thu, 2 Mar 2017 18:07:19 +0000 (UTC) From: Ngie Cooper <ngie@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r314563 - head/usr.sbin/syslogd Message-ID: <201703021807.v22I7Jeg016057@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201703021807.v22I7Jeg016057>