NAME

syslogd − log systems messages

SYNOPSIS

/etc/syslogd [−f configfile] [−m markinterval] [−d]

DESCRIPTION

syslogd reads and logs messages into a set of files described by the configuration file /etc/syslog.conf.  Each message is one line.  A message can contain a priority code, marked by a number in angle braces at the beginning of the line.  Priorities are defined in <syslog.h>.  syslogd reads from an Internet domain socket specified in /etc/services or from the named pipe /dev/log. 

syslogd configures when it starts up and whenever it receives a hangup signal.  Lines in the configuration file have a selector to determine the message priorities to which the line applies and an action. The action field is separated from the selector by one or more tabs. 

Selectors are semicolon separated lists of priority specifiers.  Each priority has a facility describing the part of the system that generated the message, a dot, and a level indicating the severity of the message.  Symbolic names may be used.  An asterisk selects all facilities.  All messages of the specified level or higher (greater severity) are selected.  More than one facility may be selected using commas to separate them.  For example:

∗.emerg;mail,daemon.crit

selects all facilities at the emerg level and the mail and daemon facilities at the crit level. 

Known facilities and levels recognized by syslogd are those listed in syslog(3C) converted to lowercase without the leading LOG_. The additional facility “mark” has a message at priority LOG_INFO sent to it every 20 minutes (this can be changed by using the −m flag).  The “mark” facility is not enabled by a facility field containing an asterisk.  The level “none” can be used to disable a particular facility.  For example,

∗.debug;mail.none

sends all messages except mail messages to the selected file. 

The second part of each line describes where the message is to be logged if this line is selected.  There are four forms:

• A filename (beginning with a leading slash).  The file is opened in append mode. 

• A hostname preceded by an at sign (@).  Selected messages are forwarded to the syslogd on the named host. 

• A comma separated list of users.  Selected messages are written to those users if they are logged in. 

• An asterisk.  Selected messages are written to all logged-in users. 

Blank lines and lines beginning with ‘#’ are ignored. 

For example, the configuration file:

kern,mark.debug/dev/console
∗.notice;mail.info/usr/spool/adm/syslog
∗.crit/usr/adm/critical
kern.err@ucbarpa
∗.emerg∗
∗.alerteric,kridle
∗.alert;auth.warningralph

logs all kernel messages and 20 minute marks onto the system console, all notice (or higher) level messages and all mail system messages except debug messages into the file /usr/spool/adm/syslog, and all critical messages into /usr/adm/critical.  Kernel messages of error severity or higher are forwarded to the machine ucbarpa.  In this example, all users are informed of any emergency messages, users “eric” and “kridle” are informed of any alert messages, and user “ralph” is informed of any alert message or any warning message (or higher) from the authorization system. 

Options

syslogd recognizes the following options:

−f configfile Use configfile instead of /etc/syslog.conf. 

−m markinterval Wait markinterval minutes between mark messages, instead of 20 minutes. 

−d Turn on debugging. 

syslogd creates the file /etc/syslog.pid, if possible, containing a single line with its process ID.  This can be used to kill or reconfigure syslogd. 

To bring syslogd down, it should be sent a terminate signal (e.g., /.BR "kill `cat /etc/syslog.pid`" ). 

AUTHOR

syslogd was developed by the University of California, Berkeley. 

FILES

/etc/syslog.conf configuration file

/etc/syslog.pid process ID

/dev/log named pipe syslog reads from

SEE ALSO

logger(1), syslog(3C). 

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991