Poster of Linux kernelThe best gift for a Linux geek
SYSLOG-FACILITY

SYSLOG-FACILITY

Section: Debian GNU/Linux (8) Updated: 2010-10-25
Local index Up
 

NAME

syslog-facility - Setup and remove LOCALx facility for sysklogd  

SYNOPSIS

syslog-facility set set_of_priority log_file ...

syslog-facility remove facility  

DESCRIPTION

syslog-facility can be used to setup a syslog facility and to remove it. The primary use of this perl script is to allow packages to automatically setup (and remove) a LOCALx facility. With the first argument beeing set, it will output a string containing the first free LOCALx facility that has been assigned to your request :

  # syslog-facility set all /var/log/sympa
  local0

This does mean that a line ``local0.*  /var/log/sympa'' has been
added to the syslog.conf file. If no free LOCALx facility has been found, then it outputs ``none'' (with a end of line).

You can use different set of priorities (most of what syslogd supports) :

  # syslog-facility set 'all;!=debug;' /var/log/sympa '=debug' /var/log/sympa-d
  local1

Pay particular attention to shell escapes since ';','!' have special meanings for them. The syntax is similar to syslog.conf except that '*' must be replaced by 'all'.

In that case you will have two lines added two the syslog.conf file :

  local1.*;local1.!=debug       /var/log/sympa
  local1.=debug                 /var/log/sympa-d

If the first argument is remove, then it will remove all references to a precise LOCALx facility. Example :

  # syslog-facility remove local1

It will remove all references to the local1 facility.  

BUGS

The script doesn't know about multi-lines configuration (ie with '\').

With a line like that ``mail,local0.* /anything'', ``syslog-facility remove local0'' would remove the entire line. It should not be a problem since lines installed by this script cannot use this syntax.  

SEE ALSO

syslog.conf(5), sysklogd(8).


 

Index

NAME
SYNOPSIS
DESCRIPTION
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:02:28 GMT, April 16, 2011