Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.
@(#)syslog.3 5.1 (Berkeley) 05/15/85
@(#)syslog.3 1.2 11/14/82
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.
@(#)syslog.3 5.1 (Berkeley) 05/15/85
@(#)syslog.3 1.2 11/14/82
SYSLOG 3 "14 November 1982"
C 5 NAME
syslog, openlog, closelog - control system log
SYNOPSIS
"#include <syslog.h> "openlog(ident, logstat)
"char *ident;
"syslog(priority, message, parameters ... )
"char *message;
"closelog()
DESCRIPTION
Syslog arranges to write the
message onto the system log maintained by
syslog (8). The message is tagged with
priority . The message looks like a
printf (3) string except that
%m is replaced by the current error message (collected from
errno ). A trailing newline is added if needed.
This message will be read by
syslog (8) and output to the system console or files as appropriate.
If special processing is needed, openlog can be called to initialize the log file. Parameters are ident which is prepended to every message, and logstat which is a bit field indicating special status; current values are:
LOG_PID \w'LOG_PID'u+3
log the process id with each message:
useful for identifying instantiations of daemons.
Openlog returns zero on success. If it cannot open the file /dev/log, it writes on /dev/console instead and returns -1.
Closelog can be used to close the log file.
EXAMPLES
syslog(LOG_SALERT, "who: internal error 23"); openlog("serverftp", LOG_PID); syslog(LOG_INFO, "Connection from host %d", CallingHost);
"SEE ALSO
syslog(8)