'\" t .\" Title: dtrust-tool .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/02/2026 .\" Manual: OpenSC Tools .\" Source: opensc .\" Language: English .\" .TH "DTRUST\-TOOL" "1" "06/02/2026" "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)" dtrust-tool \- نمایش اطلاعات درباره کارت‌های امضای D\-Trust و حذف حفاظت انتقال .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBdtrust\-tool\fR\ 'u \fBdtrust\-tool\fR [\fIگزینه‌ها\fR] .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdtrust\-tool\fR برای نمایش اطلاعات درباره کارت‌های امضای D\-Trust و حذف حفاظت انتقال اولیه (initial transport protection) به کار می‌رود\&. .SH "گزینه‌ها (OPTIONS)" .PP .PP \fB\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR .RS 4 شماره کارت‌خوان مورد استفاده\&. به صورت پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود\&. اگر \fIarg\fR یک ATR باشد، کارت‌خوانی با کارت منطبق انتخاب خواهد شد\&. .RE .PP \fB\-\-wait\fR, \fB\-w\fR .RS 4 باعث می‌شود \fBdtrust\-tool\fR تا زمان قرار گرفتن توکن در کارت‌خوان منتظر بماند\&. .RE .PP \fB\-\-verify\-can\fR, .RS 4 کارت D\-Trust شماره ۵ به همراه یک شماره دسترسی کارت (CAN) چاپ‌شده روی کارت عرضه می‌شود\&. هدف از این شماره، برقراری یک کانال ارتباطی امن میان کارت و کارت‌خوان است\&. در حالت عادی، \fBdtrust\-tool\fR در صورت نیاز به طور خودکار CAN را درخواست می‌کند\&. تحت شرایط خاص، dtrust\-tool نمی‌تواند تصمیم بگیرد که آیا CAN لازم است یا خیر\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} می‌توانید dtrust\-tool را صرفاً با این گزینه فراخوانی کنید تا اعتبارسنجی CAN را اجبار کنید؛ در صورت صحیح بودن، CAN در حافظه نهان (cache) ذخیره می‌شود\&. به محض ذخیره شدن CAN در حافظه نهان، دیگر نیازی به وارد کردن مجدد CAN این کارت نخواهید داشت\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} در صورتی که پین انتقال (transport PIN) را دو بار اشتباه وارد کنید، این پین معلق (suspended) می‌شود\&. شما به این پارامتر همراه با \fB\-\-unlock\-transport\-protection\fR نیاز دارید تا پین انتقال معلق را برای آخرین تلاش از سر بگیرید\&. عدم موفقیت در ورود پین انتقال، باعث مسدود شدن قطعی آن می‌شود\&. در این صورت باید پین انتقال را با \fB\-\-unblock\-pin\fR رفع انسداد کنید\&. .RE .RE .PP \fB\-\-enter\-can\fR, .RS 4 چندین روش برای ارائه CAN وجود دارد\&. برای جزئیات به بخش dtrust در صفحه راهنمای opensc\&.conf مراجعه کنید\&. با این پارامتر، \fBdtrust\-tool\fR به صورت تعاملی CAN را درخواست می‌کند و تمام منابع دیگر را نادیده می‌گیرد\&. این قابلیت زمانی مفید است که: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برای نخستین بار CAN را وارد می‌کنید و می‌خواهید در حافظه نهان CAN ذخیره شود .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} می‌خواهید صفحه کلید پین (pin pad) کارت‌خوان را دور بزنید\&. دور زدن pin pad نیز باعث ذخیره CAN در حافظه نهان می‌شود\&. .RE .sp پس از ذخیره شدن CAN در حافظه نهان، دیگر به این پارامتر نیازی نخواهید داشت\&. .RE .PP \fB\-\-pin\-status\fR, \fB\-s\fR .RS 4 وضعیت PINهای مختلف را نمایش می‌دهد\&. پین دارنده کارت (Card Holder PIN) برای امضاهای پیشرفته و رمزگشایی استفاده می‌شود\&. این پین تنها برای کارت‌های امضا تعریف شده است و نه کارت‌های مهر و موم (sealing cards)\&. پین امضا (Signature PIN) برای امضاهای واجد شرایط (qualified) استفاده می‌شود\&. این پین تنها زمانی قابل استفاده است که با ارائه پین انتقال (Transport PIN) باز شده باشد\&. پس از یک بار استفاده از پین انتقال، دیگر نمی‌توان از آن استفاده کرد\&. از PUK برای باز کردن قفل PINهایی استفاده می‌شود که چندین بار اشتباه وارد شده‌اند\&. .RE .PP \fB\-\-check\-transport\-protection\fR, \fB\-c\fR .RS 4 در وضعیت تحویل کارخانه، کارت با قابلیتی به نام حفاظت انتقال (transport protection) قفل است\&. این گزینه امکان بررسی فعال بودن یا نبودن حفاظت انتقال را فراهم می‌کند\&. پین امضا تنها زمانی قابل استفاده است که حفاظت انتقال برداشته شده باشد\&. .sp در ابتدا حفاظت انتقال باید دست‌نخورده باشد\&. اگر کارت جدیدی دریافت کردید و حفاظت انتقال از قبل شکسته شده بود، از آن کارت استفاده نکنید و برای راهنمایی بیشتر با تولیدکننده تماس بگیرید\&. .sp اگر حفاظت انتقال را حذف کرده‌اید، طبیعی است که \fBdtrust\-tool\fR گزارش دهد که حفاظت انتقال شکسته شده است\&. این وضعیت کاری عادی است و به این معنی نیست که کارت شما خراب شده است\&. .RE .PP \fB\-\-unlock\-transport\-protection\fR, \fB\-u\fR .RS 4 این دستور حفاظت انتقال را حذف می‌کند\&. این دستور ابتدا پین انتقال و سپس مقدار جدید پین امضا را دو بار درخواست می‌کند\&. .RE .PP \fB\-\-change\-pin\fR, .RS 4 پین مشخص‌شده را تغییر می‌دهد\&. پین‌های زیر قابل تغییر هستند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برای کارت D\-Trust نسخه ۴: PIN\&.CH, PIN\&.QES, PUK\&.CH .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برای کارت D\-Trust نسخه ۵: PIN\&.QES, PIN\&.AUT, PUK\&.CH .RE .sp تغییر دادن PUK توصیه نمی‌شود\&. .sp برای تغییر یک PIN، ابتدا باید پین قدیمی و سپس مقدار پین جدید را دو بار وارد کنید\&. .RE .PP \fB\-\-change\-verify\fR, .RS 4 این گزینه پین مورد استفاده برای اعتبارسنجی جهت تغییر پین مشخص‌شده با دستور \fB\-\-change\-pin\fR را تعیین می‌کند\&. تنها کاربرد مفید این گزینه، بازنشانی پین دارنده کارت (PIN\&.CH) در کارت‌های D\-Trust نسخه ۴.۱ با ارائه PUK دارنده کارت (PUK\&.CH) است\&. در تمام موارد دیگر، یک پین تنها با ارائه مقدار فعلی‌اش قابل تغییر است\&. .RE .PP \fB\-\-resume\-pin\fR, .RS 4 یک PIN معلق‌شده را از سر می‌گیرد\&. این مورد تنها برای PUK (PUK\&.CH) کارت‌های D\-Trust نسخه ۵ اهمیت دارد\&. پس از دو تلاش ناموفق برای اعتبارسنجی PUK، این کد معلق می‌شود\&. برای از سرگیری PUK معلق‌شده، ابتدا باید CAN و سپس مقدار PUK معلق را وارد کنید\&. اگر مجدداً PUK را اشتباه وارد کنید، PUK در نهایت مسدود شده و غیرقابل بازیابی خواهد بود\&. .sp برای از سرگیری پین انتقال معلق، از \fB\-\-unlock\-transport\-protection\fR همراه با \fB\-\-can\fR استفاده کنید\&. .RE .PP \fB\-\-unblock\-pin\fR, .RS 4 شمارنده تلاش مجدد یک PIN را به مقدار پیش‌فرض بازنشانی می‌کند\&. برای رفع انسداد یک PIN، ابتدا باید PUK را ارائه دهید\&. پین‌های زیر قابل رفع انسداد هستند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برای کارت D\-Trust نسخه ۴: PIN\&.T, PIN\&.CH, PIN\&.QES .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برای کارت D\-Trust نسخه ۵: PIN\&.T, PIN\&.T\&.AUT, PIN\&.QES, PIN\&.AUT .RE .sp امکان رفع انسداد یک PUK مسدودشده وجود ندارد\&. .sp لطفاً توجه داشته باشید که از PUK تنها به تعداد دفعات محدودی می‌توان استفاده کرد (۴۸ بار برای کارت‌های D\-Trust نسخه ۴ و ۵)\&. .RE .PP \fB\-\-help\fR, \fB\-h\fR .RS 4 پیام راهنما را روی صفحه نمایش چاپ می‌کند\&. .RE .PP \fB\-\-verbose\fR, \fB\-v\fR .RS 4 باعث افزایش جزئیات خروجی \fBdtrust\-tool\fR می‌شود\&. برای فعال‌سازی خروجی اشکال‌زدایی در کتابخانه opensc، این فلگ را چندین بار مشخص کنید\&. .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBopensc.conf\fR(5) .SH "نویسندگان (AUTHORS)" .PP \fBdtrust\-tool\fR توسط Mario Haustein نوشته شده است\&.