xref: /csrg-svn/usr.sbin/syslogd/syslogd.8 (revision 61883)
1*61883Sbostic.\" Copyright (c) 1983, 1986, 1991, 1993
2*61883Sbostic.\"	The Regents of the University of California.  All rights reserved.
319028Smckusick.\"
443845Strent.\" %sccs.include.redist.man%
535579Sbostic.\"
6*61883Sbostic.\"     @(#)syslogd.8	8.1 (Berkeley) 06/06/93
735579Sbostic.\"
847470Scael.Dd
947470Scael.Dt SYSLOGD 8
1047470Scael.Os BSD 4.2
1147470Scael.Sh NAME
1247470Scael.Nm syslogd
1347470Scael.Nd log systems messages
1447470Scael.Sh SYNOPSIS
1547470Scael.Nm syslogd
1647470Scael.Op Fl f Ar config_file
1747470Scael.Op Fl m Ar mark_interval
1847470Scael.Op Fl p Ar log_socket
1947470Scael.Sh DESCRIPTION
2047470Scael.Nm Syslogd
2145276Sbosticreads and logs messages to the system console, log files, other
2245276Sbosticmachines and/or users as specified by its configuration file.
2345276SbosticThe options are as follows:
2447470Scael.Bl -tag -width Ds
2547470Scael.It Fl f
2645276SbosticSpecify the pathname of an alternate configuration file;
2747470Scaelthe default is
2847470Scael.Pa /etc/syslog.conf .
2947470Scael.It Fl m
3045276SbosticSelect the number of minutes between ``mark'' messages;
3145276Sbosticthe default is 20 minutes.
3247470Scael.It Fl p
3345276SbosticSpecify the pathname of an alternate log socket;
3447470Scaelthe default is
3547470Scael.Pa /dev/log .
3647470Scael.El
3747470Scael.Pp
3847470Scael.Nm Syslogd
3945276Sbosticreads its configuration file when it starts up and whenever it
4045276Sbosticreceives a hangup signal.
4145276SbosticFor information on the format of the configuration file,
4245276Sbosticsee
4347470Scael.Xr syslog.conf 5 .
4447470Scael.Pp
4547470Scael.Nm Syslogd
4647470Scaelreads messages from the
4747470Scael.Tn UNIX
4847470Scaeldomain socket
4947470Scael.Pa /dev/log ,
5047470Scaelfrom an Internet domain socket specified in
5147470Scael.Pa /etc/services ,
5247470Scaeland from the special device
5347470Scael.Pa /dev/klog
5447470Scael(to read kernel messages).
5547470Scael.Pp
5647470Scael.Nm Syslogd
5747470Scaelcreates the file
5847470Scael.Pa /var/run/syslog.pid ,
5947470Scaeland stores its process
6045276Sbosticid there.
6119029SmckusickThis can be used to kill or reconfigure
6247470Scael.Nm syslogd .
6347470Scael.Pp
6445276SbosticThe message sent to
6547470Scael.Nm syslogd
6645276Sbosticshould consist of a single line.
6745276SbosticThe message can contain a priority code, which should be a preceding
6847470Scaeldecimal number in angle braces, for example,
6947470Scael.Sq Aq 5.
7045276SbosticThis priority code should map into the priorities defined in the
7147470Scaelinclude file
7247470Scael.Aq Pa sys/syslog.h .
7347470Scael.Sh FILES
7447470Scael.Bl -tag -width /var/run/syslog.pid -compact
7547470Scael.It Pa /etc/syslog.conf
7647470ScaelThe configuration file.
7747470Scael.It Pa /var/run/syslog.pid
7847470ScaelThe process id of current
7947470Scael.Nm syslogd .
8047470Scael.It Pa /dev/log
8147470ScaelName of the
8247470Scael.Tn UNIX
8347470Scaeldomain datagram log socket.
8447470Scael.It Pa /dev/klog
8547470ScaelThe kernel log device.
8647470Scael.El
8747470Scael.Sh SEE ALSO
8847470Scael.Xr logger 1 ,
8947470Scael.Xr syslog 3 ,
9047470Scael.Xr services 5 ,
9147470Scael.Xr syslog.conf 5
9247470Scael.Sh HISTORY
9347470ScaelThe
9447470Scael.Nm
9547470Scaelcommand appeared in
9647470Scael.Bx 4.3 .
97