SYSLOG-FACILITY(8)	       Debian GNU/Linux 	    SYSLOG-FACILITY(8)



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 auto
       matically 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 doesnt 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).



Debian Project			  1998-10-13		    SYSLOG-FACILITY(8)