.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "tss2_createkey" "1" "APRIL 2019" "tpm2\-tools" "General Commands Manual"
.SH "نام (NAME)"
tss2_createkey \- ایجاد کلید درون TPM
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tss2_createkey\f[R] [\f[I]OPTIONS\f[R]]
.SH "همچنین ببینید (SEE ALSO)"
\f[B]fapi\-config(5)\f[R] برای تنظیم پارامترهای FAPI مانند نمایه رمزنگاری مورداستفاده و TCTI یا دایرکتوری‌های ذخیره‌سازهای فراداده FAPI.
.PP
\f[B]fapi\-profile(5)\f[R] برای تعیین الگوریتم‌ها و پارامترهای رمزنگاری برای همه کلیدها و عملیات یک تعامل مشخص با TPM مانند الگوریتم درهم‌سازی نام، الگوریتم امضای نامتقارن، طرح، پارامترها و انتخاب بانک PCR.
.SH "توضیحات (DESCRIPTION)"
دستور \f[B]tss2_createkey\f[R](1) یک کلید درون TPM ایجاد کرده و آن را در مخزن فراداده FAPI و در صورت درخواست، به‌صورت پایا درون TPM ذخیره می‌کند.
بسته به نوع کلید مشخص‌شده، الگوریتم‌ها و پارامترهای رمزنگاری کلید ایجادشده بر اساس نمایه رمزنگاری متناظر تعیین می‌شوند (ر.ک. \f[B]fapi\-profile(5)\f[R]).
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.IP \[bu] 2
\f[B]\-p\f[R], \f[B]\-\-path\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
مسیر کلید جدید.
.RE
.IP \[bu] 2
\f[B]\-t\f[R], \f[B]\-\-type\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
کاربرد مدنظر را مشخص می‌کند.
پارامتر اختیاری.
نوع‌ها می‌توانند هر ترکیبی از موارد زیر باشند که با کاما از هم جدا شده‌اند:
.IP
.EX
\- \[dq]sign\[dq]: صفت sign کلید را تنظیم می‌کند.
\- \[dq]decrypt\[dq]: صفت decrypt کلید را تنظیم می‌کند.
\- راهنما: در صورتی که نه sign و نه decrypt مشخص شوند، هر دو صفت تنظیم می‌شوند.
\- \[dq]restricted\[dq]: صفت restricted کلید را تنظیم می‌کند.
\- راهنما: اگر restricted تنظیم شود، باید sign یا decrypt (اما نه هر دو) تنظیم شوند.
\- \[dq]exportable\[dq]: صفت‌های fixedTPM و fixedParent کلید یا
  شیء مهروموم‌شده را پاک می‌کند.
\- \[dq]noda\[dq]: صفت noda کلید یا NV index را تنظیم می‌کند.
\- \[dq]system\[dq]: داده‌های دوتایی (blobs) و فراداده‌ها را برای کلید یا شیء
  مهروموم‌شده در دایرکتوری سراسری سیستم به‌جای دایرکتوری شخصی کاربر ذخیره می‌کند.
\- یک عدد هگزادسیمال (مانند \[dq]0x81000001\[dq]): شیء کلید را برای پایا
  شدن نشانه‌گذاری کرده و هندل شیء پایا را روی این مقدار تنظیم می‌کند.
.EE
.RE
.IP \[bu] 2
\f[B]\-P\f[R], \f[B]\-\-policyPath\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
سیاستی که باید به کلید جدید مرتبط شود.
پارامتر اختیاری.
در صورت حذف، هیچ سیاستی با کلید مرتبط نخواهد شد.
.PP
یک policyPath از دو بخش تشکیل شده است که با \[lq]/\[rq] از هم جدا می‌شوند.
یک policyPath با \[lq]/policy\[rq] آغاز می‌شود.
بخش دوم مسیر، سیاست یا الگوی سیاست را با استفاده از یک نام معنادار مشخص می‌کند.
.RE
.IP \[bu] 2
\f[B]\-a\f[R], \f[B]\-\-authValue\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
گذرواژه جدید UTF\-8.
پارامتر اختیاری.
اگر نادیده گرفته شود، گذرواژه به‌صورت تعاملی از کاربر پرسیده می‌شود.
برای عدم تعیین گذرواژه، این گزینه باید با یک رشته خالی (\[lq]\[lq]) استفاده شود.
حداکثر اندازه گذرواژه بر اساس اندازه خلاصه (digest size) الگوریتم درهم‌سازی نام انتخابی در نمایه رمزنگاری تعیین می‌شود (ر.ک. \f[B]fapi\-profile(5)\f[R]).
برای مثال، انتخاب SHA256 به‌عنوان الگوریتم درهم‌سازی، امکان استفاده از گذرواژه‌هایی با حداکثر طول ۳۲ نویسه را فراهم می‌کند.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این مجموعه از گزینه‌ها بین تمام برنامه‌های tss2 مشترک هستند و اطلاعاتی را ارائه می‌دهند که ممکن است بسیاری از کاربران انتظار داشته باشند.
.IP \[bu] 2
\f[B]\-h\f[R], \f[B]\-\-help [man|no\-man]\f[R]: نمایش صفحه راهنمای ابزار.
به‌طور پیش‌فرض، تلاش می‌کند تا صفحه‌بند راهنما (manpager) را برای این ابزار فراخوانی کند؛ با این حال، در صورت بروز خطا خلاصه‌ای کوتاه از ابزار را نمایش می‌دهد.
این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد، اگرچه در صورت درخواست صریح \[lq]man\[rq]، ابزار خطاهای man را در stderr ارائه می‌دهد.
اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا manpager ناموفق باشد، گزینه‌های کوتاه در stdout خروجی داده می‌شوند.
.RS 2
.PP
استفاده موفق از قابلیت manpages مستلزم آن است که صفحات راهنما نصب شده باشند یا در \f[I]MANPATH\f[R] قرار داشته باشند؛ برای جزئیات بیشتر به \f[B]man\f[R](1) مراجعه کنید.
.RE
.IP \[bu] 2
\f[B]\-v\f[R], \f[B]\-\-version\f[R]: نمایش اطلاعات نسخه این ابزار و tctiهای پشتیبانی‌شده و خروج.
.SH "مثال‌ها (EXAMPLES)"
.SS ایجاد کلید بدون گذرواژه
.IP
.EX
tss2_createkey \-\-path=HS/SRK/myRsaCryptKey \-\-type=\[dq]noDa, decrypt\[dq] \-\-authValue=\[dq]\[dq]
.EE
.SS ایجاد کلید و درخواست گذرواژه در خط فرمان
.IP
.EX
tss2_createkey \-\-path=HS/SRK/myRsaCryptKey \-\-type=\[dq]noDa, decrypt\[dq]
.EE
.SS ایجاد کلید با گذرواژه \[lq]abc\[rq]
.IP
.EX
tss2_createkey \-\-path=HS/SRK/myRsaCryptKey \-\-type=\[dq]noDa, decrypt\[dq] \-\-authValue=abc
.EE
.SH "وضعیت خروج (EXIT STATUS)"
۰ در صورت موفقیت یا ۱ در صورت شکست.
.SH "گزارش باگ‌ها (BUGS)"
\c
.UR https://github.com/tpm2-software/tpm2-tools/issues
مسائل گیت‌هاب (Github Issues)
.UE \c
.SH "راهنما (HELP)"
ببینید \c
.UR https://lists.linuxfoundation.org/mailman/listinfo/tpm2
فهرست پستی (Mailing List)
.UE \c
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
این اثر تحت \c
.UR https://creativecommons.org/licenses/by/4.0
مجوز بین‌المللی ارجاع ۴.۰ کریتیو کامنز (CC BY 4.0)
.UE \c
\& منتشر شده است.