Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort options in man page, don't mention non-existing '-S' option,

Browse Source 
use some more markup and improve existing one.
Sync usage() with man page.
This commit is contained in:
wiz 2002-05-25 14:21:02 +00:00
parent 13076c6ae6
commit a16dbed217
2 changed files with 53 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,4 +1,4 @@
.\" $NetBSD: syslogd.8,v 1.26 2002/05/25 14:07:09 wiz Exp $
.\" $NetBSD: syslogd.8,v 1.27 2002/05/25 14:21:02 wiz 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 @@ and do not disassociate from the controlling terminal.
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 opened.
.It Fl g Ar group
Set GID to
.Ar group
after the sockets and log files have been opened.
.It Fl t Ar chroot_dir
.Xr chroot 2
to
.Ar chroot_dir
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 s
Select ``secure'' mode, in which syslogd 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
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 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
.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
.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 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 @@ By using multiple
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 .

6
usr.sbin/syslogd/syslogd.c
View File

@ -1,4 +1,4 @@
/* $NetBSD: syslogd.c,v 1.51 2002/05/02 13:53:10 lukem Exp $ */
/* $NetBSD: syslogd.c,v 1.52 2002/05/25 14:21:02 wiz Exp $ */
/*
* Copyright (c) 1983, 1988, 1993, 1994
@ -43,7 +43,7 @@ __COPYRIGHT("@(#) Copyright (c) 1983, 1988, 1993, 1994\n\
#if 0
static char sccsid[] = "@(#)syslogd.c 8.3 (Berkeley) 4/4/94";
#else
__RCSID("$NetBSD: syslogd.c,v 1.51 2002/05/02 13:53:10 lukem Exp $");
__RCSID("$NetBSD: syslogd.c,v 1.52 2002/05/25 14:21:02 wiz Exp $");
#endif
#endif /* not lint */
@ -550,7 +550,7 @@ usage()
{
(void)fprintf(stderr,
"usage: %s [-ds] [-f conffile] [-m markinterval] [-P logpathfile] [-p logpath1] [-p logpath2 ..]\n",
"usage: %s [-dns] [-f config_file] [-g group] [-m mark_interval]\n\t[-P file_list] [-p log_socket [-p log_socket2 ...]]\n\t[-t chroot_dir] [-u user]\n",
getprogname());
exit(1);
}