NAME

catboks_log - log events to the Keon bridge

SYNOPSIS

#include <cat/boks.h>

int catboks_log(cat_session *sess, const catboks_loginfo *loginfo);

DESCRIPTION

This function sends a log message to Keon Security Server 4.x.

sess is the current session and loginfo is a structure containing the parameters needed for logging.

The catboks_loginfo structure is defined as follows:

  typedef struct catboks_loginfo {
        int sys;
        char *user;
        char *prog;
        char *label;
        int argc;
        char **argv;
        unsigned elscode;
        char *elsfmt;
  } catboks_loginfo;

If the sys field of loginfo is set to a non-zero value, events will be logged in the Keon Security Server 4.x system log, otherwise events will be logged in the user log.

The user parameter can be NULL.

argv[0] is the English log message format string. The other parameters in argv are the arguments to be inserted at the ``%s'' escapes in argv[0].

If elscode is non-zero, it should be set to the ELS log code for this message. If elsfmt is non-null, it should be set to the sequence of ELS control characters (those preceded by a ``&'' in the log definition file). The string may end in ``:[hu]'', where the presence of ``h'' causes the ``&H'' parameter to be taken from the local host name, and the presence of ``u'' sets the ``&L'' parameter to the user in the loginfo struct.

See catlog for more information.

RETURN VALUES

The function returns 0 if successful, or a negative code on error.

SEE ALSO

cat, catboks, catlog