USBREDIRECT(1)

📦
version 0.15.0 · 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ usbredirect(1) — the manual page, but make it cute ✨

okay bestie, welcome to the <cyan>usbredirect</cyan> page from the User Commands section of the manual, dated February 2021 💅 sit down, grab a strawberry 🍓, we're exporting USB devices across machines like it's nothing.

🎀 NAME 🎀

usbredirect — exporting an USB device for use from another (virtual) machine

🌈 SYNOPSIS 🌈

usbredirect [--device vendor:product] [--to addr:port] [--as addr:port]
usbredirect [--device bus-device] [--to addr:port] [--as addr:port]

💖 DESCRIPTION 💖

so. usbredirect is literally a usbredir client whose whole personality is exporting an USB device — either as a TCP client or as a TCP server — so that another (virtual) machine can use it, all through the usbredir protocol. no cap, that's the whole job 🫶

how do you tell it which device though? two ways, pick your fighter:

  • by USB id, in the form <vendorid>:<prodid> 👑
  • or by bus/device number, in the form <busnum>-<devnum> 🦋
⚠️ notice — and this is the important part, don't skip it — one instance of usbredirect can only ever export a single USB device, and it will close once the other side closes the connection. like, that's it, one device per vibe check.

so if you want to export multiple devices? you start multiple instances, each one listening on a different TCP port. periodt. 💅

🌸 AUTHOR 🌸

Written by Victor Toso <victortoso@redhat.com> ✨ (iconic behaviour, honestly)

🦋 REPORTING BUGS 🦋

found a bug? 😭 you can report it to the spice-devel mailinglist at: http://lists.freedesktop.org/mailman/listinfo/spice-devel

or you can file an issue at: https://gitlab.freedesktop.org/spice/usbredir/issues/new

either one, we're not picky, we just wanna know 🙈

Copyright 2010-2021 Red Hat, Inc. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (read that again, bestie — NO WARRANTY, fr fr 💀)

and that's the whole page! this was the usbredirect manual page, USBREDIRECT(1), from February 2021 🌈 thanks for reading, you ate 💅✨

📦 where this page comes from