Bug 471176

Summary:	SYSLOG(3) enhancement request
Product:	Red Hat Enterprise Linux 5	Reporter:	masanari iida <masanari_iida>
Component:	man-pages	Assignee:	Ivana Varekova <varekova>
Status:	CLOSED ERRATA	QA Contact:	BaseOS QE <qe-baseos-auto>
Severity:	low	Docs Contact:
Priority:	medium
Version:	5.2	CC:	rvokal
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2009-11-11 09:13:36 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description masanari iida 2008-11-12 07:38:47 UTC

Description of problem:
syslog(3) online manual explains LOG_KERN facility level.
Current explanation "kernel messages" is not enough.

Because some other flavor of Unix syslog man page explains
this facility can be generated only by kernel.

For example,
Sun solaris,
LOG_KERN 
Messages generated by the kernel. These cannot be generated 
by any user processes.

FreeBSD,
LOG_KERN	   Messages generated by the kernel.  These cannot be gener-
		   ated by any user processes.

So, the RHEL manual need to add the limitation.

Request background.
A user tried  logger -p kern.debug "abc123" 
and he expected the logger output should route to  /var/log/kernel.log file,
which was specified by syslog.conf.

The acutual result was, the messages goes to /var/log/users
log, because the logger output has a user facility.

I know this is expected result.
But in order to answer this is expected, I need an evidence 
on the man page. The current man syslog(3) of the RHEL5 is 
not enough for my purpose.

Comment 1 masanari iida 2008-11-12 17:02:10 UTC

Communicate with upstream maintainer Michael Krrisk by 
private e-mail. He wrote to me he will add one line, 
" These cannot be generated by any user processes." 
in man-pages-3.14.

> Thanks for your report and all the background.  
> I agree with you, and 
> have changed things as you suggest for man-pages-3.14.

I hope this information help.

Comment 2 Ivana Varekova 2008-11-13 08:20:44 UTC

Thanks.

Comment 9 errata-xmlrpc 2009-11-11 09:13:36 UTC

An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2009-1574.html