bxhub - Man Page

Command line utility for the Bochs networking module 'socket'.

Synopsis

bxhub [options]

Description

Bxhub is a utility required for the 'socket' networking module simulating an ethernet hub for interconecting Bochs instances. It also simulates a server providing the same services as the 'vnet' networking module (DHCP / DNS / FTP / TFTP and ICMP-echo). All required parameters must be given in the command line.

Options

If bxhub is started without command line options, these default values are used:

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

The follow options can be used to change these settings:
-ports=...

Number of virtual ethernet ports (2 - 6)

-base=...

Base UDP port (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.

Availability

The latest version of this program can be found at:
 https://bochs.sourceforge.io/getcurrent.html

See Also

bochs(1), bximage(1), bochsrc(5), bochs-dlx(1)

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.

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."

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.

Referenced By

bochs(1), bximage(1).

21 Feb 2025 The Bochs Project