/
pcsc_scan.1
108 lines (104 loc) · 2.95 KB
/
pcsc_scan.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
.\" 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)
.TH PCSC_SCAN 1 "Oct 2, 2023"
.\" 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
.BI "pcsc_scan [" options ]
.SH DESCRIPTION
This manual page documents the
.B pcsc_scan
command.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBpcsc_scan\fP is a program that regularly scans every PC/SC readers
connected to the host and display the status of the cards inserted in
the readers.
The normal way to exit the program is to use Control-C.
When \fBpcsc_scan\fP is started it asks \fBPC/SC layer\fP the list of
available smart card readers. The list is printed. A sequence number is
printed before each reader.
Example:
PC/SC device scanner
V 1.6.2 (c) 2001-2022, Ludovic Rousseau <ludovic.rousseau@free.fr>
Scanning present readers...
0: Gemalto PC Twin Reader
When a card is inserted in any reader some information is printed:
.TP
date and time:
Mon Oct 2 21:01:40 2023
.TP
reader name:
Reader 0: Gemalto PC Twin Reader
.TP
card state and occurred event:
Card state: Card inserted,
.TP
ATR in case of card insertion:
ATR: 3B 82 00 86 1E
.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
.SH OPTIONS
.TP
.B \-h
print help
.TP
.B \-V
print version number
.TP
.B \-n
do not print ATR analysis.
Use this option if \fBATR_analysis\fP is not available for example.
.TP
.B \-r
prints the list of readers and then exits.
.TP
.B \-c
prints the list of cards and then exits.
.TP
.B \-s
stress mode. Sends APDU commands to the card indefinitely (until the
card or the reader is removed).
.TP
.B \-t secs
specify time program should run, in seconds. The program will terminate when this
time has passed.
.TP
.B \-q
quiet: prints minimal messages.
.TP
.B \-v
verbose: prints additional messages (default).
.TP
.B \-d
debug: prints what changed between .dwCurrentState and .dwEventState
fields for each reader.
.TP
.B \-p
Plug and Play: force the use of the "\\\\?PnP?\\Notification" specific reader.
.SH SEE ALSO
.BR pcscd "(8), " ATR_analysis (1)
.SH AUTHOR
Ludovic Rousseau <ludovic.rousseau@free.fr>