.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "tss2_setdescription" "1" "APRIL 2019" "tpm2\-tools" "General Commands Manual"
.SH "نام (NAME)"
tss2_setdescription \- اختصاص یک توضیح خوانا برای انسان به یک شیء در مخزن فرادادهٔ FAPI
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tss2_setdescription\f[R] [\f[I]گزینه‌ها\f[R]]
.SH "همچنین ببینید (SEE ALSO)"
\f[B]fapi\-config(5)\f[R] برای تنظیم پارامترهای Fapi مانند نمایهٔ رمزنگاری استفاده‌شده و TCTI یا دایرکتوری‌های مربوط به ذخیره‌سازی فرادادهٔ Fapi.
.PP
\f[B]fapi\-profile(5)\f[R] برای تعیین الگوریتم‌های رمزنگاری و پارامترها برای تمام کلیدها و عملیات مربوط به یک تعامل مشخص TPM مانند الگوریتم درهم‌سازی نام (name hash)، الگوریتم امضای نامتقارن، طرح و پارامترها و انتخاب بانک PCR.
.SH "توضیحات (DESCRIPTION)"
دستور \f[B]tss2_setdescription\f[R](1) به برنامه‌ها اجازه می‌دهد یک توضیح خوانا برای انسان را به یک شیء در مخزن فرادادهٔ FAPI اختصاص دهند.
داده‌های ذخیره‌شده را می‌توان با دستور tss2_getdescription بازخوانی کرد.
داده‌هایی که قبلاً ذخیره شده‌اند توسط این تابع بازنویسی می‌شوند.
اگر یک توضیح خالی ارسال شود، داده‌های ذخیره‌شده حذف خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.IP \[bu] 2
\f[B]\-i\f[R], \f[B]\-\-description\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
داده‌ای که باید به عنوان توضیح شیء ذخیره شود.
این پارامتر اختیاری است.
توضیحاتی که پیش‌تر ذخیره شده‌اند توسط این تابع بازنویسی می‌شوند.
در صورت حذف این گزینه، هرگونه توضیح ذخیره‌شده حذف می‌شود.
.RE
.IP \[bu] 2
\f[B]\-p\f[R], \f[B]\-\-path\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
مسیر شیئی که توضیحات برای آن ذخیره خواهد شد.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این مجموعه از گزینه‌ها میان تمامی برنامه‌های tss2 مشترک هستند و اطلاعات عمومی مورد نیاز کاربران را فراهم می‌کنند.
.IP \[bu] 2
\f[B]\-h\f[R], \f[B]\-\-help [man|no\-man]\f[R]: نمایش صفحهٔ راهنمای (manpage) ابزار.
به‌طور پیش‌فرض، تلاش می‌شود صفحه‌بند راهنما (manpager) برای ابزار فراخوانی شود، اما در صورت بروز خطا، خلاصه‌ای کوتاه از ابزار در خروجی نمایش داده خواهد شد.
این رفتار مشابه مشخص کردن آرگومان \[lq]man\[rq] برای این گزینه است؛ با این حال اگر \[lq]man\[rq] به‌صورت صریح درخواست شده باشد، خطاهای man در stderr ارسال می‌شوند.
اگر گزینهٔ \[lq]no\-man\[rq] تعیین شده باشد، یا اجرای manpager با شکست مواجه شود، گزینه‌های کوتاه در stdout چاپ خواهند شد.
.RS 2
.PP
استفادهٔ موفقیت‌آمیز از ویژگی manpage نیازمند نصب صفحات راهنما یا قرار داشتن آن‌ها در مسیر \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)"
.IP
.EX
tss2_setdescription \-\-path=HS/SRK \-\-description=description
.EE
.SH "وضعیت خروج (EXIT STATUS)"
0 در صورت موفقیت یا 1 در صورت بروز خطا.
.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 "مجوز (LICENSE)"
این اثر تحت \c
.UR https://creativecommons.org/licenses/by/4.0
مجوز بین‌المللی کریتیو کامنز ارجاع ۴.۰ (CC BY 4.0)
.UE \c
\& منتشر شده است.