Skip to content

dotse/bbk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 

Repository files navigation

The src directory contains the source code to the command line version of Bredbandskollen CLI, a bandwidth measurement tool.

How to build Bredbandskollen's CLI client

On Windows, open

src/wincli/wincli.sln

in Visual Studio 2015 or later, then choose "Build".

On all other platforms, change to the directory

src/cli

and run the command "make" (or "gmake"). GNU Make and a compiler with support for C++11 is required, e.g. GCC version 4.7 or later or LLVM Clang version 3.9 or later.

To use a specific compiler, do e.g.

make CXX=clang++

To enable support for TLS/SSL, install GnuTLS version 3.5 or later, and do

make clean
make GNUTLS=1

To perform a bandwidth measurement using TLS, do

./cli --test --ssl

For more information, see "Platform Notes" below.

How to run the CLI client

To perform a mesurement, simply run the executable program that was built using the above steps. For more information, run it with the --help argument or read

https://frontend.bredbandskollen.se/download/README.txt

About the source code

The directories framework and http contain a basic C++ network programming framework with support for "tasks" and "timers". Some of the features are explained by demo programs in the examples directory. The API documentation can be built from the source code.

The directory json11 contains a JSON library for C++ provided by Dropbox, Inc.

The directory measurement contains the bandwidth measurement engine, built atop the framework.

The directory cli contains a command line interface to the measurement engine.

The directory qt5gui contains the source code for a GUI to the measurement engine. To build it, Qt5 and QWebEngine are required. You must run the Qt5 version of qmake to create a Makefile before running make to build the GUI.

Platform Notes

  • Windows

The code has not been thoroughly tested on Windows. Pull requests are welcome.

Visual Studio 2015 or later is required, as are the components MSVC v140 (VS 2015 C++ build tools) and Windows 10 SDK. Visual Studio 2022 Community can be downloaded from https://visualstudio.microsoft.com/

Open src/wincli/wincli.sln in Visual Studio, then select "Build".

  • MacOS

Install Xcode from App Store, then go to src/cli and do make. For SSL support, install Homebrew from https://brew.sh and then do

brew install gnutls

Once GnuTLS is installed, go to src/cli and do

make clean
make GNUTLS=1
  • Linux

Make sure g++ version 4.7 or later is installed. Then go to src/cli and do

make

If GnuTLS version 3.5 or later is installed, including development files, do

make clean
make GNUTLS=1
  • OpenBSD

Install gmake, llvm and gnutls using pkg_add, then go to src/cli and do

gmake

or

gmake GNUTLS=1
  • FreeBSD

Install gmake and gnutls using pkg, then go to src/cli and do

gmake

or

gmake GNUTLS=1
  • NetBSD

Install gmake, llvm, clang, and gnutls using pkgin, then go to src/cli and do

gmake

or

gmake GNUTLS=1