USBREDIRSERVER(1)

📦 version 0.13.0, in centos-stream 9, ubuntu jammy

🦋 NAME 🦋

usbredirserver — bestie, it's a whole thing where you export a USB device so another (virtual) machine can use it 💅✨

✨ SYNOPSIS ✨

usbredirserver [-p|--port <port>] [-v|--verbose <0-5>] [-4 <ipv4_addr|I-6 <ipv6_addr>] <busnum-devnum|vendorid:prodid>
That line is transcribed character for character, no cap, no edits, no notes 🙈 I don't make the rules, I just deliver the vibes.

🌸 DESCRIPTION 🌸

okay so picture this: usbredirserver is a small standalone server whose entire main character job is exporting an USB device so it can be used from another (virtual) machine, and it does that through the usbredir protocol. iconic behaviour honestly 🫶

Now, the way you tell it which USB device to export? Two options, both valid, pick your fighter:

  • by USB id, in the form of <vendorid>:<prodid> 💖
  • by USB bus number and device address, in the form of <usbbus>-<usbaddr> 🎀
⚠️ Notice this, fr fr: one single instance of usbredirserver can only export a single USB device. That's just the deal. So if you're out here wanting to export multiple devices, you start up multiple instances, each one listening on a different TCP port. Multiple servers, multiple ports, one device each. periodt 🌈

💖 OPTIONS 💖

  • -p, --port=PORT — sets the TCP port to listen on to PORT 🌐
  • -v, --verbose=VERBOSE — sets usbredirserver's verbosity level to VERBOSE. this mostly affects USB redirection related messages, iykyk. valid values are 0-5:
    • 0: Silent 🤫
    • 1: Errors 😭
    • 2: Warnings 😬
    • 3: Info 💬
    • 4: Debug 🔍
    • 5: Debug++ 🔥

👑 AUTHOR 👑

Written by Hans de Goede <hdegoede@redhat.com> — king behaviour, we love to see it 👑

🐛 REPORTING BUGS 🐛

Found a bug? bestie, don't just scream into the void, tell the people 💀 You can report bugs to the spice-devel mailinglist:

http://lists.freedesktop.org/mailman/listinfo/spice-devel

or you can go file an issue right here:

https://gitlab.freedesktop.org/spice/usbredir/issues/new

go off, they're listening 🫶

Copyright 2010-2012 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. (that NO WARRANTY is in all caps for a reason, bestie, it's giving seriousness 😭)

and that's the whole page, we're done here 💖 this was the usbredirserver manual page, sitting pretty in the User Commands section as USBREDIRSERVER(1), dated April 2012, and you got the full rundown from me, your resident Unix bestie 🎀✨ bye babe, go export something 🌈🦋

📦 where this page comes from