xref: /original-bsd/usr.sbin/syslogd/syslogd.8 (revision c3e32dec)
1.\" Copyright (c) 1983, 1986, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)syslogd.8	8.1 (Berkeley) 06/06/93
7.\"
8.Dd
9.Dt SYSLOGD 8
10.Os BSD 4.2
11.Sh NAME
12.Nm syslogd
13.Nd log systems messages
14.Sh SYNOPSIS
15.Nm syslogd
16.Op Fl f Ar config_file
17.Op Fl m Ar mark_interval
18.Op Fl p Ar log_socket
19.Sh DESCRIPTION
20.Nm Syslogd
21reads and logs messages to the system console, log files, other
22machines and/or users as specified by its configuration file.
23The options are as follows:
24.Bl -tag -width Ds
25.It Fl f
26Specify the pathname of an alternate configuration file;
27the default is
28.Pa /etc/syslog.conf .
29.It Fl m
30Select the number of minutes between ``mark'' messages;
31the default is 20 minutes.
32.It Fl p
33Specify the pathname of an alternate log socket;
34the default is
35.Pa /dev/log .
36.El
37.Pp
38.Nm Syslogd
39reads its configuration file when it starts up and whenever it
40receives a hangup signal.
41For information on the format of the configuration file,
42see
43.Xr syslog.conf 5 .
44.Pp
45.Nm Syslogd
46reads messages from the
47.Tn UNIX
48domain socket
49.Pa /dev/log ,
50from an Internet domain socket specified in
51.Pa /etc/services ,
52and from the special device
53.Pa /dev/klog
54(to read kernel messages).
55.Pp
56.Nm Syslogd
57creates the file
58.Pa /var/run/syslog.pid ,
59and stores its process
60id there.
61This can be used to kill or reconfigure
62.Nm syslogd .
63.Pp
64The message sent to
65.Nm syslogd
66should consist of a single line.
67The message can contain a priority code, which should be a preceding
68decimal number in angle braces, for example,
69.Sq Aq 5.
70This priority code should map into the priorities defined in the
71include file
72.Aq Pa sys/syslog.h .
73.Sh FILES
74.Bl -tag -width /var/run/syslog.pid -compact
75.It Pa /etc/syslog.conf
76The configuration file.
77.It Pa /var/run/syslog.pid
78The process id of current
79.Nm syslogd .
80.It Pa /dev/log
81Name of the
82.Tn UNIX
83domain datagram log socket.
84.It Pa /dev/klog
85The kernel log device.
86.El
87.Sh SEE ALSO
88.Xr logger 1 ,
89.Xr syslog 3 ,
90.Xr services 5 ,
91.Xr syslog.conf 5
92.Sh HISTORY
93The
94.Nm
95command appeared in
96.Bx 4.3 .
97