pcsc_scan.1 2.57 KB
Newer Older
Ludovic Rousseau's avatar
Ludovic Rousseau committed
1 2 3 4
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
5
.TH PCSC_SCAN 1 "April 10, 2018"
Ludovic Rousseau's avatar
Ludovic Rousseau committed
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
pcsc_scan \- regularly scans every PC/SC readers connected to the host
.SH SYNOPSIS
21
.BI "pcsc_scan [" options ]
Ludovic Rousseau's avatar
Ludovic Rousseau committed
22
.SH DESCRIPTION
23
This manual page documents the
Ludovic Rousseau's avatar
Ludovic Rousseau committed
24 25 26 27
.B pcsc_scan
command.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
28
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
Ludovic Rousseau's avatar
Ludovic Rousseau committed
29 30
.\" respectively.
\fBpcsc_scan\fP is a program that regularly scans every PC/SC readers
31 32
connected to the host and display the status of the cards inserted in
the readers.
Ludovic Rousseau's avatar
Ludovic Rousseau committed
33

34 35
The normal way to exit the program is to use Control-C.

36
When \fBpcsc_scan\fP is started it asks \fBPC/SC layer\fP the list of
Ludovic Rousseau's avatar
Ludovic Rousseau committed
37 38 39 40 41
available smart card readers. The list is printed. A sequence number is
printed before each reader.

Example:
 PC/SC device scanner
42 43 44
 V 1.4.27 (c) 2001-2017, Ludovic Rousseau
 Scanning present readers...
 0: Gemalto PC Twin Reader
Ludovic Rousseau's avatar
Ludovic Rousseau committed
45 46 47

When a card is inserted in any reader some information is printed:
.TP
48
date and time:
49
Wed Apr 12 14:25:30 2017
Ludovic Rousseau's avatar
Ludovic Rousseau committed
50
.TP
51
reader name:
52
Reader 0: Gemalto PC Twin Reader
Ludovic Rousseau's avatar
Ludovic Rousseau committed
53
.TP
54
card state and occurred event:
55
Card state: Card inserted,
Ludovic Rousseau's avatar
Ludovic Rousseau committed
56
.TP
57
ATR in case of card insertion:
Ludovic Rousseau's avatar
Ludovic Rousseau committed
58
ATR: 3B 82 00 86 1E
59 60 61 62 63 64 65 66
.TP
print an ATR analysis if the \fBATR_analysis\fP command is available:
 ATR: 3B 82 00 86 1E
 + TS = 3B --> Direct Convention
 + T0 = 82, Y(1): 1000, K: 2 (historical bytes)
   TD(1) = 00 --> Y(i+1) = 0000, Protocol T = 0
 -----
 + Historical bytes: 86 1E
Ludovic Rousseau's avatar
Ludovic Rousseau committed
67
.SH OPTIONS
68 69 70 71 72 73 74 75
.TP
.B \-h
print help
.TP
.B \-V
print version number
.TP
.B \-n
76 77 78
do not print ATR analysis.
Use this option if \fBATR_analysis\fP is not available for example.
.TP
79 80 81
.B \-r
prints the list of readers and then exits.
.TP
82 83 84
.B \-s
stress mode. Sends APDU commands to the card indefinitely (until the
card or the reader is removed).
85
.TP
86 87 88
.B \-q
quiet: prints minimal messages.
.TP
89
.B \-v
Ludovic Rousseau's avatar
Ludovic Rousseau committed
90
verbose: prints additional messages (default).
Ludovic Rousseau's avatar
Ludovic Rousseau committed
91
.SH SEE ALSO
92
.BR pcscd "(8), " ATR_analysis (1)
Ludovic Rousseau's avatar
Ludovic Rousseau committed
93
.SH AUTHOR
94
Ludovic Rousseau <ludovic.rousseau@free.fr>