.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_evictcontrol" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" \f[B]tpm2_evictcontrol\f[R](1) \- دائمی کردن یک شیء گذرا یا خارج کردن (تخلیه) یک شیء دائمی. .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_evictcontrol\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_evictcontrol\f[R](1) \- امکان پایدار (دائمی) کردن یک شیء گذرا یا خارج کردن (تخلیه) یک شیء پایدار از TPM را فراهم می‌کند. آرگومان \f[I]HANDLE\f[R] نمایه‌ای را که هندل به آن اختصاص می‌یابد، کنترل می‌کند. اگر شیء مشخص‌شده از طریق \f[B]\-c\f[R] گذرا باشد و یک \f[I]HANDLE\f[R] دائمی مشخص شده باشد، شیء در \f[I]HANDLE\f[R] پایدار خواهد شد. اگر \f[I]HANDLE\f[R] یک \- باشد، شیء در اولین موقعیت هندل دائمی موجود ذخیره و پایدار خواهد شد. اگر شیء مشخص‌شده از طریق \f[B]\-c\f[R] یک هندل دائمی باشد، شیء از موقعیت هندل دائمی خود خارج (تخلیه) خواهد شد. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-C\f[R], \f[B]\-\-hierarchy\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP سلسله‌مراتب مجازشماری که برای تأیید و مجاز کردن دستورات استفاده می‌شود. به طور پیش‌فرض بر روی سلسله‌مراتب \[lq]owner\[rq] تنظیم است. گزینه‌های پشتیبانی‌شده عبارتند از: .IP \[bu] 2 \f[B]o\f[R] برای \f[B]TPM_RH_OWNER\f[R] .IP \[bu] 2 \f[B]p\f[R] برای \f[B]TPM_RH_PLATFORM\f[R] .IP \[bu] 2 \f[B]\f[CB]\f[B]\f[R] که در آن می‌توان از یک عدد خام استفاده کرد. .RE .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-object\-context\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP مشخص‌کننده شیء زمینه (context object) برای یک شیء گذرا یا دائمی. اگر \f[I]OBJECT\f[R] یک شیء گذرا باشد، دائمی خواهد شد؛ خواه در هندل مشخص‌شده توسط آرگومان یا در اولین هندل دائمی خالی و در دسترس. اگر \f[I]OBJECT\f[R] مربوط به یک شیء دائمی باشد، شیء از حافظه غیرفرار (non\-volatile) خارج (تخلیه) خواهد شد. .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]. .RE .IP \[bu] 2 \f[B]\-o\f[R], \f[B]\-\-output\f[R]=\f[I]FILE\f[R]: .RS 2 .PP به‌صورت اختیاری یک شیء سریالی‌شده که نشان‌دهنده هندل دائمی است را در خروجی می‌نویسد. در صورت عدم دستکاری، این فایل‌ها برای استفاده امن‌تر از هندل‌های دائمی خام هستند. در مورد یک هندل دائمی خام، باید بررسی و تأیید شود که شیء اشاره‌شده همان شیء مورد انتظار است. .RE .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ذخیره هش پارامترهای دستور. این مقدار معمولاً با عنوان cpHash شناخته می‌شود. \f[B]نکته:\f[R] هنگام انتخاب این گزینه، ابزار عملاً دستور را اجرا نمی‌کند و صرفاً مقدار cpHash را برمی‌گرداند. .RE .IP \[bu] 2 \f[B]ARGUMENT\f[R] آرگومان خط فرمان، هندل دائمی را برای ذخیره شیء گذرا مشخص می‌کند. .SH "خروجی (OUTPUT)" این ابزار یک دیکشنری سازگار با YAML با فیلدهای زیر در خروجی تولید می‌کند: persistent\-handle: action: evicted|persisted .PP که در آن \f[I]persistent\-handle\f[R] هندلی است که عملیات روی آن انجام گرفته است. که در آن \f[I]action\f[R] می‌تواند یکی از دو مقدار \f[I]evicted\f[R] یا \f[I]persisted\f[R] باشد. اگر شیء \f[I]evicted\f[R] شود، شیء دیگر در آدرس \f[I]persistent\-handle\f[R] درون TPM مستقر نخواهد بود. اگر شیء \f[I]persisted\f[R] شود، شیء در آدرس \f[I]persistent\-handle\f[R] درون TPM مستقر خواهد بود. .SS "مراجع (REFERENCES)" .SH "قالب شیء زمینه (CONTEXT OBJECT FORMAT)" نوع شیء زمینه، خواه هندل باشد یا نام فایل، بر اساس منطق زیر \f[I]به‌ترتیب\f[R] تعیین می‌شود: .IP \[bu] 2 اگر آرگومان مسیر یک فایل باشد، آن فایل به عنوان یک شیء گذرای بازیابی‌شده 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)" مجوز برای استفاده از یک شیء در TPM 2.0 می‌تواند به ۳ شکل مختلف باشد: ۱. گذرواژه (Password) ۲. HMAC ۳. نشست‌ها (Sessions) .PP \f[B]نکته:\f[R] \[lq]مجوزها در صورت مشخص نشدن به طور پیش‌فرض بر روی \f[B]گذرواژه خالی\f[R] تنظیم می‌شوند\[rq]. .PP برای احراز اصالت با مقادیر auth، دستورات ابزار به طور ضمنی یک نشست HMAC ایجاد می‌کنند. بنابراین گذرواژه‌ها به صورت رمزگذاری‌نشده ارسال نمی‌شوند. این امر در مورد گذرواژه‌های تعریف‌شده برای اشیاء صدق نمی‌کند. در این حالت، باید از یک نشست HMAC استفاده شود (به \f[B]tpm2_startauthsession\f[R](1) مراجعه کنید). .SS "گذرواژه‌ها (PASSWORDS)" گذرواژه‌ها با استفاده از شناسه‌های پیشوندی به اشکال زیر تفسیر می‌شوند. .PP \f[B]نکته\f[R]: به طور پیش‌فرض فرض می‌شود گذرواژه‌های فاقد پیشوند در قالب رشته هستند. .SS "رشته (STRING)" یک گذرواژه رشته‌ای که با پیشوند \[lq]str:\[rq] یا عدم وجود آن (رشته خام بدون پیشوند) مشخص می‌شود، پردازش تفسیری نشده و مستقیماً برای احراز هویت استفاده می‌شود. .SS "مثال‌ها (EXAMPLES)" .IP .EX foobar str:foobar .EE .SS "رشته هگز (HEX\-STRING)" یک گذرواژه رشته هگز که با پیشوند \[lq]hex:\[rq] مشخص می‌شود، از حالت شانزده‌شانزدهی (هگز) به قالب یک آرایه بایتی تبدیل می‌شود؛ بنابراین استفاده از گذرواژه‌هایی با نویسه‌های غیرقابل‌چاپ یا ناسازگار با ترمینال را ممکن می‌سازد. .SS "مثال (EXAMPLE)" .IP .EX hex:1122334455667788 .EE .SS "فایل (FILE)" یک گذرواژه مبتنی بر فایل که با پیشوند \[lq]file:\[rq] مشخص می‌شود، باید مسیر فایلی حاوی گذرواژه برای خوانده شدن توسط ابزار باشد، یا \[lq]\-\[rq] برای استفاده از ورودی استاندارد (stdin). ذخیره گذرواژه‌ها در فایل از نشت اطلاعات جلوگیری می‌کند؛ زیرا گذرواژه‌هایی که به عنوان گزینه‌های دستور ارسال می‌شوند را می‌توان از طریق فهرست فرایندها یا تاریخچه پوسته خواند. .SS "مثال‌ها (EXAMPLES)" .IP .EX # برای استفاده از stdin و درخواست تعاملی file:\- # برای استفاده از یک فایل از یک مسیر file:path/to/password/file # برای ارسال گذرواژه از طریق stdin با استفاده از echo: 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] آغاز کنید. سپس مسیری به فایل نشستی که با \f[B]tpm2_startauthsession\f[R](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] ارسال مقدار auth با عنوان mypassword: .IP .EX session:session.ctx+mypassword .EE .PP برای استفاده از فایل زمینه نشست \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال مقدار auth هگزادسیمال با مقدار 0x11223344: .IP .EX session:session.ctx+hex:11223344 .EE .SS "مجوزهای PCR (PCR AUTHORIZATIONS)" می‌توان با استفاده از پیشوند \[lq]pcr:\[rq] و زبان کوچک PCR، یک خط‌مشی 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 روی بانک‌های ۰، ۱، ۲ و ۳ از این مشخص‌کننده استفاده کنید: .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]: نمایش صفحه راهنمای ابزار. به طور پیش‌فرض تلاش می‌کند تا صفحه‌خوان man را برای ابزار فراخوانی کند؛ با این حال، در صورت بروز خطا خلاصه کوتاهی از ابزار را نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد؛ اما اگر \[lq]man\[rq] به صراحت درخواست شده باشد، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا صفحه‌خوان man با شکست مواجه گردد، گزینه‌های کوتاه در 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 برای احراز اصالت. یک گذرواژه به صورت متن آشکار برای مجاز کردن عملیات به TPM ارسال می‌شود. از این گزینه می‌توان برای رفع مشکلاتی که هنگام استفاده از نشست‌های بدون سالت (unsalted) در حالت 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 دستگاه (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 از دو کلید پشتیبانی می‌کند: .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 "دائمی کردن یک هندل گذرا در نشانی 0x81010002 (To make a transient handle persistent at address 0x81010002)" .IP .EX tpm2_changeauth \-c o ownerauth tpm2_createprimary \-c primary.ctx \-P ownerauth tpm2_evictcontrol \-C o \-c primary.ctx 0x81010002 \-P ownerauth .EE .SS "بیرون راندن یک هندل دائمی (To evict a persistent handle)" .IP .EX tpm2_evictcontrol \-C o \-c 0x81010002 \-P ownerauth .EE .SS "دائمی کردن یک هندل گذرا و خروجی دادن یک هندل دائمی سریالی‌شده (To make a transient handle persistent and output a serialized persistent handle)" .IP .EX tpm2_evictcontrol \-C o \-c primary.ctx \-o primary.handle \-P ownerauth .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 \- طرح‌واره پشتیبانی‌نشده (Non supported scheme). قابل اعمال بر 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 فهرست پستی .UE \c مراجعه کنید. .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0/ مجوز بین‌المللی کریتیو کامنز ارجاع ۴.۰ (CC BY 4.0) .UE \c منتشر شده است. \&.