Max Bandwidth (maxb)

A utility for testing maximum bandwidth between systems.

The current project page is located here: https://github.com/blb2/maxb.

Building

CMake is used to build this project. There are plenty of ways of using CMake, so choose the way that you prefer to work best.

Ensure cmake is in the PATH

• Command Prompt:

  PATH=%PROGRAMFILES%\CMake\bin;%PATH%

• PowerShell:

  $env:PATH += ";$Env:PROGRAMFILES\CMake\bin"

• Git Bash:

  PATH=$(cygpath -u "$PROGRAMFILES")/CMake/bin:$PATH

Building with presets (on Windows only for now)

The following configuration presets are available, along with build presets under them:

• windows-msvc-x86: Sets up CMake to use the "Visual Studio 18 2026" generator for producing a 32-bit build.
  • windows-msvc-x86-dbg: Builds the Debug configuration.
  • windows-msvc-x86-rel: Builds the Release configuration.
• windows-msvc-x64: Sets up CMake to use the "Visual Studio 18 2026" generator for producing a 64-bit build.
  • windows-msvc-x64-dbg: Builds the Debug configuration.
  • windows-msvc-x64-rel: Builds the Release configuration.

The following is an example of building a 64-bit release build:

cmake --preset windows-msvc-x64
cmake --build --preset windows-msvc-x64-rel
# Build artifacts are now under build/windows-msvc-x64.

Building without presets

1. Ways of configuring with CMake:

   # Simple initialization:
   cmake -B build
   
   # Allow the build process to be verbose:
   cmake -B build -DCMAKE_VERBOSE_MAKEFILE=ON
   
   # If you're on a native, 64-bit platform, but you wish to produce a
   # 32-bit build:
   cmake -B build -A Win32
   
   # If using CMake 3.27 or greater, and building on Windows with Visual
   # Studio, it is preferable to specify the version of the Windows SDK:
   cmake -B build -A version=10.0

2. Ways of building with CMake:

   # Simple building; default configuration varies:
   cmake --build build
   
   # Build with a specific configuration:
   cmake --build build --config Debug
   cmake --build build --config Release
   cmake --build build --config RelWithDebInfo
   cmake --build build --config MinSizeRel
   
   # If a solution or workspace was generated by CMake, open it in the IDE:
   cmake --open build

Usage

At the moment, this application supports testing for UDP bandwidth.

1. Benchmark how much data can be transferred within a specific time period. The time period is specified in seconds. In this example, 10 seconds is used:

   maxb 10.28.1.130 10

License

maxb is licensed under version 3 of the GPL or later. See LICENSE.txt for more info.