syslog.pl -- Unix syslog interface

This library provides an interface to the Unix syslog() facility. The interface is an almost direct translation of the POSIX syslog API, with two additions:

• syslog/3 exploits format/3 to format syslog messages
• The library integrates into library(debug) using prolog:debug_print_hook/3, where debug topics are mapped to syslog priorities and remaining debug topics are mapped to the syslog priority debug.

Note that this interface makes no attempt to abstract over logging facilities of operating systems. We expect that such abstractions will be implemented at the Prolog level using multiple integrations into library(debug).

See also

- detach_IO/1 to detach normal I/O of the process and remove it from the process group.

- fork/1 to create a daemon process.

- library(uid) to manage user identifiers (e.g., drop root privileges).

 openlog(+Ident:atom, +Options:list(atom), +Facility:atom) is det

Open system log. This predicate provides a direct interface into the openlog() library call. If the library call is successful, it runs at_halt(closelog) to ensure closing the system log on clean exit.

Arguments:

Ident	- prepended to every message, and is typically set to the program name.
Options	- is a list of options. Values are corresponding C options, after removing =LOG_= and translation to lower case: cons, ndelay, nowait, odelay, perror, pid.
Facility	- is one of auth, authpriv, cron, daemon, ftp, kern, local0 ... local7, lpr, mail, news, syslog, user or uucp.

Undocumented predicates

The following predicates are exported, but not or incorrectly documented.

 syslog(Arg1, Arg2)

 closelog

 syslog(Arg1, Arg2, Arg3)