unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Page:
Section:
Apropos / Subsearch:
optional field

SYSLOG-NG(8)                System Manager's Manual               SYSLOG-NG(8)



NAME
       syslog-ng - logs system messages

SYNOPSIS
       syslog-ng  [ -dFsvVy ] [ -f <config-filename> ] [ -p <pid-filename> ] [
       -C <chroot-dir> ] [ -u <user> ] [ -g <group> ]

DESCRIPTION
       syslog-ng reads and logs messages to the  system  console,  log  files,
       other machines and/or users as specified by its configuration file.

       The  configuration  file is read at startup and is reread after receipt
       of a hangup (HUP) signal.  When reloading the configuration  file,  all
       destination  files  are  closed  and  reopened as appropriate. For more
       information about the configuration file, see syslog-ng.conf(5).

       Typically messages are sent to  syslog-ng  via  a  Unix  domain  socket
       (/dev/log) or via UDP, to port 514 or to whatever syslog/udp is defined
       to be in /etc/services.  To receive messages from the kernel, /dev/klog
       is opened for reading.

       Messages sent to syslog-ng should be an entire line, prefixed by a pri-
       ority code in between '<' and '>'.   Definititions  of  the  recognised
       values can be found in the include file &lt;sys/syslog.h&gt;.

       syslog-ng  can  be  configured to pass messages on to other syslog-ng's
       and when doing so, it sends the message on with the priority as a  pre-
       fix.

       It is not necessary to terminate a message with a line feed or carriage
       return.


OPTIONS
       -C  <&lt;directory>&gt;, --chroot=<&lt;directory>&gt;
              Chroot to directory.

       -d, --debug
              Set "debug mode".  Prints out various messages to aid in  debug-
              ging and stops it from becoming a daemon.

       -y, --yydebug
              Enable  debugging  messages  in  the yacc parser, this option is
              only  present  if  syslog-ng  was  compiled  in  debugging  mode
              (--enable-debug configure option).

       -F, --foreground
              Don't fork into background.

       -f  <&lt;filename>&gt;, --cfgfile=<&lt;filename>&gt;
              Instead of reading the normal /etc/syslog-ng/syslog-ng.conf file
              for configuration information, use the filename given instead.

       -g  <&lt;group>&gt;, --group=<&lt;group>&gt;
              Switch to group.

       -p  <&lt;filename>&gt;, --pidfile=<&lt;filename>&gt;
              Write  the  current  PID  information  to  the  specified  file.
              Defaults to /var/run/syslog-ng.pid.

       -s, --syntax-only
              Only read and parse the configuration file.  See also the option
              -f.

       -u  <&lt;user>&gt;, --group=<&lt;user>&gt;
              Switch to user.

       -v, --verbose
              Enable verbose mode.  Process will not become a daemon.   Prints
              out fewer messages, compared to -d.

       -V, --version
              Print the version number.

DIAGNOSTICS
       It is expected that syslog-ng will run as root, however, if not running
       on a priviledged port of it it owned its own log directories,  etc,  it
       might run as a non-root user.

SEE ALSO
       syslog-ng.conf(5),  logger(1),  syslog(2), syslog(3), services(5), sys-
       log.conf(5), klogd(8), syslogd(8), sysklogd(8)

FILES
       /etc/syslog-ng/syslog-ng.conf
              Configuration file for  syslog-ng.   See  syslog-ng.conf(5)  for
              more information.

       /var/run/syslog-ng.pid
              The file containing the process id of syslog-ng.

BUGS
       If  you  find  any,  please send email to the syslog-ng mailing list at
       syslog-ngATlists.hu



                                                                  SYSLOG-NG(8)