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.