Balazs, This patch adds the missing command line options to the syslog-ng.8 manpage. The patch also applies to syslog-ng 1.9.x (he default syslog-ng.conf location still has to be corrected). Regards, jpo -- José Pedro Oliveira mailto: jpo@di.uminho.pt * http://gsd.di.uminho.pt/~jpo diff -ruN syslog-ng-1.6.5-orig/doc/syslog-ng.8 syslog-ng-1.6.5/doc/syslog-ng.8 --- syslog-ng-1.6.5-orig/doc/syslog-ng.8 1999-07-10 16:58:32.000000000 +0100 +++ syslog-ng-1.6.5/doc/syslog-ng.8 2005-01-30 00:05:48.906523000 +0000 @@ -7,7 +7,7 @@ .B syslog-ng [ -.B \-dvV +.B \-dFsvV ] [ .B \-f <\fIconfig-filename\fP> @@ -17,6 +17,12 @@ ] [ .B \-C <\fIchroot-dir\fP> +] [ +.B \-u +<\fIuser\fP> +] [ +.B \-g +<\fIgroup\fP> ] .SH DESCRIPTION .PP @@ -64,38 +70,72 @@ \fBsyslog-ng\fP will also save all the current values as a "checkpoint". .SH OPTIONS .TP -.B \-d +.B \-C \0<directory>, \-\-chroot=<directory> +Chroot to directory. +.TP +.B \-d, \-\-debug Set "debug mode". Prints out various messages to aid in debugging and stops it from becoming a daemon. To activate debugging in the yacc parser, either use this option twice or combine with \fB-v\fP. .TP -.B \-f \0<filename> +.B \-F, \-\-foreground +Don't fork into background. +.TP +.B \-f \0<filename>, \-\-cfgfile=<filename> Instead of reading the normal \fB/etc/syslog-ng/syslog-ng.conf\fP file for configuration information, use the filename given instead. .TP -.B \-p \0<filename> +.B \-g \0<group>, \-\-group=<group> +Switch to group. +.TP +.B \-p \0<filename>, \-\-pidfile=<filename> Write the current PID information to the specified file. +Defaults to \fB/var/run/syslog-ng.pid\fP. +.TP +.B \-s, \-\-syntax\-only +Only read and parse the configuration file. See also the option \fB-f\fP. .TP -.B \-v +.B \-u \0<user>, \-\-group=<user> +Switch to user. +.TP +.B \-v, \-\-verbose Enable verbose mode. Process will not become a daemon. Prints out fewer messages, compared to \fB-d\fP. .TP -.B \-V +.B \-V, \-\-version Print the version number. .SH DIAGNOSTICS It is expected that \fBsyslog-ng\fP 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. .SH SEE ALSO -logger(1), syslog(3), services(5), syslog.conf(5), syslog-ng.conf(5) +.BR syslog-ng.conf (5), +.BR logger (1), +.BR syslog (2), +.BR syslog (3), +.BR services (5), +.BR syslog.conf (5), +.BR klogd (8), +.BR syslogd (8), +.BR sysklogd (8) .SH FILES -/etc/syslog-ng/syslog-ng.conf -/etc/syslog-ng/filename.sha1 -/etc/syslog-ng/filename.H0 -/etc/syslog-ng/filename.salt -.br -/var/run/syslog.pid -.br +.TP +.I /etc/syslog-ng/syslog-ng.conf +Configuration file for +.BR syslog\-ng . +See +.BR syslog\-ng.conf (5) +for more information. +.TP +.I /etc/syslog-ng/filename.sha1 +.TP +.I /etc/syslog-ng/filename.H0 +.TP +.I /etc/syslog-ng/filename.salt +.TP +.I /var/run/syslog-ng.pid +The file containing the process id of +.BR syslog-ng . .SH BUGS .PP If you find any, please send email to me at bazsi@balabit.hu
Thanks. On Sun, 2005-01-30 at 03:06 +0000, Jose Pedro Oliveira wrote:
Balazs,
This patch adds the missing command line options to the syslog-ng.8 manpage.
The patch also applies to syslog-ng 1.9.x (he default syslog-ng.conf location still has to be corrected).
Regards, jpo plain text document attachment (syslog-ng-1.6.5-syslog-ng.8.patch)
-- Bazsi
Balazs, Still regarding the syslog-ng(8) manpage update (thanks!): i) I think that the following note "NOTE: This file is not up to date. Please refer to the html documentation." in the SYNOPSIS should be removed. The SGML based documentation doesn't mention the syslog-ng command line options. ii) Regarding the -d option. Is it still possible to activate debugging in the yacc parser? Regards, jpo
Thanks.
On Sun, 2005-01-30 at 03:06 +0000, Jose Pedro Oliveira wrote:
Balazs,
This patch adds the missing command line options to the syslog-ng.8 manpage.
The patch also applies to syslog-ng 1.9.x (he default syslog-ng.conf location still has to be corrected).
Regards, jpo plain text document attachment (syslog-ng-1.6.5-syslog-ng.8.patch)
-- José Pedro Oliveira * mailto: jpo@di.uminho.pt * http://gsd.di.uminho.pt/~jpo * * gpg fingerprint = F9B6 8D87 859D 1C94 48F0 84C0 9749 9EB5 91BD 851B *
On Mon, 2005-01-31 at 20:53 +0000, José Pedro Oliveira wrote:
Balazs,
Still regarding the syslog-ng(8) manpage update (thanks!):
I thank you for the patches.
i) I think that the following note
"NOTE: This file is not up to date. Please refer to the html documentation."
in the SYNOPSIS should be removed. The SGML based documentation doesn't mention the syslog-ng command line options.
done.
ii) Regarding the -d option. Is it still possible to activate debugging in the yacc parser?
there's a separate --yydebug option now which is only enabled if syslog-ng is configured with --enable-debug configure option, so the answer is no, -d cannot be used to enable yacc debugging anymore. I added documentation on this one myself. Could you please update the syslog-ng.conf manpage as well? It would be very much appreciated. -- Bazsi
Balazs,
Could you please update the syslog-ng.conf manpage as well? It would be very much appreciated.
I will try to update it during the weekend. jpo -- José Pedro Oliveira mailto: jpo@di.uminho.pt * http://gsd.di.uminho.pt/~jpo
Balazs, These changes haven't appeared in the latest snapshot (20050202), could you confirm that they appear in the next snapshot? Meanwhile, two more corrections: - syslog-ng.8 typo (see syslog-1.6.5-syslog-ng.8.patch) - contrib/syslog2ng (replacement of "..." by "..") (see syslog-1.6.5-syslog2ng.patch) Regards, jpo
On Mon, 2005-01-31 at 20:53 +0000, José Pedro Oliveira wrote:
Balazs,
Still regarding the syslog-ng(8) manpage update (thanks!):
I thank you for the patches.
i) I think that the following note
"NOTE: This file is not up to date. Please refer to the html documentation."
in the SYNOPSIS should be removed. The SGML based documentation doesn't mention the syslog-ng command line options.
done.
ii) Regarding the -d option. Is it still possible to activate debugging in the yacc parser?
there's a separate --yydebug option now which is only enabled if syslog-ng is configured with --enable-debug configure option, so the answer is no, -d cannot be used to enable yacc debugging anymore. I added documentation on this one myself.
Could you please update the syslog-ng.conf manpage as well? It would be very much appreciated.
-- José Pedro Oliveira * mailto: jpo@di.uminho.pt * http://gsd.di.uminho.pt/~jpo * * gpg fingerprint = F9B6 8D87 859D 1C94 48F0 84C0 9749 9EB5 91BD 851B *
On Wed, 2005-02-02 at 16:29 +0000, José Pedro Oliveira wrote:
Balazs,
These changes haven't appeared in the latest snapshot (20050202), could you confirm that they appear in the next snapshot?
Meanwhile, two more corrections:
- syslog-ng.8 typo (see syslog-1.6.5-syslog-ng.8.patch)
- contrib/syslog2ng (replacement of "..." by "..") (see syslog-1.6.5-syslog2ng.patch)
added, thanks. -- Bazsi
participants (3)
-
Balazs Scheidler
-
Jose Pedro Oliveira
-
José Pedro Oliveira