Return to syslog.3 CVS log

Up to [CSRG BSD Unix] / 42BSD / usr.lib / sendmail / aux

Annotation of 42BSD/usr.lib/sendmail/aux/syslog.3, revision 1.1.1.1

1.1       root        1: .TH syslog 3
                      2: .SH NAME
                      3: syslog, openlog, closelog -- control system log
                      4: .SH SYNOPSIS
                      5: # include <syslog.h>
                      6: .PP
                      7: openlog(ident, logstat)
                      8: .br
                      9: char *ident;
                     10: .PP
                     11: syslog(priority, message, parameters ... )
                     12: .br
                     13: char *message;
                     14: .PP
                     15: closelog()
                     16: .SH DESCRIPTION
                     17: .I Syslog
                     18: writes the
                     19: .I message
                     20: to the program syslog(8)
                     21: The message is tagged with priority
                     22: .I priority.
                     23: The message looks like a
                     24: .I printf(3)
                     25: string except that
                     26: .B %m
                     27: is replaced by the current error message
                     28: (collected from
                     29: .I errno\c
                     30: ).
                     31: A trailing newline is added if needed.
                     32: This message will be read by
                     33: .I 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 a string prepended to every message,
                     42: and
                     43: .I logstat
                     44: a bit field indicating special status;
                     45: current values are:
                     46: .IP LOG_PID \w'LOG_PID'u+3
                     47: log the process id with each message:
                     48: useful for identifying instantiations of daemons.
                     49: .LP
                     50: .I Openlog
                     51: returns zero if it could create the socket.
                     52: Otherwise, it arranges to write on /dev/console
                     53: and returns -1.
                     54: Calls to
                     55: .I syslog
                     56: can still proceed,
                     57: but any message with priority under
                     58: .I LogMask (normally
                     59: .BR LOG_CRIT )
                     60: will be thrown away.
                     61: .PP
                     62: .I Closelog
                     63: can be used to close the log socket.
                     64: .SH EXAMPLES
                     65: .nf
                     66: syslog(LOG_SALERT, "who: internal error 23");
                     67: .PP
                     68: openlog("serverftp", LOG_PID);
                     69: syslog(LOG_INFO, "Connection from host %d", CallingHost);
                     70: .fi
                     71: .SH SEE\ ALSO
                     72: syslog(8)

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