New: resolver.3 man page: RES_DEBUG option has effect only if libresolv compiled with DEBUG defined
https://bugzilla.kernel.org/show_bug.cgi?id=43061
URL: http://man7.org/linux/man-pages/man3/resolver.3.html
Summary: resolver.3 man page: RES_DEBUG option has effect only
if libresolv compiled with DEBUG defined
Product: Documentation
Version: unspecified
Kernel Version: n/a
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: kernelbugs-a6y0ucgZPWpWk0Htik3J/[email protected]
Regression: No
The resolver.3 man page's description of the available _res.options flag says:
RES_DEBUG
Print debugging messages.
However, from looking at the libresolv source, I get the impression that if the library was not compiled with "DEBUG" defined then the RES_DEBUG option is silently ignored.
Since it appears to be fairly common for the library to be compiled without DEBUG, it seems worth adding a note to the man page mentioning that RES_DEBUG will be ignored in that situation.
(As far as I can tell from the build logs, both Debian and Ubuntu build the eglibc packages without DEBUG defined. Is there any easy way to tell on a given running system the whether libresolv was build with or without DEBUG defined?)
It might also be worth mentioning the compile-time issue on the resolv.conf.5 page (in the paragraph for the "debug" option).
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 43061] resolver.3 man page: RES_DEBUG option has effect only if libresolv compiled with DEBUG defined
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=43061
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |[email protected]
Resolution| |CODE_FIX--- Comment #1 from Michael Kerrisk <[email protected]> 2013-03-05 06:46:47 --- Thanks Nathan. I've applied the patch below.
Cheers,
Michael
man3/resolver.3 +5 -1
@@ -27,7 +27,7 @@ .\" Modified 1993-07-25 by Rik Faith ([email protected]) .\" Modified 2004-10-31 by aeb .\" -.TH RESOLVER 3 2012-04-23 "GNU" "Linux Programmer's Manual" +.TH RESOLVER 3 2013-03-05 "GNU" "Linux Programmer's Manual" .SH NAME res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand \- resolver routines
@@ -185,6 +185,10 @@ has been called. .TP .B RES_DEBUG Print debugging messages. +This option is only available if glibc was built with debugging enabled, +.\" See resolv/README. +.\" Support for RES_DEBUG was made conditional in glibc 2.2. +which is not the default. .TP .B RES_AAONLY Accept authoritative answers only.
man5/resolv.conf.5 +4 -2
@@ -18,7 +18,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH RESOLV.CONF 5 2012-11-11 "" "Linux Programmer's Manual" +.TH RESOLV.CONF 5 2013-03-05 "" "Linux Programmer's Manual" .UC 4 .SH NAME resolv.conf \- resolver configuration file
@@ -133,7 +133,9 @@ where \fIoption\fP is one of the following: sets .BR RES_DEBUG in -.IR _res.options . +.IR _res.options +(only effective if glibc was built with debug support; see +.BR resolver (3)). .TP .BI ndots: n .\" Since glibc 2.2
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html