#1074245 pam_pkcs11 manpage has no useful information and referes to non-existing pam_pkcs11.conf

Package:
libpam-pkcs11
Source:
libpam-pkcs11
Description:
Fully featured PAM module for using PKCS#11 smart cards
Submitter:
Michael Tokarev
Date:
2024-06-25 16:57:03 UTC
Severity:
normal
#1074245#5
Date:
2024-06-25 05:21:39 UTC
From:
To:
the pam_pkcs11 manpage contains no information whatsoever about how to
use the module.  Also, it refers to pam_pkcs11.conf manpage which is not
shipped with the package.  The result of all this is that the module is
basically unusable.  It isn't even clear where pam_pkcs11.conf file should
be.  Okay, examples/READMEs shipped in /usr/share/doc/libpam-pkcs11/
helps a bit, also strings and strace tools, but it's not where one looks
for the info usually.

Thanks,

/mjt
#1074245#10
Date:
2024-06-25 16:55:39 UTC
From:
To:
Le 25/06/2024 à 07:21, Michael Tokarev a écrit :

You can find more documentation on the project web page: https://github.com/OpenSC/pam_pkcs11/blob/master/README.md

PAM-PKCS11 User Manual is available at https://opensc.github.io/pam_pkcs11/doc/pam_pkcs11.html

I am not sure the manpages should contain everything.

As indicated in pam_pkcs11(8) the pam_pkcs11.conf file should be at /etc/pam_pkcs11/pam_pkcs11.conf

I agree the reference to pam_pkcs11.conf(5) is incorrect and should be fixed.
I reported the issue upstream at https://github.com/OpenSC/pam_pkcs11/issues/76

Bye