Package: opensc
Version: 0.11.4-5

pkcs15-init(1) suggests that -P is equivalent to --store-public-key,
while the output of pkcs15-init -h suggests that -P is in fact
equivalent to --store-pin (which is itself not documented in the man
page)

[0 [EMAIL PROTECTED] ~]$ man pkcs15-init | grep -A4 '.-P'
       --store-public-key filename, -P filename
          Tells pkcs15-init to download the specified public key to the card
          and create a public key object with the key ID specified via the
          --id. By default, the file is assumed to contain the key in PEM
          format. Alternative formats can be specified using --format.
[0 [EMAIL PROTECTED] ~]$ pkcs15-init -h | grep '.-P'
  --store-pin, -P               Store a new PIN/PUK on the card
[0 [EMAIL PROTECTED] ~]$ 

This could be quite a surprise for someone trying to work from the man
page, and makes me worry that there may be other errors lurking in the
man page.  Misleading documentation can sometimes be worse than no
documentation at all :/ The fact that you can actually destroy most
smartcards by doing the wrong thing too many times in a row makes
mixups in the documentation extra troublesome, though i don't think
this mixup itself is inherently dangerous that way.

Thanks for maintaining opensc in debian!

       --dkg

Attachment: pgpQEMLJSkKcx.pgp
Description: PGP signature

Reply via email to