'\" t
.\"     Title: dnie-tool
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/10/2024
.\"    Manual: OpenSC Tools
.\"    Source: opensc
.\"  Language: English
.\"
.TH "DNIE\-TOOL" "1" "03/10/2024" "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"
dnie-tool \- displays information about DNIe based security tokens
.SH "SYNOPSIS"
.HP \w'\fBdnie\-tool\fR\ 'u
\fBdnie\-tool\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.PP
The
\fBdnie\-tool\fR
utility is used to display additional information about DNIe, the Spanish National eID card\&.
.SH "OPTIONS"
.PP
.PP
\fB\-\-idesp\fR, \fB\-i\fR
.RS 4
Show the DNIe IDESP value\&.
.RE
.PP
\fB\-\-data\fR, \fB\-d\fR
.RS 4
Show DNIe personal information\&. Reads and print DNIe number and User Name and SurName
.RE
.PP
\fB\-\-all\fR, \fB\-a\fR
.RS 4
Displays every available information\&. This command is equivalent to \-d \-i \-V \-s
.RE
.PP
\fB\-\-serial\fR, \fB\-s\fR
.RS 4
Displays DNIe Serial Number
.RE
.PP
\fB\-\-version\fR, \fB\-V\fR
.RS 4
Show DNIe sw version\&. Displays software version for in\-card DNIe OS
.RE
.PP
\fB\-\-pin\fR \fIpin\fR, \fB\-p\fR \fIpin\fR
.RS 4
These options 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\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR
.RS 4
Number of the reader to use\&. By default, the first reader with a present card is used\&. If
\fIarg\fR
is an ATR, the reader with a matching card will be chosen\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
Causes
\fBdnie\-tool\fR
to wait for the token to be inserted into reader\&.
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
Causes
\fBdnie\-tool\fR
to be more verbose\&. Specify this flag several times to enable debug output in the opensc library\&.
.RE
.SH "AUTHORS"
.PP
\fBdnie\-tool\fR
was written by Juan Antonio Martinez
<jonsito@terra\&.es>\&.