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)