d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Wordsmith syslogd(8)

Browse Source 
- 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
This commit is contained in:
ngie 2017-03-02 18:07:19 +00:00
parent 6a00199f55
commit 7b66c3d21b
1 changed files with 14 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
usr.sbin/syslogd/syslogd.8
View File

@ -28,7 +28,7 @@
.\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 .\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 21, 2016 .Dd March 2, 2017
.Dt SYSLOGD 8 .Dt SYSLOGD 8
.Os .Os
.Sh NAME .Sh NAME
@ -102,21 +102,23 @@ options may be specified.
The The
.Ar allowed_peer .Ar allowed_peer
option may be any of the following: option may be any of the following:
.Bl -tag -width "ipaddr/masklen[:service]XX" .Bl -tag -width "ipaddr[/prefixlen][:service]XX"
.It Xo .It Xo
.Sm off .Sm off
.Ar ipaddr .Ar ipaddr
.No / Ar masklen .Op / Ar masklen
.Op \&: Ar service
.Pp
.Ar ipaddr
.Op / Ar prefixlen
.Op \&: Ar service .Op \&: Ar service
.Sm on .Sm on
.Xc .Xc
Accept datagrams from Accept datagrams from
.Ar ipaddr ,
.Ar ipaddr .Ar ipaddr
(in the usual dotted quad notation) with can be specified as an IPv4 address or as an IPv6
.Ar masklen address enclosed with
bits being taken into account when doing the address comparison.
.Ar ipaddr
can be also IPv6 address by enclosing the address with
.Ql \&[ .Ql \&[
and and
.Ql \&] . .Ql \&] .
@ -129,7 +131,7 @@ A
.Ar service .Ar service
of of
.Ql \&* .Ql \&*
allows packets being sent from any UDP port. allows packets to be sent from any UDP port.
The default The default
.Ar service .Ar service
is is
@ -265,7 +267,7 @@ the default is
.Pa /var/run/log . .Pa /var/run/log .
When a single When a single
.Fl p .Fl p
options are specified, option is specified,
the default pathname is replaced with the specified one. the default pathname is replaced with the specified one.
When two or more When two or more
.Fl p .Fl p
@ -282,7 +284,7 @@ the default is
.Pa /var/run/logpriv . .Pa /var/run/logpriv .
When a single When a single
.Fl S .Fl S
options are specified, option is specified,
the default pathname is replaced with the specified one. the default pathname is replaced with the specified one.
When two or more When two or more
.Fl S .Fl S
@ -309,7 +311,7 @@ which also disables logging to remote machines.
.It Fl T .It Fl T
Always use the local time and date for messages received from the network, 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. 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. or are unable to generate a correct timestamp.
.It Fl u .It Fl u
Unique priority logging. Unique priority logging.