Bug 1180186

Summary: Man page pam_pkcs11.conf(5) is not available even if man page pam_pkcs11(8) references it
Product: Red Hat Enterprise Linux 7 Reporter: Jan Pazdziora (Red Hat) <jpazdziora>
Component: pam_pkcs11Assignee: Bob Relyea <rrelyea>
Status: CLOSED ERRATA QA Contact: Asha Akkiangady <aakkiang>
Severity: low Docs Contact:
Priority: low    
Version: 7.0CC: arubin, rpattath
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: pam_pkcs11-0.6.2-23.el7 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-11-19 13:01:12 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 Jan Pazdziora (Red Hat) 2015-01-08 15:20:17 UTC
Description of problem:

man pam_pkcs11(8) ends with

SEE ALSO
       pam(8),   pam_pkcs11.conf(5),   PAM   Systems   Administrator    Guide,
       README.mappers file, PAM-PKCS#11 User Manual.

However, man pam_pkcs11.conf does not yield any hit.

Version-Release number of selected component (if applicable):

pam_pkcs11-0.6.2-17.el7.x86_64

How reproducible:

Deterministic.

Steps to Reproduce:
1. Read man page about pam_pkcs11.
2. Try to learn more about the configuration file.
3. Using SEE ALSO's clue, try man pam_pkcs11.conf.

Actual results:

No manual entry for pam_pkcs11.conf

Expected results:

Man page shown or pam_pkcs11.conf(5) not listed in pam_pkcs11(8).

Additional info:

Comment 2 Bob Relyea 2015-01-12 22:03:26 UTC
reasonable thing to fix in 7.2

Comment 4 Bob Relyea 2015-07-06 22:23:07 UTC
remove dangling reference to non-existant pam_pkcs11.conf(5) and fix up pointer to Admin doc which contains the required information for the user.

Comment 5 Bob Relyea 2015-07-06 22:42:06 UTC
fixed in pam_pkcs11-0.6.2-19.el7

Comment 7 Roshni 2015-08-31 00:05:37 UTC
[root@ipaqavmd ~]# rpm -qi pam_pkcs11
Name        : pam_pkcs11
Version     : 0.6.2
Release     : 21.el7
Architecture: x86_64
Install Date: Sun 30 Aug 2015 07:54:43 PM EDT
Group       : System Environment/Base
Size        : 1105588
License     : LGPLv2+
Signature   : RSA/SHA256, Wed 05 Aug 2015 04:46:25 AM EDT, Key ID 938a80caf21541eb
Source RPM  : pam_pkcs11-0.6.2-21.el7.src.rpm
Build Date  : Mon 06 Jul 2015 11:27:53 PM EDT
Build Host  : x86-018.build.eng.bos.redhat.com
Relocations : (not relocatable)
Packager    : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>
Vendor      : Red Hat, Inc.
URL         : http://www.opensc-project.org/pam_pkcs11
Summary     : PKCS #11/NSS PAM login module

U sing the above build, I still see the following

man pam_pkcs11(8) ends with

SEE ALSO
       pam(8),   pam_pkcs11.conf(5),   PAM   Systems   Administrator    Guide,
       README.mappers file, PAM-PKCS#11 User Manual.

[root@ipaqavmd ~]# man pam_pkcs11.conf
No manual entry for pam_pkcs11.conf

Comment 8 Bob Relyea 2015-09-01 00:52:44 UTC
Good catch Roshni. I had changed the target file but not the source that it's built from. The build rebuilt the old incorrect version. This build now changes both.

Comment 10 Roshni 2015-09-02 16:22:16 UTC
[root@dhcp129-45 ~]# rpm -qi pam_pkcs11
Name        : pam_pkcs11
Version     : 0.6.2
Release     : 23.el7
Architecture: x86_64
Install Date: Wed 02 Sep 2015 12:17:49 PM EDT
Group       : System Environment/Base
Size        : 1104350
License     : LGPLv2+
Signature   : (none)
Source RPM  : pam_pkcs11-0.6.2-23.el7.src.rpm
Build Date  : Mon 31 Aug 2015 08:45:08 PM EDT
Build Host  : x86-020.build.eng.bos.redhat.com
Relocations : (not relocatable)
Packager    : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>
Vendor      : Red Hat, Inc.
URL         : http://www.opensc-project.org/pam_pkcs11
Summary     : PKCS #11/NSS PAM login module

pam_pkcs11.conf(5) no longer exist in man pam_pkcs11

SEE ALSO
       pam(8),         PAM         Systems         Administrator         Guide
       (/usr/share/doc/pam_pkcs11-0.6.2/pam_pkcs11.htm    l),   README.mappers
       file, PAM-PKCS#11 User Manual.

Comment 11 errata-xmlrpc 2015-11-19 13:01:12 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/RHEA-2015-2415.html