syslog-ng(8)

1SYSLOG-NG(8)                System Manager's Manual               SYSLOG-NG(8)
2
3
4

NAME

6       syslog-ng - logs system messages
7

SYNOPSIS

9       NOTE:  This file is not up to date. Please refer to the html documenta‐
10       tion.
11
12       syslog-ng [ -dFsvV ] [ -f <config-filename> ] [ -p <pid-filename>  ]  [
13       -C <chroot-dir> ] [ -u <user> ] [ -g <group> ]
14

DESCRIPTION

16       syslog-ng  reads  and  logs  messages to the system console, log files,
17       other machines and/or users as specified by its configuration file.
18
19       The configuration file is read at startup and is reread  after  receipt
20       of  a  hangup (HUP) signal.  When reloading the configuration file, all
21       destination files are closed and  reopened  as  appropriate.  For  more
22       information about the configuration file, see syslog-ng.conf(5).
23
24       Typically  messages  are  sent  to  syslog-ng  via a Unix domain socket
25       (/dev/log) or via UDP, to port 514 or to whatever syslog/udp is defined
26       to  be  in  /etc/services.   To  receieve  messages  from  the  kernel,
27       /dev/klog is opened for reading.
28
29       Messages sent to syslog-ng should be an entire line, prefixed by a pri‐
30       ority  code  in  between  '<' and '>'.  Definititions of the recognised
31       values can be found in the include file <sys/syslog.h>.
32
33       syslog-ng can be configured to pass messages on  to  other  syslog-ng's
34       and  when doing so, it sends the message on with the priority as a pre‐
35       fix.
36
37       It is not necessary to terminate a message with a line feed or carriage
38       return.
39
40

OPTIONS

42       -C  <directory>, --chroot=<directory>
43              Chroot to directory.
44
45       -d, --debug
46              Set  "debug mode".  Prints out various messages to aid in debug‐
47              ging and stops it from becoming a daemon.  To activate debugging
48              in the yacc parser, either use this option twice or combine with
49              -v.
50
51       -F, --foreground
52              Don't fork into background.
53
54       -f  <filename>, --cfgfile=<filename>
55              Instead of reading the normal /etc/syslog-ng/syslog-ng.conf file
56              for configuration information, use the filename given instead.
57
58       -g  <group>, --group=<group>
59              Switch to group.
60
61       -p  <filename>, --pidfile=<filename>
62              Write  the  current  PID  information  to  the  specified  file.
63              Defaults to /var/run/syslog-ng.pid.
64
65       -s, --syntax-only
66              Only read and parse the configuration file.  See also the option
67              -f.
68
69       -u  <user>, --group=<user>
70              Switch to user.
71
72       -v, --verbose
73              Enable  verbose mode.  Process will not become a daemon.  Prints
74              out fewer messages, compared to -d.
75
76       -V, --version
77              Print the version number.
78

DIAGNOSTICS

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

FILES

89       /etc/syslog-ng/syslog-ng.conf
90              Configuration  file  for  syslog-ng.   See syslog-ng.conf(5) for
91              more information.
92
93       /var/run/syslog-ng.pid
94              The file containing the process id of syslog-ng.
95

BUGS

97       If you find any, please send email to the  syslog-ng  mailing  list  at
98       syslog-ng@lists.balabit.hu
99
100
101
102                                                                  SYSLOG-NG(8)