UHUBCTL(8)

📦
version 2.6.0 · 5 versions
, in debian trixie, ubuntu questing

💖 uhubctl — the manual page, but make it slay 💖

okay bestie, welcome to uhubctl(8) — section 8, System Administration Utilities, iykyk. This is the whole entire manual, no skips, no cuts, we are doing the full read. Grab a snack 🍓

✨ NAME ✨

uhubctl — it's uhubctl. That's the name. That's the vibe. Short, iconic, does exactly what it says on the tin. 💅

🌸 SYNOPSIS 🌸

uhubctl [options]

That's it. That's the whole shape of it. You give it options, it does stuff. Periodt.

🦋 DESCRIPTION 🦋

uhubctl is a utility to control USB port power for smart hubs. Yes, like, actually turning the power on a USB port off and on again. Main character energy for real.

If you run it with no options at all, it just shows you the status for all smart hubs. A little vibe check of every smart hub it can find. 👑

🎀 OPTIONS 🎀

Defaults live in brackets, bestie, don't forget them.

  • --action, -a — the action to do to the affected ports. Your choices are off/on/cycle/toggle/flash, which map to the numbers 0/1/2/3/4.
  • --ports, -p — which ports to operate on. Default is [all hub ports].
  • --location, -l — limit the hub by location. Default is [all smart hubs].
  • --level, -L — limit the hub by location level. For example, a-b.c is level 3. Cute little numbering situation.
  • --vendor, -n — limit the hub by vendor id. Default is [any], and partial is ok.
  • --search, -s — limit the hub by attached device description. Detective mode 🔍
  • --delay, -d — the delay for cycle/flash action. Default is [2 sec].
  • --repeat, -r — repeat power off count. Default is [1]. Some devices literally need it to actually turn off, no cap.
  • --exact, -e — exact location, which means no USB3 duality handling. ✨
  • --force, -f — force the operation even on unsupported hubs. Risky girlboss move, but okay.
  • --nodesc, -N — do not query device description. Helpful for unresponsive devices, so like, be nice to them.
  • --nosysfs, -S — do not use the Linux sysfs port disable interface.
  • --reset, -R — reset the hub after each power-on action, causing all devices to reassociate. Everyone say hi to each other again 🫶
  • --wait, -w — wait before repeat power off. Default is [20 ms].
  • --version, -v — print program version.
  • --help, -h — print this text.
💌 Found a bug? Got a request? Send them to: https://github.com/mvp/uhubctl — version: 2.6.0-1

🌈 SEE ALSO 🌈

This manual page was automatically created at build time with help2man for the Debian project. So like, it's not hand-written by a poet, it's generated. Be gentle with it 😭

Please report any bugs in it to the Debian BTS: https://bugs.debian.org

and that's the whole page, bestie!! This was uhubctl 2.6.0-1, dated September 2024, and it lives in section 8 of the manual, filed under UHUBCTL(8). go unplug something (responsibly) 💖✨🎀🦋🌸💅

📦 where this page comes from