UHUB(1)

✨ UHUB(1) β€” the uhub manual, but make it cute ✨

okay bestie, gather round, we're learning uhub from the General Commands Manual, section 1 πŸ’…


πŸŽ€ NAME πŸŽ€

uhub β€” a high performance ADC peer-to-peer hub πŸ¦‹


🌸 SYNOPSIS 🌸

uhub [options]

that's it. that's the whole summoning ritual. options go in, hub comes out 😌


πŸ’– DESCRIPTION πŸ’–

uhub is a high performance peer-to-peer hub for the ADC network. no cap.

the way that its low memory footprint lets it do the absolute most 😭 it can handle several thousand users on high-end servers, or run a tiny little private hub on embedded hardware. like, both. same binary. main character energy either way πŸ‘‘


✨ OPTIONS ✨

  • -v β€” Verbose mode πŸ—£οΈ and if you want more verbosity, just stack more -v's. yes, really, more -v's = higher verbosity. go off.
  • -q β€” Quiet mode 🀫 if quiet mode is on, no output and no logs are made. not a single peep. silence, iconic.
  • -f β€” Fork uhub to the background so it can run as a daemon 🧚 detach and thrive.
  • -l logfile β€” Log messages to the given logfile (default: stderr) πŸ“
  • -L β€” Log messages to syslog πŸ“‘
  • -c config β€” Specify the configuration file (default: /etc/uhub/uhub.conf) πŸ“‚
  • -C β€” Check configuration files and return. Will print either 🫢 (the manual page's sentence genuinely just ends right there, bestie β€” i'm not hiding anything from you, iykyk)
  • -s β€” Show all configuration parameters, in a format that's compatible with the configuration files πŸ’«
  • -S β€” Show all non-default configuration parameters πŸ‘€ so just the spicy ones.
  • -h β€” Show the help message πŸ†˜
  • -u user β€” Drop privileges and run as the given user πŸ”
  • -g group β€” Drop privileges and run with the given group permissions πŸ«‚
  • -V β€” Show the version number πŸ”’

🌈 EXAMPLES 🌈

want uhub running as a daemon and logging to a file? say less:

uhub  -f -l /var/log/uhub/uhub.log

(those two spaces between uhub and -f are exactly how the manual writes it, so i'm keeping them fr fr πŸ“)


πŸ‘‘ AUTHOR πŸ‘‘

this program was written by Jan Vidar Krey <janvidar@extatic.org> ✨ absolute legend behavior.


πŸ’€ BUG REPORTS πŸ’€

found a bug in uhub? do not suffer in silence πŸ™ˆ report it right here:

https://github.com/janvidar/uhub/issues

the maintainers want to hear about it, fr fr 🫢


and that's the whole page, bestie πŸ’œ this edition of the UHUB(1) manual comes from the source/version stamped March 2009 β€” go forth and hub responsibly, slay, periodt πŸ’…βœ¨πŸŒΈ

πŸ“¦ where this page comes from