.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_clearcontrol" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" \f[B]tpm2_clearcontrol\f[R] \- تنظیم یا بازنشانی صفت TPMA_PERMANENT.disableClear جهت مسدود یا آزاد کردن دستگیره مجازشماری lockout برای صدور دستور پاک‌سازی TPM .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_clearcontrol\f[R] [\f[I]گزینه‌ها\f[R]] [\f[I]آرگومان\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_clearcontrol\f[R](1) \- به کاربری که مقدار مجازشماری سلسله‌مراتب lockout یا سلسله‌مراتب platform را دارد اجازه می‌دهد تا صفت disableClear را تنظیم کند، که مانع از توانایی مجازشماری lockout برای اجرای دستور tpm2_clear می‌شود\&. تنها کاربری که به مجازشماری سلسله‌مراتب platform دسترسی دارد می‌تواند disableClear را بازنشانی (پاک) کند\&. به‌طور پیش‌فرض، این دستور تلاش می‌کند بیت disableClear را پاک کند\&. .PP نکته: از دستگیره مجازشماری سلسله‌مراتب platform همواره می‌توان برای پاک‌سازی TPM با دستور tpm2_clear استفاده کرد\&. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-C\f[R], \f[B]\-\-hierarchy\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP مشخص می‌کند که این ابزار باید روی کدام دستگیره مجازشماری (سلسله‌مراتب platform یا lockout) عمل کند\&. به‌طور پیش‌فرض، روی دستگیره سلسله‌مراتب platform عمل می‌کند\&. دستگیره را به‌صورت p|l|platform|lockout مشخص کنید\&. .PP \f[B]نکته: کار روی سلسله‌مراتب platform نیازمند احراز هویت platform است\&.\f[R] .RE .IP \[bu] 2 \f[B]\-P\f[R], \f[B]\-\-auth\f[R]=\f[I]AUTH\f[R]: .RS 2 .PP مقدار مجازشماری سلسله‌مراتب مشخص‌شده با \f[B]\-C\f[R]\&. این ابزار تنها از گزینه‌های \f[I]Password\f[R] و \f[I]HMAC\f[R] پشتیبانی می‌کند\&. .RE .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت هش پارامترهای دستور\&. این مقدار معمولاً cpHash نامیده می‌شود\&. نکته: هنگامی که این گزینه انتخاب شود، ابزار دستور را واقعاً اجرا نمی‌کند و فقط یک cpHash بازمی‌گرداند\&. .RE .IP \[bu] 2 \f[B]ARGUMENT\f[R] ** مشخص کردن یک عدد صحیح 0|1 یا رشته c|s برای پاک کردن یا تنظیم صفت disableClear\&. .SS "مراجع (REFERENCES)" .SH "قالب شیء زمینه (CONTEXT OBJECT FORMAT)" نوع یک شیء زمینه، خواه دستگیره باشد یا نام فایل، بر اساس منطق \f[I]ترتیبی\f[R] زیر تعیین می‌شود: .IP \[bu] 2 اگر آرگومان یک مسیر فایل باشد، فایل به عنوان یک شیء گذرای (transient) بازیابی‌شده TPM بارگذاری می‌شود\&. .IP \[bu] 2 اگر آرگومان تطابق \f[I]پیشوندی\f[R] با یکی از موارد زیر داشته باشد: .RS 2 .IP \[bu] 2 owner: سلسله‌مراتب مالک (owner) .IP \[bu] 2 platform: سلسله‌مراتب پلتفرم (platform) .IP \[bu] 2 endorsement: سلسله‌مراتب تاییدیه (endorsement) .IP \[bu] 2 lockout: شیء پایدار کنترل lockout .RE .IP \[bu] 2 اگر آرگومان بتواند به صورت یک عدد بارگذاری شود، به عنوان یک دستگیره در نظر گرفته شده (مانند 0x81010013) و مستقیماً استفاده می‌شود\&. .SH "قالب‌بندی مجازشماری (AUTHORIZATION FORMATTING)" مجازشماری برای استفاده از یک شیء در TPM2.0 می‌تواند در ۳ شکل مختلف باشد: ۱. گذرواژه (Password) ۲. کد HMAC ۳. نشست‌ها (Sessions)\&. .PP \f[B]نکته:\f[R] \[lq]مجازشماری‌ها در صورت عدم تعیین، به‌طور پیش‌فرض بر روی \f[B]گذرواژه خالی\f[R] تنظیم می‌شوند\[rq]\&. .PP برای احراز هویت با مقادیر auth، دستورات ابزار به‌طور ضمنی یک نشست HMAC ایجاد می‌کنند\&. بنابراین گذرواژه‌ها به صورت رمزنشده منتقل نمی‌شوند\&. این موضوع برای گذرواژه‌های تعریف‌شده برای اشیاء صدق نمی‌کند\&. در این حالت، باید از یک نشست HMAC استفاده شود (نگاه کنید به tpm2_startauthsession(1))\&. .SS "گذرواژه‌ها (PASSWORDS)" گذرواژه‌ها با استفاده از شناسه‌های پیشوندی به اشکال زیر تفسیر می‌شوند\&. .PP \f[B]نکته\f[R]: به‌طور پیش‌فرض، گذرواژه‌های فاقد پیشوند به صورت رشته متنی فرض می‌شوند\&. .SS "رشته (STRING)" یک گذرواژه رشته‌ای که با پیشوند \[lq]str:\[rq] یا بدون پیشوند (رشته خام) مشخص می‌شود، پردازش تفسیری نشده و مستقیماً برای مجازشماری استفاده می‌گردد\&. .SS "مثال‌ها (EXAMPLES)" .IP .EX foobar str:foobar .EE .SS "رشته شانزده‌شانزدهی (HEX-STRING)" یک گذرواژه بر مبنای ۱۶ (hex\-string) که با پیشوند \[lq]hex:\[rq] مشخص می‌شود، از حالت هگزادسیمال به یک آرایه بایتی تبدیل می‌شود؛ بدین ترتیب استفاده از گذرواژه‌هایی با نویسه‌های غیرقابل‌چاپ یا ناسازگار با ترمینال امکان‌پذیر می‌گردد\&. .SS "مثال (EXAMPLE)" .IP .EX hex:1122334455667788 .EE .SS "فایل (FILE)" یک گذرواژه مبتنی بر فایل که با پیشوند \[lq]file:\[rq] مشخص می‌شود، باید مسیر فایلی حاوی گذرواژه برای خوانده شدن توسط ابزار باشد، یا \[lq]\-\[rq] برای استفاده از ورودی استاندارد (stdin)\&. ذخیره گذرواژه‌ها در فایل از نشت اطلاعات جلوگیری می‌کند؛ گذرواژه‌هایی که به عنوان گزینه خط فرمان ارسال می‌شوند ممکن است از فهرست پردازش‌ها یا تاریخچه پوسته خوانده شوند\&. .SS "مثال‌ها (EXAMPLES)" .IP .EX # برای استفاده از ورودی استاندارد با درخواست ورود file:\- # برای استفاده از فایل از یک مسیر file:path/to/password/file # برای ارسال گذرواژه از طریق ورودی استاندارد (stdin): echo foobar | tpm2_tool \-p file:\- # برای استفاده از bash here\-string از طریق stdin: tpm2_tool \-p file:\- <<< foobar .EE .SS "نشست‌ها (SESSIONS)" هنگام استفاده از یک نشست خط‌مشی (policy session) جهت مجازشماری استفاده از یک شیء، آرگومان گزینه را با کلمه کلیدی \f[I]session\f[R] پیشوندگذاری کنید\&. سپس مسیر فایل نشستی را که با tpm2_startauthsession(1) ایجاد شده مشخص نمایید\&. در صورت تمایل، اگر نشست نیازمند ارسال یک مقدار auth همراه با دستگیره نشست باشد (مانند گذرواژه خط‌مشی)، یک + و یک رشته را همان‌طور که در بخش \f[B]گذرواژه‌ها (PASSWORDS)\f[R] شرح داده شده اضافه کنید\&. .SS "مثال‌ها (EXAMPLES)" برای استفاده از یک فایل زمینه نشست به نام \f[I]session.ctx\f[R]: .IP .EX session:session.ctx .EE .PP برای استفاده از فایل زمینه نشست \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال مقدار مجازشماری mypassword: .IP .EX session:session.ctx+mypassword .EE .PP برای استفاده از فایل زمینه نشست \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال مقدار مجازشماری شانزده‌شانزدهی (\f[I]HEX\f[R]) معادل 0x11223344: .IP .EX session:session.ctx+hex:11223344 .EE .SS "مجازشماری‌های PCR (PCR AUTHORIZATIONS)" می‌توانید یک خط‌مشی PCR را با استفاده از پیشوند \[lq]pcr:\[rq] و ریززبان PCR برآورده کنید\&. ریززبان PCR به این صورت است: \f[CR]=\f[R] .PP مشخصات PCR در بخش \[lq]مشخص‌کننده‌های بانک PCR\[rq] مستند شده است\&. .PP شناسه \f[CR]raw\-pcr\-file\f[R] یک آرگومان \f[B]اختیاری\f[R] است که حاوی خروجی محتویات خام PCR است که توسط \f[I]tpm2_pcrread(1)\f[R] بازگردانده می‌شود\&. .PP مشخص‌کننده‌های بانک PCR .SS "مثال‌ها (EXAMPLES)" برای برآورده ساختن یک خط‌مشی PCR با sha256 روی بانک‌های 0، 1، 2 و 3 از این مشخص‌کننده استفاده کنید: .IP .EX pcr:sha256:0,1,2,3 .EE .PP مشخص کردن \f[I]AUTH\f[R]\&. .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک بوده و اطلاعات مورد انتظار کاربران را فراهم می‌کنند\&. .IP \[bu] 2 \f[B]\-h\f[R], \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنمای ابزار\&. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای ابزار فراخوانی کند، اما در صورت شکست، خلاصه کوتاهی از ابزار را نشان می‌دهد\&. این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد، با این حال اگر صراحتاً \[lq]man\[rq] درخواست شود، ابزار خطاهای دریافتی از man را در خروجی خطای استاندارد (stderr) گزارش می‌کند\&. اگر گزینه \[lq]no\-man\[rq] مشخص شود یا فراخوانی manpager شکست بخورد، گزینه‌های کوتاه در خروجی استاندارد چاپ خواهند شد\&. .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 برای احراز هویت\&. یک گذرواژه متن‌آشکار به TPM ارسال می‌شود تا انجام عملیات را مجاز کند\&. از این گزینه می‌توان برای جلوگیری از مشکلات ناشی از نشست‌های بدون سالت در حالت OpenSSL FIPS استفاده کرد\&. اگر مقادیر auth به کار گرفته شوند، باید از یک نشست با سالت برای احراز هویت استفاده شود\&. .IP \[bu] 2 \f[B]\-R\f[R], \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرای ایجادشده با این دستور\&. اگر یک شیء والد از یک فایل زمینه بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد\&. تخلیه خودکار همچنین زمانی فعال می‌شود که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد\&. .SH "پیکربندی TCTI (TCTI CONFIGURATION)" رابط TCTI یا \[lq]واسط انتقال (Transmission Interface)\[rq] سازوکار ارتباطی با 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] دقیقاً با متن \[lq]none\[rq] ارائه شود\&. .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 به عنوان پیش‌فرض انتخاب خواهد شد\&. جفت کلید\-مقدار \[lq]default\-tcti\[rq] نشان می‌دهد که کدام‌یک از 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 دستگاه، فایل دستگاه نویسه‌ای 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 "تنظیم disableClear جهت مسدود کردن دسترسی مجازشماری lockout به پاک‌سازی TPM" .IP .EX tpm2_clearcontrol \-C l s .EE .SS "پاک کردن disableClear جهت رفع انسداد مجازشماری lockout برای پاک‌سازی TPM" .IP .EX tpm2_clearcontrol \-C p c .EE .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 "اشکالات (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 مجوز بین‌المللی کریتیو کامنز ارجاع 4.0 (CC BY 4.0) .UE \c منتشر شده است\&.