User Commands                                   pkloginfinder(1)



NAME
     pkloginfinder - map certificates into a user

SYNOPSIS
     /usr/lib/pampkcs11/pkloginfinder [debug] [configfile=filename]


DESCRIPTION
     pkloginfinder uses the pampkcs11 library infrastructure to
     interactively map a PKCS#11 provided certificate to a user.


     pkloginfinder uses the same configuration  file  and  argu-
     ments than pampkcs11(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:

     configfile=fileame    Set the configuration file.

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


     debug                  Enable debugging output.

                            The default is no debug.



     As it uses the same configuration file as pampkcs11(5), all
     of  the  pampkcs11  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.

          pkcs11inspect 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                                   pkloginfinder(1)



     2    An error occurred.

          No user match was found.


EXAMPLES
     Example 1 Using pkloginfinder


     The  following  example  runs  the  pkloginfinder   command
     without any options:


       % pkcs11inspect



     Example 2 Using pkloginfinder with Options


     The following example  runs  the  pkcsfinder  command  with
     options:


       % pkloginfinder debug configfile=${HOME}/.pampkcs11.conf



FILES
     /etc/security/pampkcs11/pampkcs11.conf




AUTHORS
     Juan Antonio Martinez, jonsito@teleline.es

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















SunOS 5.11          Last change: 17 Jul 2008                    2






User Commands                                   pkloginfinder(1)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE      
    
     Availability                 SUNWpampkcs11u,            
                                  SUNWpampkcs11r,            
                                  SUNWpampkcs11-docs         
   
    Interface Stability          Uncommitted                 
   


SEE ALSO
     pkcs11inspect(1), attributes(5), pampkcs11(5)


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






































SunOS 5.11          Last change: 17 Jul 2008                    3