.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_startauthsession" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" \f[B]tpm2_startauthsession\f[R] \- آغاز یک نشست با TPM. .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_startauthsession\f[R] [\f[I]OPTIONS\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_startauthsession\f[R](1) \- یک نشست را با TPM آغاز می‌کند. حالت پیش‌فرض آغاز یک نشست آزمایشی (\f[I]trial\f[R]) است، مگر اینکه گزینهٔ \f[B]\-a\f[R] مشخص شده باشد. داده‌های نشست پالیسی را در یک فایل ذخیره می‌کند. این فایل سپس می‌تواند در ابزارهای بعدی که از فایل پالیسی برای احراز اصالت یا رویدادهای پالیسی بهره می‌برند، استفاده شود. .PP این قابلیت با مدیران منابع (RMها) به جز \c .UR https://github.com/tpm2-software/tpm2-abrmd tpm2\-abrmd .UE \c کار نخواهد کرد، چرا که بیشتر RMها هنگام قطع ارتباط کلاینت از کانال IPC، دستگیره‌های نشست (session handles) را پاکسازی (flush) می‌کنند. با این حال، هنگام استفاده از یک RM بدون ویژگی session gapping، می‌توان از TCTI دستوری (command TCTI) برای باز نگه داشتن اتصال استفاده کرد. .PP نخستین گام، ایجاد یک شنوندهٔ سوکت (socket listener) است که از tpm2_send استفاده می‌کند: .IP .EX mknod \[dq]$HOME/backpipe\[dq] p \f[B]while\f[R] [ 1 ]\f[B];\f[R] \f[B]do\f[R] tpm2_send 0<\[dq]$HOME/backpipe\[dq] \f[B]|\f[R] nc \-lU \[dq]$HOME/sock\[dq] 1>\[dq]$HOME/backpipe\[dq]\f[B];\f[R] \f[B]done\f[R]\f[B];\f[R] .EE .PP گام بعدی، استفاده از TCTI دستوری و netcat (nc) برای ارسال داده به سوکت است. .IP .EX tpm2_startauthsession \-\-tcti=\[dq]cmd:nc \-q 0 \-U $HOME/sock\[dq] .EE .PP پس از پایان، حتماً شنونده را متوقف کنید (kill کنید). برای دستورهایی که با TCTI دستوری در برابر شنونده اجرا می‌شوند، نیاز به مدیریت دستگیره‌های گذرا (transient handles) خواهید داشت. ساده‌ترین راه، افزودن یک دستور پاکسازی (flush) پس از هر دستور است: \f[CR]tpm2_flushcontext \-\-tcti=\[dq]cmd:nc \-q 0 \-U $HOME/sock\[dq] \-t\f[R] .PP نکته: این مثال از سوکت‌های UNIX استفاده می‌کند، زیرا سوکت با کنترل‌های دسترسی لینوکس مهار می‌شود. استفاده از پورت شبکه پیشنهاد نمی‌شود، چرا که یا به روی تمام کاربران سیستم باز است (localhost) یا به یک کارت شبکه مقید شده و در معرض شبکه قرار می‌گیرد. .PP این روش با دسترسی مستقیم به TPM کار خواهد کرد، اما توجه داشته باشید که این دستور در درون خود یک \f[I]ContextSave\f[R] و یک \f[I]ContextLoad\f[R] را روی دستگیرهٔ نشست فراخوانی می‌کند، بنابراین این نشست \f[B]نمی‌تواند\f[R] دوباره ذخیره یا بارگذاری شود. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-\-policy\-session\f[R]: .RS 2 .PP یک نشست پالیسی از نوع \f[B]TPM_SE_POLICY\f[R] آغاز می‌کند. پیش‌فرض بدون این گزینه \f[B]TPM_SE_TRIAL\f[R] است. .PP \f[B]نکته\f[R]: نشست آزمایشی (\f[I]trial\f[R]) هنگام ایجاد پالیسی و نشست پالیسی (\f[I]policy\f[R]) هنگام احراز اصالت با یک پالیسی استفاده می‌شود. .RE .IP \[bu] 2 \f[B]\-\-audit\-session\f[R]: .RS 2 .PP یک نشست HMAC را آغاز می‌کند تا به عنوان نشست بازرسی (audit session) استفاده شود. پیش‌فرض بدون این گزینه \f[B]TPM2_SE_TRIAL\f[R] است. .RE .IP \[bu] 2 \f[B]\-\-hmac\-session\f[R]: .RS 2 .PP یک نشست HMAC از نوع \f[B]TPM_SE_HMAC\f[R] آغاز می‌کند. پیش‌فرض بدون این گزینه \f[B]TPM2_SE_TRIAL\f[R] است. .RE .IP \[bu] 2 \f[B]\-g\f[R], \f[B]\-\-hash\-algorithm\f[R]=\f[I]ALGORITHM\f[R]: .RS 2 .PP الگوریتم درهم‌سازی (هش) استفاده‌شده در محاسبهٔ خلاصه‌سازی پالیسی (policy digest). .RE .IP \[bu] 2 \f[B]\-G\f[R], \f[B]\-\-key\-algorithm\f[R]=\f[I]ALGORITHM\f[R]: .RS 2 .PP الگوریتم متقارن استفاده‌شده در رمزنگاری/رمزگشایی پارامتر. .RE .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-key\-context\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP اشیاء tpmkey و bind را یکسان تنظیم می‌کند. رمزنگاری پارامتر نشست فعال می‌شود. رمزگشایی پارامتر نشست فعال می‌شود. کلید متقارن رمزنگاری/رمزگشایی پارامتر روی AES\-CFB تنظیم می‌شود. .RE .IP \[bu] 2 \f[B]\-S\f[R], \f[B]\-\-session\f[R]=\f[I]FILE\f[R]: .RS 2 .PP نام فایل نشست پالیسی؛ الزامی است. .RE .IP \[bu] 2 \f[B]\-\-bind\-context\f[R]=\f[I]FILE\f[R]: .RS 2 .PP شیء bind را تنظیم می‌کند. رمزنگاری پارامتر نشست غیرفعال است. از \f[B]tpm2_sessionconfig\f[R] برای فعال کردن استفاده کنید. رمزگشایی پارامتر نشست غیرفعال است. از \f[B]tpm2_sessionconfig\f[R] برای فعال کردن استفاده کنید. کلید متقارن رمزنگاری/رمزگشایی پارامتر روی AES\-CFB تنظیم می‌شود. .RE .IP \[bu] 2 \f[B]\-\-bind\-auth\f[R]=\f[I]AUTH\f[R]: .RS 2 .PP مقدار مجوز (authorization value) را برای شیء bind تنظیم می‌کند. .RE .IP \[bu] 2 \f[B]\-\-tpmkey\-context\f[R]=\f[I]FILE\f[R]: .RS 2 .PP شیء tpmkey را تنظیم می‌کند. رمزنگاری پارامتر نشست غیرفعال است. از \f[B]tpm2_sessionconfig\f[R] برای فعال کردن استفاده کنید. رمزگشایی پارامتر نشست غیرفعال است. از \f[B]tpm2_sessionconfig\f[R] برای فعال کردن استفاده کنید. کلید متقارن رمزنگاری/رمزگشایی پارامتر روی AES\-CFB تنظیم می‌شود. .RE .IP \[bu] 2 \f[B]\-n\f[R], \f[B]\-\-name\f[R]=\f[I]FILE\f[R] .RS 2 .PP یک فایل name به عنوان خروجی از ابزاری مانند گزینهٔ \f[CR]\-n\f[R] در دستور tpm2_readpublic(1). فایل name می‌تواند برای \f[B]اعتبارسنجی\f[R] یک دستگیرهٔ ماندگار (persistent handle) ورودی برای گزینه‌های \f[CR]\-\-tpmkey\-context\f[R]، \f[CR]\-c\f[R] و \f[CR]\-\-key\-context\f[R] استفاده شود. اعتبارسنجی اینکه شیء ارجاع‌شده توسط یک دستگیرهٔ ماندگار، مثلاً 0x81000000، همان کلید مورد انتظار است، از انجام حملات مرد میانی (man\-in\-the\-middle) توسط مهاجمان بر روی ترافیک نشست جلوگیری می‌کند. .RE.SS مراجع (References) .SH "قالب شیء زمینه (Context Object Format)" نوع یک شیء زمینه، چه یک دستگیره (handle) باشد یا نام فایل، طبق منطق زیر و \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 می‌تواند به ۳ شکل مختلف باشد: 1. گذرواژه (Password) 2. HMAC 3. نشست‌ها (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)" یک گذرواژهٔ رشتهٔ هگز، که با پیشوند \[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 # برای ارسال گذرواژه با دستور echo از طریق 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 value) به همراه دستگیرهٔ نشست باشد (مانند گذرواژهٔ خط‌مشی)، یک علامت + و سپس یک رشته را طبق توضیحات بخش \f[B]گذرواژه‌ها (Passwords)\f[R] به انتهای آن اضافه نمایید. .SS "مثال‌ها (Examples)" برای استفاده از یک فایل بافتار نشست (session context) به نام \f[I]session.ctx\f[R]: .IP .EX session:session.ctx .EE .PP برای استفاده از یک فایل بافتار نشست به نام \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال authvalue با مقدار mypassword: .IP .EX session:session.ctx+mypassword .EE .PP برای استفاده از یک فایل بافتار نشست به نام \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال authvalue هگزادسیمال (\f[I]HEX\f[R]) با مقدار 0x11223344: .IP .EX session:session.ctx+hex:11223344 .EE .SS "اعتبارسنجی‌های PCR (PCR Authorizations)" می‌توانید یک خط‌مشی PCR را با استفاده از پیشوند \[lq]pcr:\[rq] و ریززبان (minilanguage) PCR برآورده سازید. ریززبان PCR به شرح زیر است: \f[CR]=\f[R] .PP مشخصات PCR در بخش \[lq]تعیین‌کننده‌های بانک PCR (PCR bank specifiers)\[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]: نمایش صفحهٔ راهنمای (manpage) ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای این ابزار فراخوانی کند؛ با این حال در صورت شکست، خلاصه‌ای کوتاه از ابزار را در خروجی نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینهٔ \[lq]man\[rq] تعیین شده باشد، اما اگر به‌طور صریح \[lq]man\[rq] درخواست شود، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینهٔ \[lq]no\-man\[rq] مشخص شود، یا 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). در صورتی مفید است که نیاز باشد یک اصلاح errata روی دستورهای ارسالی به 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 session) برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی پاکسازی خودکار (autoflush) برای اشیاء گذرا (transient) که توسط دستور ایجاد شده‌اند. اگر یک شیء والد از یک فایل بافتار بارگذاری شود، شیء والد گذرا نیز پاکسازی (flush) خواهد شد. پاکسازی خودکار همچنین با تنظیم متغیر محیطی 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 جهت استفاده توسط آن قابل تعیین است. مقدار پیش‌فرض \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 تعیین نام tabrmd tcti و رشته پیکربندیِ \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 مترادف هستند. ماژول‌های گوناگون شناخته‌شده TCTI. .RE.SH "مثال‌ها (EXAMPLES)" .SS رمزنگاری پارامتر در صورتی که از نشست hmac برای دستورها استفاده نشود، پارامترهای دستور و پاسخ‌ها رمزنگاری نمی‌شوند. نشستی که در آن پارامتر (در این مورد، گذرواژه) رمزنگاری می‌شود، می‌تواند به صورت زیر ایجاد شود: .IP .EX tpm2_createprimary \-c prim.ctx tpm2_startauthsession \-S enc_session.ctx \-\-hmac\-session \-\-key\-context prim.ctx tpm2_create \-C prim.ctx \-c key.ctx \-S enc_session.ctx \-p password .EE .PP حتی بدون استفاده از کلید برای نشست، می‌توان از یک نشست برای رمزنگاری پارامتر استفاده کرد: .IP .EX tpm2_startauthsession \-S enc_session.ctx \-\-hmac\-session tpm2_sessionconfig enc_session.ctx \-\-enable\-decrypt tpm2_create \-C prim.ctx \-c key.ctx \-S enc_session.ctx \-p password .EE .PP اگر نیاز باشد پاسخ رمزنگاری شود، می‌توان از پارامتر \[en]enable\-encrypt استفاده کرد: .IP .EX tpm2_startauthsession \-S enc_session.ctx \-\-hmac\-session tpm2_sessionconfig enc_session.ctx \-\-enable\-encrypt tpm2_getrandom \-S enc_session.ctx \-o rand .EE .SS شروع یک نشست \f[I]trial\f[R] و ذخیره داده‌های نشست در یک فایل .IP .EX tpm2_startauthsession \-S mysession.ctx .EE .SS شروع یک نشست \f[I]policy\f[R] و ذخیره داده‌های نشست در یک فایل .IP .EX tpm2_startauthsession \-\-policy\-session \-S mysession.ctx .EE .SS شروع یک نشست \f[I]policy\f[R] مقید و رمزنگاری‌شده و ذخیره داده‌های نشست در یک فایل .IP .EX tpm2_createprimary \-c primary.ctx tpm2_startauthsession \-\-policy\-session \-c primary.ctx \-S mysession.ctx .EE .SH "وضعیت خروج (EXIT STATUS)" ابزارها می‌توانند هر یک از کدهای زیر را بازگردانند: .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 فهرست پستی .UE \c .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی کریتیو کامنز انتساب ۴٫۰ (CC BY 4.0) .UE \c \& منتشر شده است.