OPENPGP-TOOL(1)

    .SH "NAME" openpgp-tool - utility for accessing visible data OpenPGP smart cards and compatible tokens
    .SH "SYNOPSIS"
        .HP u
            openpgp-tool
             [OPTIONS]

    .SH "DESCRIPTION"

        .PP The openpgp-tool utility is used for accessing data from the OpenPGP v1.1 and v2.0 smart cards and compatible tokens like e.g. GPF CryptoStick v1.x, which might not be present in PKCS#15 objects but available in custom files on the card. The data can be printed on screen or used by other programs via environment variables.

    .SH "OPTIONS"

        .PP
                .PP --card-info, -C

                        Show card information.
                    .RE
                    .PP --del-key arg

                            Delete key indicated by arg. arg can be 1, 2, 3, or all.
                        .RE
                        .PP --do arg, -d arg

                                Dump private data object (DO) indicated by arg. arg can be in the form x, 10x, or 010x to access DO 010x, where x is 1, 2, 3, or 4.
                            .RE
                            .PP --erase, -E

                                    Erase (i.e. reset) the card.
                                .RE
                                .PP --exec prog, -x prog

                                        Execute the given program with data in environment variables.
                                    .RE
                                    .PP --gen-key arg, -G arg

                                            Generate key with the ID given as arg. arg can be one of 1, 2, or 3.
                                        .RE
                                        .PP --help, -h

                                                Print help message on screen.
                                            .RE
                                            .PP --key-info, -K

                                                    Show information of keys on the card.
                                                .RE
                                                .PP --key-type keytype, -t keytype

                                                        Specify the type of the key to be generated. Supported values for keytype are rsa for RSA with 2048 bits, rsaLENGTH for RSA with a bit length of LENGTH. If not given, it defaults to rsa2048.
                                                    .RE
                                                    .PP --pin string

                                                            The PIN text to verify. If set to env:VARIABLE, the value of the environment variable VARIABLE is used.
                                                        .RE
                                                        .PP --pretty

                                                                Print values in pretty format.
                                                            .RE
                                                            .PP --raw

                                                                    Print values in raw format, as they are stored on the card.
                                                                .RE
                                                                .PP --reader arg, -r arg

                                                                        Number of the reader to use. By default, the first reader with a present card is used. If arg is an ATR, the reader with a matching card will be chosen.
                                                                    .RE
                                                                    .PP --user-info, -U

                                                                            Show card holder information.
                                                                        .RE
                                                                        .PP --verify pintype

                                                                                Verify PIN (CHV1, CHV2 or CHV3).
                                                                            .RE
                                                                            .PP --version, -V

                                                                                    Print the version of the utility and exit.
                                                                                .RE
                                                                                .PP --verbose, -v

                                                                                        Verbose operation. Use several times to enable debug output.
                                                                                    .RE
                                                                                    .PP --wait, -w

                                                                                            Wait for a card to be inserted.
                                                                                        .RE

                                                                            .SH "AUTHORS"

                                                                                .PP openpgp-tool utility was written by Peter Marschall <peter@adpm.de>.