.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "tss2_quote" "1" "APRIL 2019" "tpm2\-tools" "General Commands Manual"
.SH "نام (NAME)"
\f[B]tss2_quote\f[R] \- انجام تصدیق اصالت با استفاده از TPM
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tss2_quote\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 مانند الگوریتم درهم‌سازی نام (name hash)، الگوریتم امضای نامتقارن، طرح، پارامترها و انتخاب بانک PCR.
.SH "توضیحات (DESCRIPTION)"
دستور \f[B]tss2_quote\f[R](1) یک تصدیق اصالت (attestation) را با استفاده از TPM انجام می‌دهد.
بانک PCR برای هر اندیس ارائه‌شده از PCR و طرح امضا در نمایه رمزنگاری تنظیم می‌شوند (رجوع کنید به \f[B]fapi\-profile(5)\f[R]).
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.IP \[bu] 2
\f[B]\-x\f[R], \f[B]\-\-pcrList\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
آرایه‌ای شامل اندیس‌های PCR برای اعمال عملیات quote.
.RE
.IP \[bu] 2
\f[B]\-Q\f[R], \f[B]\-\-qualifyingData\f[R]=\f[I]FILENAME\f[R] یا
\f[I]\-\f[R] (برای stdin):
.RS 2
.PP
یک نانس (nonce) ارائه‌شده توسط فراخوان‌کننده جهت اطمینان از تازگی امضا.
پارامتر اختیاری.
.RE
.IP \[bu] 2
\f[B]\-l\f[R], \f[B]\-\-pcrLog\f[R]=\f[I]FILENAME\f[R] یا \f[I]\-\f[R]
(برای stdout):
.RS 2
.PP
لاگ PCR را برای PCR انتخاب‌شده بازمی‌گرداند.
پارامتر اختیاری.
.PP
لاگ‌های رویداد PCR فهرستی (آرایه JSON با طول دلخواه) از مدخل‌های لاگ با محتوای زیر هستند:
.IP
.EX
\- recnum: شماره رکورد یکتا
\- pcr: اندیس PCR
\- digest: خلاصه‌ها (digests)
\- type: نوع رویداد. در حال حاضر تنها مقدار ممکن: \[dq]LINUX_IMA\[dq] (نسخه قدیمی IMA)
\- eventDigest: خلاصه رویداد؛ برای مثال خلاصه فایل اندازه‌گیری‌شده
\- eventName: نام رویداد؛ برای مثال نام فایل اندازه‌گیری‌شده.
.EE
.RE
.IP \[bu] 2
\f[B]\-f\f[R], \f[B]\-\-force\f[R]:
.RS 2
.PP
رونویسی اجباری فایل خروجی.
.RE
.IP \[bu] 2
\f[B]\-p\f[R], \f[B]\-\-keyPath\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
کلید امضا را مشخص می‌کند.
.RE
.IP \[bu] 2
\f[B]\-q\f[R], \f[B]\-\-quoteInfo\f[R]=\f[I]FILENAME\f[R] یا
\f[I]\-\f[R] (برای stdout):
.RS 2
.PP
یک ساختار با کدگذاری JSON شامل ورودی‌های عملیات quote را بازمی‌گرداند.
این ساختار شامل مقدار درهم‌سازی (digest) و مقادیر PCR است.
.RE
.IP \[bu] 2
\f[B]\-o\f[R], \f[B]\-\-signature\f[R]=\f[I]FILENAME\f[R] یا
\f[I]\-\f[R] (برای stdout):
.RS 2
.PP
امضای اعمال‌شده بر روی داده‌های quote را بازمی‌گرداند.
.RE
.IP \[bu] 2
\f[B]\-c\f[R], \f[B]\-\-certificate\f[R]=\f[I]FILENAME\f[R] یا
\f[I]\-\f[R] (برای stdout):
.RS 2
.PP
گواهی مرتبط با keyPath در قالب PEM.
پارامتر اختیاری.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این مجموعه گزینه‌ها میان تمامی برنامه‌های tss2 مشترک بوده و اطلاعاتی را فراهم می‌کنند که اغلب کاربران انتظار دارند.
.IP \[bu] 2
\f[B]\-h\f[R], \f[B]\-\-help [man|no\-man]\f[R]: نمایش صفحه راهنمای
(manpage) ابزار.
به‌طور پیش‌فرض تلاش می‌شود تا صفحه‌بند man برای ابزار فراخوانی شود، اما در
صورت عدم موفقیت، خلاصه‌ای کوتاه از ابزار چاپ می‌شود.
این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد،
با این حال اگر \[lq]man\[rq] به‌طور صریح درخواست شود، ابزار خطاهای man را
در stderr گزارش می‌دهد.
اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا فراخوانی صفحه‌بند man با شکست
مواجه شود، خلاصه‌ای از گزینه‌ها در خروجی استاندارد (stdout) نمایش داده خواهد شد.
.RS 2
.PP
برای استفاده موفق از قابلیت صفحات راهنما، لازم است که این صفحات نصب شده
یا در \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_quote \-\-keyPath=HS/SRK/quotekey \-\-pcrList=\[dq]10,16\[dq] \-\-qualifyingData=qualifyingData.file \-\-signature=signature.file \-\-pcrLog=pcrLog.file \-\-certificate=certificate.file \-\-quoteInfo=quoteInfo.info
.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 "کپی‌رایت و تکثیر (COPYRIGHT)"
این اثر تحت مجوز \c
.UR https://creativecommons.org/licenses/by/4.0
کریتیو کامنز ارجاع نسخه 4.0 بین‌المللی (CC BY 4.0)
.UE \c
\& منتشر شده است.