.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "swtpm_bios 8"
.TH swtpm_bios 8 2026-03-26 swtpm ""
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
swtpm_bios \- ابزار شبیه‌سازی بایوس (BIOS) برای swtpm
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBswtpm_bios [OPTIONS]\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBswtpm_bios\fR ابزاری است که می‌تواند دستوراتی را به TPM (برنامه \fIswtpm\fR) ارسال کند که معمولاً توسط BIOS برای مقداردهی اولیه TPM استفاده می‌شوند.
کاربر می‌تواند از میان چندین گزینه خط فرمان انتخاب کند تا حالتی را که TPM باید روی آن تنظیم شود، تعیین نماید.
.PP
این دستور برای ارتباط از طریق TCP نیازمند تنظیم متغیر محیطی \fITCSD_USE_TCP_DEVICE\fR است.
در غیر این صورت از دستگاه تنظیم‌شده در متغیر محیطی \fITPM_DEVICE\fR استفاده خواهد کرد یا به عنوان گزینه جایگزین از
\&\fI/dev/tpm0\fR برای ارسال دستورات استفاده می‌کند. در حالت TCP، متغیر محیطی
\&\fITCSD_TCP_DEVICE_HOSTNAME\fR برای مشخص کردن میزبانی که دستورات باید به آن ارسال شوند استفاده می‌شود. به طور پیش‌فرض \fIlocalhost\fR فرض می‌شود. درگاه TCP پیش‌فرض 6545 است مگر اینکه متغیر محیطی \fITCSD_TCP_DEVICE_PORT\fR درگاه دیگری را مشخص کند.
.PP
در صورت موفقیت مقدار 0 برگردانده می‌شود. در صورتی که خطای TPM رخ دهد، کد خروجی 128 خواهد بود. در صورت خرابی ارتباط مقدار 255 بازگردانده می‌شود. در صورتی که برای فعال شدن TPM نیاز به راه‌اندازی مجدد (reset) باشد، مقدار 129 برگردانده خواهد شد.
.PP
این دستور دنباله زیر از دستورات را به TPM ارسال می‌کند:
.IP "\fBTPM_Startup(chosen mode)\fR \-\- startup TPM" 4
.IX Item "TPM_Startup(chosen mode) -- startup TPM"
.PD 0
.IP "\fBTSC_PhysicalPresence(0x20)\fR \-\- PhysicalPresenceCMDEnable" 4
.IX Item "TSC_PhysicalPresence(0x20) -- PhysicalPresenceCMDEnable"
.IP "\fBTSC_PhysicalPresence(0x08)\fR \-\- turn on physical presence" 4
.IX Item "TSC_PhysicalPresence(0x08) -- turn on physical presence"
.IP "\fBTPM_GetCapability\fR \-\- get permanent flags" 4
.IX Item "TPM_GetCapability -- get permanent flags"
.IP "\fBTPM_PhysicalEnable\fR \-\- enable the TPM" 4
.IX Item "TPM_PhysicalEnable -- enable the TPM"
.IP "\fBTPM_PhysicalSetDeactivated(0x0)\fR \-\- activate TPM" 4
.IX Item "TPM_PhysicalSetDeactivated(0x0) -- activate TPM"
.IP "\fBTPM_ContinueSelfTest\fR \-\- continue self test" 4
.IX Item "TPM_ContinueSelfTest -- continue self test"
.IP "\fBTSC_PhysicalPresence(0x20)\fR \-\- PhysicalPresenceCMDEnable" 4
.IX Item "TSC_PhysicalPresence(0x20) -- PhysicalPresenceCMDEnable"
.IP "\fBTSC_PhysicalPresence(0x14)\fR \-\- turn off physical presence & lock it" 4
.IX Item "TSC_PhysicalPresence(0x14) -- turn off physical presence & lock it"
.PD
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.IP "\fB\-\-tpm\-device <device>\fR" 4
.IX Item "--tpm-device <device>"
استفاده از دستگاه داده‌شده به جای پیش‌فرض /dev/tpm0. این گزینه متغیر محیطی TPM_DEVICE را لغو می‌کند.
.IP "\fB\-\-tcp <server>:<port>\fR" 4
.IX Item "--tcp <server>:<port>"
اتصال به سرور و درگاه داده‌شده؛ اگر سروری مشخص نشود، از 127.0.0.1 استفاده می‌شود؛ اگر درگاه مشخص نشود، از درگاه پیش‌فرض 6545 استفاده می‌شود.
.IP "\fB\-\-unix <path>\fR" 4
.IX Item "--unix <path>"
اتصال به مسیر UnixIO داده‌شده.
.IP \fB\-tpm2\fR 4
.IX Item "-tpm2"
دستگاه یک TPM 2 است.
.IP \fB\-c\fR 4
.IX Item "-c"
ارسال دستور TPM_Startup(ST_CLEAR) (پیش‌فرض). این به TPM دستور می‌دهد با حالت پاک (clear) شروع به کار کند.
.IP \fB\-s\fR 4
.IX Item "-s"
ارسال دستور TPM_Startup(ST_STATE). این به TPM دستور می‌دهد با بازیابی وضعیت ذخیره‌شده قبلی شروع به کار کند.
.IP \fB\-d\fR 4
.IX Item "-d"
ارسال دستور TPM_Startup(ST_DEACTIVATED). این به TPM دستور می‌دهد در حالت غیرفعال شروع به کار کند. این گزینه روی TPM 2 بی‌تأثیر است.
.IP \fB\-n\fR 4
.IX Item "-n"
دستور TPM_Startup ارسال نشود.
.IP \fB\-o\fR 4
.IX Item "-o"
فقط دستور راه‌اندازی ارسال شود و چیز دیگری فرستاده نشود.
.IP \fB\-ea\fR 4
.IX Item "-ea"
اطمینان از فعال بودن TPM؛ اگر TPM نیاز به راه‌اندازی مجدد داشته باشد، برنامه خارج شده و کد خروجی 129 را بازمی‌گرداند.
.IP \fB\-cs\fR 4
.IX Item "-cs"
ارسال یک دستور TPM_ContinueSelfTest به TPM 1.2 و یک دستور TPM2_IncrementalSelfTest به TPM 2.
.IP \fB\-u\fR 4
.IX Item "-u"
صرف‌نظر کردن از حضور فیزیکی (physical presence) در TPM 1.2. در مورد TPM 2 سلسله‌مراتب پلتفرم را روی یک گذرواژه تصادفی تنظیم می‌کند.
.IP \fB\-v\fR 4
.IX Item "-v"
نمایش نسخه و خروج.
.IP \fB\-h\fR 4
.IX Item "-h"
نمایش صفحه راهنما و خروج.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
.SH "گزارش خطاها (REPORTING BUGS)"
.IX Header "REPORTING BUGS"
گزارش باگ‌ها به Stefan Berger <stefanb@linux.vnet.ibm.com>