Bug 46091 - syslog.3 says LOG_AUTH is deprecated
Summary: syslog.3 says LOG_AUTH is deprecated
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 normal
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-08-17 09:36 UTC by Simon Josefsson
Modified: 2012-09-25 03:53 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments
Patch undeprecating LOG_AUTH (1.24 KB, text/plain)
2012-08-17 09:36 UTC, Simon Josefsson
Details

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.

Note You need to log in before you can comment on or make changes to this bug.