bxhub(1)

📦 version 3.1, in fedora 43, fedora 44, nixpkgs unstable

💖 bxhub — the Bochs Project's little networking bestie

okay so you found the manual page for bxhub(1), a.k.a. the Bochs Project's command line utility, and honestly? she's iconic. let's get into it 🫶

✨ NAME ✨

bxhub — Command line utility for the Bochs networking module socket. that's it, that's the girl 💅

🌸 SYNOPSIS 🌸

bxhub [options]

🦋 DESCRIPTION 🦋

So bxhub is a utility you literally need for the socket networking module — she simulates an ethernet hub so your Bochs instances can interconnect, like a lil group chat for emulators 🫂

She also simulates a server dishing out the exact same services as the vnet networking module: DHCP / DNS / FTP / TFTP and ICMP-echo. all of it. she does it all.

And heads up bestie — all required parameters must be given in the command line. no config file, no vibes-based guessing, just tell her what you want ✨

🎀 OPTIONS 🎀

If you start bxhub with zero command line options, she just goes with these defaults, no questions asked:

  • UDP base port 40000
  • 2 client connections
  • Server MAC address b0:c4:20:00:00:0f
  • FTP / TFTP support disabled

and now the options that let you change all that 👇

  • -ports=... — Number of virtual ethernet ports (2 - 6)
  • -base=... — Base UDP port (heads up: bxhub uses 2 ports per Bochs session 👀)
  • -mac=... — Host MAC address (default is b0:c4:20:00:00:0f)
  • -tftp=... — Enable FTP and TFTP support using specified directory as root
  • -bootfile=... — Network bootfile reported by DHCP — located on TFTP server
  • -loglev=... — Set log level (0 - 3, default 1)
  • -logfile=... — Send log output to file
  • --help — Display help message and exit

👑 LICENSE 👑

This program is distributed under the terms of the GNU Lesser General Public License as published by the Free Software Foundation. See the LICENSE and COPYING files located in /usr/share/doc/bochs/ for details on the license and the lack of warranty. (yes, lack of warranty — read it, bestie, it's giving "we told you so" 💀)

🌈 AVAILABILITY 🌈

The latest version of this program can be found at:

https://bochs.sourceforge.io/getcurrent.html

💜 SEE ALSO 💜

The Bochs IA-32 Emulator site on the World Wide Web:

https://bochs.sourceforge.io

Online Bochs Documentation:

https://bochs.sourceforge.io/doc/docbook

🧚 AUTHORS 🧚

The original version of bxhub was written by Mariusz Matuszek in 2003 as a part of the socket networking patch. The builtin server support comes from the vnet networking module and it has been adapted and extended by Volker Ruppert. legends, both of them 🫡

💀 BUGS 💀

Please report all bugs to the bug tracker on our web site. Just go to https://bochs.sourceforge.io, and click "Bug Reports" on the sidebar under "Feedback."

when you do, provide a detailed description of the bug, the version of the program you are running, the operating system you are running the program on, and the operating system you are running in the emulator. all four, bestie, don't skimp 🙈

and that's the whole page, fr fr — this was bxhub from The Bochs Project, dated 21 Feb 2025, and she ate. no cap. periodt ✨💅🎀

📦 where this page comes from