summaryrefslogtreecommitdiffstats
path: root/usr.sbin/syslogd/syslogd.8
diff options
context:
space:
mode:
authorjoerg <joerg@FreeBSD.org>1997-05-03 22:17:43 +0000
committerjoerg <joerg@FreeBSD.org>1997-05-03 22:17:43 +0000
commit448c1dca859c219c3ca33a924fb16c2fe5aca01f (patch)
treee1640e6f3cc76b34949b0bc015d8d01b24cd3bcb /usr.sbin/syslogd/syslogd.8
parentff12d1d1773aae3e2ba252b0daa09e91d35e57c1 (diff)
downloadFreeBSD-src-448c1dca859c219c3ca33a924fb16c2fe5aca01f.zip
FreeBSD-src-448c1dca859c219c3ca33a924fb16c2fe5aca01f.tar.gz
Nobody ever seemed to be interested in reviewing these changes, and i
found that my syslogd is now running them for several months... Add an option to syslogd to restrict the IP addresses that are allowed to log to this syslogd. It's too late to develop the inter-syslogd communications protocol mentioned in the BUGS section, some 10 years too late. Thus, restricting the IP address range is about the most effective change we can do if we want to allow incoming syslog messages at all. IMHO, we should encourage the system administrators to use this option, and thus provide a knob in /etc/rc.* for it, defaulting to -a 127.0.0.1/32 (just as a hint about the usage). Please state opinions about whether to merge this change into 2.2 or not (i've got it running on RELENG_2_2 anyway).
Diffstat (limited to 'usr.sbin/syslogd/syslogd.8')
-rw-r--r--usr.sbin/syslogd/syslogd.880
1 files changed, 75 insertions, 5 deletions
diff --git a/usr.sbin/syslogd/syslogd.8 b/usr.sbin/syslogd/syslogd.8
index 3efab7f..12bcb11 100644
--- a/usr.sbin/syslogd/syslogd.8
+++ b/usr.sbin/syslogd/syslogd.8
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93
-.\" $Id: syslogd.8,v 1.9 1997/04/26 00:00:32 pst Exp $
+.\" $Id: syslogd.8,v 1.10 1997/04/29 09:09:40 jmg Exp $
.\"
.Dd October 12, 1995
.Dt SYSLOGD 8
@@ -40,10 +40,11 @@
.Nd log systems messages
.Sh SYNOPSIS
.Nm
-.Op Fl \&dI
+.Op Fl a Ar allowed_peer
.Op Fl f Ar config_file
.Op Fl m Ar mark_interval
.Op Fl p Ar log_socket
+.Op Fl s
.Sh DESCRIPTION
The
.Nm
@@ -51,6 +52,55 @@ daemon 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
+.It Fl a Ar allowed_peer
+Allow
+.Ar allowed_peer
+to log to this
+.Nm syslogd
+using UDP datagrams. Multiple
+.Fl a
+options may be specified.
+.Pp
+.Ar Allowed_peer
+can be any of the following:
+.Bl -tag -width "ipaddr/masklen[:service]XX"
+.It Ar ipaddr/masklen Ns Op Ar :service
+Accept datagrams from
+.Ar ipaddr
+(in the usual dotted quad notation) with
+.Ar masklen
+bits being taken into account when doing the address comparision. If
+specified,
+.Ar service
+is the name or number of an UDP service (see
+.Xr services 5 ) Ns
+the source packet must belong to. A
+.Ar service
+of
+.Ql \&*
+allows packets being sent from any UDP port. The default
+.Ar service
+is
+.Ql syslog .
+A missing
+.Ar masklen
+will be substituted by the historic class A or class B netmasks if
+.Ar ipaddr
+belongs into the address range of class A or B, respectively, or
+by 24 otherwise.
+.It Ar domainname Ns Op Ar :service
+Accept datagrams where the reverse address lookup yields
+.Ar domainname
+for the sender address. The meaning of
+.Ar service
+is as explained above.
+.It Ar *domainname Ns Op Ar :service
+Same as before, except that any source host whose name
+.Em ends
+in
+.Ar domainname
+will get permission.
+.El
.It Fl d
Put
.Nm
@@ -60,8 +110,6 @@ into debugging mode. This is probably only of use to developers working on
Specify the pathname of an alternate configuration file;
the default is
.Pa /etc/syslog.conf .
-.It Fl s
-Operate in secure mode. Do not listen for log message from remote machines.
.It Fl m
Select the number of minutes between
.Dq mark
@@ -70,6 +118,8 @@ messages; the default is 20 minutes.
Specify the pathname of an alternate log socket;
the default is
.Pa /var/run/log .
+.It Fl s
+Operate in secure mode. Do not listen for log message from remote machines.
.El
.Pp
The
@@ -134,12 +184,32 @@ The
.Nm
command appeared in
.Bx 4.3 .
+.Pp
+The
+.Fl s
+and
+.Fl a
+options are
+.Fx 2.2
+extensions.
.Sh BUGS
The ability to log messages received in UDP packets is equivalent to
an unauthenticated remote disk-filling service, and should probably be
disabled by default. Some sort of
.No inter- Ns Nm syslogd
-authentication mechanism ought to be worked out.
+authentication mechanism ought to be worked out. To prevent the worst
+abuse, use of the
+.Fl a
+option is therefore highly recommended.
+.Pp
+The
+.Fl a
+matching algorithm doesn't pretend to be very efficient; use of numeric
+IP addresses is faster than domain name comparision. Since the allowed
+peer list is being walked linearly, peer groups where frequent messages
+are being anticipated from should be put early into the
+.Fl a
+list.
.Pp
The log socket was moved from
.Pa /dev
OpenPOWER on IntegriCloud