[src/netbsd-1-6]: src/usr.sbin/syslogd resolve 1.6 pullup ticket #23 from wiz

[perry <perry%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a160429579f0
branches:  netbsd-1-6
changeset: 527539:a160429579f0
user:      perry <perry%NetBSD.org@localhost>
date:      Sat May 25 17:43:00 2002 +0000

description:
resolve 1.6 pullup ticket #23 from wiz
pulls up revisions 1.26, 1.27
Original commit messages:

> Grammar fixes and a markup fix.

and

> Sort options in man page, don't mention non-existing '-S' option,
> use some more markup and improve existing one.

diffstat:

 usr.sbin/syslogd/syslogd.8 |  89 +++++++++++++++++++++++++--------------------
 1 files changed, 49 insertions(+), 40 deletions(-)

diffs (165 lines):

diff -r 502350e4f02e -r a160429579f0 usr.sbin/syslogd/syslogd.8
--- a/usr.sbin/syslogd/syslogd.8        Sat May 25 17:19:14 2002 +0000
+++ b/usr.sbin/syslogd/syslogd.8        Sat May 25 17:43:00 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: syslogd.8,v 1.25 2002/02/02 01:59:04 wiz Exp $
+.\"    $NetBSD: syslogd.8,v 1.25.2.1 2002/05/25 17:43:00 perry Exp $
 .\"
 .\" Copyright (c) 1983, 1986, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,26 +33,20 @@
 .\"
 .\"     from: @(#)syslogd.8    8.1 (Berkeley) 6/6/93
 .\"
-.Dd February 18, 1999
+.Dd May 25, 2002
 .Dt SYSLOGD 8
 .Os
 .Sh NAME
 .Nm syslogd
 .Nd log systems messages
 .Sh SYNOPSIS
-.Nm "
-.Op Fl dsSn
+.Nm
+.Op Fl dns
 .Bk -words
 .Op Fl f Ar config_file
 .Ek
 .Bk -words
-.Op Fl u Ar user
-.Ek
-.Bk -words
-.Op Fl g Ar user
-.Ek
-.Bk -words
-.Op Fl t Ar chroot_dir
+.Op Fl g Ar group
 .Ek
 .Bk -words
 .Op Fl m Ar mark_interval
@@ -61,17 +55,23 @@
 .Op Fl P Ar file_list
 .Ek
 .Bk -words
-.Op Fl p Ar log_socket
+.Oo
+.Fl p Ar log_socket
+.Op Fl p Ar log_socket2 ...
+.Oc
 .Ek
 .Bk -words
-.Op Fl p Ar log_socket2 ...
+.Op Fl t Ar chroot_dir
+.Ek
+.Bk -words
+.Op Fl u Ar user
 .Ek
 .Sh DESCRIPTION
 .Nm
 reads and logs messages to the system console, log files, other
 machines and/or users as specified by its configuration file.
 The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width 15n
 .It Fl d
 Enable debugging to the standard output,
 and do not disassociate from the controlling terminal.
@@ -79,43 +79,49 @@
 Specify the pathname of an alternative configuration file;
 the default is
 .Pa /etc/syslog.conf .
-.It Fl u Ar user
-Set UID to
-.Ar user
-after the sockets and log files have been open.
 .It Fl g Ar group
 Set GID to
 .Ar group
-after the sockets and log files have been open.
-.It Fl t Ar chroot_dir
-.Xr chroot 2
-to
-.Ar chroot_dir
-after the sockets and log files        have been open.
+after the sockets and log files have been opened.
 .It Fl m
 Select the number of minutes between ``mark'' messages;
 the default is 20 minutes.
 .It Fl n
 Do not perform hostname lookups; report only numeric addresses.
+.It Fl P
+Specify the pathname of a file containing a list of sockets to be
+created.  The format of the file is simply one socket per line.
+.It Fl p
+Specify the pathname of a log socket.  Multiple
+.Fl p
+options create multiple log sockets.  If no
+.Fl p
+arguments are created, the default socket of
+.Pa /var/run/log
+is used.
 .It Fl s
-Select ``secure'' mode, in which syslogd does not listen on a UDP socket but
-only communicates over a
+Select
+.Dq secure
+mode, in which
+.Nm
+does not listen on a UDP socket but only communicates over a
 .Ux
 domain socket.
 This is valuable when the machine on
-which syslogd runs is subject to attack over the network and it is desired
+which
+.Nm
+runs is subject to attack over the network and it is desired
 that the machine be protected from attempts to remotely fill logs
 and similar attacks.
-.It Fl p
-Specify the pathname of an log socket.  Multiple
-.Fl p
-options create multiple log sockets.  If no -p arguments are created,
-the default socket of
-.Pa /var/run/log
-is used.
-.It Fl P
-Specify the pathname of a file containing a list of sockets to be
-created.  The format of the file is simply one socket per line.
+.It Fl t Ar chroot_dir
+.Xr chroot 2
+to
+.Ar chroot_dir
+after the sockets and log files have been opened.
+.It Fl u Ar user
+Set UID to
+.Ar user
+after the sockets and log files have been opened.
 .El
 .Pp
 .Nm
@@ -149,10 +155,13 @@
 options, one can setup many chroot environments by passing the pathname
 to the log socket
 .Pa ( /var/run/log )
-in each chroot area to syslogd.  For example:
+in each chroot area to
+.Nm "" .
+For example:
 .Dl syslogd -p /var/run/log -p /web/var/run/log -p /ftp/var/run/log
 .Pp
-note: the normal log socket must now also be passed to syslogd.
+Note: the normal log socket must now also be passed to
+.Nm "" .
 .Pp
 Accesses from UDP socket can be filtered by libwrap configuration files, like
 .Pa /etc/hosts.deny .
@@ -164,7 +173,7 @@
 Refer to
 .Xr hosts_access 5
 for details.
-.Sh SYSLOG PROTOCOL NOTES
+.Ss SYSLOG PROTOCOL NOTES
 The message sent to
 .Nm
 should consist of a single line.