NAME¶
Clogit - log server messages in local log or in system logger
SYNOPSIS¶
#include "Clog.h"
int Cinitlog (char *cmd, char
*logfile)
int Clogit (int level, char *func,
char *msg, ...)
int Cvlogit (int level, char *func,
char *msg, va_list ap)
DESCRIPTION¶
Cinitlog initializes the server logging routines.
Clogit logs server messages in a local log or in the system logger.
Cvlogit is the same as
Clogit but takes a va_list instead of a
variable number of arguments.
- cmd
- specifies a string to be prepended to the syslog
messages.
- logfile
- specifies a path for the server log file. If set to
syslog, the system logger will be used. By default, only messages
with level at least as important as LOG_INFO will be logged. The level
threshold can be changed with the environment variable LOG_PRIORITY.
- level
- is associated with the message. The possible values, in
order of decreasing importance are:
- LOG_EMERG
- LOG_ALERT
- LOG_CRIT
- LOG_ERR
- LOG_WARNING
- LOG_NOTICE
- LOG_INFO
- LOG_DEBUG
- func
- is the name of the function that issues the message.
- msg
- is a format as in printf.
RETURN VALUE¶
These routines return 0 if the operation was successful or -1 if the operation
failed. In the latter case,
serrno is set appropriately.
ERRORS¶
- EFAULT
- logfile is a NULL pointer.
- ENAMETOOLONG
- The length of logfile exceeds
CA_MAXPATHLEN.