Bug 1475496

Summary: systemd: add a blurb about masking rpc-gssd to the man page
Product: Red Hat Enterprise Linux 7 Reporter: ChunYu Wang <chunwang>
Component: nfs-utilsAssignee: Steve Dickson <steved>
Status: CLOSED WONTFIX QA Contact: Yongcheng Yang <yoyang>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.4CC: xzhou, yoyang
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-01-15 07:40:19 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 ChunYu Wang 2017-07-26 19:13:08 UTC
-- Description of problem:

Upstream has just included a patch to improve manual page nfs.systemd(7), maybe we would better improve our man page to sync up:

commit e8eb9e14411d9ef95e5eb26065dee7166052448e
Author: Scott Mayhew <smayhew>
Date:   Wed Jul 26 14:03:12 2017 -0400

    systemd: add a blurb about masking rpc-gssd to the man page
    
    This is helpful for users that have a krb5.keytab but do not want to use
    secure NFS.  Also fixed a typo that appears earlier on the page.
    
    Reviewed-by: NeilBrown <neilb>
    Signed-off-by: Scott Mayhew <smayhew>
    Signed-off-by: Steve Dickson <steved>

-- file diff

[chunwang@bootp-73-5-215 ~]$ diff ./nfs.systemd.original ./nfs.systemd.git.e8eb9e1441 
3,4d2
< 
< 
43c41
<        Several	other  units  which  might  be considered to be optional, such as rpc-gssd.service are careful to only start if the required configuration file exists.	 rpc-gsdd.service will not start if the

       ^^^^^^ rpc-gsdd is a typo error

---
>        Several	other  units  which  might  be considered to be optional, such as rpc-gssd.service are careful to only start if the required configuration file exists.	 rpc-gssd.service will not start if the
61,62c59,60
<        Two particular services which this can apply to are rpcbind and idmapd.	rpcbind is not part of the nfs-utils package, but it used by several NFS services.  However it is not needed when only NFSv4 is
<        in use.	If a site will never use NFSv3 (or NFSv2) and does not want rpcbind to be running, the correct approach is to run
---
>        Three  particular services which this can apply to are rpcbind, idmapd, and rpc-gssd.  rpcbind is not part of the nfs-utils package, but it used by several NFS services.  However it is not needed when
>        only NFSv4 is in use.  If a site will never use NFSv3 (or NFSv2) and does not want rpcbind to be running, the correct approach is to run
69a68,69
>        rpc-gssd is assumed to be needed if the krb5.keytab file is present.  If a site needs this file present but does not want rpc-gssd running, it can be masked with
> 	      systemctl mask rpc-gssd
78,79d77
< 
< 

-- Version-Release number of selected component (if applicable):
[chunwang@bootp-73-5-215 /]$ rpm -q nfs-utils
nfs-utils-1.3.0-0.48.el7.x86_64

Comment 3 RHEL Program Management 2021-01-15 07:40:19 UTC
After evaluating this issue, there are no plans to address it further or fix it in an upcoming release.  Therefore, it is being closed.  If plans change such that this issue will be fixed in an upcoming release, then the bug can be reopened.