components/rsyslog/patches/tools-rsyslog.conf.patch
author Mike Sullivan <Mike.Sullivan@Oracle.COM>
Mon, 11 Mar 2013 10:38:09 -0700
branchs11-update
changeset 2520 ceec631e74d1
parent 847 4ae04177ffa1
permissions -rw-r--r--
Close of build 10.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
847
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     1
--- rsyslog/tools/rsyslog.conf.5	Thu Dec  1 02:26:19 2011
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     2
+++ rsyslog/tools/rsyslog.conf.5	Fri May 25 11:09:56 2012
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     3
@@ -17,27 +17,23 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     4
 .\" along with this program; if not, write to the Free Software
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     5
 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     6
 .\"
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     7
-.TH RSYSLOG.CONF 5 "11 July 2008" "Version 3.18.0" "Linux System Administration"
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     8
+.TH RSYSLOG.CONF 4 "16 May 2012" "Version 6.2.0" "File Formats"
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
     9
 .SH NAME
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    10
-rsyslog.conf \- rsyslogd(8) configuration file
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    11
+rsyslog.conf \- rsyslogd(1M) configuration file
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    12
 .SH DESCRIPTION
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    13
 The
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    14
 .I rsyslog.conf
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    15
 file is the main configuration file for the
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    16
-.BR rsyslogd (8)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    17
+.BR rsyslogd (1M)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    18
 which logs system messages on *nix systems.  This file specifies rules
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    19
 for logging.  For special features see the
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    20
-.BR rsyslogd (8)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    21
-manpage. Rsyslog.conf is backward-compatible with sysklogd's syslog.conf file. So if you migrate
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    22
-from sysklogd you can rename it and it should work.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    23
+.BR rsyslogd (1M)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    24
+manpage.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    25
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    26
-.B Note that this version of rsyslog ships with extensive documentation in html format.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    27
-This is provided in the ./doc subdirectory and probably
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    28
-in a separate package if you installed rsyslog via a packaging system.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    29
 To use rsyslog's advanced features, you
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    30
 .B need
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    31
-to look at the html documentation, because the man pages only cover
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    32
-basic aspects of operation.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    33
+to look at the online documentation at http://www.rsyslog.com/doc,
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    34
+because the man pages only cover basic aspects of operation.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    35
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    36
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    37
 .SH MODULES
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    38
@@ -184,7 +180,7 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    39
 priority and higher are logged according to the given action. Rsyslogd behaves
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    40
 the same, but has some extensions.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    41
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    42
-In addition to the above mentioned names the rsyslogd(8) understands the
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    43
+In addition to the above mentioned names the rsyslogd(1M) understands the
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    44
 following extensions: An asterisk ('*') stands for all facilities or all
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    45
 priorities, depending on where it is used (before or after the period). The
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    46
 keyword none stands for no priority of the given facility.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    47
@@ -231,10 +227,10 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    48
 .RE
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    49
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    50
 .SS Named pipes
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    51
-This version of rsyslogd(8) has support for logging output to named pipes (fifos). A fifo or 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    52
+This version of rsyslogd(1M) has support for logging output to named pipes (fifos). A fifo or 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    53
 named pipe can be used as a destination for log messages by prepending a pipe symbol ('|') 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    54
 to the name of the file. This is handy for debugging. Note that the fifo must be created with 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    55
-the mkfifo(1) command before rsyslogd(8) is started.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    56
+the mkfifo(1) command before rsyslogd(1M) is started.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    57
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    58
 .SS Terminal and console
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    59
 If the file you specified is a tty, special tty-handling is done, same with /dev/console.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    60
@@ -426,7 +422,8 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    61
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    62
 Properties can be accessed by the property replacer (see there for details).
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    63
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    64
-.B Please note that templates can also by used to generate selector lines with dynamic file names.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    65
+.B Please note
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    66
+that templates can also be used to generate selector lines with dynamic file names.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    67
 For example, if you would like to split syslog messages from different hosts 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    68
 to different files (one per host), you can define the following template:
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    69
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    70
@@ -472,7 +469,8 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    71
 that several vendors have violated the sql standard and introduced their own 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    72
 escape methods, it is impossible to have a single option doing all the work.  
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    73
 So you yourself must make sure you are using the right format.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    74
-.B If you choose the wrong one, you are still vulnerable to sql injection.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    75
+.B If you choose the wrong one,
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    76
+you are still vulnerable to sql injection.
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    77
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    78
 Please note that the database writer *checks* that the sql option is present 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    79
 in the template. If it is not present, the write database action is disabled. 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    80
@@ -758,9 +756,9 @@
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    81
 .B rsyslogd
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    82
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    83
 .SH SEE ALSO
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    84
-.BR rsyslogd (8),
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    85
+.BR rsyslogd (1M),
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    86
 .BR logger (1),
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    87
-.BR syslog (3)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    88
+.BR syslog (3C)
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    89
 
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    90
 The complete documentation can be found in the doc folder of the rsyslog distribution or online at
4ae04177ffa1 PSARC 2012/197 rsyslog
John Beck <John.Beck@Oracle.COM>
parents:
diff changeset
    91