Man page - pklogin_finder(1)

Packages contains this manual

Package: libpam-pkcs11
apt-get install libpam-pkcs11

Manuals in package:

Documentations in package:

libpam-pkcs11

Manual

pklogin_finder

NAME
SYNTAX
DESCRIPTION
OPTIONS
RETURN VALUE
FILES
EXAMPLES
AUTHORS
SEE ALSO

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 pam_pkcs11 (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>