نام (NAME)

pcscd - دیمن کارت هوشمند PC/SC

خلاصه دستور (SYNOPSIS)

pcscd [-acfTdeCvHSI] [--apdu] [--config dir] [--foreground] [--color] [--debug] [--info] [--error] [--critical] [--force-reader-polling] [-t number] [--max-thread number] [-s number] [--max-card-handle-per-thread number] [-r number] [--max-card-handle-per-reader number] [--version] [--hotplug] [--reader-name-no-serial] [--reader-name-no-interface] [--disable-polkit]

pcscd -h

pcscd --help

گزینه‌ها (OPTIONS)

-a, --apdu: ثبت گزارش‌های مربوط به APDU و SW با استفاده از روش اشکال‌زدایی (به --debug مراجعه کنید).
-c, --config dir: پوشه dir را به عنوان مکانی جایگزین برای /etc/reader.conf.d/ مشخص می‌کند. این آرگومان همچنین می‌تواند یک فایل پیکربندی تکی باشد (برای سازگاری با نسخه‌های پیشین).
-f, --foreground: اجرای pcscd در پیش‌زمینه و ارسال پیام‌های گزارش به جای syslog(3) به خروجی خطای استاندارد (stderr).
-T, --color: اجبار به استفاده از گزارش‌های رنگی.
-d, --debug: استفاده از پایین‌ترین سطح گزارش‌گیری. هر پیام گزارش در این سطح یا بالاتر، بسته به استفاده از --foreground به stderr یا syslog(3) فرستاده می‌شود.
--info: استفاده از سطح گزارش‌گیری info. این سطح پیش‌فرض گزارش‌گیری است.
-e, --error: استفاده از سطح گزارش‌گیری error.
-C, --critical: استفاده از سطح گزارش‌گیری critical.

سطوح گزارش‌گیری به این ترتیب مرتب شده‌اند: debug < info < error < critical. استفاده از سطح l این سطح و تمام سطوح بالاتر از آن را ثبت می‌کند.

--force-reader-polling: نادیده گرفتن قابلیت IFD_GENERATE_HOTPLUG کارت‌خوان.
-t, --max-thread number: حداکثر تعداد رشته‌ها (پیش‌فرض: ۲۰۰).
این مقدار حداکثر تعداد کلاینت‌هایی (SCardEstablishContext) است که pcscd می‌تواند مدیریت کند.
-s, --max-card-handle-per-thread number: حداکثر تعداد دستگیره کارت به ازای هر رشته (پیش‌فرض: ۲۰۰).
این مقدار حداکثر تعداد دستگیره کارت (SCardConnect) به ازای هر کلاینت (SCardEstablishContext) است.
-r, --max-card-handle-per-reader number: حداکثر تعداد دستگیره کارت به ازای هر کارت‌خوان (پیش‌فرض: ۲۰۰).
این مقدار حداکثر تعداد دستگیره کارت (SCardConnect) به ازای هر کارت‌خوان است.
-h, --help: نمایش اطلاعات درباره خط فرمان pcscd.
-v, --version: نمایش شماره نسخه برنامه.
-H, --hotplug: درخواست از pcscd برای خواندن دوباره فایل‌های /etc/reader.conf.d/my_reader.conf جهت تشخیص کارت‌خوان‌های غیر USB اضافه یا حذف شده (سریال یا PCMCIA).
-x, --auto-exit: برنامه pcscd پس از ۶۰ ثانیه بی‌کاری و پس از آزادسازی آخرین بافتار PC/SC خارج خواهد شد. این گزینه زمانی به کار می‌رود که pcscd بر اساس تقاضا توسط systemd اجرا شده باشد.
-S, --reader-name-no-serial: عدم گنجاندن شماره سریال USB در نام کارت‌خوان.
-I, --reader-name-no-interface: عدم گنجاندن نام رابط USB در نام کارت‌خوان.
--disable-polkit: نادیده گرفتن قوانین polkit. تمام دسترسی‌ها مجاز دانسته می‌شوند.

توضیحات (DESCRIPTION)

برنامه pcscd دیمن مربوط به pcsc-lite است. این برنامه یک مدیر منابع است که ارتباطات با کارت‌خوان‌های هوشمند، کارت‌های هوشمند و نشانه‌های رمزنگاری متصل به سیستم را هماهنگ می‌کند.

این برنامه به نرم‌افزارها اجازه می‌دهد با استفاده از رابط برنامه‌نویسی WinSCard API بدون آگاهی از جزئیات دقیق کارت یا کارت‌خوان، به کارت‌های هوشمند و کارت‌خوان‌ها دسترسی داشته باشند.

برنامه pcscd بارگذاری درایورها برای کارت‌خوان‌ها را هماهنگ می‌کند.

درایورهای کارت‌خوان سریال (SERIAL SMART CARD READER DRIVERS)

درایورهای کارت‌خوان‌های هوشمند در دایرکتوری /usr/lib/pcsc/drivers قرار می‌گیرند. هر درایور صرفاً یک فایل .so است. برنامه pcscd درایور را با استفاده از فایل‌های /etc/reader.conf.d/my_reader.conf پیدا می‌کند. برای اطلاعات بیشتر به صفحه راهنمای reader.conf(5) مراجعه فرمایید.

برخی درایورها در نشانی https://muscle.apdu.fr/musclecard.com/drivers.html در دسترس هستند.

درایورهای کارت‌خوان USB (USB SMART CARD READER DRIVERS)

درایورهای کارت‌خوان هوشمند USB در دایرکتوری /usr/lib/pcsc/drivers به عنوان یک بسته نرم‌افزاری (bundle) قرار می‌گیرند. شما نباید درایور USB را در یک فایل /etc/reader.conf.d/my_reader.conf اضافه کنید.

فایل پیکربندی (CONFIGURATION FILE)

می‌توان آرگومان‌های مورد استفاده توسط pcscd را با فایل پیکربندی /etc/default/pcscd تنظیم کرد. به عنوان مثال می‌توانید سطح اشکال‌زدایی را با استفاده از دستور زیر افزایش دهید:

PCSCD_ARGS=--debug

یا متغیرهای محیطی را به صورت زیر مشخص کنید:

PCSCLITE_FILTER_IGNORE_READER_NAMES="Twin"
PCSCLITE_FILTER_EXTEND_READER_NAMES=" $HOSTNAME"

برای جزئیات بیشتر به پیوند زیر مراجعه کنید: https://blog.apdu.fr/posts/2021/08/pcsc-lite-configuration-using

فیلتر کردن کارت‌خوان USB با UDEV (فقط لینوکس)

اگر پشتیبانی از udev فعال باشد، تنظیم ویژگی udev به صورت PCSCLITE_IGNORE=1 روی یک دستگاه USB سبب می‌شود آن کارت‌خوان نادیده گرفته شود. به عنوان مثال برای نادیده گرفتن هر کارت‌خوانی که به درگاه USB شماره ۳ از گذرگاه ۱ متصل است، عبارت زیر را به یک فایل foobar.rules در دایرکتوری /etc/udev/rules.d/ اضافه نمایید:

ACTION!="remove|unbind", SUBSYSTEM=="usb", KERNEL=="1-3", ENV{PCSCLITE_IGNORE}="1"

فایل‌ها (FILES)

/etc/default/pcscd : فایل پیکربندی دیمن

/etc/reader.conf.d/* : فایل‌های پیکربندی کارت‌خوان سریال

/run/pcscd/pcscd.pid : شناسه فرآیند نسخه در حال اجرای pcscd

/usr/lib/pcsc/drivers/ : دایرکتوری حاوی بسته‌های درایورهای USB

همچنین ببینید (SEE ALSO)

reader.conf(5), syslog(3), udev(7)

نویسندگان (AUTHORS)

David Corcoran <corcoran@musclecard.com> و Ludovic Rousseau <ludovic.rousseau@free.fr>