NAME 

pklogin_finder - maps certificates into a user

SYNTAX 

pklogin_finder [debug] [config_file=<filename>]

DESCRIPTION 

pklogin_finder uses the pam_pkcs11 library infrastructure to interactively map a PKCS#11 provided certificate to a user. pklogin_finder uses the the same configuration file and arguments than (8) PAM module. Load defined mapper modules, and try to find a map between found certificates and a user login.

OPTIONS 

debug
Enable debugging output. Default is no debug.
config_file=<configuration file>
Sets the configuration file to use. Default value is /etc/pam_pkcs11/pam_pkcs11.conf. As it uses the same configuration file than pam_pkcs11, all pam_pkcs11 options are also available. Note that some of them has no sense in a non-PAM environment, so they will be ignored.

RETURN VALUE 

On success pklogin_finder prints on stdout the login name and exits returns 0. On user mapping error it returns 1. On no user match it prints nothing and returns 2.

FILES 

/etc/pam_pkcs11/pam_pkcs11.conf

EXAMPLES 

To run this program the standard way, insert a smart card into the reader and type: pklogin_finder Alternatively you can specify options: pklogin_finder debug config_file=${HOME}/.pam_pkcs11.conf

AUTHORS 

Juan Antonio Martinez <jonsito@teleline.es>

SEE ALSO 

(8), pkcs11_inspect(1), PAM-PKCS11 User Manual