tools: Add util_get_pin helper function

Using this helper PINs can be passed via the command line, stdin and an
environment variable.

For now only used in the openpgp tool.

closes #289
use util_get_pin in tools
fixed documentation of dnie-tool
Merge pull request #320 from frankmorgner/tools-pin

Optimize util_get_pin from #289