YUBICO-PIV-TOOL(1)               User Commands              YUBICO-PIV-TOOL(1)

نام (NAME)
       yubico-piv-tool - ابزاری برای مدیریت اعتبارات احراز هویت شخصی (PIV) روی
       Yubikeyها

خلاصه دستور (SYNOPSIS)
       yubico-piv-tool [OPTION]...

توضیحات (DESCRIPTION)
       -h, --help
              چاپ راهنما و خروج

       --full-help
              چاپ راهنما، شامل گزینه‌های پنهان، و خروج

       -V, --version
              چاپ نسخه و خروج

       -v, --verbose[=INT]
              چاپ اطلاعات بیشتر  (پیش‌فرض=`0')

       -r, --reader=STRING
              تنها استفاده از کارت‌خوان منطبق  (پیش‌فرض=`Yubikey')

       -k, --key[=STRING]
              کلید مدیریتی مورد استفاده؛ در صورت مشخص نشدن، کلید درخواست خواهد
              شد (پیش‌فرض=`010203040506070801020304050607080102030405060708')

       -a, --action=ENUM
              اقدام برای انجام  (مقادیر ممکن: "version"، "generate"،
              "set-mgm-key"، "reset"، "pin-retries"، "import-key"،
              "import-certificate"، "set-chuid"، "request-certificate"،
              "verify-pin"، "verify-bio"، "change-pin"، "change-puk"،
              "unblock-pin"، "selfsign-certificate"، "delete-certificate"،
              "read-certificate"، "read-public-key"، "status"،
              "test-signature"، "test-decipher"، "list-readers"، "set-ccc"،
              "write-object"، "read-object"، "attest"، "move-key"،
              "delete-key")

              می‌توان چندین اقدام را به طور هم‌زمان مشخص کرد که به ترتیب اجرا
              خواهند شد؛ برای نمونه: --action=verify-pin
              --action=request-certificate

       -s, --slot=ENUM
              اسلات کلید برای انجام عملیات  (مقادیر ممکن: "9a"، "9c"، "9d"،
              "9e"، "82"، "83"، "84"، "85"، "86"، "87"، "88"، "89"، "8a"،
              "8b"، "8c"، "8d"، "8e"، "8f"، "90"، "91"، "92"، "93"، "94"،
              "95"، "f9")

              اسلات 9a برای احراز هویت PIV اسلات 9c برای امضای دیجیتال (PIN
              همیشه بررسی می‌شود) اسلات 9d برای مدیریت کلید اسلات 9e برای احراز
              هویت کارت (PIN هرگز بررسی نمی‌شود) اسلات‌های 82-95 برای مدیریت
              کلیدهای بازنشسته اسلات f9 برای تصدیق اعتبار (Attestation)

       --to-slot=ENUM
              اسلاتی که کلید موجود باید به آن منتقل شود  (مقادیر ممکن: "9a"،
              "9c"، "9d"، "9e"، "82"، "83"، "84"، "85"، "86"، "87"، "88"،
              "89"، "8a"، "8b"، "8c"، "8d"، "8e"، "8f"، "90"، "91"، "92"،
              "93"، "94"، "95"، "f9")

              اسلات 9a برای احراز هویت PIV اسلات 9c برای امضای دیجیتال (PIN
              همیشه بررسی می‌شود) اسلات 9d برای مدیریت کلید اسلات 9e برای احراز
              هویت کارت (PIN هرگز بررسی نمی‌شود) اسلات‌های 82-95 برای مدیریت
              کلیدهای بازنشسته اسلات f9 برای تصدیق اعتبار (Attestation)

       -A, --algorithm=ENUM
              الگوریتم مورد استفاده  (مقادیر ممکن: "RSA1024"، "RSA2048"،
              "RSA3072"، "RSA4096"، "ECCP256"، "ECCP384"، "ED25519"، "X25519"
              پیش‌فرض=`RSA2048')

       -H, --hash=ENUM
              درهم‌سازی (هش) مورد استفاده برای امضاها  (مقادیر ممکن: "SHA1"،
              "SHA256"، "SHA384"، "SHA512" پیش‌فرض=`SHA256')

       -n, --new-key=STRING
              کلید مدیریتی جدید برای اقدام set-mgm-key؛ در صورت مشخص نشدن،
              کلید درخواست خواهد شد

       --pin-retries=INT
              تعداد دفعات تلاش مجاز پیش از مسدود شدن کد pin

       --puk-retries=INT
              تعداد دفعات تلاش مجاز پیش از مسدود شدن کد puk

       -i, --input=STRING
              نام فایل ورودی، - برای stdin  (پیش‌فرض=`-')

       -o, --output=STRING
              نام فایل خروجی، - برای stdout (پیش‌فرض=`-')

       -K, --key-format=ENUM
              قالب کلید در حال خواندن/نوشتن  (مقادیر ممکن: "PEM"، "PKCS12"،
              "GZIP"، "DER"، "SSH" پیش‌فرض=`PEM')

       --compress
              فشرده‌سازی گواهی‌های بزرگ با استفاده از GZIP پیش از وارد کردن
              (پیش‌فرض=غیرفعال)

       --global
              بازنشانی کل دستگاه برای تمام برنامه‌های کاربردی (پیش‌فرض=غیرفعال)

       -p, --password=STRING
              گذرواژه برای رمزگشایی فایل کلید خصوصی؛ در صورت مشخص نشدن،
              گذرواژه درخواست خواهد شد

       -S, --subject=STRING
              موضوع (subject) مورد استفاده برای درخواست گواهی

              موضوع باید به این صورت نوشته شود:
              /CN=host.example.com/OU=test/O=example.com/

       --serial=INT
              شماره سریال گواهی خودامضا

       --valid-days=INT
              مدت زمان (به روز) تا انقضای گواهی خودامضا  (پیش‌فرض=`365')

       -P, --pin=STRING
              کد pin/puk برای اعتبارسنجی؛ در صورت مشخص نشدن، کد pin/puk
              درخواست خواهد شد

       -N, --new-pin=STRING
              کد pin/puk جدید برای تغییر دادن؛ در صورت مشخص نشدن، کد pin/puk
              درخواست خواهد شد

       --pin-policy=ENUM
              تنظیم سیاست pin برای اقدام generate یا import-key.  تنها در
              YubiKey 4 یا جدیدتر در دسترس است  (مقادیر ممکن: "never"، "once"،
              "always"، "matchonce"، "matchalways")

       --touch-policy=ENUM
              تنظیم سیاست لمس برای اقدام generate، import-key یا set-mgm-key.
              تنها در YubiKey 4 یا جدیدتر در دسترس است (مقادیر ممکن: "never"،
              "always"، "cached")

       --id=INT
              شناسه شیء برای نوشتن/خواندن شیء

       -f, --format=ENUM
              قالب داده‌ها برای نوشتن/خواندن شیء  (مقادیر ممکن: "hex"،
              "base64"، "binary" پیش‌فرض=`hex')

       --attestation
              افزودن امضای متقابل تصدیق اعتبار (attestation cross-signature)
              (پیش‌فرض=غیرفعال)

       -m, --new-key-algo=ENUM
              الگوریتم کلید مدیریتی جدید برای اقدام set-mgm-key  (مقادیر ممکن:
              "TDES"، "AES128"، "AES192"، "AES256" پیش‌فرض=`TDES')

       --scp11
              ارتباط با YubiKey از طریق یک کانال رمزنگاری‌شده انجام می‌شود.
              منسوخ شده است! لطفاً به جای آن از پرچم '--enc' استفاده کنید
              (پیش‌فرض=غیرفعال)

       --enc  ارتباط با YubiKey از طریق یک کانال رمزنگاری‌شده انجام می‌شود
              (پیش‌فرض=غیرفعال)

yubico-piv-tool 2.7.3            January 2026               YUBICO-PIV-TOOL(1)