Bug#561503: rsyslog: Missing documentation about hyphens in configuration file.

2010-12-31 Thread Tanguy Ortolo
tag 561503 + patch
thanks

Le jeudi 17 décembre 2009, Philipp Weis a écrit :
 I assume that the hyphens in rsyslog.conf in front of some filenames
 indicate that these files aren't synced after every message, but
 there's no information about this in the manpage.

Well, I found the same problem, so I fixed it. Here is a patch that adds
documentation about the -file syntax to rsyslogd.conf(5) manpage.

I attach this patch in two formats:
* the git-format-patch, ready to be git-am'ed: this one adds a patch in
  debian/patches;
* the raw patch itself against tools/rsyslog.conf.5.
Use the one you prefer!

Regards,

-- 
 ,--.
: /` )   Tanguy Ortolo xmpp:tan...@ortolo.eu irc://irc.oftc.net/Elessar
| `-'Theoretically Debian Maintainer
 \_
Author: Tanguy Ortolo tanguy+deb...@ortolo.eu
Last-Update: 2010-12-31
Description: Document the -file form in rsyslog.conf(5)
The regular file action allows to prepend file name with a minus sign
to omit syncing the file after every logging. This patch documents it
on the manpage.

Index: rsyslog/tools/rsyslog.conf.5
===
--- rsyslog.orig/tools/rsyslog.conf.5	2010-12-31 16:31:53.937106592 +0100
+++ rsyslog/tools/rsyslog.conf.5	2010-12-31 16:32:11.549106726 +0100
@@ -216,6 +216,10 @@
 Typically messages are logged to real files. The file has to be specified with full pathname, 
 beginning with a slash ('/').
 
+You may prefix each entry with the minus -'' sign to omit syncing the file
+after every logging. Note that you might lose information if the system crashes
+right behind a write attempt.
+
 .B Example:
 .RS
 *.* /var/log/traditionalfile.log;RSYSLOG_TraditionalFormat  # log to a file in the traditional format
From 2624aeccec5948d0f74631d7d2ab9a5ba9cf526a Mon Sep 17 00:00:00 2001
From: Tanguy Ortolo tanguy+deb...@ortolo.eu
Date: Fri, 31 Dec 2010 16:37:46 +0100
Subject: [PATCH] Document async file in rsyslogd.conf(5)

---
 .../patches/03-manpage_document_async_files.patch  |   22 
 debian/patches/series  |1 +
 2 files changed, 23 insertions(+), 0 deletions(-)
 create mode 100644 debian/patches/03-manpage_document_async_files.patch

diff --git a/debian/patches/03-manpage_document_async_files.patch b/debian/patches/03-manpage_document_async_files.patch
new file mode 100644
index 000..eb06fe3
--- /dev/null
+++ b/debian/patches/03-manpage_document_async_files.patch
@@ -0,0 +1,22 @@
+Author: Tanguy Ortolo tanguy+deb...@ortolo.eu
+Last-Update: 2010-12-31
+Description: Document the -file form in rsyslog.conf(5)
+The regular file action allows to prepend file name with a minus sign
+to omit syncing the file after every logging. This patch documents it
+on the manpage.
+
+Index: rsyslog/tools/rsyslog.conf.5
+===
+--- rsyslog.orig/tools/rsyslog.conf.5	2010-12-31 16:31:53.937106592 +0100
 rsyslog/tools/rsyslog.conf.5	2010-12-31 16:32:11.549106726 +0100
+@@ -216,6 +216,10 @@
+ Typically messages are logged to real files. The file has to be specified with full pathname, 
+ beginning with a slash ('/').
+ 
++You may prefix each entry with the minus -'' sign to omit syncing the file
++after every logging. Note that you might lose information if the system crashes
++right behind a write attempt.
++
+ .B Example:
+ .RS
+ *.* /var/log/traditionalfile.log;RSYSLOG_TraditionalFormat  # log to a file in the traditional format
diff --git a/debian/patches/series b/debian/patches/series
index 3bdc4f1..68e1a77 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -1,3 +1,4 @@
 # Debian patches for rsyslog
 01-dont_create_db.patch
 02-tls_loop_fix.patch
+03-manpage_document_async_files.patch
-- 
1.7.2.3



signature.asc
Description: Digital signature


Bug#561503: rsyslog: Missing documentation about hyphens in configuration file.

2009-12-17 Thread Philipp Weis
Package: rsyslog
Version: 4.4.2-1
Severity: normal

I assume that the hyphens in rsyslog.conf in front of some filenames
indicate that these files aren't synced after every message, but
there's no information about this in the manpage.


-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (600, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages rsyslog depends on:
ii  libc6  2.10.2-2  GNU C Library: Shared libraries
ii  lsb-base   3.2-23Linux Standard Base 3.2 init scrip
ii  zlib1g 1:1.2.3.3.dfsg-15 compression library - runtime

Versions of packages rsyslog recommends:
ii  logrotate 3.7.8-4Log rotation utility

Versions of packages rsyslog suggests:
pn  rsyslog-doc   none (no description available)
pn  rsyslog-gnutlsnone (no description available)
pn  rsyslog-gssapinone (no description available)
pn  rsyslog-mysql | rsyslog-pgsql none (no description available)
pn  rsyslog-relp  none (no description available)

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org