boltctl - คู่มืออ้างอิง ตัวเลือก ตัวอย่างคำสั่ง

---

ชื่อ

boltctl - ควบคุมตัวจัดการอุปกรณ์สายฟ้า

เรื่องย่อ

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 เนื่องจากเป็นข้อมูลที่ค่อนข้างละเอียดอ่อน จึงไม่แนะนำให้แชร์ต่อสาธารณะแบบเต็มความยาว แทนที่จะใช้ short หรือ alias เมื่อแชร์ผลลัพธ์ของ boltctl

full

พิมพ์ UUID ทั้งหมดแบบเต็มความยาว

short

ตัดทอน UUID ทั้งหมดเพื่อให้พิมพ์เฉพาะอักขระ 13 ตัวแรก

alias

UUID ทั้งหมดจะถูกแทนที่ด้วยสตริงแบบสุ่มที่ได้มาจาก UUID ดังนั้นจึงสามารถระบุอุปกรณ์โดยไม่ซ้ำกันโดยไม่ต้องเปิดเผย UUID ดั้งเดิม

N

หากระบุเป็นจำนวนเต็ม N UUID ทั้งหมดจะถูกตัดให้เหลือแสดงเพียง N

คำสั่ง

authorize [-F | --first-time] DEVICE

ให้สิทธิ์อุปกรณ์ที่ไม่ได้รับอนุญาตในปัจจุบันที่ระบุผ่านรหัสเฉพาะ (uuid) DEVICE หากเก็บคีย์ไว้ในฐานข้อมูล ระบบจะใช้คีย์นั้น เนื่องจากระดับความปลอดภัยของโดเมนรองรับการเชื่อมต่ออุปกรณ์ที่ปลอดภัย ใช้ boltctl list เพื่อค้นหา uuid ของอุปกรณ์

-F | --first-time

โดยปกติแล้ว เมื่อพยายามอนุญาตอุปกรณ์ที่ได้รับอนุญาตแล้ว boltctl จะไม่ดำเนินการใดๆ และจะส่งคืนรหัสสถานะที่สำเร็จ เมื่อใช้ตัวเลือกนี้ ความพยายามจะล้มเหลวและส่งผลให้รหัสทางออกติดลบ หากอุปกรณ์ได้รับอนุญาตแล้ว

config --describe [global|domain|device]

แสดงรายการคุณสมบัติส่วนกลาง โดเมน หรือทั้งหมด (หากไม่ได้ระบุ) รูปแบบคือ 3 คอลัมน์: สิทธิ์ ชื่อ คำอธิบาย การอนุญาตระบุว่าคุณสมบัตินั้นสามารถอ่านได้อย่างเดียวหรือสามารถเขียนได้

config KEY [VALUE]

รับหรือตั้งค่า หากระบุเป็น VALUE คุณสมบัติส่วนกลาง

config <domain|device>.KEY TARGET [VALUE]

รับหรือตั้งค่า หากระบุเป็น VALUE โดเมนหรือพร็อพเพอร์ตี้อุปกรณ์ โดยที่ TARGET คือรหัสเฉพาะของโดเมนหรืออุปกรณ์

domains [-v | --verbose]

แสดงรายการโดเมน Thunderbolt ที่ใช้งานอยู่ทั้งหมด โดเมน Thunderbolt แสดงถึงฮาร์ดแวร์ตัวควบคุม Thunderbolt จะมีหนึ่งโดเมน (และอุปกรณ์โฮสต์) สำหรับคอนโทรลเลอร์ Thunderbolt แต่ละตัวที่มีอยู่ในระบบ คุณสมบัติ ความปลอดภัย แสดงระดับความปลอดภัยของคอนโทรลเลอร์ หากการสนับสนุน iommu ทำงานอยู่ (ดูที่หน้าคู่มือ boltd) จะมีการระบุด้วย +iommu ต่อท้ายสำหรับ "secure" หรือ "user" โหมด หรือเพียงแค่ iommu ธรรมดาในกรณีที่ระดับความปลอดภัยเป็น "ไม่มี" (sl0) bootacl แสดงช่องที่ใช้และช่องทั้งหมดของรายการควบคุมการเข้าถึงการบูต (BootACL) และเนื้อหาของรายการที่ไม่ว่างเปล่าทั้งหมด หมายเหตุ: หากไม่รองรับ BootACL จะแสดง 0 สำหรับทั้งคู่ (0/0) คุณสมบัติ ออนไลน์ แสดงว่าตัวควบคุม Thunderbolt ใช้พลังงานจากเฟิร์มแวร์อยู่หรือไม่ หมายเหตุ: หากคอนโทรลเลอร์อยู่ในสถานะออฟไลน์ รายการ BootACL จะแสดงสิ่งที่ boltd ประมาณการว่ารายการจะมีลักษณะอย่างไร เมื่อคอนโทรลเลอร์กลับมาออนไลน์และการเปลี่ยนแปลงในเครื่องได้รับการซิงโครไนซ์กับคอนโทรลเลอร์ . การดำเนินการนี้อาจไม่ถูกต้องหากรายการได้รับการแก้ไขในระหว่างนี้ เช่น จากการติดตั้งหรือระบบปฏิบัติการอื่น

enroll [--policy policy] DEVICE

ให้สิทธิ์และบันทึกอุปกรณ์ด้วยรหัสเฉพาะ DEVICE ในฐานข้อมูล หากโดเมนรองรับการเชื่อมต่อที่ปลอดภัย คีย์ใหม่จะถูกสร้างขึ้นและจัดเก็บไว้ในฐานข้อมูลพร้อมกับชื่ออุปกรณ์และชื่อผู้ขาย หากสร้างคีย์ จะใช้ในอนาคตเพื่ออนุญาตอุปกรณ์อย่างปลอดภัย

--policy {default | auto | manual}

ระบุนโยบายที่จะใช้สำหรับอุปกรณ์ที่ลงทะเบียนใหม่

default

ใช้นโยบายดีฟอลต์โกลบอลของดีมอน สิ่งนี้สามารถเปลี่ยนแปลงได้ แต่โดยปกติจะเป็น อัตโนมัติ ด้วย

auto

อนุญาตอุปกรณ์นี้โดยอัตโนมัติทุกครั้งที่มีการเชื่อมต่อ

manual

ไม่ ให้สิทธิ์อุปกรณ์โดยอัตโนมัติ จำเป็นต้องให้สิทธิ์ด้วยตนเองผ่าน boltctl authorize

forget DEVICE

ลบข้อมูลเกี่ยวกับอุปกรณ์ที่มี ID เฉพาะ DEVICE ออกจากฐานข้อมูล ซึ่งรวมถึงรหัสหากมีการสร้างไว้ก่อนหน้านี้ หากคุณผ่าน --ทั้งหมด แทนที่จะเป็น DEVICE อุปกรณ์ทั้งหมดจะถูกลบออกแทนที่จะเป็นเพียงเครื่องเดียว

info DEVICE

แสดงข้อมูลเกี่ยวกับอุปกรณ์ด้วยรหัสเฉพาะ DEVICE

list [-a | --all]

แสดงรายการและพิมพ์ข้อมูลเกี่ยวกับอุปกรณ์ที่เชื่อมต่อและจัดเก็บทั้งหมด

-a | --all

โดยปกติแล้ว อุปกรณ์ประเภทเดียวที่จะแสดงคืออุปกรณ์ต่อพ่วง ดังนั้นอุปกรณ์ที่เป็นตัวแทนของโฮสต์จะถูกละไว้ การใช้ตัวเลือกนี้จะรวมอุปกรณ์ทุกประเภทไว้ในรายการแทน

monitor

ฟังและแสดงการเปลี่ยนแปลงในอุปกรณ์ที่เชื่อมต่อ

power [-t | --timeout seconds] [-q | --query]

เปิดเครื่องควบคุม Thunderbolt หากคอนโทรลเลอร์ Thunderbolt ไม่ได้อยู่ใน "โหมดการแจงนับเนทีฟ" เฟิร์มแวร์โฮสต์/BIOS จะปิดการทำงานโดยสมบูรณ์ ในระบบที่รองรับมีอินเทอร์เฟซสำหรับ "บังคับ" จ่ายไฟให้กับตัวควบคุมสายฟ้า หากรองรับคำสั่งนี้จะร้องขอให้ daemon ทำเช่นนั้น daemon จะติดตามคำขอของไคลเอ็นต์ทั้งหมด และจะปล่อยการบังคับใช้พลังงานแทนที่เมื่อมีการปล่อยคำขอล่าสุด

-t | --timeout seconds

ปล่อยคำขอพลังบังคับหลังจากเวลา วินาที ที่ระบุและออก

-q | --query

สอบถามสถานะพลังบังคับปัจจุบันของภูต

ผู้เขียน

เขียนโดย Christian Kellner ckellner@redhat.com