Bug 1037926

Summary:	[rpc.mountd] update rpc.mountd(8) manpage to change -P option as an alias for -p
Product:	Red Hat Enterprise Linux 6	Reporter:	JianHong Yin <jiyin>
Component:	nfs-utils	Assignee:	Steve Dickson <steved>
Status:	CLOSED ERRATA	QA Contact:	Yongcheng Yang <yoyang>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.6	CC:	eguan, yoyang
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	nfs-utils-1.2.3-73.el6	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:	1037924	Environment:
Last Closed:	2017-03-21 11:22:47 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:

Description JianHong Yin 2013-12-04 05:29:49 UTC

+++ This bug was initially created as a clone of Bug #1037924 +++

Description of problem:
[rpc.mountd] -P option parse error.
  in man page:
       -P     Ignored (compatibility with unfsd??).
but in fact, if specify the -P, rpc.mountd error and exit.

Version-Release number of selected component (if applicable):
------------------------------------------------
TimeInfo  : 2013-12-03 23:55:49
CaseName  : /CoreOS/nfs-utils/commands/utils/rpc-mountd
$HOSTNAME : dell-pr7610-01.lab.bos.redhat.com
DistroInfo: RedHatEnterpriseWorkstation 7.0 : RHEL-7.0-20131123.0
kernelInfo: Linux dell-pr7610-01.lab.bos.redhat.com 3.10.0-54.el7.x86_64 #1 SMP Thu Nov 21 15:34:15 EST 2013 x86_64 x86_64 x86_64 GNU/Linux
packageInfo
	libnfsidmap-0.25-7.el7.x86_64
	package libsss_idmap is not installed
	nfs-utils-1.2.9-0.3.el7.x86_64
------------------------------------------------

How reproducible:
100%

Steps to Reproduce:
1.
2.
3.

Actual results:

[23:56:08 root@ /mnt/tests/CoreOS/nfs-utils/commands/utils/rpc-mountd]# rpc.mountd -P
Usage: rpc.mountd [-F|--foreground] [-h|--help] [-v|--version] [-d kind|--debug kind]
	[-o num|--descriptors num] [-f exports-file|--exports-file=file]
	[-p|--port port] [-V version|--nfs-version version]
	[-N version|--no-nfs-version version] [-n|--no-tcp]
	[-H ha-callout-prog] [-s|--state-directory-path path]
	[-g|--manage-gids] [-t num|--num-threads=num] [-u|--no-udp]
:: [   FAIL   ] :: Running 'rpc.mountd -P' (Expected 0, got 1)

Expected results:
ignore the option, as desc in man page.

Additional info:
  RHEL6.5 has the same problem

Comment 1 JianHong Yin 2013-12-04 05:36:43 UTC

------------------------------------------------
TimeInfo  : 2013-12-03 23:59:01
CaseName  : /CoreOS/nfs-utils/commands/utils/rpc-mountd
$HOSTNAME : intel-sugarbay-dh-01.lab.eng.rdu.redhat.com
DistroInfo: RedHatEnterpriseWorkstation 6.5 : RHEL6.5-20131111.0
kernelInfo: Linux intel-sugarbay-dh-01.lab.eng.rdu.redhat.com 2.6.32-431.el6.i686 #1 SMP Sun Nov 10 22:20:22 EST 2013 i686 i686 i386 GNU/Linux
packageInfo
	package libnfsidmap is not installed
	package libsss_idmap is not installed
	nfs-utils-1.2.3-39.el6.i686
------------------------------------------------

[23:59:20 root@ /mnt/tests/CoreOS/nfs-utils/commands/utils/rpc-mountd]# rpc.mountd -P
Usage: rpc.mountd [-F|--foreground] [-h|--help] [-v|--version] [-d kind|--debug kind]
	[-o num|--descriptors num] [-f exports-file|--exports-file=file]
	[-p|--port port] [-V version|--nfs-version version]
	[-N version|--no-nfs-version version] [-n|--no-tcp]
	[-H ha-callout-prog] [-s|--state-directory-path path]
	[-g|--manage-gids] [-t num|--num-threads=num]
:: [   FAIL   ] :: Running 'rpc.mountd -P' (Expected 0, got 1)

-------------------------------------------------
And, in RHEL5 same result; maybe we need update man pages,

Comment 5 Steve Dickson 2016-03-10 13:40:20 UTC

The man page is incorrect.... -P is an alias for -p

Comment 6 Yongcheng Yang 2016-05-17 05:33:36 UTC

The needed upstream patch:

commit d0f9df9761d5fc63327fcaa0bc4515e739ca6f0e
Author: Yongcheng Yang <yongcheng.yang>
Date:   Wed Mar 16 12:15:32 2016 -0400

    mountd.man: Update to change -P option as an alias for -p

Comment 9 Yongcheng Yang 2016-10-31 09:23:17 UTC

Moving to VERIFIED according to the test logs of Comment #8.

Also will include this automatic case as regression tests in the future.

Comment 11 errata-xmlrpc 2017-03-21 11:22:47 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://rhn.redhat.com/errata/RHBA-2017-0741.html