'\" t
.\"     Title: eidenv
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/05/2024
.\"    Manual: OpenSC Tools
.\"    Source: opensc
.\"  Language: English
.\"
.TH "EIDENV" "1" "04/05/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"
eidenv \- utility for accessing visible data from electronic identity cards
.SH "SYNOPSIS"
.HP \w'\fBeidenv\fR\ 'u
\fBeidenv\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.PP
The
\fBeidenv\fR
utility is used for accessing data from electronic identity cards (like national eID cards) 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
\fB\-\-exec\fR \fIprog\fR, \fB\-x\fR \fIprog\fR
.RS 4
Executes the given program with data in environment variables\&.
.RE
.PP
\fB\-\-help\fR, \fB\-h\fR
.RS 4
Print help message on screen\&.
.RE
.PP
\fB\-\-print\fR, \fB\-p\fR
.RS 4
Prints all data fields from the card, like validity period, document number etc\&.
.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\-\-stats\fR, \fB\-t\fR
.RS 4
Prints key usage statistics (only for Estonian ID card)\&.
.RE
.PP
\fB\-\-version\fR, \fB\-v\fR
.RS 4
Prints the version of the utility and exits\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
Wait for a card to be inserted
.RE
.SH "AUTHORS"
.PP
\fBeidenv\fR
utility was written by Stef Hoeben and Martin Paljak
<martin@martinpaljak\&.net>\&.