.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "tss2_sign" "1" "APRIL 2019" "tpm2\-tools" "General Commands Manual"
.SH "نام (NAME)"
tss2_sign \- امضای داده‌ها یا خلاصه پیام با استفاده از کلیدی در TPM
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tss2_sign\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_sign\f[R](1) از یک کلید درونی TPM برای امضای یک مقدار خلاصه (digest) بر اساس طرح‌های امضای TPM طبق آنچه در نمایهٔ رمزنگاری مشخص شده است (ر.ک. \f[B]fapi\-profile(5)\f[R]) استفاده می‌کند.
مقدار خلاصه می‌تواند به عنوان یک آرگومان ارائه شود یا از داده‌هایی که به عنوان آرگومان ارسال شده‌اند محاسبه گردد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.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]\-s\f[R], \f[B]\-\-padding\f[R]=\f[I]STRING\f[R]:
.RS 2
.PP
طرح لایه‌گذاری (padding) مورداستفاده.
مقادیر مجاز عبارتند از \[lq]RSA_SSA\[rq] و \[lq]RSA_PSS\[rq] (بدون حساسیت به بزرگی و کوچکی حروف).
پارامتر اختیاری.
در صورت حذف، مقدار پیش‌فرض لایه‌گذاری مشخص‌شده در نمایهٔ رمزنگاری (ر.ک. \f[B]fapi\-profile(5)\f[R]) استفاده می‌شود.
.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
.IP \[bu] 2
\f[B]\-d\f[R], \f[B]\-\-digest\f[R]=\f[I]FILENAME\f[R] یا \f[I]\-\f[R] (برای stdin):
.RS 2
.PP
داده‌هایی که باید امضا شوند و از قبل درهم‌سازی (hash) شده‌اند.
.RE
.IP \[bu] 2
\f[B]\-m\f[R], \f[B]\-\-data\f[R]=\f[I]FILENAME\f[R] یا \f[I]\-\f[R] (برای stdin):
.RS 2
.PP
داده‌هایی که مقدار درهم‌سازی از آن‌ها محاسبه شده و سپس امضا می‌شود.
.RE
.IP \[bu] 2
\f[B]\-f\f[R], \f[B]\-\-force\f[R]:
.RS 2
.PP
بازنویسی اجباری فایل خروجی.
.RE
.IP \[bu] 2
\f[B]\-k\f[R], \f[B]\-\-publicKey\f[R]=\f[I]FILENAME\f[R] یا \f[I]\-\f[R] (برای stdout):
.RS 2
.PP
کلید عمومی مرتبط با keyPath در قالب PEM.
پارامتر اختیاری.
.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
امضا را به صورت باینری بازمی‌گرداند.
.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
استفادهٔ موفقیت‌آمیز از ویژگی 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 "مثال (EXAMPLE)"
.IP
.EX
tss2_sign \-\-keyPath=HS/SRK/myRSASign \-\-padding=\[dq]RSA_PSS\[dq] \-\-digest=digest.file \-\-signature=signature.file \-\-publicKey=publicKey.file
.EE
.SH "کدهای بازگشتی (RETURNS)"
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
Creative Commons Attribution 4.0 International License (CC BY 4.0)
.UE \c
\& منتشر شده است.