Bug 46091

Summary:	syslog.3 says LOG_AUTH is deprecated
Product:	Documentation	Reporter:	Simon Josefsson (simon)
Component:	man-pages	Assignee:	documentation_man-pages (documentation_man-pages)
Status:	RESOLVED CODE_FIX
Severity:	normal	CC:	mtk.manpages
Priority:	P1
Hardware:	All
OS:	Linux
Kernel Version:		Subsystem:
Regression:	No	Bisected commit-id:
Attachments:	Patch undeprecating LOG_AUTH

Description Simon Josefsson 2012-08-17 09:36:57 UTC

Created attachment 77881 [details]
Patch undeprecating LOG_AUTH

Hi!

syslog.3 contains:

.B LOG_AUTH
security/authorization messages (DEPRECATED Use
.B LOG_AUTHPRIV
instead)
.TP
.B LOG_AUTHPRIV
security/authorization messages (private)

However I cannot find any other source that claim LOG_AUTH is deprecated in anyway.  LOG_AUTH is distinct from LOG_AUTHPRIV.  The GNU C Library manual only documents LOG_AUTH.  The header files contains both without any comment.  Common systems like Debian appear to refer to both auth and authpriv facilities in syslog configurations.  Popular daemons appear to use both facilities.  Both facilities are discussed in several RFCs.

Thus, I propose attached patch to not say DEPRECATED anymore.

While the patch is trivial, I'm opening a bugzilla bug to track discussions since there could be other opinions.

For more background, see:
http://thread.gmane.org/gmane.comp.gnu.shishi.general/708/focus=735
http://thread.gmane.org/gmane.comp.gnu.shishi.general/708/focus=734

/Simon

Comment 1 Michael Kerrisk 2012-08-17 12:56:04 UTC

It's puzzling to me also why LOG_AUTH is marked DEPRECATED in the man page. That text goes back to the original version of the page, written in 1994.

Comment 2 Michael Kerrisk 2012-08-17 13:07:31 UTC

I've applied your patch, less the changelog text (nowadays,
the project generally just relies on the Git log, except in
the case of major changes, which also get a note in the changelog
in the page source.

Thanks for reporting this, Simon.

Comment 3 Simon Josefsson 2012-09-04 09:45:10 UTC

Thank you for fixing my patch and applying it.  I don't see this in the git repository though, has it been pushed?

/Simon

Comment 4 Michael Kerrisk 2012-09-25 03:53:43 UTC

Yes, sorry about that. Pushed now.