Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LIBXO(3)		 BSD Library Functions Manual		      LIBXO(3)

NAME
     xo_syslog,	xo_vsyslog, xo_open_log, xo_close_log, xo_set_logmask -- cre-
     ate SYSLOG	(RFC5424) log records using libxo formatting

LIBRARY
     library "libxo"

SYNOPSIS
     #include <libxo/xo.h>

     void
     xo_syslog(int pri,	const char *name, const	char *fmt, ...);

     void
     xo_vsyslog(int pri, const char *name, const char *fmt, va_list vap);

     void
     xo_close_log(void);

     void
     xo_open_log(const char *ident, int	logstat, int logfac);

     int
     xo_set_logmask(int	pmask);

DESCRIPTION
     The xo_syslog() function creates log entries following the	standard de-
     fined in RFC5424.	These messages are sent	to the log syslogd(8) daemon,
     where they	can be filtered, forwarded, and	archived.  libxo format
     strings are used to create	both the message text and the SD-PARAMS	con-
     tent, containing name/value pairs that can	be parsed by suitable automa-
     tion software.

     Refer to xo_format(5) for basic information about formatting strings.
     xo_syslog encodes all value fields	at SD-PARAMS within the	syslog mes-
     sage.  An exception is made for fields with the "{d:}" modifier; such
     fields appear in the message text only, with fields with the "{e:}" modi-
     fier appear as SD-PARAMS, but not in the message text.

     xo_vsyslog() accepts a va_list for	additional flexibility.

     xo_open_log(), xo_close_log(), and	xo_set_logmask() are all analogous to
     their libs	counterparts, openlog(3), closelog(3), and setlogmask(3).  The
     extra underscores in the names are	unfortunate, but keep consistency in
     libxo function names.

EXAMPLES
	       xo_syslog(LOG_LOCAL4 | LOG_NOTICE, "ID47",
			 "{e:iut/%u}An {:event-source} {:event-id/%u} log entry",
			 iut, source, id);

SEE ALSO
     xo_syslog(3), xo_set_syslog_enterprise_id(3), xo_format(5), libxo(3)

HISTORY
     The libxo library first appeared in FreeBSD 11.0.

AUTHORS
     libxo was written by Phil Shafer <phil@freebsd.org>.

BSD				 July 20, 2015				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xo_syslog&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help