openlog()

Open the system log

Synopsis:

#include <syslog.h>

void openlog( const char * ident, 
              int logopt, 
              int facility );

Library:

libc

Description:

The openlog() function opens the system log and provides for more specialized processing of the messages sent by syslog() and vsyslog(). The ident parameter is a string that's prepended to every message. The logopt argument is a bit field specifying logging options, and is formed by combining one or more of the following values with an OR operation:

LOG_CONS

If syslog() can't pass the message to syslogd, it attempts to write the message to the /dev/console device. The /dev/console device is usually a symlink (see the ln command) to a real device (e.g. /dev/text, /dev/con1 or /dev/ser1).

LOG_NDELAY

Open the connection to syslogd immediately. Normally the opening is delayed until the first message is logged.

LOG_PERROR

Write the message to standard error output as well to the system log.

LOG_PID

Log the process ID with each message. This is useful for identifying instantiations of daemons.

The facility parameter encodes a default facility to be assigned to all messages that don't have an explicit facility encoded. In the following list, parameter values marked with an asterisk (*) aren't used by any of the QNX 6 standard utilities.

LOG_AUTH *

The authorization system.

LOG_AUTHPRIV *

The same as LOG_AUTH, but logged to a file readable only by selected individuals.

LOG_CRON *

The clock daemon.

LOG_DAEMON

System daemons (such as ftpd) that aren't provided for explicitly by other facilities.

LOG_KERN *

Messages generated by the kernel. These can't be generated by any user processes.

LOG_LPR

The line printer spooling system.

LOG_MAIL

The mail system.

LOG_NEWS *

The network news system.

LOG_SYSLOG

Messages generated internally by syslogd.

LOG_USER*

Messages generated by random user processes. This is the default facility identifier if none is specified.

LOG_UUCP *

The uucp system.

LOG_LOCAL0 through LOG_LOCAL7 *

Reserved for local use.

Examples:

See syslog().

Classification:

Standard Unix

See also:

closelog(), setlogmask(), syslog(), vsyslog()

logger, syslogd in the Utilities reference