'\" t
.\" Title: gids-tool
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 01/14/2025
.\" Manual: OpenSC Tools
.\" Source: opensc
.\" Language: English
.\"
.TH "GIDS\-TOOL" "1" "01/14/2025" "opensc" "OpenSC Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gids-tool \- smart card utility for GIDS cards
.SH "SYNOPSIS"
.HP \w'\fBgids\-tool\fR\ 'u
\fBgids\-tool\fR [\fIOPTIONS\fR]
.SH ""
.PP
The
\fBgids\-tool\fR
utility can be used from the command line to perform miscellaneous smart card operations on a GIDS smart card\&.
.SH "OPTIONS"
.PP
.PP
\fB\-X\fR, \fB\-\-initialize\fR
.RS 4
Initialize token\&.
.RE
.PP
\fB\-\-admin\-key\fR \fIargument\fR
.RS 4
Define the administrator key
.RE
.PP
\fB\-\-pin\fR \fIpin\fR
.RS 4
This option can be used to specify the PIN value on the command line\&. If the value is set to
env:\fIVARIABLE\fR, the value of the specified environment variable is used\&. By default, the code is prompted on the command line if needed\&.
.sp
Note that on most operation systems, any user can display the command line of any process on the system using utilities such as
\fBps(1)\fR\&. Therefore, you should prefer passing the codes via an environment variable on an unsecured system\&.
.RE
.PP
\fB\-\-serial\-number\fR \fIargument\fR
.RS 4
Define serial number\&.
.RE
.PP
\fB\-U\fR, \fB\-\-unblock\fR
.RS 4
Unblock the user PIN after an administrator authentication\&.
.RE
.PP
\fB\-C\fR, \fB\-\-change\-admin\-key\fR
.RS 4
Change the administrator key\&.
.RE
.PP
\fB\-\-new\-admin\-key\fR \fIargument\fR
.RS 4
Define the new administrator key\&.
.RE
.PP
\fB\-\-reader\fR \fIargument\fR, \fB\-r\fR \fIargument\fR
.RS 4
Number of the reader to use\&. By default, the first reader with a present card is used\&. If
\fIargument\fR
is an ATR, the reader with a matching card will be chosen\&.
.RE
.PP
\fB\-w\fR, \fB\-\-wait\fR
.RS 4
Wait for a card to be inserted\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Verbose operation\&. Use several times to enable debug output\&.
.RE
.SH "SEE ALSO"
.PP
\fBopensc-tool\fR(1)
.SH "AUTHORS"
.PP
\fBgids\-tool\fR
was written by Vincent Le Toux
\&.