Permalink
Browse files

Remove the manual pages, to make the sources DFSG-free.

The manual pages are under a non-DFSG-free license, and are generated
from DocBook, of which we do not have the sources for. Therefore,
remove the man pages from the source, to make it DFSG-free.
  • Loading branch information...
1 parent 3a736e6 commit fc3ffc21cf09f977b3dff628a6d3ae951b9beb71 @algernon committed Sep 8, 2011
Showing with 1 addition and 1,291 deletions.
  1. +0 −5 configure.in
  2. +1 −2 doc/Makefile.am
  3. +0 −186 doc/man/loggen.1.in
  4. +0 −312 doc/man/pdbtool.1.in
  5. +0 −224 doc/man/syslog-ng-ctl.1.in
  6. +0 −192 doc/man/syslog-ng.8.in
  7. +0 −370 doc/man/syslog-ng.conf.5.in
View
5 configure.in
@@ -1139,11 +1139,6 @@ AC_OUTPUT(dist.conf
scripts/Makefile
scripts/update-patterndb
doc/Makefile
- doc/man/loggen.1
- doc/man/pdbtool.1
- doc/man/syslog-ng.8
- doc/man/syslog-ng.conf.5
- doc/man/syslog-ng-ctl.1
contrib/Makefile
scl/Makefile
tests/Makefile
View
3 doc/Makefile.am
@@ -1,11 +1,10 @@
-EXTRA_DIST = man/syslog-ng.8.in man/syslog-ng.conf.5.in man/pdbtool.1.in man/loggen.1.in man/syslog-ng-ctl.1.in \
+EXTRA_DIST = \
security/bof-2002-09-27.txt \
security/dos-2000-11-22.txt \
xsd/patterndb-1.xsd \
xsd/patterndb-2.xsd \
xsd/patterndb-3.xsd
-man_MANS = man/syslog-ng.8 man/syslog-ng.conf.5 man/pdbtool.1 man/loggen.1 man/syslog-ng-ctl.1
xsddir = $(datadir)/xsd
xsd_DATA = xsd/patterndb-1.xsd xsd/patterndb-2.xsd xsd/patterndb-3.xsd
View
186 doc/man/loggen.1.in
@@ -1,186 +0,0 @@
-'\" t
-.\" Title: loggen
-.\" Author: [see the "Author" section]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\" Date: 06/30/2010
-.\" Manual: The loggen manual page
-.\" Source: syslog-ng 3.2
-.\" Language: English
-.\"
-.TH "LOGGEN" "1" "06/30/2010" "syslog\-ng" "The loggen manual page"
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-loggen \- Generate syslog messages at a specified rate
-.SH "SYNOPSIS"
-.HP \w'\fBloggen\fR\fBtarget\fR\ 'u
-\fBloggen\fR [options]\fBtarget\fR [port]
-.SH "DESCRIPTION"
-.PP
-NOTE: The loggen application is distributed with the syslog\-ng system logging application, and is usually part of the syslog\-ng package\&. The latest version of the syslog\-ng application is available at the
-\m[blue]\fBofficial syslog\-ng website\fR\m[]\&\s-2\u[1]\d\s+2\&.
-.PP
-This manual page is only an abstract; for the complete documentation of syslog\-ng, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2\&.
-.PP
-The loggen application is tool to test and stress\-test your syslog server and the connection to the server\&. It can send syslog messages to the server at a specified rate, using a number of connection types and protocols\&.
-.SH "OPTIONS"
-.PP
-\fB\-\-csv\fR or \fB\-C\fR
-.RS 4
-Send statistics of the sent messages to stdout as CSV\&. This can be used for plotting the message rate\&.
-.RE
-.PP
-\fB\-\-dgram\fR or \fB\-D\fR
-.RS 4
-Use datagram socket (UDP or unix\-dgram) to send the messages to the target\&.
-.RE
-.PP
-\fB\-\-help\fR or \fB\-h\fR
-.RS 4
-Display a brief help message\&.
-.RE
-.PP
-\fB\-\-inet\fR or \fB\-i\fR
-.RS 4
-Use the TCP (by default) or UDP (when used together with the \-\-dgram option) protocol to send the messages to the target\&.
-.RE
-.PP
-\fB\-\-interval <seconds>\fR or \fB\-I <seconds>\fR
-.RS 4
-The number of seconds loggen will run\&. Default value: 10
-.RE
-.PP
-\fB\-\-no\-framing\fR or \fB\-F\fR
-.RS 4
-Do not use the framing of the IETF\-syslog protocol style, even if the
-\fIsyslog\-proto\fR
-option is set\&.
-.RE
-.PP
-\fB\-\-rate <message/second>\fR or \fB\-r <message/second>\fR
-.RS 4
-The number of messages generated per second\&. Default value: 1000
-.RE
-.PP
-\fB\-\-read\-file\fR or \fB\-R\fR
-.RS 4
-Read the messages from a file and send them to the target\&. See also the
-\fI\-\-skip\-tokens\fR
-option\&.
-.RE
-.PP
-\fB\-\-size\fR or \fB\-s\fR
-.RS 4
-The size of a syslog message in bytes\&. Default value: 256
-.RE
-.PP
-\fB\-\-skip\-tokens\fR
-.RS 4
-Skip the specified number of space\-separated tokens (words) at the beginning of every line\&. For example, if the messages in the file look like
-\fIfoo bar message\fR,
-\fI\-\-skip\-tokens 2\fR
-skips the
-\fIfoo bar\fR
-part of the line, and sends only the
-\fImessage\fR
-part\&. Works only when used together with the
-\fI\-\-read\-file\fR
-parameter\&.
-.RE
-.PP
-\fB\-\-stream\fR or \fB\-S\fR
-.RS 4
-Use a stream socket (TCP or unix\-stream) to send the messages to the target\&.
-.RE
-.PP
-\fB\-\-syslog\-proto\fR or \fB\-P\fR
-.RS 4
-Use the new IETF\-syslog message format as specified in RFC5424\&. By default, loggen uses the legacy BSD\-syslog message format (as described in RFC3164)\&. See also the
-\fI\-\-no\-framing\fR
-option\&.
-.RE
-.PP
-\fB\-\-unix\fR or \fB\-x\fR
-.RS 4
-Use a UNIX domain socket to send the messages to the target\&.
-.RE
-.PP
-\fB\-\-use\-ssl\fR or \fB\-U\fR
-.RS 4
-Use an SSL\-encrypted channel to send the messages to the target\&. Note that it is not possible to check the certificate of the target, or to perform mutual authentication\&.
-.RE
-.PP
-\fB\-\-verbose\fR or \fB\-V\fR
-.RS 4
-Display the actual speed of sending messages in messages/second\&.
-.RE
-.SH "EXAMPLE"
-.PP
-The following command generates 100 messages per second for ten minutes, and sends them to port 2010 of the localhost via TCP\&. Each message is 300 bytes long\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-loggen \-\-size 300 \-\-rate 100 \-\-interval 600 127\&.0\&.0\&.1 2010
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-The following command is similar to the one above, but uses the UDP protocol\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-loggen \-\-inet \-\-dgram \-\-size 300 \-\-rate 100 \-\-interval 600 127\&.0\&.0\&.1 2010
-.fi
-.if n \{\
-.RE
-.\}
-
-.SH "SEE ALSO"
-.PP
-
-\fBsyslog\-ng\&.conf\fR(5)
-.PP
-
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2
-.PP
-If you experience any problems or need help with loggen or syslog\-ng, visit the
-\m[blue]\fBsyslog\-ng mailing list\fR\m[]\&\s-2\u[3]\d\s+2
-.SH "AUTHOR"
-.PP
-This manual page was written by the BalaBit Documentation Team <documentation@balabit\&.com>\&.
-.SH "COPYRIGHT"
-.PP
-Copyright \(co 2000\-2009 BalaBit IT Security Ltd\&. Published under the Creative Commons Attribution\-Noncommercial\-No Derivative Works (by\-nc\-nd) 3\&.0 license\&. See
-\m[blue]\fBhttp://creativecommons\&.org/\fR\m[]
-for details\&. The latest version is always available at
-\m[blue]\fBhttp://www\&.balabit\&.com/support/documentation\fR\m[]\&.
-.SH "NOTES"
-.IP " 1." 4
-official syslog-ng website
-.RS 4
-\%http://www.balabit.com/network-security/syslog-ng/
-.RE
-.IP " 2." 4
-The syslog-ng Administrator Guide
-.RS 4
-\%http://www.balabit.com/support/documentation/
-.RE
-.IP " 3." 4
-syslog-ng mailing list
-.RS 4
-\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
-.RE
View
312 doc/man/pdbtool.1.in
@@ -1,312 +0,0 @@
-'\" t
-.\" Title: pdbtool
-.\" Author: [see the "Author" section]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\" Date: 06/30/2010
-.\" Manual: The pdbtool manual page
-.\" Source: syslog-ng 3.2
-.\" Language: English
-.\"
-.TH "PDBTOOL" "1" "06/30/2010" "syslog\-ng" "The pdbtool manual page"
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-pdbtool \- An application to test and convert syslog\-ng pattern database rules
-.SH "SYNOPSIS"
-.HP \w'\fBpdbtool\fR\ 'u
-\fBpdbtool\fR [command] [options]
-.SH "DESCRIPTION"
-.PP
-This manual page is only an abstract; for the complete documentation of syslog\-ng and pdbtool, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
-.PP
-The syslog\-ng application can match the contents of the log messages to a database of predefined message patterns (also called patterndb)\&. By comparing the messages to the known patterns, syslog\-ng is able to identify the exact type of the messages, tag the messages, and sort them into message classes\&. The message classes can be used to classify the type of the event described in the log message\&. The functionality of the pattern database is similar to that of the logcheck project, but the syslog\-ng approach is faster, scales better, and is much easier to maintain compared to the regular expressions of logcheck\&.
-.PP
-The
-\fBpdbtool\fR
-application is a utility that can be used to:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-test message patterns;
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-convert an older pattern database to the latest database format;
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-merge pattern databases into a single file;
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-dump the RADIX tree built from the pattern database (or a part of it) to explore how the pattern matching works\&.
-.RE
-.SH "THE MATCH COMMAND"
-.HP \w'\fBmatch\fR\ 'u
-\fBmatch\fR [options]
-.PP
-Use the
-\fBmatch\fR
-command to test the rules in a pattern database\&. The command tries to match the specified message against the patterns of the database, evaluates the parsers of the pattern, and also displays which part of the message was parsed successfully\&. The command returns with a
-\fI0\fR
-(success) or
-\fI1\fR
-(no match) return code and displays the following information:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-the class assigned to the message (e\&.g\&., system, violation, etc\&.),
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-the ID of the rule that matched the message, and
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-the values of the parsers (if there were parsers in the matching pattern)\&.
-.RE
-.PP
-The
-\fBmatch\fR
-command has the following options:
-.PP
-\fB\-\-color\-out \fR or \fB\-c\fR
-.RS 4
-Color the terminal output to highlight the part of the message that was successfully parsed\&.
-.RE
-.PP
-\fB\-\-debug\-pattern\fR or \fB\-D\fR
-.RS 4
-Print debugging information about the pattern matching\&.
-.RE
-.PP
-\fB\-\-message\fR or \fB\-M\fR
-.RS 4
-The text of the log message to match (only the
-\fI$MESSAGE\fR
-part without the syslog headers)\&.
-.RE
-.PP
-\fB\-\-pdb\fR or \fB\-p\fR
-.RS 4
-Name of the pattern database file to use\&.
-.RE
-.PP
-\fB\-\-program\fR or \fB\-P\fR
-.RS 4
-Name of the program to use, as contained in the
-\fI$PROGRAM\fR
-part of the syslog message\&.
-.RE
-.PP
-Example:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-pdbtool match \-p patterndb\&.xml \-P sshd \-M "Accepted publickey for myuser from 127\&.0\&.0\&.1 port 59357 ssh2"
-.fi
-.if n \{\
-.RE
-.\}
-.SH "THE MERGE COMMAND"
-.HP \w'\fBmerge\fR\ 'u
-\fBmerge\fR [options]
-.PP
-Use the
-\fBmerge\fR
-command to combine separate pattern database files into a single file (pattern databases are usually stored in separate files per applications to simplify maintenance)\&. If a file uses an older database format, it is automatically updated to the latest format (V3)\&. See the
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[1]\d\s+2
-for details on the different pattern database versions\&.
-.PP
-\fB\-\-directory\fR or \fB\-D\fR
-.RS 4
-The directory that contains the pattern database XML files to be merged\&.
-.RE
-.PP
-\fB\-\-pdb\fR or \fB\-p\fR
-.RS 4
-Name of the output pattern database file\&.
-.RE
-.PP
-Example:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-pdbtool merge \-\-directory /home/me/mypatterns/ \-\-pdb /var/lib/syslog\-ng/patterndb\&.xml
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-
-Currently it is not possible to convert a file without merging, so if you only want to convert an older pattern database file to the latest format, you have to copy it into an empty directory\&.
-.SH "THE DUMP COMMAND"
-.HP \w'\fBdump\fR\ 'u
-\fBdump\fR [options]
-.PP
-Display the RADIX tree built from the patterns\&. This shows how are the patterns represented in syslog\-ng and it might also help to track down pattern\-matching problems\&. The dump utility can dump the tree used for matching the PROGRAM or the MSG parts\&.
-.PP
-\fB\-\-pdb\fR or \fB\-p\fR
-.RS 4
-Name of the pattern database file to use\&.
-.RE
-.PP
-\fB\-\-program\fR or \fB\-P\fR
-.RS 4
-Displays the RADIX tree built from the patterns belonging to the
-\fI$PROGRAM\fR
-application\&.
-.RE
-.PP
-\fB\-\-program\-tree\fR or \fB\-T\fR
-.RS 4
-Display the
-\fI$PROGRAM\fR
-tree\&.
-.RE
-.PP
-Example and sample output:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-pdbtool dump \-p patterndb\&.xml \-P \'sshd\'
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\'p\'
- \'assword for\'
- @QSTRING:@
- \'from\'
- @QSTRING:@
- \'port \'
- @NUMBER:@ rule_id=\'fc49054e\-75fd\-11dd\-9bba\-001e6806451b\'
- \' ssh\' rule_id=\'fc55cf86\-75fd\-11dd\-9bba\-001e6806451b\'
- \'2\' rule_id=\'fc4b7982\-75fd\-11dd\-9bba\-001e6806451b\'
- \'ublickey for\'
- @QSTRING:@
- \'from\'
- @QSTRING:@
- \'port \'
- @NUMBER:@ rule_id=\'fc4d377c\-75fd\-11dd\-9bba\-001e6806451b\'
- \' ssh\' rule_id=\'fc5441ac\-75fd\-11dd\-9bba\-001e6806451b\'
- \'2\' rule_id=\'fc44a9fe\-75fd\-11dd\-9bba\-001e6806451b\'
-
-.fi
-.if n \{\
-.RE
-.\}
-.SH "FILES"
-.PP
-
-@expanded_sysconfdir@/syslog\-ng\&.conf
-.SH "SEE ALSO"
-.PP
-
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[1]\d\s+2
-.PP
-
-\fBsyslog\-ng\&.conf\fR(5)
-.PP
-
-\fBsyslog\-ng\fR(8)
-.PP
-If you experience any problems or need help with syslog\-ng, visit the
-\m[blue]\fBsyslog\-ng mailing list\fR\m[]\&\s-2\u[2]\d\s+2
-.PP
-For news and notifications about the documentation of syslog\-ng, visit the
-\m[blue]\fBBalaBit Documentation Blog\fR\m[]\&\s-2\u[3]\d\s+2\&.
-.SH "AUTHOR"
-.PP
-This manual page was written by the BalaBit Documentation Team <documentation@balabit\&.com>\&.
-.SH "COPYRIGHT"
-.PP
-Copyright \(co 2000\-2009 BalaBit IT Security Ltd\&. Published under the Creative Commons Attribution\-Noncommercial\-No Derivative Works (by\-nc\-nd) 3\&.0 license\&. See
-\m[blue]\fBhttp://creativecommons\&.org/\fR\m[]
-for details\&. The latest version is always available at
-\m[blue]\fBhttp://www\&.balabit\&.com/support/documentation\fR\m[]\&.
-.SH "NOTES"
-.IP " 1." 4
-The syslog-ng Administrator Guide
-.RS 4
-\%http://www.balabit.com/support/documentation/
-.RE
-.IP " 2." 4
-syslog-ng mailing list
-.RS 4
-\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
-.RE
-.IP " 3." 4
-BalaBit Documentation Blog
-.RS 4
-\%http://robert.blogs.balabit.com
-.RE
View
224 doc/man/syslog-ng-ctl.1.in
@@ -1,224 +0,0 @@
-'\" t
-.\" Title: syslog-ng-ctl
-.\" Author: [see the "Author" section]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\" Date: 06/30/2010
-.\" Manual: The logstore tool manual page
-.\" Source: syslog-ng 3.2
-.\" Language: English
-.\"
-.TH "SYSLOG\-NG\-CTL" "1" "06/30/2010" "syslog\-ng" "The syslog\-ng\-ctl page"
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-syslog-ng-ctl \- Display message statistics and enable verbose, debug and trace modes in syslog\-ng
-.SH "SYNOPSIS"
-.HP \w'\fBsyslog\-ng\-ctl\fR\ 'u
-\fBsyslog\-ng\-ctl\fR [command] [options]
-.SH "DESCRIPTION"
-.PP
-NOTE: The syslog\-ng\-ctl application is distributed with the syslog\-ng system logging application, and is usually part of the syslog\-ng package\&. The latest version of the syslog\-ng application is available at the
-\m[blue]\fBofficial syslog\-ng website\fR\m[]\&\s-2\u[1]\d\s+2\&.
-.PP
-This manual page is only an abstract; for the complete documentation of syslog\-ng, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2\&.
-.PP
-The
-\fBsyslog\-ng\-ctl\fR
-application is a utility that can be used to:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-enable/disable various syslog\-ng messages for troubleshooting;
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-display statistics about the processed messages\&.
-.RE
-.SH "ENABLING TROUBLESHOOTING MESSAGES"
-.HP \w'\fBcommand\fR\ 'u
-\fBcommand\fR [options]
-.PP
-Use the
-\fBsyslog\-ng\-ctl <command> \-\-set=on\fR
-command to display verbose, trace, or debug messages\&. If you are trying to solve configuration problems, the debug (and occassionally trace) messages are usually sufficient; debug messages are needed mostly for finding software errors\&. After solving the problem, do not forget to turn these messages off using the
-\fBsyslog\-ng\-ctl <command> \-\-set=off\fR\&. Note that enabling debug messages does not enable verbose and trace messages\&.
-.PP
-Use
-\fBsyslog\-ng\-ctl <command>\fR
-without any parameters to display whether the particular type of messages are enabled or not\&.
-.PP
-If you need to use a non\-standard control socket to access syslog\-ng, use the
-\fBsyslog\-ng\-ctl <command> \-\-set=on \-\-control=<socket>\fR
-command to specify the socket to use\&.
-.PP
-\fBverbose\fR
-.RS 4
-Print verbose messages\&. If syslog\-ng was started with the
-\fI\-\-stderr\fR
-or
-\fI\-e\fR
-option, the messages will be sent to stderr\&. If not specified, syslog\-ng will log such messages to its internal source\&.
-.RE
-.PP
-\fBtrace\fR
-.RS 4
-Print trace messages of how messages are processed\&. If syslog\-ng was started with the
-\fI\-\-stderr\fR
-or
-\fI\-e\fR
-option, the messages will be sent to stderr\&. If not specified, syslog\-ng will log such messages to its internal source\&.
-.RE
-.PP
-\fBdebug\fR
-.RS 4
-Print debug messages\&. If syslog\-ng was started with the
-\fI\-\-stderr\fR
-or
-\fI\-e\fR
-option, the messages will be sent to stderr\&. If not specified, syslog\-ng will log such messages to its internal source\&.
-.RE
-.PP
-Example:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-syslog\-ng\-ctl verbose \-\-set=on
-.fi
-.if n \{\
-.RE
-.\}
-.SH "THE STATS COMMAND"
-.HP \w'\fBstats\fR\ 'u
-\fBstats\fR [options]
-.PP
-Use the
-\fBvalidate\fR
-command to validate the signatures and timestamps of a logstore file\&. The
-\fBvalidate\fR
-command has the following options:
-.PP
-\fB\-\-control=<socket>\fR or \fB\-c\fR
-.RS 4
-Specify the socket to use to access syslog\-ng\&. Only needed when using a non\-standard socket\&.
-.RE
-.PP
-Example:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-syslog\-ng\-ctl stats
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-An example output:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-src\&.internal;s_all#0;;a;processed;6445
-src\&.internal;s_all#0;;a;stamp;1268989330
-destination;df_auth;;a;processed;404
-destination;df_news_dot_notice;;a;processed;0
-destination;df_news_dot_err;;a;processed;0
-destination;d_ssb;;a;processed;7128
-destination;df_uucp;;a;processed;0
-source;s_all;;a;processed;7128
-destination;df_mail;;a;processed;0
-destination;df_user;;a;processed;1
-destination;df_daemon;;a;processed;1
-destination;df_debug;;a;processed;15
-destination;df_messages;;a;processed;54
-destination;dp_xconsole;;a;processed;671
-dst\&.tcp;d_network#0;10\&.50\&.0\&.111:514;a;dropped;5080
-dst\&.tcp;d_network#0;10\&.50\&.0\&.111:514;a;processed;7128
-dst\&.tcp;d_network#0;10\&.50\&.0\&.111:514;a;stored;2048
-destination;df_syslog;;a;processed;6724
-destination;df_facility_dot_warn;;a;processed;0
-destination;df_news_dot_crit;;a;processed;0
-destination;df_lpr;;a;processed;0
-destination;du_all;;a;processed;0
-destination;df_facility_dot_info;;a;processed;0
-center;;received;a;processed;0
-destination;df_kern;;a;processed;70
-center;;queued;a;processed;0
-destination;df_facility_dot_err;;a;processed;0
-.fi
-.if n \{\
-.RE
-.\}
-
-.SH "SEE ALSO"
-.PP
-
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2
-.PP
-
-\fBsyslog\-ng\&.conf\fR(5)
-.PP
-
-\fBsyslog\-ng\fR(8)
-.PP
-If you experience any problems or need help with syslog\-ng, visit the
-\m[blue]\fBsyslog\-ng mailing list\fR\m[]\&\s-2\u[3]\d\s+2
-.PP
-For news and notifications about the documentation of syslog\-ng, visit the
-\m[blue]\fBBalaBit Documentation Blog\fR\m[]\&\s-2\u[4]\d\s+2\&.
-.SH "AUTHOR"
-.PP
-This manual page was written by the BalaBit Documentation Team <documentation@balabit\&.com>\&.
-.SH "COPYRIGHT"
-.PP
-Copyright \(co 2000\-2009 BalaBit IT Security Ltd\&. Published under the Creative Commons Attribution\-Noncommercial\-No Derivative Works (by\-nc\-nd) 3\&.0 license\&. See
-\m[blue]\fBhttp://creativecommons\&.org/\fR\m[]
-for details\&. The latest version is always available at
-\m[blue]\fBhttp://www\&.balabit\&.com/support/documentation\fR\m[]\&.
-.SH "NOTES"
-.IP " 1." 4
-official syslog-ng website
-.RS 4
-\%http://www.balabit.com/network-security/syslog-ng/
-.RE
-.IP " 2." 4
-The syslog-ng Administrator Guide
-.RS 4
-\%http://www.balabit.com/support/documentation/
-.RE
-.IP " 3." 4
-syslog-ng mailing list
-.RS 4
-\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
-.RE
-.IP " 4." 4
-BalaBit Documentation Blog
-.RS 4
-\%http://robert.blogs.balabit.com
-.RE
View
192 doc/man/syslog-ng.8.in
@@ -1,192 +0,0 @@
-'\" t
-.\" Title: syslog-ng
-.\" Author: [see the "Author" section]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\" Date: 06/30/2010
-.\" Manual: The syslog-ng manual page
-.\" Source: syslog-ng 3.2
-.\" Language: English
-.\"
-.TH "SYSLOG\-NG" "8" "06/30/2010" "syslog\-ng\&" "The syslog-ng manual page"
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-syslog-ng \- syslog\-ng system logger application
-.SH "SYNOPSIS"
-.HP \w'\fBsyslog\-ng\fR\ 'u
-\fBsyslog\-ng\fR [options]
-.SH "DESCRIPTION"
-.PP
-This manual page is only an abstract; for the complete documentation of syslog\-ng, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2\&.
-.PP
-The syslog\-ng application is a flexible and highly scalable system logging application\&. Typically, syslog\-ng is used to manage log messages and implement centralized logging, where the aim is to collect the log messages of several devices on a single, central log server\&. The different devices \- called syslog\-ng clients \- all run syslog\-ng, and collect the log messages from the various applications, files, and other
-\fIsources\fR\&. The clients send all important log messages to the remote syslog\-ng server, where the server sorts and stores them\&.
-.SH "OPTIONS"
-.PP
-\fB\-\-cfgfile <file>\fR or \fB\-f <file>\fR
-.RS 4
-Use the specified configuration file\&.
-.RE
-.PP
-\fB\-\-chroot <dir>\fR or \fB\-C <dir>\fR
-.RS 4
-Change root to the specified directory after reading the configuration file\&. The directory must be set up accordingly\&. Note that it is not possible to reload the syslog\-ng configuration after chrooting\&.
-.RE
-.PP
-\fB\-\-debug\fR or \fB\-d\fR
-.RS 4
-Start syslog\-ng in debug mode\&.
-.RE
-.PP
-\fB\-\-enable\-core\fR
-.RS 4
-Enable syslog\-ng to write core files in case of a crash to help support and debugging\&.
-.RE
-.PP
-\fB\-\-fd\-limit\fR
-.RS 4
-Set the minimal number of required file descriptors (fd\-s); this sets how many files syslog\-ng can keep open simultaneously\&. Default value:
-\fI4096\fR\&. Note that this does not override the global ulimit setting of the host\&.
-.RE
-.PP
-\fB\-\-foreground\fR or \fB\-F\fR
-.RS 4
-Do not daemonize, run in the foreground\&.
-.RE
-.PP
-\fB\-\-group <group>\fR or \fB\-g <group>\fR
-.RS 4
-Switch to the specified group after initializing the configuration file\&.
-.RE
-.PP
-\fB\-\-help\fR or \fB\-h\fR
-.RS 4
-Display a brief help message\&.
-.RE
-.PP
-\fB\-\-no\-caps\fR
-.RS 4
-Run syslog\-ng as root, without capability\-support\&. This is the default behavior\&. On Linux, it is possible to run syslog\-ng as non\-root with capability\-support if syslog\-ng was compiled with the
-\fI\-\-enable\-linux\-caps\fR
-option enabled\&. (Execute
-\fBsyslog\-ng \-\-version\fR
-to display the list of enabled build parameters\&.)
-.RE
-.PP
-\fB\-\-persist\-file <persist\-file>\fR or \fB\-R <persist\-file>\fR
-.RS 4
-Set the path and name of the
-syslog\-ng\&.persist
-file where the persistent options and data are stored\&.
-.RE
-.PP
-\fB\-\-pidfile <pidfile>\fR or \fB\-p <pidfile>\fR
-.RS 4
-Set path to the PID file where the pid of the main process is stored\&.
-.RE
-.PP
-\fB\-\-process\-mode <pidfile>\fR
-.RS 4
-Sets how to run syslog\-ng: in the
-\fIforeground\fR
-(mainly used for debugging), in the
-\fIbackground\fR
-as a daemon, or in
-\fIsafe\-background\fR
-mode\&. By default, syslog\-ng runs in
-\fIsafe\-background\fR
-mode\&. This mode creates a supervisor process called
-\fIsupervising syslog\-ng\fR
-, that restarts syslog\-ng if it crashes\&.
-.RE
-.PP
-\fB\-\-qdisk\-dir <path>\fR or \fB\-Q <path>\fR
-.RS 4
-Specify the location of the file used for disk\-based buffering\&. By default, this file is located at
-/var/lib/syslog\-ng/\&.
-.RE
-.PP
-\fB\-\-stderr\fR or \fB\-e\fR
-.RS 4
-Log internal messages of syslog\-ng to stderr\&. Mainly used for debugging purposes in conjunction with the
-\fI\-\-foreground\fR
-option\&. If not specified, syslog\-ng will log such messages to its internal source\&.
-.RE
-.PP
-\fB\-\-syntax\-only\fR or \fB\-s\fR
-.RS 4
-Verify that the configuration file is syntactically correct and exit\&.
-.RE
-.PP
-\fB\-\-user <user>\fR or \fB\-u <user>\fR
-.RS 4
-Switch to the specified user after initializing the configuration file (and optionally chrooting)\&. Note that it is not possible to reload the syslog\-ng configuration if the specified user has no privilege to create the
-/dev/log
-file\&.
-.RE
-.PP
-\fB\-\-verbose\fR or \fB\-v\fR
-.RS 4
-Enable verbose logging used to troubleshoot syslog\-ng\&.
-.RE
-.PP
-\fB\-\-version\fR or \fB\-V\fR
-.RS 4
-Display version number and compilation information\&.
-.RE
-.SH "FILES"
-.PP
-
-@expanded_sysconfdir@/syslog\-ng\&.conf
-.SH "SEE ALSO"
-.PP
-
-\fBsyslog\-ng\&.conf\fR(5)
-.PP
-
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2
-.PP
-If you experience any problems or need help with syslog\-ng, visit the
-\m[blue]\fBsyslog\-ng mailing list\fR\m[]\&\s-2\u[3]\d\s+2
-.PP
-For news and notifications about the documentation of syslog\-ng, visit the
-\m[blue]\fBBalaBit Documentation Blog\fR\m[]\&\s-2\u[4]\d\s+2\&.
-.SH "AUTHOR"
-.PP
-This manual page was written by the BalaBit Documentation Team <documentation@balabit\&.com>\&.
-.SH "COPYRIGHT"
-.PP
-Copyright \(co 2000\-2009 BalaBit IT Security Ltd\&. Published under the Creative Commons Attribution\-Noncommercial\-No Derivative Works (by\-nc\-nd) 3\&.0 license\&. See
-\m[blue]\fBhttp://creativecommons\&.org/\fR\m[]
-for details\&. The latest version is always available at
-\m[blue]\fBhttp://www\&.balabit\&.com/support/documentation\fR\m[]\&.
-.SH "NOTES"
-.IP " 1." 4
-official syslog-ng website
-.RS 4
-\%http://www.balabit.com/network-security/syslog-ng/
-.RE
-.IP " 2." 4
-The syslog-ng Administrator Guide
-.RS 4
-\%http://www.balabit.com/support/documentation/
-.RE
-.IP " 3." 4
-syslog-ng mailing list
-.RS 4
-\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
-.RE
-.IP " 4." 4
-BalaBit Documentation Blog
-.RS 4
-\%http://robert.blogs.balabit.com
-.RE
View
370 doc/man/syslog-ng.conf.5.in
@@ -1,370 +0,0 @@
-'\" t
-.\" Title: syslog-ng.conf
-.\" Author: [see the "Author" section]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\" Date: 06/30/2010
-.\" Manual: The syslog-ng.conf manual page
-.\" Source: syslog-ng 3.2
-.\" Language: English
-.\"
-.TH "SYSLOG\-NG\&.CONF" "5" "06/30/2010" "syslog\-ng" "The syslog-ng.conf manual page"
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-syslog-ng.conf \- syslog\-ng configuration file
-.SH "SYNOPSIS"
-.HP \w'\fBsyslog\-ng\&.conf\fR\ 'u
-\fBsyslog\-ng\&.conf\fR
-.SH "DESCRIPTION"
-.PP
-This manual page is only an abstract; for the complete documentation of syslog\-ng, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2\&.
-.PP
-The syslog\-ng application is a flexible and highly scalable system logging application\&. Typically, syslog\-ng is used to manage log messages and implement centralized logging, where the aim is to collect the log messages of several devices on a single, central log server\&. The different devices \- called syslog\-ng clients \- all run syslog\-ng, and collect the log messages from the various applications, files, and other
-\fIsources\fR\&. The clients send all important log messages to the remote syslog\-ng server, where the server sorts and stores them\&.
-.PP
-The syslog\-ng application reads incoming messages and forwards them to the selected
-\fIdestinations\fR\&. The syslog\-ng application can receive messages from files, remote hosts, and other
-\fIsources\fR\&.
-.PP
-Log messages enter syslog\-ng in one of the defined sources, and are sent to one or more
-\fIdestinations\fR\&.
-.PP
-Sources and destinations are independent objects;
-\fIlog paths\fR
-define what syslog\-ng does with a message, connecting the sources to the destinations\&. A log path consists of one or more sources and one or more destinations; messages arriving to a source are sent to every destination listed in the log path\&. A log path defined in syslog\-ng is called a
-\fIlog statement\fR\&.
-.PP
-Optionally, log paths can include
-\fIfilters\fR\&. Filters are rules that select only certain messages, for example, selecting only messages sent by a specific application\&. If a log path includes filters, syslog\-ng sends only the messages satisfying the filter rules to the destinations set in the log path\&.
-.SH "CONFIGURING SYSLOG-NG"
-.PP
-Global objects (for example sources, destinations, log paths, or filters) are defined in the syslog\-ng configuration file\&. Object definitions consist of the following elements:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\fIType of the object\fR: One of
-\fIsource\fR,
-\fIdestination\fR,
-\fIlog\fR,
-\fIfilter\fR,
-\fIparser\fR,
-\fIrewrite\fR
-rule, or
-\fItemplate\fR\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\fIIdentifier of the object\fR: A unique name identifying the object\&. When using a reserved word as an identifier, enclose the identifier in quotation marks\&.
-.if n \{\
-.sp
-.\}
-.RS 4
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBTip\fR
-.ps -1
-.br
-Use identifiers that refer to the type of the object they identify\&. For example, prefix source objects with
-\fIs_\fR, destinations with
-\fId_\fR, and so on\&.
-.sp .5v
-.RE
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\fIParameters\fR: The parameters of the object, enclosed in braces
-\fI{parameters}\fR\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\fISemicolon\fR: Object definitions end with a semicolon (\fI;\fR)\&.
-.RE
-.PP
-The syntax is summarized as follows:
-.PP
-The syntax of log statements is as follows:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-log {
- source(s1); source(s2); \&.\&.\&.
- optional_element(filter1|parser1|rewrite1); optional_element(filter2|parser2|rewrite2);\&.\&.\&.
- destination(d1); destination(d2); \&.\&.\&.
- flags(flag1[, flag2\&.\&.\&.]);
- };
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-The following log statement sends all messages arriving to the localhost to a remote server\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-source s_localhost { tcp(ip(127\&.0\&.0\&.1) port(1999) ); };
-destination d_tcp { tcp("10\&.1\&.2\&.3" port(1999); localport(999)); };
-log { source(s_localhost); destination(d_tcp); };
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-The syslog\-ng application has a number of global options governing DNS usage, the timestamp format used, and other general points\&. Each option may have parameters, similarly to driver specifications\&. To set global options, add an option statement to the syslog\-ng configuration file using the following syntax:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-options { option1(params); option2(params); \&.\&.\&. };
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-The sources, destinations, and filters available in syslog\-ng are listed below\&. For details, see
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.B Table\ \&1.\ \&Source drivers available in syslog-ng
-.TS
-allbox tab(:);
-lB lB.
-T{
-Name
-T}:T{
-Description
-T}
-.T&
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l.
-T{
-internal()
-T}:T{
-Messages generated internally in syslog\-ng\&.
-T}
-T{
-file()
-T}:T{
-Opens the specified file and reads messages\&.
-T}
-T{
-pipe(), fifo
-T}:T{
-Opens the specified named pipe and reads messages\&.
-T}
-T{
-program()
-T}:T{
-Opens the specified application and reads messages from its standard output\&.
-T}
-T{
-sun\-stream(), sun\-streams()
-T}:T{
-Opens the specified \fISTREAMS\fR device on Solaris systems and reads incoming messages\&.
-T}
-T{
-syslog()
-T}:T{
-Listens for incoming messages using the new IETF\-standard syslog protocol\&.
-T}
-T{
-tcp(), tcp6()
-T}:T{
-Listens on the specified TCP port for incoming messages using the BSD\-syslog protocol over IPv4 and IPv6 networks, respectively\&.
-T}
-T{
-udp(), udp6()
-T}:T{
-Listens on the specified UDP port for incoming messages using the BSD\-syslog protocol over IPv4 and IPv6 networks, respectively\&.
-T}
-T{
-unix\-dgram()
-T}:T{
-Opens the specified unix socket in \fISOCK_DGRAM\fR mode and listens for incoming messages\&.
-T}
-T{
-unix\-stream()
-T}:T{
-Opens the specified unix socket in \fISOCK_STREAM\fR mode and listens for incoming messages\&.
-T}
-.TE
-.sp 1
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.B Table\ \&2.\ \&Destination drivers available in syslog-ng
-.TS
-allbox tab(:);
-lB lB.
-T{
-Name
-T}:T{
-Description
-T}
-.T&
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l
-l l.
-T{
-file()
-T}:T{
-Writes messages to the specified file\&.
-T}
-T{
-fifo(), pipe()
-T}:T{
-Writes messages to the specified named pipe\&.
-T}
-T{
-program()
-T}:T{
-Forks and launches the specified program, and sends messages to its standard input\&.
-T}
-T{
-sql()
-T}:T{
-Sends messages into an SQL database\&. In addition to the standard syslog\-ng packages, the \fIsql()\fR destination requires database\-specific packages to be installed\&. Refer to the section appropriate for your platform in ???\&.
-T}
-T{
-syslog()
-T}:T{
-Sends messages to the specified remote host using the IETF\-syslog protocol\&. The IETF standard supports message transport using the UDP, TCP, and TLS networking protocols\&.
-T}
-T{
-tcp() and tcp6()
-T}:T{
-Sends messages to the specified TCP port of a remote host using the BSD\-syslog protocol over IPv4 and IPv6, respectively\&.
-T}
-T{
-udp() and udp6()
-T}:T{
-Sends messages to the specified UDP port of a remote host using the BSD\-syslog protocol over IPv4 and IPv6, respectively\&.
-T}
-T{
-unix\-dgram()
-T}:T{
-Sends messages to the specified unix socket in \fISOCK_DGRAM\fR style (BSD)\&.
-T}
-T{
-unix\-stream()
-T}:T{
-Sends messages to the specified unix socket in \fISOCK_STREAM\fR style (Linux)\&.
-T}
-T{
-usertty()
-T}:T{
-Sends messages to the terminal of the specified user, if the user is logged in\&.
-T}
-.TE
-.sp 1
-.SH "FILES"
-.PP
-
-@expanded_sysconfdir@/syslog\-ng\&.conf
-.SH "SEE ALSO"
-.PP
-
-\fBsyslog\-ng\fR(8)
-.PP
-
-\m[blue]\fBThe syslog\-ng Administrator Guide\fR\m[]\&\s-2\u[2]\d\s+2
-.PP
-If you experience any problems or need help with syslog\-ng, visit the
-\m[blue]\fBsyslog\-ng mailing list\fR\m[]\&\s-2\u[3]\d\s+2
-.PP
-For news and notifications about the documentation of syslog\-ng, visit the
-\m[blue]\fBBalaBit Documentation Blog\fR\m[]\&\s-2\u[4]\d\s+2\&.
-.SH "AUTHOR"
-.PP
-This manual page was written by the BalaBit Documentation Team <documentation@balabit\&.com>\&.
-.SH "COPYRIGHT"
-.PP
-Copyright \(co 2000\-2009 BalaBit IT Security Ltd\&. Published under the Creative Commons Attribution\-Noncommercial\-No Derivative Works (by\-nc\-nd) 3\&.0 license\&. See
-\m[blue]\fBhttp://creativecommons\&.org/\fR\m[]
-for details\&. The latest version is always available at
-\m[blue]\fBhttp://www\&.balabit\&.com/support/documentation\fR\m[]\&.
-.SH "NOTES"
-.IP " 1." 4
-official syslog-ng website
-.RS 4
-\%http://www.balabit.com/network-security/syslog-ng/
-.RE
-.IP " 2." 4
-The syslog-ng Administrator Guide
-.RS 4
-\%http://www.balabit.com/support/documentation/
-.RE
-.IP " 3." 4
-syslog-ng mailing list
-.RS 4
-\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
-.RE
-.IP " 4." 4
-BalaBit Documentation Blog
-.RS 4
-\%http://robert.blogs.balabit.com
-.RE

0 comments on commit fc3ffc2

Please sign in to comment.