pkcs11_inspect(1) User Commands pkcs11_inspect(1)
NAME
pkcs11_inspect - print certificate contents
SYNOPSIS
/usr/lib/pam_pkcs11/pkcs11_inspect [debug] [config_file=filename]
DESCRIPTION
pkcs11_inspect uses the pam_pkcs11 library infrastructure to obtain the content of a certificate and display it.
pkcs11_inspect uses the same configuration file and arguments as the pam_pkcs11(5) PAM module. It loads defined mapper modules, and uses
them to look into the certificate for required entries, that is, ms_mapper looks for ms UPN entries, and so forth.
When a mapper module finds a proper entry in the certificate, it converts to UTF-8 and prints it to stdout.
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.
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 all certificate contents that are found for mappers.
1 An error occurred.
EXAMPLES
Example 1 Using pkcs_inspect
The following example runs the pkcs_inspect command without any options:
% pkcs11_inspect
Example 2 Using pkcs_inspect with Options
The following example runs the pkcs_inspect command with options:
% pkcs11_inspect 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 attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWpampkcs11u, SUNWpamp- |
| |kcs11r, SUNWpampkcs11-docs |
+-----------------------------+-----------------------------+
|Interface Stability |Uncommitted |
+-----------------------------+-----------------------------+
SEE ALSO
pklogin_finder(1), attributes(5), pam_pkcs11(5)
PAM-PKCS11 User Manual, http://www.opensc-project.org/pam_pkcs11
SunOS 5.11 16 Jul 2008 pkcs11_inspect(1)