NETKEY-TOOL(1)                   OpenSC Tools                   NETKEY-TOOL(1)

نام (NAME)
       netkey-tool - ابزار مدیریتی برای کارت‌های Netkey E4

خلاصه دستور (SYNOPSIS)
       netkey-tool [OPTIONS] [COMMAND]

توضیحات (DESCRIPTION)
       از ابزار netkey-tool می‌توان در خط فرمان برای انجام برخی عملیات‌های کارت
       هوشمند با کارت‌های NetKey E4 استفاده کرد که با دیگر ابزارهای OpenSC
       به‌سادگی امکان‌پذیر نیستند؛ از جمله تغییر PINهای محلی، ذخیره گواهی‌ها در
       فایل‌های گواهی خالی NetKey E4 یا نمایش مقدار اولیه PUK.

گزینه‌ها (OPTIONS)
       --help, -h
           پیام راهنمای کوتاهی را نمایش می‌دهد.

       --pin pin, -p pin
           مقدار کنونی PIN سراسری (global PIN) را مشخص می‌کند.

       --puk pin, -u pin
           مقدار کنونی PUK سراسری (global PUK) را مشخص می‌کند.

       --pin0 pin, -0 pin
           مقدار کنونی PIN0 محلی (معروف به PIN محلی) را مشخص می‌کند.

       --pin1 pin, -1 pin
           مقدار کنونی PIN1 محلی (معروف به PUK محلی) را مشخص می‌کند.

       --reader arg, -r arg
           شماره کارت‌خوان مورد استفاده. به‌طور پیش‌فرض، نخستین کارت‌خوانی که
           کارتی در آن قرار دارد استفاده می‌شود. اگر arg یک ATR باشد، کارت‌خوانی
           با کارت منطبق انتخاب خواهد شد.

       -v
           موجب افزایش جزئیات خروجی netkey-tool می‌شود. این گزینه می‌تواند چندین
           بار تکرار شود تا سطح پرگویی بالاتر برود.

قالب PIN (PIN FORMAT)
       با گزینه‌های -p، -u، -0 یا -1 می‌توان یکی از pinهای کارت را مشخص کرد.
       می‌توانید از رشته‌های متنی اسکی (ascii) ساده (مانند 123456) یا رشته‌های
       هگزادسیمال (مانند 31:32:33:34:35:36) استفاده کنید. یک رشته هگزادسیمال
       باید دقیقاً از n عدد هگز ۲ رقمی تشکیل شده باشد که با n-1 دونقطه از
       یکدیگر جدا شده‌اند. در غیر این صورت به عنوان یک رشته ascii تفسیر خواهد
       شد. برای نمونه :12:34: و 1:2:3:4 هر دو pinهایی با طول ۷ هستند، در حالی
       که 12:34 و 01:02:03:04 pinهایی به طول ۲ و ۴ می‌باشند.

دستورها (COMMANDS)
       هنگامی که netkey-tool بدون هیچ گزینه یا دستوری به کار رود، اطلاعاتی در
       مورد pinها و گواهی‌های کارت هوشمند نمایش می‌دهد. این کار هیچ تغییری در
       وضعیت کارت شما ایجاد نخواهد کرد (به فرض اینکه نقصی در netkey-tool وجود
       نداشته باشد). به‌ویژه شمارنده‌های تلاش‌های باقیمانده pinها بدون انجام
       اعتبارسنجی واقعی بررسی می‌شوند.

       اگر PIN سراسری را با گزینه --pin مشخص کنید، netkey-tool مقدار اولیه PUK
       سراسری کارت را نیز نمایش خواهد داد. اگر PUK سراسری شما تغییر کرده باشد،
       netkey-tool همچنان مقدار اولیه آن را نمایش می‌دهد. هیچ راهی برای بازیابی
       یک PUK سراسری گم‌شده پس از تغییر آن وجود ندارد. همچنین هیچ راهی برای
       نمایش مقدار اولیه PUK سراسری بدون دانستن مقدار کنونی PIN سراسری وجود
       نخواهد داشت.

       برای بیشتر دستورهایی که netkey-tool می‌تواند اجرا کند، باید یک pin را
       مشخص کنید. یک استثنای قابل توجه دستور nullpin است، اما این دستور فقط یک
       بار در طول عمر کارت NetKey E4 قابل اجراست.

       cert number filename
           این دستور یکی از گواهی‌های کارت شما را (همان‌طور که توسط number مشخص
           شده) می‌خواند و آن را در قالب PEM در فایل filename ذخیره می‌کند.
           گواهی‌های روی کارت NetKey E4 بدون نیاز به pin خواندنی هستند،
           بنابراین نیازی به مشخص کردن pin ندارید.

       cert filename number
           این دستور نخستین گواهی کدگذاری‌شده با PEM را از فایل filename
           می‌خواند و آن را در فایل گواهی number کارت هوشمند شما ذخیره می‌کند.
           برخی از فایل‌های گواهی کارت هوشمند شما ممکن است فقط‌خواندنی باشند،
           بنابراین این عمل با تمام مقادیر number کار نخواهد کرد. اگر یک فایل
           گواهی قابل نوشتن باشد، برای تغییر آن باید یک pin مشخص کنید. اگر سعی
           کنید بدون مشخص کردن pin از این دستور استفاده کنید، netkey-tool به
           شما خواهد گفت که به کدام pin نیاز است.

       change {pin | puk | pin0 | pin1} new-pin
           این دستور مقدار pin مشخص‌شده را به مقدار جدید داده‌شده تغییر می‌دهد.
           برای انجام این کار باید یا مقدار کنونی همان pin یا pin دیگری را
           مشخص کنید، و اگر pin درست را تعیین نکنید، netkey-tool اعلام خواهد
           کرد که کدام مورد نیاز است.

       nullpin initial-pin
           این دستور تنها در صورتی قابل اجرا است که PIN سراسری کارت شما در
           وضعیت nullpin باشد. پس از آنکه PIN سراسری خود را تغییر دادید، هیچ
           راهی برای بازگشت به وضعیت nullpin وجود ندارد. برای اجرای دستور
           nullpin نیازی به pin ندارید. پس از اجرای موفقیت‌آمیز دستور nullpin،
           ابزار netkey-tool مقدار اولیه PUK کارت شما را نمایش خواهد داد.

       unblock {pin | pin0 | pin1}
           این دستور قفل pin مشخص‌شده را باز می‌کند. برای این کار باید pin دیگری
           را مشخص کنید و در صورتی که مورد درستی را تعیین نکنید، netkey-tool
           به شما اعلام می‌کند که کدام pin مورد نیاز است.

همچنین ببینید (SEE ALSO)
       opensc-explorer(1)

نویسندگان (AUTHORS)
       netkey-tool توسط Peter Koch <pk_opensc@web.de> نوشته شده است.

opensc                            06/02/2026                    NETKEY-TOOL(1)