نام (NAME)

tss2_createnv - ایجاد یک اندیس NV در TPM

خلاصه دستور (SYNOPSIS)

tss2_createnv [OPTIONS]

همچنین ببینید (SEE ALSO)

fapi-config(5) برای تنظیم پارامترهای Fapi مانند نمایهٔ رمزنگاری مورداستفاده و TCTI یا دایرکتوری‌های ذخیره‌سازی فراداده‌های Fapi.

fapi-profile(5) برای تعیین الگوریتم‌ها و پارامترهای رمزنگاری برای تمام کلیدها و عملیات‌های یک تعامل مشخص با TPM مانند الگوریتم درهم‌سازی نام، الگوریتم، طرح و پارامترهای امضای نامتقارن، و انتخاب بانک PCR.

توضیحات (DESCRIPTION)

tss2_createnv(1) - این دستور یک اندیس NV در TPM ایجاد می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های موجود عبارتند از:

•: -p, --path=STRING:

مسیر فضای NV جدید.

این مسیر از سه بخش تشکیل شده است که با “/” از یکدیگر جدا می‌شوند. یک nvPath با “/nv” آغاز می‌شود. بخش دوم مسیر، دامنهٔ دستگیره (handle range) را برای شیء nv مشخص می‌کند. این بخش شامل مقادیر زیر است: Owner، TPM، Platform، Endorsement_Certificate، Platform_Certificate، Component_OEM، TPM_OEM، Platform_OEM، PC-Client، Server، Virtualized_Platform، MPWG، Embedded. بخش سوم مسیر، NV-Index واقعی را با استفاده از یک نام معنادار مشخص می‌کند.

•: -t, --type=STRING:

کاربرد مورد نظر را مشخص می‌کند. پارامتر اختیاری. انواع می‌توانند هر ترکیبی از مقادیر زیر باشند که با کاما از هم جدا شده‌اند:

- "noda": ویژگی noda مربوط به یک کلید یا اندیس NV را تنظیم می‌کند.
- "bitfield": نوع NV را به bitfield تنظیم می‌کند.
- "counter": نوع NV را به counter تنظیم می‌کند.
- "pcr": نوع NV را به رفتاری مشابه pcr تنظیم می‌کند.
- نکته: اگر هیچ‌یک از سه کلیدواژه پیشین ارائه نشود، یک اندیس
  NV معمولی ایجاد می‌شود.

•: -s, --size=INTEGER:

اندازه بر حسب بایت برای اندیس NV که قرار است ایجاد شود. در صورتی که اندازه از نوع آن قابل استنباط باشد می‌توان آن را نادیده گرفت؛ برای نمونه، یک اندیس NV از نوع counter دارای اندازهٔ ۸ بایت است.

•: -P, --policyPath=STRING:

سیاستی (policy) را که باید با فضای NV جدید مرتبط شود مشخص می‌کند. پارامتر اختیاری. در صورت عدم درج، هیچ سیاستی با کلید مرتبط نخواهد شد.

یک policyPath از دو بخش تشکیل شده است که با “/” از هم جدا می‌شوند. یک policyPath با “/policy” آغاز می‌شود. بخش دوم مسیر، سیاست یا الگوی سیاست را با استفاده از یک نام معنادار مشخص می‌کند.

•: -a, --authValue=STRING:

گذرواژه جدید UTF-8. پارامتر اختیاری. اگر تعیین نشود، گذرواژه به صورت تعاملی از کاربر پرسیده خواهد شد. برای تنظیم نکردن گذرواژه، این گزینه باید با رشته خالی (“”) به کار رود. حداکثر اندازه گذرواژه توسط اندازه دایجستِ الگوریتم درهم‌سازی نام انتخاب‌شده در نمایه رمزنگاری تعیین می‌شود (ن.ک. fapi-profile(5)). برای نمونه، انتخاب SHA256 به عنوان الگوریتم درهم‌سازی، گذرواژه‌هایی با حداکثر ۳۲ نویسه را مجاز می‌داند.

گزینه‌های عمومی (COMMON OPTIONS)

این مجموعه از گزینه‌ها میان تمام برنامه‌های tss2 مشترک بوده و اطلاعاتی را ارائه می‌دهند که ممکن است مورد انتظار بسیاری از کاربران باشد.

•: -h, --help [man|no-man]: نمایش صفحه راهنمای (manpage) ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای این ابزار فراخوانی کند؛ با این حال، در صورت بروز خطا خلاصه کوتاهی از ابزار را در خروجی نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه “man” مشخص شده باشد، اما اگر صریحاً “man” درخواست شود، ابزار خطاهای man را در خروجی خطای استاندارد (stderr) ارائه می‌دهد. اگر گزینه “no-man” مشخص شود، یا صفحه‌بند راهنما با شکست مواجه گردد، گزینه‌های کوتاه در خروجی استاندارد (stdout) نمایش داده خواهند شد.

استفادهٔ موفق از ویژگی صفحات راهنما نیازمند آن است که این صفحات نصب شده یا در MANPATH موجود باشند؛ برای جزئیات بیشتر man(1) را ببینید.

•: -v, --version: نمایش اطلاعات نسخه این ابزار و tctiهای پشتیبانی‌شده، و خروج.

مثال‌ها (EXAMPLES)

tss2_createnv --authValue=abc --path=/nv/Owner/myNV --size=20 --type="noDa"

وضعیت خروج (EXIT STATUS)

0 در صورت موفقیت یا 1 در صورت شکست.

گزارش باگ‌ها (BUGS)

مشکلات گیت‌هاب (Github Issues)

راهنما (HELP)

مشاهدهٔ فهرست پستی (Mailing List)

مجوز (LICENSE)

این اثر تحت Creative Commons Attribution 4.0 International License (CC BY 4.0) مجوزدهی شده است.