Provided by: bolt_0.5-1_amd64 bug

NAME

       boltctl - control the thunderbolt device manger

SYNOPSIS

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

DESCRIPTION

       boltctl is the command line interface to interact with boltd, the system daemon that
       manages Thunderbolt 3(TM) devices. It can be used to query the state of devices as well as
       manage them.

       Devices can be globally identified via their unique identifier (uuid). All commands that
       take a DEVICE identifier expect this unique id.

       If no command is given, it is equivalent to boltctl list.

OPTIONS

       --version
           Print version information and exit.

COMMANDS

   authorize [-F | --first-time] DEVICE
       Authorize a currently unauthorized device identified via its unique id (uuid) DEVICE. If a
       key is stored in the database it will be used, given the security level of the domain
       supports secure device connection. Use boltctl list to find out the uuid of a device.

       -F | --first-time
           Normally, when attempting to authorize an already authorized device boltctl will do
           nothing and return a successful status code. When using this option, the attempt will
           fail and result in a negative exit code if the device is already authorized.

   domains [-v | --verbose]
       List all currently active Thunderbolt domains. A Thunderbolt domain represents the
       Thunderbolt controller hardware. There will be one domain (and host device) for each
       Thunderbolt controller present in the system. NB: The Thunderbolt controllers might be
       powered down by the firmware and my not be visible.

   enroll [--policy policy] DEVICE
       Authorize and record the device with the unique id DEVICE in the database. If the domain
       supports secure connection a new key will be generated and stored in the database
       alongside the device name and vendor name. The key, if created, will be used in the future
       to securely authorize the device.

       --policy {default | auto | manual}
           Specify the policy to be used for the newly enrolled device.

           default
               Use the global default policy of the daemon; this can be changed, but is normally
               also auto.

           auto
               Automatically authorize this device whenever it is connected.

           manual
               Do not automatically authorize the device; instead require manual authorization
               via boltctl authorize.

   forget DEVICE
       Remove the information about the device with the unique id DEVICE from the database. This
       includes the key, if one was previously generated. If you pass --all instead of the DEVICE
       all devices are removed instead of just one.

   info DEVICE
       Display information about the device with the unique id DEVICE.

   list [-a | --all]
       List and print information about all connected and stored devices.

       -a | --all
           Normally, the only the device type that will be shown is peripherals. Therefore the
           device that represents the host itself will be omitted. Using this option will instead
           include all device types in the list.

   monitor
       Listen for and show changes in connected devices.

   power [-t | --timeout seconds] [-q | --query]
       Power up the Thunderbolt controller. If the Thunderbolt controller is not in "native
       enumeration mode" it can be completely powered down by the host firmware/BIOS. On
       supported systems there is an interface to "force" power the thunderbolt controller. If
       supported this command will request the daemon to do so. The daemon will keep track of all
       client requests and will release the force power override when the last request is
       released.

       -t | --timeout seconds
           Release the force power request after the specified amount of seconds and exit.

       -q | --query
           Query the current force power status of the daemon.

AUTHOR

       Written by Christian Kellner <ckellner@redhat.com>.