#include <cat/boks.h>
int catboks_log(cat_session *sess, const catboks_loginfo *loginfo);
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.