tpm2_pcrreset(1) General Commands Manual tpm2_pcrreset(1)

tpm2_pcrreset - بازنشانی یک یا چند بانک ثبات وضعیت پلتفرم (PCR)

tpm2_pcrreset [گزینه‌ها] PCR_INDEX ...

دستور tpm2_pcrreset(1) مقدار ثبات PCR را در تمام بانک‌ها برای شاخص‌های مشخص‌شده بازنشانی (reset) می‌کند. می‌توان بیش از یک شاخص PCR را تعیین کرد.

مقدار بازنشانی وابسته به سازنده تراشه TPM است و دنباله‌ای از مقادیر 00 یا FF به اندازه طول الگوریتم درهم‌سازی برای هر بانک پشتیبانی‌شده است.

پارامتر PCR_INDEX فهرستی از شاخص‌های عددی PCR است که با فاصله از هم جدا شده‌اند و هنگام اجرای دستور بازنشانی خواهند شد.

این ابزار گزینه اختصاصی ندارد.

•
--cphash=FILE

مسیر فایل برای ثبت هش پارامترهای دستور. این مقدار معمولاً به عنوان cpHash نامیده می‌شود. نکته: هنگامی که این گزینه انتخاب شود، ابزار در واقع دستور را اجرا نمی‌کند و فقط cpHash را برمی‌گرداند.

این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک هستند و اطلاعاتی را ارائه می‌دهند که کاربران عموماً انتظار دارند.

•
-h، --help=[man|no-man]: نمایش صفحه راهنمای ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای ابزار فراخوانی کند؛ اما در صورت عدم موفقیت، خلاصه‌ای کوتاه از ابزار را خروجی می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه «man» مشخص شده باشد؛ اما اگر «man» صریحاً درخواست شده باشد، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینه «no-man» مشخص شود یا فراخوانی manpager با شکست مواجه گردد، گزینه‌های کوتاه در stdout چاپ می‌شوند.

استفاده موفقیت‌آمیز از ویژگی صفحات راهنما نیازمند نصب بودن صفحات راهنما یا قرار داشتن آن‌ها در MANPATH است؛ برای جزئیات بیشتر به man(1) مراجعه کنید.

•
-v، --version: نمایش اطلاعات نسخه این ابزار، TCTIهای پشتیبانی‌شده و خروج.
•
-V، --verbose: افزایش اطلاعاتی که ابزار در طول اجرای خود در کنسول چاپ می‌کند. هنگام استفاده از این گزینه، نام فایل و شماره خط چاپ می‌شوند.
•
-Q، --quiet: خاموش کردن خروجی عادی ابزار به stdout.
•
-Z، --enable-errata: فعال‌سازی اعمال اصلاحیه‌های اشکالات (errata fixups). زمانی مفید است که اعمال اصلاحیه خطا روی دستورات ارسالی به TPM ضروری باشد. تنظیم متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این گزینه است.
•
-z، --pwd-session: استفاده از نشست گذرواژه به جای نشست HMAC برای احراز اصالت. یک گذرواژه به صورت متن‌آشکار (clear text) برای صدور مجوز عملیات به TPM ارسال می‌شود. این گزینه می‌تواند برای جلوگیری از بروز مشکلات هنگام استفاده از نشست‌های بدون نمک (unsalted) در حالت OpenSSL FIPS به کار رود. اگر از مقادیر auth استفاده می‌شود، باید از یک نشست نمک‌دار (salted) برای احراز اصالت استفاده گردد.
•
-R، --autoflush: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرای ایجادشده توسط دستور. اگر یک شیء والد از فایل بافتار بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد. تخلیه خودکار همچنین با تنظیم متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true فعال می‌شود.

رابط TCTI یا «Transmission Interface»، سازوکار ارتباطی با TPM است. TCTIها را می‌توان برای برقراری ارتباط با TPM از طریق بسترهای مختلف تغییر داد.

برای کنترل TCTI، ابزارها موارد زیر را رعایت می‌کنند:

1.
گزینه خط فرمان -T یا --tcti
2.
متغیر محیطی: TPM2TOOLS_TCTI.

نکته: گزینه خط فرمان همیشه بر متغیر محیطی اولویت دارد.

TCTIهای شناخته‌شده کنونی عبارتند از:

•
tabrmd - مدیر منابع، موسوم به tabrmd. توجه داشته باشید که tabrmd و abrmd به عنوان نام tcti مترادف یکدیگرند.
•
mssim - معمولاً برای برقراری ارتباط با شبیه‌ساز نرم‌افزاری TPM استفاده می‌شود.
•
device - هنگام برقراری ارتباط مستقیم با فایل دستگاه TPM استفاده می‌شود.
•
none - هیچ اتصالی با TPM برقرار نمی‌کند. برخی ابزارها امکان استفاده از گزینه‌های خارج از TPM (off-tpm) را فراهم می‌کنند و بنابراین از عدم استفاده از TCTI پشتیبانی می‌کنند. ابزارهایی که از آن پشتیبانی نمی‌کنند، در صورت تلاش برای استفاده بدون اتصال TCTI با خطا مواجه می‌شوند. از هیچ گزینه‌ای پشتیبانی نمی‌کند و باید حتماً دقیقاً به صورت متن «none» ارائه شود.

آرگومان‌های ارسال‌شده به گزینه خط فرمان یا متغیر محیطی به قالب زیر هستند:

<tcti-name>:<tcti-option-config>

تعیین یک رشته خالی برای هر یک از <tcti-name> یا <tcti-option-config> باعث می‌شود مقدار پیش‌فرض برای آن بخش به کار گرفته شود.

هنگامی که TCTI مشخص نشده باشد، TCTI پیش‌فرض با استفاده از معناشناسی dlopen(3) جستجو می‌شود. ابزارها به دنبال TCTIهای tabrmd، device و mssim به همان ترتیب می‌گردند و از اولین مورد یافت‌شده استفاده می‌کنند. می‌توانید با استفاده از گزینه -v برای چاپ اطلاعات نسخه، بررسی کنید که کدام TCTI به عنوان پیش‌فرض انتخاب خواهد شد. جفت کلید-مقدار «default-tcti» مشخص می‌کند که کدام‌یک از TCTIهای یادشده پیش‌فرض است.

هر TCTI که رابط TCTI پویا را پیاده‌سازی کند می‌تواند بارگذاری شود. ابزارها در داخل از dlopen(3) استفاده می‌کنند و مقدار خام tcti-name برای جستجو به کار می‌رود. بنابراین، این مقدار می‌تواند مسیری به کتابخانه مشترک یا نام کتابخانه‌ای باشد که بر اساس معناشناسی dlopen(3) درک می‌شود.

این مجموعه گزینه‌ها برای پیکربندی ماژول‌های گوناگون و شناخته‌شده TCTI موجود استفاده می‌شوند:

•
device: برای TCTI دستگاه (device)، فایل دستگاه نویسه‌ای TPM برای استفاده توسط TCTI دستگاه می‌تواند مشخص شود. مقدار پیش‌فرض /dev/tpm0 است.

مثال: -T device:/dev/tpm0 یا export TPM2TOOLS_TCTI=“device:/dev/tpm0”

•
mssim: برای TCTI شبیه‌ساز mssim، نام دامنه یا آدرس IP و شماره درگاه (پورت) استفاده‌شده توسط شبیه‌ساز می‌تواند مشخص شود. مقادیر پیش‌فرض 127.0.0.1 و 2321 هستند.

مثال: -T mssim:host=localhost,port=2321 یا export TPM2TOOLS_TCTI=“mssim:host=localhost,port=2321”

•
abrmd: برای TCTI abrmd، قالب رشته پیکربندی مجموعه‌ای از جفت‌های کلید-مقدار ساده است که با نویسه `,' از یکدیگر جدا شده‌اند. هر کلید و مقدار با نویسه `=' از هم تفکیک می‌شوند.
•
ماژول TCTI abrmd از دو کلید پشتیبانی می‌کند:
1.
`bus_name` : نام سرویس tabrmd روی گذرگاه (یک رشته).
2.
`bus_type` : نوع نمونه dbus (یک رشته) محدود به `session` و `system`.

مشخص کردن نام tcti به صورت tabrmd و رشته پیکربندی bus_name=com.example.FooBar:

\--tcti=tabrmd:bus_name=com.example.FooBar

مشخص کردن tcti پیش‌فرض (abrmd) و رشته پیکربندی bus_type=session:

\--tcti:bus_type=session

نکته: abrmd و tabrmd مترادف یکدیگر هستند.

tpm2_pcrreset 23

tpm2_pcrreset 16 23

در سطح دسترسی سیستم‌عامل (locality، معمولاً locality 0)، تنها ثبات PCR 23 قابل بازنشانی است. ثبات PCR-16 نیز ممکن است در این سطح دسترسی بسته به سازنده TPM (که این PCR را قابل بازنشانی تعریف کرده باشد یا خیر) قابل بازنشانی باشد.

ثبات‌های PCR 0 تا 15 قابل بازنشانی نیستند (زیرا بخشی از زنجیره اندازه‌گیری ریشه ایستا یا SRTM هستند). ثبات‌های PCR 16 تا 22 بیشتر برای زنجیره ریشه پویا (DRTM) رزرو شده‌اند یا به سطوح دسترسی (localities) خاصی اختصاص دارند و بسته به سطح دسترسی فعلی TPM ممکن است قابل بازنشانی نباشند.

ابزارها می‌توانند هر یک از کدهای بازگشتی زیر را ارائه دهند:

•
0 - موفقیت‌آمیز.
•
1 - خطای عمومی و نامشخص.
•
2 - خطای پردازش گزینه‌ها.
•
3 - خطای احراز اصالت.
•
4 - خطای مرتبط با TCTI.
•
5 - طرح پشتیبانی‌نشده. قابل اعمال بر روی tpm2_testparams.

tpm2_pcrread(1), tpm2_pcrextend(1), tpm2_pcrevent(1)

مسائل گیت‌هاب (Github Issues)

مشاهده فهرست پستی (Mailing List).

این اثر تحت مجوز بین‌المللی کریتیو کامنز ارجاع ۴.۰ (CC BY 4.0) منتشر شده است.

tpm2-tools