Return to syslog.3 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/syslog.3, revision 1.1.1.1

1.1       root        1: .TH SYSLOG 3 "14 November 1982"
                      2: .\"    @(#)syslog.3    1.2             11/14/82
                      3: .SH NAME
                      4: syslog, openlog, closelog \- control system log
                      5: .SH SYNOPSIS
                      6: .B "#include <syslog.h>
                      7: .PP
                      8: .B "openlog(ident, logstat)
                      9: .br
                     10: .B "char *ident;
                     11: .PP
                     12: .B "syslog(priority, message, parameters ... )
                     13: .br
                     14: .B "char *message;
                     15: .PP
                     16: .B "closelog()
                     17: .SH DESCRIPTION
                     18: .I Syslog
                     19: arranges to write the
                     20: .I message
                     21: onto the system log maintained by
                     22: .IR syslog (8).
                     23: The message is tagged with
                     24: .IR priority .
                     25: The message looks like a
                     26: .IR printf (3)
                     27: string except that
                     28: .B %m
                     29: is replaced by the current error message (collected from
                     30: .IR errno ).
                     31: A trailing newline is added if needed.
                     32: This message will be read by
                     33: .IR syslog (8)
                     34: and output to the system console or files as appropriate.
                     35: .PP
                     36: If special processing is needed,
                     37: .I openlog
                     38: can be called to initialize the log file.
                     39: Parameters are
                     40: .I ident
                     41: which is prepended to every message, and
                     42: .I logstat
                     43: which is a bit field indicating special status; current values are:
                     44: .IP LOG_PID \w'LOG_PID'u+3
                     45: log the process id with each message:
                     46: useful for identifying instantiations of daemons.
                     47: .LP
                     48: .I Openlog
                     49: returns zero on success.
                     50: If it cannot open the file
                     51: .I /dev/log,
                     52: it writes on
                     53: .I /dev/console
                     54: instead and returns \-1.
                     55: .PP
                     56: .I Closelog
                     57: can be used to close the log file.
                     58: .SH EXAMPLES
                     59: .nf
                     60: syslog(LOG_SALERT, "who: internal error 23");
                     61: 
                     62: openlog("serverftp", LOG_PID);
                     63: syslog(LOG_INFO, "Connection from host %d", CallingHost);
                     64: .fi
                     65: .SH "SEE ALSO
                     66: syslog(8)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.