BOLTCTL(1) bolt Manual BOLTCTL(1)

boltctl - ابزار کنترل و مدیریت دستگاههای تاندربولت (Thunderbolt)

boltctl authorize DEVICE
boltctl config
boltctl domains
boltctl enroll DEVICE
boltctl forget DEVICE
boltctl info DEVICE
boltctl list
boltctl monitor
boltctl power

دستور boltctl رابط خط فرمان برای تعامل با boltd است؛ دیمن سیستمی که دستگاه‌های Thunderbolt 3(TM) را مدیریت می‌کند. از این ابزار می‌توان برای پرس‌وجوی وضعیت دستگاه‌ها و همچنین مدیریت آن‌ها استفاده کرد.

دستگاه‌ها را می‌توان در سراسر سیستم با شناسه یکتای آن‌ها (uuid) شناسایی کرد. تمام دستوراتی که شناسه DEVICE را می‌پذیرند، انتظار این شناسه یکتا را دارند.

اگر هیچ دستوری مشخص نشود، معادل اجرای boltctl list خواهد بود.

--version

نمایش اطلاعات نسخه و خروج.

-U | --uuid {full | short | alias | N}

کنترل نحوه چاپ UUIDها. از آنجا که این شناسه‌ها داده‌های تا حدی حساس هستند، به اشتراک گذاشتن عمومی آن‌ها با طول کامل توصیه نمی‌شود. در عوض، هنگام اشتراک‌گذاری خروجی boltctl می‌توان و باید از short یا alias استفاده کرد.

full

چاپ تمام UUIDها با طول کامل.

short

کوتاه‌سازی تمام UUIDها به طوری که فقط ۱۳ کاراکتر اول چاپ شوند.

alias

جایگزینی تمام UUIDها با یک رشته تصادفی که از UUID مشتق شده است؛ بنابراین دستگاه‌ها می‌توانند بدون آشکار شدن UUID اصلی به طور یکتا شناسایی شوند.

N

اگر یک عدد صحیح N مشخص شود، تمام UUIDها کوتاه می‌شوند تا فقط حداکثر تا N کاراکتر نمایش داده شوند.

تایید و مجاز کردن یک دستگاه غیرمجاز فعلی که با شناسه یکتای (uuid) آن با DEVICE مشخص شده است. در صورتی که سطح امنیتی دامنه از اتصال امن دستگاه پشتیبانی کند، اگر کلیدی در پایگاه‌داده ذخیره شده باشد، استفاده خواهد شد. برای یافتن uuid یک دستگاه از boltctl list استفاده کنید.

-F | --first-time

به طور معمول، هنگام تلاش برای مجاز کردن دستگاهی که از قبل مجاز شده است، boltctl هیچ کاری انجام نمی‌دهد و یک کد وضعیت موفقیت‌آمیز برمی‌گرداند. در صورت استفاده از این گزینه، اگر دستگاه از قبل مجاز باشد، این تلاش با شکست مواجه شده و منجر به یک کد خروج منفی (خطا) می‌شود.

فهرست کردن ویژگی‌های سراسری (global)، دامنه (domain)، یا همه موارد (اگر چیزی مشخص نشود). قالب در ۳ ستون است: دسترسی، نام، توضیحات. دسترسی نشان می‌دهد که ویژگی فقط خواندنی است یا امکان نوشتن نیز دارد.

دریافت، یا تنظیم یک ویژگی سراسری (global) در صورت مشخص شدن VALUE.

دریافت، یا تنظیم یک ویژگی دامنه یا دستگاه در صورت مشخص شدن VALUE ، که در آن TARGET شناسه یکتای دامنه یا دستگاه است.

فهرست کردن تمام دامنه‌های فعال تاندربولت (Thunderbolt). یک دامنه تاندربولت سخت‌افزار کنترل‌کننده تاندربولت را نشان می‌دهد. برای هر کنترل‌کننده تاندربولت موجود در سیستم، یک دامنه (و دستگاه میزبان) وجود خواهد داشت. ویژگی security سطح امنیتی کنترل‌کننده را نشان می‌دهد. اگر پشتیبانی از iommu فعال باشد (صفحه راهنمای boltd را ببینید) با یک پسوند +iommu برای حالت‌های "secure" یا "user" مشخص می‌شود، یا در حالتی که سطح امنیت "none" (sl0) باشد، صرفاً به صورت iommu نشان داده می‌شود. bootacl اسلات‌های استفاده‌شده و کل اسلات‌های لیست کنترل دسترسی بوت (BootACL) و محتوای تمام ورودی‌های غیرخالی را نشان می‌دهد. نکته: اگر BootACL پشتیبانی نشود، برای هر دو مقدار ۰ را نشان می‌دهد (0/0). ویژگی online نشان می‌دهد که آیا کنترل‌کننده تاندربولت در حال حاضر توسط فریم‌ور تغذیه می‌شود یا خیر. نکته: اگر کنترل‌کننده در حال حاضر آفلاین باشد، لیست BootACL تخمینی را منعکس می‌کند که boltd از ظاهر لیست پس از بازگشت کنترل‌کننده به حالت آنلاین و همگام‌سازی تغییرات محلی در کنترل‌کننده دارد. اگر لیست در این میان تغییر کرده باشد، مثلاً از یک نصب یا سیستم‌عامل دیگر، ممکن است دقیق نباشد.

تایید و ثبت دستگاه با شناسه یکتای DEVICE در پایگاه‌داده. اگر دامنه از اتصال امن پشتیبانی کند، کلید جدیدی تولید شده و همراه با نام دستگاه و نام تولیدکننده در پایگاه‌داده ذخیره می‌شود. این کلید، در صورت ایجاد، در آینده برای مجاز کردن ایمن دستگاه استفاده خواهد شد.

--policy {default | auto | manual}

مشخص کردن خط‌مشی مورد استفاده برای دستگاه تازه ثبت‌شده.

default

استفاده از خط‌مشی پیش‌فرض سراسری دیمن؛ این مورد قابل تغییر است، اما معمولاً روی auto تنظیم شده است.

auto

مجاز کردن خودکار این دستگاه هر زمان که متصل شود.

manual

عدم تایید خودکار دستگاه؛ در عوض نیاز به تایید دستی از طریق boltctl authorize خواهد داشت.

حذف اطلاعات مربوط به دستگاه با شناسه یکتای DEVICE از پایگاه‌داده. این شامل کلید نیز می‌شود (در صورتی که قبلاً تولید شده باشد). اگر به جای DEVICE گزینه --all را ارسال کنید، به جای یک دستگاه، تمام دستگاه‌ها حذف می‌شوند.

نمایش اطلاعات درباره دستگاه با شناسه یکتای DEVICE.

فهرست کردن و چاپ اطلاعات درباره تمام دستگاه‌های متصل و ذخیره‌شده.

-a | --all

به طور معمول، تنها نوع دستگاهی که نمایش داده می‌شود دستگاه‌های جانبی (peripherals) هستند؛ بنابراین دستگاهی که خود میزبان را نشان می‌دهد حذف می‌شود. استفاده از این گزینه باعث می‌شود تمام انواع دستگاه‌ها در فهرست گنجانده شوند.

شنود و نمایش تغییرات در دستگاه‌های متصل.

روشن کردن کنترل‌کننده تاندربولت. اگر کنترل‌کننده تاندربولت در «حالت شمارش بومی» (native enumeration mode) نباشد، می‌تواند توسط فریم‌ور/بایوس میزبان به طور کامل خاموش شود. در سیستم‌های پشتیبانی‌شده، یک رابط برای روشن کردن «اجباری» کنترل‌کننده تاندربولت وجود دارد. در صورت پشتیبانی، این دستور از دیمن درخواست انجام این کار را می‌کند. دیمن تمام درخواست‌های کلاینت را ردیابی کرده و هنگامی که آخرین درخواست لغو شود، وضعیت روشن‌بودن اجباری را لغو می‌کند.

-t | --timeout seconds

لغو درخواست روشن‌بودن اجباری پس از مدت زمان مشخص‌شده به seconds (ثانیه) و خروج.

-q | --query

استعلام وضعیت فعلی روشن‌بودن اجباری دیمن.

نوشته‌شده توسط Christian Kellner <ckellner@redhat.com>.

08/10/2026 bolt 0.9.11