.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_pcrreset" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_pcrreset \- بازنشانی یک یا چند بانک ثبات وضعیت پلتفرم (PCR) .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_pcrreset\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]PCR_INDEX\f[R] \&... .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_pcrreset\f[R](1) مقدار ثبات PCR را در تمام بانک‌ها برای شاخص‌های مشخص‌شده بازنشانی (reset) می‌کند. می‌توان بیش از یک شاخص PCR را تعیین کرد. .PP مقدار بازنشانی وابسته به سازنده تراشه TPM است و دنباله‌ای از مقادیر 00 یا FF به اندازه طول الگوریتم درهم‌سازی برای هر بانک پشتیبانی‌شده است. .PP پارامتر \f[I]PCR_INDEX\f[R] فهرستی از شاخص‌های عددی PCR است که با فاصله از هم جدا شده‌اند و هنگام اجرای دستور بازنشانی خواهند شد. .SH "گزینه‌ها (OPTIONS)" این ابزار گزینه اختصاصی ندارد. .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت هش پارامترهای دستور. این مقدار معمولاً به عنوان cpHash نامیده می‌شود. نکته: هنگامی که این گزینه انتخاب شود، ابزار در واقع دستور را اجرا نمی‌کند و فقط cpHash را برمی‌گرداند. .RE .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک هستند و اطلاعاتی را ارائه می‌دهند که کاربران عموماً انتظار دارند. .IP \[bu] 2 \f[B]\-h\f[R]، \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنمای ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای ابزار فراخوانی کند؛ اما در صورت عدم موفقیت، خلاصه‌ای کوتاه از ابزار را خروجی می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه «man» مشخص شده باشد؛ اما اگر «man» صریحاً درخواست شده باشد، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینه «no\-man» مشخص شود یا فراخوانی manpager با شکست مواجه گردد، گزینه‌های کوتاه در stdout چاپ می‌شوند. .RS 2 .PP استفاده موفقیت‌آمیز از ویژگی صفحات راهنما نیازمند نصب بودن صفحات راهنما یا قرار داشتن آن‌ها در \f[I]MANPATH\f[R] است؛ برای جزئیات بیشتر به man(1) مراجعه کنید. .RE .IP \[bu] 2 \f[B]\-v\f[R]، \f[B]\-\-version\f[R]: نمایش اطلاعات نسخه این ابزار، TCTIهای پشتیبانی‌شده و خروج. .IP \[bu] 2 \f[B]\-V\f[R]، \f[B]\-\-verbose\f[R]: افزایش اطلاعاتی که ابزار در طول اجرای خود در کنسول چاپ می‌کند. هنگام استفاده از این گزینه، نام فایل و شماره خط چاپ می‌شوند. .IP \[bu] 2 \f[B]\-Q\f[R]، \f[B]\-\-quiet\f[R]: خاموش کردن خروجی عادی ابزار به stdout. .IP \[bu] 2 \f[B]\-Z\f[R]، \f[B]\-\-enable\-errata\f[R]: فعال‌سازی اعمال اصلاحیه‌های اشکالات (errata fixups). زمانی مفید است که اعمال اصلاحیه خطا روی دستورات ارسالی به TPM ضروری باشد. تنظیم متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این گزینه است. .IP \[bu] 2 \f[B]\-z\f[R]، \f[B]\-\-pwd\-session\f[R]: استفاده از نشست گذرواژه به جای نشست HMAC برای احراز اصالت. یک گذرواژه به صورت متن‌آشکار (clear text) برای صدور مجوز عملیات به TPM ارسال می‌شود. این گزینه می‌تواند برای جلوگیری از بروز مشکلات هنگام استفاده از نشست‌های بدون نمک (unsalted) در حالت OpenSSL FIPS به کار رود. اگر از مقادیر auth استفاده می‌شود، باید از یک نشست نمک‌دار (salted) برای احراز اصالت استفاده گردد. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرای ایجادشده توسط دستور. اگر یک شیء والد از فایل بافتار بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد. تخلیه خودکار همچنین با تنظیم متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true فعال می‌شود. .SH "پیکربندی TCTI (TCTI Configuration)" رابط TCTI یا «Transmission Interface»، سازوکار ارتباطی با TPM است. TCTIها را می‌توان برای برقراری ارتباط با TPM از طریق بسترهای مختلف تغییر داد. .PP برای کنترل TCTI، ابزارها موارد زیر را رعایت می‌کنند: .IP "1." 3 گزینه خط فرمان \f[B]\-T\f[R] یا \f[B]\-\-tcti\f[R] .IP "2." 3 متغیر محیطی: \f[I]TPM2TOOLS_TCTI\f[R]. .PP \f[B]نکته:\f[R] گزینه خط فرمان همیشه بر متغیر محیطی اولویت دارد. .PP TCTIهای شناخته‌شده کنونی عبارتند از: .IP \[bu] 2 tabrmd \- مدیر منابع، موسوم به \c .UR https://github.com/tpm2-software/tpm2-abrmd tabrmd .UE \c \&. توجه داشته باشید که tabrmd و abrmd به عنوان نام tcti مترادف یکدیگرند. .IP \[bu] 2 mssim \- معمولاً برای برقراری ارتباط با شبیه‌ساز نرم‌افزاری TPM استفاده می‌شود. .IP \[bu] 2 device \- هنگام برقراری ارتباط مستقیم با فایل دستگاه TPM استفاده می‌شود. .IP \[bu] 2 none \- هیچ اتصالی با TPM برقرار نمی‌کند. برخی ابزارها امکان استفاده از گزینه‌های خارج از TPM (off\-tpm) را فراهم می‌کنند و بنابراین از عدم استفاده از TCTI پشتیبانی می‌کنند. ابزارهایی که از آن پشتیبانی نمی‌کنند، در صورت تلاش برای استفاده بدون اتصال TCTI با خطا مواجه می‌شوند. از \f[I]هیچ\f[R] گزینه‌ای پشتیبانی نمی‌کند و \f[I]باید حتماً\f[R] دقیقاً به صورت متن «none» ارائه شود. .PP آرگومان‌های ارسال‌شده به گزینه خط فرمان یا متغیر محیطی به قالب زیر هستند: .PP \f[CR]:\f[R] .PP تعیین یک رشته خالی برای هر یک از \f[CR]\f[R] یا \f[CR]\f[R] باعث می‌شود مقدار پیش‌فرض برای آن بخش به کار گرفته شود. .SS "پیش‌فرض‌های TCTI (TCTI Defaults)" هنگامی که TCTI مشخص نشده باشد، TCTI پیش‌فرض با استفاده از معناشناسی \f[I]dlopen(3)\f[R] جستجو می‌شود. ابزارها به دنبال TCTIهای \f[I]tabrmd\f[R]، \f[I]device\f[R] و \f[I]mssim\f[R] \f[B]به همان ترتیب\f[R] می‌گردند و \f[B]از اولین مورد یافت‌شده استفاده می‌کنند\f[R]. می‌توانید با استفاده از گزینه \f[B]\-v\f[R] برای چاپ اطلاعات نسخه، بررسی کنید که کدام TCTI به عنوان پیش‌فرض انتخاب خواهد شد. جفت کلید\-مقدار «default\-tcti» مشخص می‌کند که کدام‌یک از TCTIهای یادشده پیش‌فرض است. .SS "TCTIهای سفارشی (Custom TCTIs)" هر TCTI که رابط TCTI پویا را پیاده‌سازی کند می‌تواند بارگذاری شود. ابزارها در داخل از \f[I]dlopen(3)\f[R] استفاده می‌کنند و مقدار خام \f[I]tcti\-name\f[R] برای جستجو به کار می‌رود. بنابراین، این مقدار می‌تواند مسیری به کتابخانه مشترک یا نام کتابخانه‌ای باشد که بر اساس معناشناسی \f[I]dlopen(3)\f[R] درک می‌شود. .SH "گزینه‌های TCTI (TCTI OPTIONS)" این مجموعه گزینه‌ها برای پیکربندی ماژول‌های گوناگون و شناخته‌شده TCTI موجود استفاده می‌شوند: .IP \[bu] 2 \f[B]device\f[R]: برای TCTI دستگاه (device)، فایل دستگاه نویسه‌ای TPM برای استفاده توسط TCTI دستگاه می‌تواند مشخص شود. مقدار پیش‌فرض \f[I]/dev/tpm0\f[R] است. .RS 2 .PP مثال: \f[B]\-T device:/dev/tpm0\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]device:/dev/tpm0\[rq]\f[R] .RE .IP \[bu] 2 \f[B]mssim\f[R]: برای TCTI شبیه‌ساز mssim، نام دامنه یا آدرس IP و شماره درگاه (پورت) استفاده‌شده توسط شبیه‌ساز می‌تواند مشخص شود. مقادیر پیش‌فرض 127.0.0.1 و 2321 هستند. .RS 2 .PP مثال: \f[B]\-T mssim:host=localhost,port=2321\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]mssim:host=localhost,port=2321\[rq]\f[R] .RE .IP \[bu] 2 \f[B]abrmd\f[R]: برای TCTI abrmd، قالب رشته پیکربندی مجموعه‌ای از جفت‌های کلید\-مقدار ساده است که با نویسه `,' از یکدیگر جدا شده‌اند. هر کلید و مقدار با نویسه `=' از هم تفکیک می‌شوند. .RS 2 .IP \[bu] 2 ماژول TCTI abrmd از دو کلید پشتیبانی می‌کند: .RS 2 .IP "1." 3 `bus_name` : نام سرویس tabrmd روی گذرگاه (یک رشته). .IP "2." 3 `bus_type` : نوع نمونه dbus (یک رشته) محدود به `session` و `system`. .RE .PP مشخص کردن نام tcti به صورت tabrmd و رشته پیکربندی \f[CR]bus_name=com.example.FooBar\f[R]: .IP .EX \[rs]\-\-tcti=tabrmd:bus_name=com.example.FooBar .EE .PP مشخص کردن tcti پیش‌فرض (abrmd) و رشته پیکربندی \f[CR]bus_type=session\f[R]: .IP .EX \[rs]\-\-tcti:bus_type=session .EE .PP \f[B]نکته\f[R]: abrmd و tabrmd مترادف یکدیگر هستند. .RE .SH "مثال‌ها (EXAMPLES)" .SS "بازنشانی یک PCR منفرد" .IP .EX tpm2_pcrreset 23 .EE .SS "بازنشانی چندین PCR" .IP .EX tpm2_pcrreset 16 23 .EE .SH "نکات (NOTES)" در سطح دسترسی سیستم‌عامل (locality، معمولاً locality 0)، تنها ثبات PCR 23 قابل بازنشانی است. ثبات PCR\-16 نیز ممکن است در این سطح دسترسی بسته به سازنده TPM (که این PCR را قابل بازنشانی تعریف کرده باشد یا خیر) قابل بازنشانی باشد. .PP ثبات‌های PCR 0 تا 15 قابل بازنشانی نیستند (زیرا بخشی از زنجیره اندازه‌گیری ریشه ایستا یا SRTM هستند). ثبات‌های PCR 16 تا 22 بیشتر برای زنجیره ریشه پویا (DRTM) رزرو شده‌اند یا به سطوح دسترسی (localities) خاصی اختصاص دارند و بسته به سطح دسترسی فعلی TPM ممکن است قابل بازنشانی نباشند. .SH "کدهای بازگشتی (RETURNS)" ابزارها می‌توانند هر یک از کدهای بازگشتی زیر را ارائه دهند: .IP \[bu] 2 0 \- موفقیت‌آمیز. .IP \[bu] 2 1 \- خطای عمومی و نامشخص. .IP \[bu] 2 2 \- خطای پردازش گزینه‌ها. .IP \[bu] 2 3 \- خطای احراز اصالت. .IP \[bu] 2 4 \- خطای مرتبط با TCTI. .IP \[bu] 2 5 \- طرح پشتیبانی‌نشده. قابل اعمال بر روی tpm2_testparams. .SH "همچنین ببینید (SEE ALSO)" .BR tpm2_pcrread (1), .BR tpm2_pcrextend (1), .BR tpm2_pcrevent (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 منتشر شده است.