Manual Pages for UNIX Operating System command usage for man pklogin_finder

User Commands                                   pklogin_finder(1)



NAME
     pklogin_finder - map certificates into a user

SYNOPSIS
     /usr/lib/pam_pkcs11/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 same configuration  file  and  argu-
     ments than pam_pkcs11(5) PAM module. It loads defined mapper
     modules and tries to find a map between  found  certificates
     and a user login.

OPTIONS
     The following options are supported:

     config_file=fileame    Set the configuration file.

                            The      default       value       is
                            /etc/security/pam_pkcs11/pam_pkcs11.conf.


     debug                  Enable debugging output.

                            The default is no debug.



     As it uses the same configuration file as pam_pkcs11(5), all
     of  the  pam_pkcs11  options  are  available.  Some of these
     options make no sense in  a  non-PAM  environment,  and  are
     therefore ignored. Some mapper options (mapfile, ignorecase)
     have no effect on certificate contents, and they are ignored
     as well.

EXIT STATUS
     The following exit values are returned:

     0    Successful completion.

          pkcs11_inspect prints on  stdout  the  login  name  and
          exits.


     1    An error occurred.

          A user mapping error was found.




SunOS 5.11          Last change: 17 Jul 2008                    1






User Commands                                   pklogin_finder(1)



     2    An error occurred.

          No user match was found.


EXAMPLES
     Example 1 Using pklogin_finder


     The  following  example  runs  the  pklogin_finder   command
     without any options:


       % pkcs11_inspect



     Example 2 Using pklogin_finder with Options


     The following example  runs  the  pkcs_finder  command  with
     options:


       % pklogin_finder debug config_file=${HOME}/.pam_pkcs11.conf



FILES
     /etc/security/pam_pkcs11/pam_pkcs11.conf




AUTHORS
     Juan Antonio Martinez, jonsito@teleline.es

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:















SunOS 5.11          Last change: 17 Jul 2008                    2






User Commands                                   pklogin_finder(1)



     ________________________________________________________________
   |        ATTRIBUTE TYPE       |          ATTRIBUTE VALUE        |
   | ____________________________|_________________________________|_
   |  Availability               |  library/security/pam/module/pam-|
   |                             |  pkcs11,     SUNWpampkcs11r,    |
   |                             |  SUNWpampkcs11-docs             |
   |_____________________________|_________________________________|
   | Interface Stability         | Uncommitted                     |
   |_____________________________|_________________________________|


SEE ALSO
     pkcs11_inspect(1), attributes(5), pam_pkcs11(5)


     PAM-PKCS11       User       Manual,       http://www.opensc-
     project.org/pam_pkcs11






































SunOS 5.11          Last change: 17 Jul 2008                    3