.\"                                      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 "February 18, 2026"
.\" 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 \- پویش منظم تمامی کارت‌خوان‌های PC/SC متصل به میزبان
.SH "خلاصه دستور (SYNOPSIS)"
.BI "pcsc_scan [" گزینه‌ها ]
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما دستور
.B pcsc_scan
را مستندسازی می‌کند.
.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 ابزاری است که به‌طور منظم تمامی کارت‌خوان‌های PC/SC متصل به میزبان را پویش کرده و وضعیت کارت‌های وارد شده در کارت‌خوان‌ها را نمایش می‌دهد.

روش معمول برای خروج از این برنامه استفاده از Control-C است.

هنگامی که \fBpcsc_scan\fP آغاز به کار می‌کند، فهرست کارت‌خوان‌های کارت هوشمند موجود را از \fBPC/SC layer\fP درخواست می‌کند. این فهرست نمایش داده می‌شود و پیش از نام هر کارت‌خوان، یک شمارهٔ ترتیبی چاپ می‌شود.

مثال:
 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

هنگامی که کارتی در هر یک از کارت‌خوان‌ها وارد شود، اطلاعاتی نمایش داده می‌شود:
.TP
تاریخ و زمان:
Mon Oct  2 21:01:40 2023
.TP
نام کارت‌خوان:
Reader 0: Gemalto PC Twin Reader
.TP
وضعیت کارت و رخداد پیش‌آمده:
Card state: Card inserted,
.TP
مقدار ATR در هنگام وارد شدن کارت:
ATR: 3B 82 00 86 1E
.TP
چاپ تحلیل ATR در صورت در دسترس بودن دستور \fBATR_analysis\fP:
 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
نمایش راهنما.
.TP
.B \-V
نمایش شمارهٔ نسخه.
.TP
.B \-n
عدم چاپ تحلیل ATR.
برای مثال در صورتی که \fBATR_analysis\fP در دسترس نباشد از این گزینه استفاده کنید.
.TP
.B \-r
چاپ فهرست کارت‌خوان‌ها و سپس خروج.
.TP
.B \-c
چاپ فهرست کارت‌ها و سپس خروج.
.TP
.B \-s
حالت آزمون فشار (stress mode). دستورهای APDU را به‌طور نامحدود (تا زمانی که کارت یا کارت‌خوان جدا شود) به کارت ارسال می‌کند.
.TP
.B \-t secs
مشخص کردن مدت‌زمان اجرای برنامه بر حسب ثانیه. برنامه پس از سپری شدن این زمان خاتمه می‌یابد.
.TP
.B \-d
اشکال‌زدایی (debug): چاپ تغییرات رخ‌داده میان فیلدهای .dwCurrentState و .dwEventState برای هر کارت‌خوان.
.TP
.B \-p
اتصال و اجرا (Plug and Play): اجبار به استفاده از کارت‌خوان خاص "\\\\?PnP?\\Notification".
.SH "همچنین ببینید (SEE ALSO)"
.BR pcscd "(8), " ATR_analysis (1)
.SH "نویسندگان (AUTHORS)"
Ludovic Rousseau <ludovic.rousseau@free.fr>