NVME-TLS-KEY(1)                   NVMe Manual                  NVME-TLS-KEY(1)

نام (NAME)
       nvme-tls-key - مدیریت و تولید کلیدهای امنیتی TLS برای NVMe-oF

خلاصه دستور (SYNOPSIS)
       nvme tls-key [--keyring=<name> | -k <name>]
                               [--keytype=<type> | -t <type>]
                               [--keyfile=<file> | -f <file>]
                               [--import | -i] [--export | -e]
                               [--revoke=<description>| -r <description>]
                               [--verbose | -v]

توضیحات (DESCRIPTION)
       وارد کردن (Import)، صادر کردن (Export) یا حذف کلیدهای از پیش به اشتراک
       گذاشته شده (PSK) مربوط به NVMe TLS از جاکلیدی (keystore) سیستم. زمانی
       که گزینه --export مشخص شود، تمام کلیدهای NVMe TLS PSK در قالب زیر صادر
       می‌شوند:

       <descriptions> <psk>

       که در آن <description> توضیحات کلید صادرشده و <psk> داده‌های کلید در
       قالب تبادل PSK به صورت NVMeTLSkey-1:01:<base64 encoded data>: است. هر
       کلید در یک خط جداگانه صادر می‌شود. زمانی که گزینه --import مشخص شود،
       داده‌های کلید با همین قالب خوانده شده و به جاکلیدی هسته (kernel
       keystore) وارد می‌شوند.

گزینه‌ها (OPTIONS)
       -k <name>, --keyring=<name>
           نام جاکلیدی (keyring) که کلید TLS نگهداری‌شده (retained) باید در آن
           ذخیره شود. مقدار پیش‌فرض .nvme است.

       -t <type>, --keytype=<type>
           نوع کلید برای کلید TLS حاصل. مقدار پیش‌فرض psk است.

       -f <file>, --keyfile=<file>
           فایلی که باید کلیدها از آن خوانده یا در آن نوشته شوند به‌جای ورودی
           استاندارد (stdin) / خروجی استاندارد (stdout).

       -i, --import
           خواندن داده‌های کلید از فایل تعیین‌شده توسط --keyfile یا ورودی
           استاندارد (stdin) در صورت عدم تعیین فایل.

       -e, --export
           نوشتن داده‌های کلید در فایل تعیین‌شده توسط --keyfile یا خروجی
           استاندارد (stdout) در صورت عدم تعیین فایل.

       -r <description>, --revoke=<description>
           ابطال یک کلید از جاکلیدی (keyring).

       -v, --verbose
           افزایش سطح جزئیات اطلاعات در خروجی.

مثال‌ها (EXAMPLES)
       •   ایجاد یک کلید TLS جدید و درج مستقیم آن در جاکلیدی .nvme:

               # nvme gen-tls-key -i -n hostnqn0 -c subsys0
               NVMeTLSkey-1:01:/b9tVz2OXJVISnoFgrPAygyS86XYJWkAapQeULns6PMpM8wv:
               Inserted TLS key 26b3260e

       •   صادر کردن کلید قبلاً ایجاد شده از جاکلیدی هسته و ذخیره آن در یک
           فایل:

               # nvme tls-key -e -f nvme-tls-keys.txt

       •   صادر کردن/فهرست کردن همه کلیدها از جاکلیدی .nvme با استفاده از nvme
           و keyctl:

               # nvme tls-key --export
               NVMe0R01 hostnqn0 subsys0 NVMeTLSkey-1:01:/b9tVz2OXJVISnoFgrPAygyS86XYJWkAapQeULns6PMpM8wv:

               # keyctl show
               Session Keyring
                573249525 --alswrv      0     0  keyring: _ses
                353599402 --alswrv      0 65534   \_ keyring: _uid.0
                475911922 ---lswrv      0     0   \_ keyring: .nvme
                649274894 --als-rv      0     0       \_ psk: NVMe0R01 hostnqn0 subsys0

       •   ابطال یک کلید با استفاده از توضیحات آن و اعتبارسنجی عملیات با
           keyctl:

               # nvme tls-key --revoke="NVMe0R01 hostnqn0 subsys0"

               # keyctl show
               Session Keyring
                573249525 --alswrv      0     0  keyring: _ses
                353599402 --alswrv      0 65534   \_ keyring: _uid.0
                475911922 ---lswrv      0     0   \_ keyring: .nvme
               649274894: key inaccessible (Key has been revoked)

       •   وارد کردن مجدد کلید قبلاً ایجادشده از فایل و اعتبارسنجی با keyctl:

               # nvme tls-key --import -f nvme-tls-keys.txt

               # keyctl show
               Session Keyring
                573249525 --alswrv      0     0  keyring: _ses
                353599402 --alswrv      0 65534   \_ keyring: _uid.0
                475911922 ---lswrv      0     0   \_ keyring: .nvme
                734343968 --als-rv      0     0       \_ psk: NVMe0R01 hostnqn0 subsys0

NVME
       بخشی از مجموعه ابزارهای nvme-user

NVMe                              02/16/2026                   NVME-TLS-KEY(1)