pkcs11_inspect(1)

1pkcs11_inspect(1)                 PAM PKCS#11                pkcs11_inspect(1)
2
3
4

NAME

6       pkcs11_inspect - print certificate contents
7

SYNOPSIS

9       pkcs11_inspect [debug] [config_file=<filename>]
10

DESCRIPTION

12       pkcs11_inspect  uses  the  pam_pkcs11 library infrastructure to get the
13       content of a certificate and display it.
14
15       pkcs11_inspect uses the same  configuration  file  and  arguments  than
16       pam_pkcs11(8) PAM module. It loads defined mapper modules, and use them
17       to look into the certificate for required entries (ie: ms_mapper  looks
18       for ms UPN entries, and so on).
19
20       When  a  mapper module finds a proper entry in the certificate, it con‐
21       verts to UTF-8 and print it to stdout.
22

OPTIONS

24       debug  Enable debugging output.
25
26       config_file=<filename>
27              Sets  the  configuration  file  to   use.   Default   value   is
28              /etc/pam_pkcs11/pam_pkcs11.conf.
29
30       As  it  uses  the same configuration file as pam_pkcs11, all pam_pkcs11
31       options are also available. Note that some of them have no sense  in  a
32       non-PAM environment, so they will be ignored. Some mapper options (map‐
33       file, ignorecase) have no effect on certificate contents, so they  will
34       be ignored too.
35

RETURN VALUE

37       On  success  pkcs11_inspect  prints  on stdout all certificate contents
38       that are found for mappers and returns 0.
39
40       On error it returns 1.
41

FILES

43       /etc/pam_pkcs11/pam_pkcs11.conf
44

EXAMPLES

46       To run this program the standard way, insert a smart card in the reader
47       and type:
48
49        pkcs11_inspect
50
51       Alternatively you can specify options:
52
53        pkcs11_inspect debug config_file=${HOME}/.pam_pkcs11.conf
54

AUTHORS

56       Juan Antonio Martinez <jonsito@teleline.es>
57