NAME¶
syslogd
—
log systems messages
SYNOPSIS¶
syslogd |
[ -V ]
[-a
socket ]
[-d ]
[-f
config_file ]
[-h ]
[-l
host_list ]
[-m
mark_interval ]
[-n ]
[-p
log_socket ]
[-r ]
[-s
domain_list ]
[--no-klog ]
[--no-unixaf ]
[--no-forward ] |
DESCRIPTION¶
Syslogd
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:
-V
- Print version number and exit.
--help
- Display help information and exit.
-d
- Enter debug mode. syslogd does not put itself in the background, does not
fork and shows debug information.
-a
- Specify additional sockets from that syslogd has to listen to. This is
needed if you are going to let some daemon run within a chroot()'ed
environment. You can specify up to 19 additional sockets.
- -f, --rcfile=FILE
- Specify the pathname of an alternate configuration file; the default is
system specific and displayed in the help output.
- --rcdir=DIR
- Specify the pathname of an alternate configuration directory; the default
is system specific and displayed in the help output.
- -h, --hop
- Enable forwarding remote messages. By default syslogd will not forward
messages it receives from remote hosts.
-l
- A colon-seperated lists of hosts which should be considered local; they
are logged by their hostnames instead by their FQDN.
- -m, --mark=INTERVAL/fP
- Select the number of minutes between ``mark'' messages; the
default is 20 minutes. Setting it to 0 disables timestamps.
- -n, --no-detach
- Suppress backgrounding and detachment of the daemon from its controlling
terminal.
- -p, --socket=PATH
- Specify the pathname of an alternate log socket. The default is
systemspecific and displayed in the help output.
- -r, --inet
- Enable to receive remote messages using an internet domain socket. The
default is to not receive any messages from the network. Older version
always accepted remote messages.
-s
- A colon-seperated list of domainnames which should be stripped from the
FQDNs of hosts when logging.
--no-klog
- Do not listen to the kernel log device. This is only supported on systems
which define a kernel log device, on all others this is already the
default, and the option will be silently ignored.
--no-unixaf
- Do not listen to any unix domain socket. This option overrides -p and
-a.
--no-forward
- Do not forward any messages. This overrides -h.
Syslogd
reads its configuration file when it
starts up and whenever it receives a hangup signal. For information on the
format of the configuration file, see
syslog.conf(5).
Syslogd
reads messages from the UNIX domain
socket
/dev/log, from an Internet domain
socket specified in
/etc/services, and from
the one of the special devices
/dev/klog or
/proc/kmsg depending on the system (to read
kernel messages). In a GNU/Linux system it will not parse the System.map and
use it to annotate the kernel messages.
Syslogd
creates the file
/var/run/syslog.pid, and stores its process
id there. This can be used to kill or reconfigure
syslogd
.
The message sent to
syslogd
should consist of
a single line. The message can contain a priority code, which should be a
preceding decimal number in angle braces, for example,
‘⟨5.⟩’ This priority code should map into the
priorities defined in the include file
⟨
sys/syslog.h⟩.
FILES¶
- /etc/syslog.conf
- The configuration file.
- /var/run/syslog.pid
- The process id of current
syslogd
.
- /dev/log
- Name of the UNIX domain datagram log socket.
- /dev/klog, /proc/kmsg
- The kernel log device.
SEE ALSO¶
logger(1),
syslog(3),
services(5),
syslog.conf(5)
HISTORY¶
The
syslogd
command appeared in
4.3BSD.