NAME

catlog_mklabel - register a new label

SYNOPSIS

#include <cat/cat.h>

#include <cat/log.h>

int catlog_mklabel(const char *facility, const char *lbl, unsigned code, const char *description);

DESCRIPTION

This function registers a log label and facility label with an ELS code and a description string. The facility label can be NULL.

facility is the facility tag (see catlog).

label is the message tag (see catlog).

code is the ELS code (see catlog).

description is the ELS description string, with embedded ``&character'' sequences, where each sequence causes a single piece of information (as set with catlog_set()) to be included in the event log message. See catlog for details of ELS description strings.

This function returns CAT_OK if successful, or a negative code on error.

SEE ALSO

cat, catlog

NOTES

MT-level: Unsafe