Bug 820311

Summary:	Manpage: rsyslogd does the fork in debug mode while manpage says otherwise
Product:	Red Hat Enterprise Linux 6	Reporter:	Karel Srot <ksrot>
Component:	rsyslog	Assignee:	Tomas Heinrich <theinric>
Status:	CLOSED ERRATA	QA Contact:	Dalibor Pospíšil <dapospis>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.3	CC:	dapospis, lmiksik, pvrabec
Target Milestone:	rc	Keywords:	ManPageChange, Reopened
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:	Previously, the manual page stated that the '-d' option which turns on debugging causes the daemon to run in foreground. This was misleading as the current behavior is to run in background. The manual page was updated to reflect the correct behavior.	Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-06-20 06:59:09 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	805204

Description Karel Srot 2012-05-09 15:11:16 UTC

Description of problem:

rsyslog-5.8.10-1.el6.x86_64

When starting rsyslogd in debug mode (rsyslogd -d) the process should not fork and disconnect from the terminal but it actually does. 
This bug makes rsyslogd debugging hard.

This is a regression introduced by rsyslog update in bug 672182.

Comment 4 Karel Srot 2012-05-10 16:33:45 UTC

Lowering the severity since this can be workarounded with 
rsyslogd -dn

But anyway it seems to be a bug & regression

Comment 5 Tomas Heinrich 2012-05-11 13:06:48 UTC

According to upstream, this is the intended behavior.

Comment 6 Karel Srot 2012-05-14 05:49:07 UTC

Reopening this bug for updating the rsyslogd manpage. 

ATM it states:

       -d     Turns on debug mode.  Using this the daemon will not proceed
              a fork(2) to set  itself in  the  background, but opposite 
              to that stay in the foreground and write much debug 
              information on the current tty.  See the DEBUGGING section 
              for more information.

which is in opposite to #c5 (intended behavior).

Comment 11 Tomas Heinrich 2012-05-17 17:00:59 UTC

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Previously, the manual page stated that the '-d' option which turns on debugging causes the daemon to run in foreground.
This was misleading as the current behavior is to run in background. The manual page was updated to reflect the correct behavior.

Comment 12 Dalibor Pospíšil 2012-05-18 10:55:30 UTC

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1 +1,2 @@
-Previously, the manual page stated that the '-d' option which turns on debugging causes the daemon to run in foreground.
This was misleading as the current behavior is to run in background. The manual page was updated to reflect the correct behavior.+Previously, the manual page stated that the '-d' option which turns on debugging causes the daemon to run in foreground.
+This was misleading as the current behavior is to run in background. The manual page was updated to reflect the correct behavior.

Comment 15 errata-xmlrpc 2012-06-20 06:59:09 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHSA-2012-0796.html