'\" t .\" Title: opensc-explorer .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/02/2026 .\" Manual: OpenSC Tools .\" Source: opensc .\" Language: Persian .\" .TH "OPENSC\-EXPLORER" "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)" opensc-explorer \- ابزار تعاملی عمومی برای دسترسی به عملکردهای کارت هوشمند و توکن‌های امنیتی مشابه .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBopensc\-explorer\fR\ 'u \fBopensc\-explorer\fR [\fIOPTIONS\fR] [\fISCRIPT\fR] .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBopensc\-explorer\fR می‌تواند برای انجام عملیات متفرقه مانند کاوش محتویات یا ارسال دستورهای دلخواه APDU به یک کارت هوشمند یا توکن امنیتی مشابه استفاده شود\&. .PP اگر یک \fISCRIPT\fR مشخص شده باشد، \fBopensc\-explorer\fR در حالت غیرتعاملی اجرا شده و دستورها را به‌صورت خط‌به‌خط از \fISCRIPT\fR می‌خواند\&. اگر اسکریپتی داده نشود، \fBopensc\-explorer\fR در حالت تعاملی اجرا می‌شود و دستورها را از ورودی استاندارد می‌خواند\&. .SH "گزینه‌ها (OPTIONS)" .PP در ادامه گزینه‌های خط فرمان برای \fBopensc\-explorer\fR آمده است\&. پس از اجرا، دستورهای تعاملی دیگری نیز در دسترس خواهند بود\&. .PP \fB\-\-card\-driver\fR \fIdriver\fR, \fB\-c\fR \fIdriver\fR .RS 4 از راه‌انداز کارت (driver) مشخص‌شده استفاده می‌کند\&. پیش‌فرض، تشخیص خودکار راه‌انداز کارت مناسب است\&. مقدار دقیق ? تمام راه‌اندازهای کارت موجود را فهرست کرده و به اجرای \fBopensc\-explorer\fR پایان می‌دهد\&. .RE .PP \fB\-\-mf\fR \fIpath\fR, \fB\-m\fR \fIpath\fR .RS 4 فایل ارجاع‌داده‌شده توسط مسیر مشخص‌شده را هنگام راه‌اندازی انتخاب می‌کند\&. پیش‌فرض، مسیر فایل اصلی استاندارد، یعنی 3F00 است\&. اگر \fIpath\fR خالی باشد (مانند \fBopensc\-explorer \-\-mf ""\fR)، هیچ فایلی به‌طور صریح انتخاب نمی‌شود\&. .RE .PP \fB\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR .RS 4 شماره کارت‌خوان مورد استفاده\&. به‌طور پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود\&. اگر \fIarg\fR یک ATR باشد، کارت‌خوان دارای کارت منطبق انتخاب خواهد شد\&. .RE .PP \fB\-\-verbose\fR, \fB\-v\fR .RS 4 موجب پرگویی بیشتر \fBopensc\-explorer\fR می‌شود\&. این پرچم را چند بار مشخص کنید تا خروجی اشکال‌زدایی در کتابخانه opensc فعال شود\&. .RE .PP \fB\-\-wait\fR, \fB\-w\fR .RS 4 منتظر وارد شدن یک کارت می‌ماند\&. .RE .SH "دستورها (COMMANDS)" .PP \fBopensc\-explorer\fR از دستورها به همراه آرگومان‌هایشان در اعلان تعاملی خود یا در فایل‌های اسکریپت ارسال‌شده از طریق پارامتر خط فرمان \fISCRIPT\fR پشتیبانی می‌کند\&. .PP مشابه یک شل دستوری مانند bash، هر خط ورودی به کلماتی که با نویسه فاصله (white-space) جدا شده‌اند تقسیم می‌شود\&. از میان این کلمات، کلمه نخست به‌عنوان دستور و کلمات باقی‌مانده به‌عنوان آرگومان‌های آن دستور در نظر گرفته می‌شوند\&. .PP دستورهای زیر پشتیبانی می‌شوند: .PP \fB#\fR ... .RS 4 خط را به‌عنوان توضیح (کامنت) در نظر می‌گیرد\&. هر چیزی تا انتهای خط که با # آغاز شده باشد نادیده گرفته می‌شود\&. .RE .PP \fBapdu\fR \fIdata\fR... .RS 4 یک دستور سفارشی APDU به کارت ارسال می‌کند\&. \fIdata\fR مجموعه‌ای از توالی‌های مقادیر هگزادسیمال و رشته‌های محصور در نقل‌قول دوگانه ("\&.\&.\&.") است\&. .RE .PP \fBasn1\fR \fIfile\-id\fR [\fIrec\-no\fR] [\fIoffs\fR] .RS 4 محتوای کدگذاری‌شده با ASN\&.1 مربوط به EF فعال مشخص‌شده با \fIfile\-id\fR را تجزیه کرده و چاپ می‌کند\&. اگر پارامتر اختیاری \fIrec\-no\fR داده شده باشد و فایل یک EF رکورد-محور باشد، تنها رکورد تعیین‌شده توسط این پارامتر را تجزیه و چاپ می‌کند\&. اگر پارامتر اختیاری \fIoffs\fR داده شده باشد، تجزیه و چاپ فایل یا رکورد را از آفست مشخص‌شده با مقدار داده‌شده آغاز می‌کند\&. در صورت مشخص نشدن این پارامتر، آفست پیش‌فرض 0 است\&. .RE .PP \fBcat\fR [\fIfile\-id\fR | sfi:\fIshort\-id\fR] [\fIrec\-no\fR] .RS 4 محتویات EF فعال مشخص‌شده توسط \fIfile\-id\fR یا شناسه کوتاه فایل \fIshort\-id\fR را چاپ می‌کند\&. اگر پارامتر اختیاری دوم \fIrec\-no\fR داده شده باشد، تنها رکورد تعیین‌شده با این پارامتر را چاپ می‌کند\&. اگر آرگومانی داده نشود، محتویات EF انتخاب‌شده فعلی را چاپ می‌کند\&. .RE .PP \fBcd\fR {\&.\&. | \fIfile\-id\fR | aid:\fIDF\-name\fR} .RS 4 به یک DF دیگر که با آرگومان ارائه‌شده مشخص می‌شود تغییر مسیر می‌دهد\&. اگر آرگومان داده‌شده \&.\&. باشد، در سلسله‌مراتب سیستم فایل یک سطح به بالا می‌رود\&. اگر یک \fIfile\-id\fR باشد که باید یک DF مستقیماً زیر DF فعلی باشد، به آن DF تغییر مسیر می‌دهد\&. اگر یک شناسه برنامه باشد که به‌صورت aid:\fIDF\-name\fR داده شده، به MF برنامه‌ای که با \fIDF\-name\fR مشخص شده پرش می‌کند\&. .RE .PP \fBchange\fR CHV\fIpin\-ref\fR [[\fIold\-pin\fR]\ \fInew\-pin\fR] .RS 4 مقدار PIN مشخص‌شده توسط \fIpin\-ref\fR را از مقدار داده‌شده در \fIold\-pin\fR به \fInew\-pin\fR تغییر می‌دهد\&. .sp مقادیر \fIold\-pin\fR و \fInew\-pin\fR می‌توانند توالی‌هایی از مقادیر هگزادسیمال، رشته‌های محصور در نقل‌قول دوگانه ("\&.\&.\&.")، خالی ("") یا غایب باشند\&. در صورت غایب بودن، مقادیر از پین‌پد کارت‌خوان خوانده می‌شوند\&. .sp مثال‌ها: .PP change CHV2 00:00:00:00:00:00 "foobar" .RS 4 تغییر دادن PIN مربوط به CHV2 به مقدار جدید foobar، با مشخص کردن مقدار پیشین 00:00:00:00:00:00\&. .RE .PP change CHV2 "foobar" .RS 4 تنظیم PIN مربوط به CHV2 به مقدار جدید foobar\&. .RE .PP change CHV2 .RS 4 تغییر دادن PIN مربوط به CHV2 با استفاده از پین‌پد کارت‌خوان\&. .RE .sp .RE .PP \fBcreate\fR \fIfile\-id\fR \fIsize\fR .RS 4 یک EF جدید ایجاد می‌کند\&. \fIfile\-id\fR شناسه عددی و \fIsize\fR اندازه EF مورد نظر برای ایجاد را مشخص می‌کند\&. .RE .PP \fBdebug\fR [\fIlevel\fR] .RS 4 سطح اشکال‌زدایی OpenSC را روی \fIlevel\fR تنظیم می‌کند\&. .sp اگر \fIlevel\fR ذکر نشود، سطح اشکال‌زدایی فعلی را نشان می‌دهد\&. .RE.PP \fBdelete\fR \fIfile\-id\fR .RS 4 حذف EF یا DF مشخص‌شده با \fIfile\-id\fR\&. .RE .PP \fBdo_get\fR \fIhex\-tag\fR [\fIoutput\fR] .RS 4 کپی کردن محتوای شیء داده‌ای (DO) کارت مشخص‌شده با \fIhex\-tag\fR به فایلی در رایانهٔ میزبان محلی به نام \fIoutput\fR\&. .sp اگر \fIoutput\fR داده نشود، محتوای \fIhex\-tag\fR به صورت hex\-dump نمایش داده خواهد شد\&. .RE .PP \fBdo_put\fR \fIhex\-tag\fR \fIdata\fR .RS 4 تغییر محتوای شیء داده‌ای (DO) کارت مشخص‌شده با \fIhex\-tag\fR به \fIdata\fR\&. .sp \fIdata\fR یا دنباله‌ای از مقادیر هگزادسیمال است یا رشته‌ای محصور در علامت نقل‌قول دوتایی ("\&.\&.\&.")\&. .RE .PP \fBecho\fR \fIstring\fR... .RS 4 چاپ کردن \fIstring\fRهای داده‌شده\&. .RE .PP \fBerase\fR .RS 4 پاک کردن کارت، در صورتی که کارت از آن پشتیبانی کند\&. .RE .PP \fBget\fR \fIfile\-id\fR [\fIoutput\fR] .RS 4 کپی کردن یک EF به یک فایل محلی\&. فایل محلی با \fIoutput\fR مشخص می‌شود در حالی که فایل کارت با \fIfile\-id\fR تعیین می‌گردد\&. .sp اگر \fIoutput\fR ذکر نشود، نام فایل خروجی از مسیر کامل کارت به \fIfile\-id\fR مشتق خواهد شد\&. .RE .PP \fBget_record\fR \fIfile\-id\fR \fIrec\-no\fR [\fIoutput\fR] .RS 4 کپی کردن یک رکورد از یک EF رکورد-محور به یک فایل محلی\&. فایل محلی با \fIoutput\fR مشخص می‌شود در حالی که فایل کارت و رکورد با \fIfile\-id\fR و \fIrec\-no\fR مشخص می‌گردند، .sp اگر \fIoutput\fR ذکر نشود، نام فایل خروجی از مسیر کامل کارت به \fIfile\-id\fR\&. و \fIrec\-no\fR\&. مشتق خواهد شد\&. .RE .PP \fBhelp\fR [\fIpattern\fR] .RS 4 نمایش فهرست دستورهای موجود، گزینه‌ها و پارامترهای آن‌ها همراه با یک متن راهنمای کوتاه\&. اگر \fIpattern\fR داده شود، دستورهای نمایش‌داده‌شده به مواردی که با \fIpattern\fR تطابق دارند محدود می‌شوند\&. .RE .PP \fBinfo\fR [\fIfile\-id\fR] .RS 4 نمایش مشخصه‌های فایل مشخص‌شده با \fIfile\-id\fR\&. اگر \fIfile\-id\fR ارائه نشود، مشخصه‌های فایل جاری نمایش داده می‌شوند\&. .RE .PP \fBls\fR [\fIpattern\fR...] .RS 4 فهرست کردن فایل‌ها در DF جاری\&. اگر هیچ \fIpattern\fRی داده نشود، تمام فایل‌ها فهرست می‌شوند\&. اگر یک یا چند \fIpattern\fR داده شود، تنها فایل‌هایی که دست‌کم با یک \fIpattern\fR تطابق دارند فهرست خواهند شد\&. .RE .PP \fBfind\fR [\fIstart\-id\fR\ [\fIend\-id\fR]] .RS 4 یافتن تمام فایل‌ها در DF جاری\&. فایل‌ها با انتخاب تمامی شناسه‌های فایل در بازهٔ \fIstart\-fid\fR تا \fIend\-fid\fR پیدا می‌شوند\&. .sp در صورت عدم ارائه، مقدار پیش‌فرض برای \fIstart\-fid\fR برابر با 0000، و مقدار پیش‌فرض برای \fIend\-fid\fR برابر با FFFF است\&. .RE .PP \fBfind_tags\fR [\fIstart\-tag\fR\ [\fIend\-tag\fR]] .RS 4 یافتن تمام برچسب‌های اشیاء داده‌ای در زمینهٔ جاری\&. برچسب‌ها با استفاده از GET DATA در بازهٔ \fIstart\-tag\fR تا \fIend\-tag\fR پیدا می‌شوند\&. .sp در صورت عدم ارائه، مقدار پیش‌فرض برای \fIstart\-tag\fR برابر با 0000، و مقدار پیش‌فرض برای \fIend\-tag\fR برابر با FFFF است\&. .RE .PP \fBmkdir\fR \fIfile\-id\fR \fIsize\fR .RS 4 ایجاد یک DF\&. \fIfile\-id\fR شناسهٔ عددی، و \fIsize\fR اندازهٔ DF را برای ایجاد مشخص می‌کند\&. .RE .PP \fBpin_info\fR \fIkey\-type\fR\fIkey\-id\fR .RS 4 دریافت اطلاعات دربارهٔ یک PIN یا کلید از کارت، که در آن \fIkey\-type\fR می‌تواند یکی از مقادیر CHV، KEY، AUT یا PRO باشد\&. \fIkey\-id\fR عددی است که نمایانگر ارجاع کلید یا PIN است\&. .RE .PP \fBput\fR \fIfile\-id\fR \fIinput\fR .RS 4 کپی کردن یک فایل محلی به کارت\&. فایل محلی با \fIinput\fR مشخص می‌شود در حالی که فایل کارت با \fIfile\-id\fR تعیین می‌گردد\&. .RE .PP \fBquit\fR .RS 4 خروج از برنامه\&. .RE .PP \fBrandom\fR \fIcount\fR [\fIoutput\-file\fR] .RS 4 تولید \fIcount\fR بایت از داده‌های تصادفی\&. اگر \fIoutput\-file\fR داده شود، داده‌ها در فایل رایانهٔ میزبان مشخص‌شده با آن نوشته می‌شوند، در غیر این صورت داده‌ها به صورت hex dump نمایش داده خواهند شد\&. .RE .PP \fBrm\fR \fIfile\-id\fR .RS 4 حذف EF یا DF مشخص‌شده با \fIfile\-id\fR\&. .RE .PP \fBunblock\fR CHV\fIpin\-ref\fR [\fIpuk\fR\ [\fInew\-pin\fR]] .RS 4 رفع انسداد PIN مشخص‌شده با \fIpin\-ref\fR با استفاده از PUK \fIpuk\fR، و در صورت امکان تغییر مقدار آن به \fInew\-pin\fR\&. .sp \fIpuk\fR و \fInew\-pin\fR می‌توانند دنباله‌ای از مقادیر هگزادسیمال، رشته‌های محصور در علامت نقل‌قول دوتایی ("\&.\&.\&.")، خالی ("")، یا ذکر نشده باشند\&. در صورت ذکر نشدن، مقادیر از صفحه کلید کارت‌خوان (pin pad) خوانده می‌شوند\&. .sp مثال‌ها: .PP unblock CHV2 00:00:00:00:00:00 "foobar" .RS 4 رفع انسداد PIN CHV2 با استفاده از PUK 00:00:00:00:00:00 و تنظیم آن بر روی مقدار جدید foobar\&. .RE.PP unblock CHV2 00:00:00:00:00:00 "" .RS 4 رفع مسدودیت PIN مربوط به CHV2 با استفاده از PUK با مقدار 00:00:00:00:00:00 و حفظ مقدار قبلی\&. .RE .PP unblock CHV2 "" "foobar" .RS 4 تنظیم مقدار جدید PIN مربوط به CHV2 روی foobar\&. .RE .PP unblock CHV2 00:00:00:00:00:00 .RS 4 رفع مسدودیت PIN مربوط به CHV2 با استفاده از PUK با مقدار 00:00:00:00:00:00\&. مقدار جدید PIN توسط pinpad درخواست می‌شود\&. .RE .PP unblock CHV2 "" .RS 4 تنظیم PIN مربوط به CHV2\&. مقدار جدید PIN توسط pinpad درخواست می‌شود\&. .RE .PP unblock CHV2 .RS 4 رفع مسدودیت PIN مربوط به CHV2\&. کد رفع مسدودیت و مقدار جدید PIN توسط pinpad درخواست می‌شوند\&. .RE .sp .RE .PP \fBupdate_binary\fR \fIfile\-id\fR \fIoffs\fR \fIdata\fR .RS 4 بروزرسانی باینری فایل تعیین‌شده با \fIfile\-id\fR توسط داده‌های لفظی \fIdata\fR با شروع از آفست تعیین‌شده با \fIoffs\fR\&. .sp \fIdata\fR می‌تواند به صورت دنباله‌ای از مقادیر هگزادسیمال یا به صورت یک رشته محصور در علامت نقل‌قول ("\&.\&.\&.") ارائه شود\&. .RE .PP \fBupdate_record\fR \fIfile\-id\fR \fIrec\-nr\fR \fIrec\-offs\fR \fIdata\fR .RS 4 بروزرسانی رکورد تعیین‌شده با \fIrec\-nr\fR از فایل مشخص‌شده با \fIfile\-id\fR توسط داده‌های لفظی \fIdata\fR با شروع از آفست تعیین‌شده با \fIrec\-offs\fR\&. .sp \fIdata\fR می‌تواند به صورت دنباله‌ای از مقادیر هگزادسیمال یا به صورت یک رشته محصور در علامت نقل‌قول ("\&.\&.\&.") ارائه شود\&. .RE .PP \fBverify\fR \fIkey\-type\fR\fIkey\-id\fR [\fIkey\fR] .RS 4 ارائه یک PIN یا کلید به کارت، که در آن \fIkey\-type\fR می‌تواند یکی از موارد CHV، KEY، AUT یا PRO باشد\&. \fIkey\-id\fR عددی است که مرجع کلید یا PIN را مشخص می‌کند\&. \fIkey\fR کلید یا PIN مورد اعتبارسنجی است که به صورت دنباله‌ای از مقادیر هگزادسیمال جداشده با دونقطه یا رشته‌ای محصور در علامت نقل‌قول ("\&.\&.\&.") قالب‌بندی می‌شود\&. .sp اگر \fIkey\fR حذف شود، رفتار دقیق به ویژگی‌های کارت‌خوان بستگی دارد: اگر کارت‌خوان از ورود PIN از طریق pin pad پشتیبانی کند، اعتبارسنجی PIN با استفاده از pin pad کارت‌خوان انجام خواهد شد\&. اگر کارت‌خوان از ورود PIN پشتیبانی نکند، PIN به صورت تعاملی پرسیده خواهد شد\&. .sp مثال‌ها: .PP verify CHV2 31:32:33:34:00:00:00:00 .RS 4 اعتبارسنجی CHV2 با استفاده از مقدار هگز 31:32:33:34:00:00:00:00 .RE .PP verify CHV1 "secret" .RS 4 اعتبارسنجی CHV1 با استفاده از مقدار رشته‌ای secret\&. .RE .PP verify KEY2 .RS 4 اعتبارسنجی KEY2، دریافت مقدار از pin pad کارت‌خوان\&. .RE .sp .RE .PP \fBsm\fR {open | close} .RS 4 فراخوانی گرداننده پیام‌رسانی امن (Secure Messaging) برای open یا close کارت\&. .RE.SH "همچنین ببینید (SEE ALSO)" .PP \fBopensc-tool\fR(1) .SH "نویسندگان (AUTHORS)" .PP \fBopensc\-explorer\fR توسط Juha Yrjölä نوشته شده است\&.