'\" t
.\"     Title: boltctl
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/10/2026
.\"    Manual: bolt Manual
.\"    Source: bolt 0.9.11
.\"  Language: Persian
.\"
.TH "BOLTCTL" "1" "08/10/2026" "bolt 0\&.9\&.11" "bolt Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
boltctl \- ابزار کنترل و مدیریت دستگاههای تاندربولت (Thunderbolt)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBboltctl\fR \fIauthorize\fR \fIDEVICE\fR
\fBboltctl\fR \fIconfig\fR
\fBboltctl\fR \fIdomains\fR
\fBboltctl\fR \fIenroll\fR \fIDEVICE\fR
\fBboltctl\fR \fIforget\fR \fIDEVICE\fR
\fBboltctl\fR \fIinfo\fR \fIDEVICE\fR
\fBboltctl\fR \fIlist\fR
\fBboltctl\fR \fImonitor\fR
\fBboltctl\fR \fIpower\fR
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fIboltctl\fR
رابط خط فرمان برای تعامل با
\fIboltd\fR
است؛ دیمن سیستمی که دستگاه‌های Thunderbolt 3(TM) را مدیریت می‌کند\&. از این ابزار می‌توان برای پرس‌وجوی وضعیت دستگاه‌ها و همچنین مدیریت آن‌ها استفاده کرد\&.
.sp
دستگاه‌ها را می‌توان در سراسر سیستم با شناسه یکتای آن‌ها (uuid) شناسایی کرد\&. تمام دستوراتی که شناسه
\fIDEVICE\fR
را می‌پذیرند، انتظار این شناسه یکتا را دارند\&.
.sp
اگر هیچ دستوری مشخص نشود، معادل اجرای
\fIboltctl list\fR
خواهد بود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخه و خروج\&.
.RE
.PP
\fB\-U | \-\-uuid {\fR\fB\fIfull\fR\fR\fB | \fR\fB\fIshort\fR\fR\fB | \fR\fB\fIalias\fR\fR\fB | N}\fR
.RS 4
کنترل نحوه چاپ UUIDها\&. از آنجا که این شناسه‌ها داده‌های تا حدی حساس هستند، به اشتراک گذاشتن عمومی آن‌ها با طول کامل توصیه نمی‌شود\&. در عوض، هنگام اشتراک‌گذاری خروجی
\fIboltctl\fR
می‌توان و باید از
\fIshort\fR
یا
\fIalias\fR
استفاده کرد\&.
.PP
\fIfull\fR
.RS 4
چاپ تمام UUIDها با طول کامل\&.
.RE
.PP
\fIshort\fR
.RS 4
کوتاه‌سازی تمام UUIDها به طوری که فقط ۱۳ کاراکتر اول چاپ شوند\&.
.RE
.PP
\fIalias\fR
.RS 4
جایگزینی تمام UUIDها با یک رشته تصادفی که از UUID مشتق شده است؛ بنابراین دستگاه‌ها می‌توانند بدون آشکار شدن UUID اصلی به طور یکتا شناسایی شوند\&.
.RE
.PP
N
.RS 4
اگر یک عدد صحیح
\fIN\fR
مشخص شود، تمام UUIDها کوتاه می‌شوند تا فقط حداکثر تا
\fIN\fR
کاراکتر نمایش داده شوند\&.
.RE
.RE
.SH "دستورات (COMMANDS)"
.SS "authorize [\-F | \-\-first\-time] \fIDEVICE\fR"
.sp
تایید و مجاز کردن یک دستگاه غیرمجاز فعلی که با شناسه یکتای (uuid) آن با
\fIDEVICE\fR
مشخص شده است\&. در صورتی که سطح امنیتی دامنه از اتصال امن دستگاه پشتیبانی کند، اگر کلیدی در پایگاه‌داده ذخیره شده باشد، استفاده خواهد شد\&. برای یافتن uuid یک دستگاه از
\fIboltctl list\fR
استفاده کنید\&.
.PP
\fB\-F | \-\-first\-time\fR
.RS 4
به طور معمول، هنگام تلاش برای مجاز کردن دستگاهی که از قبل مجاز شده است،
\fBboltctl\fR
هیچ کاری انجام نمی‌دهد و یک کد وضعیت موفقیت‌آمیز برمی‌گرداند\&. در صورت استفاده از این گزینه، اگر دستگاه از قبل مجاز باشد، این تلاش با شکست مواجه شده و منجر به یک کد خروج منفی (خطا) می‌شود\&.
.RE
.SS "config \-\-describe [global|domain|device]"
.sp
فهرست کردن ویژگی‌های سراسری (global)، دامنه (domain)، یا همه موارد (اگر چیزی مشخص نشود)\&. قالب در ۳ ستون است: دسترسی، نام، توضیحات\&. دسترسی نشان می‌دهد که ویژگی فقط خواندنی است یا امکان نوشتن نیز دارد\&.
.SS "config \fIKEY\fR [\fIVALUE\fR]"
.sp
دریافت، یا تنظیم یک ویژگی سراسری (global) در صورت مشخص شدن
\fIVALUE\fR\&.
.SS "config \fI<domain|device>\&.KEY\fR \fITARGET\fR [\fIVALUE\fR]"
.sp
دریافت، یا تنظیم یک ویژگی دامنه یا دستگاه در صورت مشخص شدن
\fIVALUE\fR
، که در آن
\fITARGET\fR
شناسه یکتای دامنه یا دستگاه است\&.
.SS "domains [\-v | \-\-verbose]"
.sp
فهرست کردن تمام دامنه‌های فعال تاندربولت (Thunderbolt)\&. یک دامنه تاندربولت سخت‌افزار کنترل‌کننده تاندربولت را نشان می‌دهد\&. برای هر کنترل‌کننده تاندربولت موجود در سیستم، یک دامنه (و دستگاه میزبان) وجود خواهد داشت\&. ویژگی
\fIsecurity\fR
سطح امنیتی کنترل‌کننده را نشان می‌دهد\&. اگر پشتیبانی از
\fIiommu\fR
فعال باشد (صفحه راهنمای
\fBboltd\fR
را ببینید) با یک پسوند
\fI+iommu\fR
برای حالت‌های "secure" یا "user" مشخص می‌شود، یا در حالتی که سطح امنیت "none" (sl0) باشد، صرفاً به صورت
\fIiommu\fR
نشان داده می‌شود\&.
\fIbootacl\fR
اسلات‌های استفاده‌شده و کل اسلات‌های لیست کنترل دسترسی بوت (BootACL) و محتوای تمام ورودی‌های غیرخالی را نشان می‌دهد\&. نکته: اگر BootACL پشتیبانی نشود، برای هر دو مقدار ۰ را نشان می‌دهد (0/0)\&. ویژگی
\fIonline\fR
نشان می‌دهد که آیا کنترل‌کننده تاندربولت در حال حاضر توسط فریم‌ور تغذیه می‌شود یا خیر\&.
\fBنکته\fR:
اگر کنترل‌کننده در حال حاضر آفلاین باشد، لیست BootACL تخمینی را منعکس می‌کند که
\fIboltd\fR
از ظاهر لیست پس از بازگشت کنترل‌کننده به حالت آنلاین و همگام‌سازی تغییرات محلی در کنترل‌کننده دارد\&. اگر لیست در این میان تغییر کرده باشد، مثلاً از یک نصب یا سیستم‌عامل دیگر، ممکن است دقیق نباشد\&.
.SS "enroll [\-\-policy \fIpolicy\fR] \fIDEVICE\fR"
.sp
تایید و ثبت دستگاه با شناسه یکتای
\fIDEVICE\fR
در پایگاه‌داده\&. اگر دامنه از اتصال امن پشتیبانی کند، کلید جدیدی تولید شده و همراه با نام دستگاه و نام تولیدکننده در پایگاه‌داده ذخیره می‌شود\&. این کلید، در صورت ایجاد، در آینده برای مجاز کردن ایمن دستگاه استفاده خواهد شد\&.
.PP
\fB\-\-policy {\fR\fB\fIdefault\fR\fR\fB | \fR\fB\fIauto\fR\fR\fB | \fR\fB\fImanual\fR\fR\fB}\fR
.RS 4
مشخص کردن خط‌مشی مورد استفاده برای دستگاه تازه ثبت‌شده\&.
.PP
\fIdefault\fR
.RS 4
استفاده از خط‌مشی پیش‌فرض سراسری دیمن؛ این مورد قابل تغییر است، اما معمولاً روی
\fIauto\fR
تنظیم شده است\&.
.RE
.PP
\fIauto\fR
.RS 4
مجاز کردن خودکار این دستگاه هر زمان که متصل شود\&.
.RE
.PP
\fImanual\fR
.RS 4
عدم تایید خودکار دستگاه؛ در عوض نیاز به تایید دستی از طریق
\fBboltctl authorize\fR
خواهد داشت\&.
.RE
.RE
.SS "forget \fIDEVICE\fR"
.sp
حذف اطلاعات مربوط به دستگاه با شناسه یکتای
\fIDEVICE\fR
از پایگاه‌داده\&. این شامل کلید نیز می‌شود (در صورتی که قبلاً تولید شده باشد)\&. اگر به جای
\fIDEVICE\fR
گزینه
\fI\-\-all\fR
را ارسال کنید، به جای یک دستگاه، تمام دستگاه‌ها حذف می‌شوند\&.
.SS "info \fIDEVICE\fR"
.sp
نمایش اطلاعات درباره دستگاه با شناسه یکتای
\fIDEVICE\fR\&.
.SS "list [\-a | \-\-all]"
.sp
فهرست کردن و چاپ اطلاعات درباره تمام دستگاه‌های متصل و ذخیره‌شده\&.
.PP
\fB\-a | \-\-all\fR
.RS 4
به طور معمول، تنها نوع دستگاهی که نمایش داده می‌شود دستگاه‌های جانبی (peripherals) هستند؛ بنابراین دستگاهی که خود میزبان را نشان می‌دهد حذف می‌شود\&. استفاده از این گزینه باعث می‌شود تمام انواع دستگاه‌ها در فهرست گنجانده شوند\&.
.RE
.SS "monitor"
.sp
شنود و نمایش تغییرات در دستگاه‌های متصل\&.
.SS "power [\-t | \-\-timeout \fIseconds\fR] [\-q | \-\-query]"
.sp
روشن کردن کنترل‌کننده تاندربولت\&. اگر کنترل‌کننده تاندربولت در «حالت شمارش بومی» (native enumeration mode) نباشد، می‌تواند توسط فریم‌ور/بایوس میزبان به طور کامل خاموش شود\&. در سیستم‌های پشتیبانی‌شده، یک رابط برای روشن کردن «اجباری» کنترل‌کننده تاندربولت وجود دارد\&. در صورت پشتیبانی، این دستور از دیمن درخواست انجام این کار را می‌کند\&. دیمن تمام درخواست‌های کلاینت را ردیابی کرده و هنگامی که آخرین درخواست لغو شود، وضعیت روشن‌بودن اجباری را لغو می‌کند\&.
.PP
\fB\-t | \-\-timeout \fR\fB\fIseconds\fR\fR
.RS 4
لغو درخواست روشن‌بودن اجباری پس از مدت زمان مشخص‌شده به
\fIseconds\fR
(ثانیه) و خروج\&.
.RE
.PP
\fB\-q | \-\-query\fR
.RS 4
استعلام وضعیت فعلی روشن‌بودن اجباری دیمن\&.
.RE
.SH "نویسندگان (AUTHORS)"
.sp
نوشته‌شده توسط Christian Kellner <ckellner@redhat\&.com>\&.