Examples are lacking leading to use confusion. about opensc HOT 6 CLOSED

Improvement to documentation to make this tool more accessible to enable people to use pkcs11 more readily.

Your contributions are happily welcome. Currently, documentation of this kind is driven by special interests - please consult the wiki pages regarding your token type whether this is covered. If it is not, first get in touch with the token creator how to do this. If this doesn't give any feedback, you can open a more specific issue here.

from opensc.

Improvement to documentation to make this tool more accessible to enable people to use pkcs11 more readily.

Your contributions are happily welcome. Currently, documentation of this kind is driven by special interests - please consult the wiki pages regarding your token type whether this is covered. If it is not, first get in touch with the token creator how to do this. If this doesn't give any feedback, you can open a more specific issue here.

And how am I meant to contribute improvements to the examples, If I can't work out how to use the tool in the first place? 🤔

I can't document something that I can't work out ....

I am aware of the audience of pkcs11-tool being professionals and administrators, but even with nearly a decade of sysadmin experience the current man page is dense and hard to use at best.

For example, if I wanted to wrap a key to move to another token, there is no clear way to do this because the --wrap option doesn't show you what other options are needed to work with it.

from opensc.

Btw, the primary focus of OpenSC to make tokens work in a PKCS#11 module via end user applications (e.g. Browser, VPN, E-Mail). The targeted audience of pkcs11-tool is professionals rather than end users, so please don't expect end user documentation for pkcs11-tool.

from opensc.

I just added some examples to the pkcs11-tool manual page, they are available in PR #2936. Try to look in the OpenSC source code, there are integration tests that test wrap/unwrap (tests/test-pkcs11-tool-unwrap-wrap-test.sh).

from opensc.

Thank you! I'll have a look!

from opensc.

Maybe we can also move some of the examples from https://github.com/OpenSC/OpenSC/tree/master/tests into the manual pages with some explanatory text

from opensc.