GIDS-TOOL(1)

    .SH "NAME" gids-tool - smart card utility for GIDS cards
    .SH "SYNOPSIS"
        .HP u
            gids-tool
             [OPTIONS]

    .SH ""
        .PP The gids-tool utility can be used from the command line to perform miscellaneous smart card operations on a GIDS smart card.

    .SH "OPTIONS"

        .PP
                .PP -X, --initialize

                        Initialize token.
                    .RE
                    .PP --admin-key argument

                            Define the administrator key
                        .RE
                        .PP --pin pin

                                    This option can be used to specify the PIN value on the command line. If the value is set to env:VARIABLE, the value of the specified environment variable is used. By default, the code is prompted on the command line if needed.

                                    Note that on most operation systems, any user can display the command line of any process on the system using utilities such as ps(1). Therefore, you should prefer passing the codes via an environment variable on an unsecured system.

                            .RE
                            .PP --serial-number argument

                                    Define serial number.
                                .RE
                                .PP -U, --unblock

                                        Unblock the user PIN after an administrator authentication.
                                    .RE
                                    .PP -C, --change-admin-key

                                            Change the administrator key.
                                        .RE
                                        .PP --new-admin-key argument

                                                Define the new administrator key.
                                            .RE
                                            .PP --reader argument, -r argument

                                                        Number of the reader to use. By default, the first reader with a present card is used. If argument is an ATR, the reader with a matching card will be chosen.

                                                .RE
                                                .PP -w, --wait

                                                        Wait for a card to be inserted.
                                                    .RE
                                                    .PP -v, --verbose

                                                            Verbose operation. Use several times to enable debug output.
                                                        .RE

                                            .SH "SEE ALSO"

                                                .PP opensc-tool(1)

                                            .SH "AUTHORS"

                                                .PP gids-tool was written by Vincent Le Toux <vincent.letoux@mysmartlogon.com>.