Bug 1662503

Summary:	The "use-vc" parameter did not show in the "man resolv.conf" page
Product:	Red Hat Enterprise Linux 7	Reporter:	Runming Long <rulong>
Component:	man-pages-overrides	Assignee:	Nikola Forró <nforro>
Status:	CLOSED ERRATA	QA Contact:	Jan Houska <jhouska>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	7.6	CC:	hhorak, jhouska
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	man-pages-overrides-7.7.0-2.el7	Doc Type:	No Doc Update
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-08-06 12:33:38 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:	1663159

Description Runming Long 2018-12-29 02:33:36 UTC

Description of problem:
The "use-vc" parameter did not show in the "man resolv.conf" page under the "options" parameter, reference other information and test the parameter by myself,  this parameter seems like work.

reference link: 

http://man7.org/linux/man-pages/man5/resolv.conf.5.html

https://github.com/mkerrisk/man-pages/commit/7d9f4717fde0c60a07f5ce61cc0001a56b631bea

Version-Release number of selected component (if applicable):
RHEL7.5 & 7.6
glibc-2.17-260.el7.x86_64

How reproducible:
man resolv.conf

Steps to Reproduce:
1. man resolv.conf
2.
3.

Actual results:
The "use-vc" parameter did not show in the "man resolv.conf" page under the "options" parameter,

Expected results:
add the "use-vc" parameter after glibc 2.14

Additional info:
The customer wanna resolving DNS names using TCP instead of UDP in my case(#02281123). according to my test results, this parameter is valid, but there is no information about this parameter in our man resolv.conf page.

Comment 4 Jan Houska 2019-01-07 12:01:42 UTC

Complete reproducer (1minutetip 1MT-RHEL-7.7-20190101.n.0-16175-2019-01-07-11-51):

yum install -y glibc
yum install -y man-pages-overrides
man resolv.conf

=>
# rpm -qa man-pages-overrides glibc
glibc-2.17-260.el7.x86_64
man-pages-overrides-7.7.0-1.el7.x86_64

Comment 8 Jan Houska 2019-06-25 10:20:46 UTC

VERIFIED:


NEW PASS:
man-pages-overrides-7.7.3-1.el7


# man resolv.conf
              no-tld-query (since glibc 2.14)
                     sets   RES_NOTLDQUERY   in   _res.options.    This   option    causes
                     res_nsearch()  to not attempt to resolve an unqualified name as if it
                     were a top level domain (TLD).  This option can cause problems if the
                     site  has  ``localhost'' as a TLD rather than having localhost on one
                     or more elements of the search list.  This option has  no  effect  if
                     neither RES_DEFNAMES or RES_DNSRCH is set.

              use-vc (since glibc 2.14)
                     sets  RES_USEVC in _res.options.  This option forces the usage of TCP
                     for DNS resolutions.

              no-reload (since glibc 2.26)
                     sets RES_NORELOAD in _res.options.  This  option  disables  automatic
                     reloading of a changed configuration file.



OLD FAIL:
man-pages-overrides-7.6.2-1.el7

# man resolv.conf
              no-tld-query (since glibc 2.14)
                     sets   RES_NOTLDQUERY   in   _res.options.    This   option    causes
                     res_nsearch()  to not attempt to resolve an unqualified name as if it
                     were a top level domain (TLD).  This option can cause problems if the
                     site  has  ``localhost'' as a TLD rather than having localhost on one
                     or more elements of the search list.  This option has  no  effect  if
                     neither RES_DEFNAMES or RES_DNSRCH is set.

              no-reload (since glibc 2.26)
                     sets  RES_NORELOAD  in  _res.options.  This option disables automatic
                     reloading of a changed configuration file.




DIFF
# diff new old 
9,12d8
<               use-vc (since glibc 2.14)
<                      sets  RES_USEVC in _res.options.  This option forces the usage of TCP
<                      for DNS resolutions.
< 
14c10
<                      sets RES_NORELOAD in _res.options.  This  option  disables  automatic
---
>                      sets  RES_NORELOAD  in  _res.options.  This option disables automatic

Comment 10 errata-xmlrpc 2019-08-06 12:33:38 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.

https://access.redhat.com/errata/RHBA-2019:2034