Building SwiftRNG utilities on Linux, CentOS, FreeBSD and macOS

Make sure packages make, gcc, libusb and gcc-c++ are installed before running the build.

Important: due to some issues with the libusb version 1.0.25, we strongly advise installing a libusb version prior to or after 1.0.25.

When working with the SwiftRNG API and utilities on Linux, the udev component is a dependency for detecting SwiftRNG devices. Although udev is commonly part of standard Linux installations, you might need to install it separately if it’s not present on your system.

Ubuntu

On Ubuntu, this can be done with the following commands to install the required dependencies:

sudo apt-get update
sudo apt-get install make
sudo apt-get install gcc
sudo apt-get install g++
sudo apt-get install libusb-1.0

CentOS and Red Hat

On CentOS or Red Hat, use the following commands to install the required dependencies:

yum update
yum install make
yum install gcc
yum install gcc-c++
yum install libusb*

macOS

On macOS, the libusb dependency can be installed by running the following from the command line (make sure Homebrew is installed).

brew install libusb

Note: Please follow recommendations described at this address for installing the correct libusb version.

FreeBSD

On FreeBSD, use the following command to install the gcc required dependency:

sudo pkg install lang/gcc

Make

To build and install utilities in CentOS, Linux and macOS, you will need to run the following from the command line:

cd linux-and-osx/swrng
make
sudo make install

Make (FreeBSD)

To build and install utilities in FreeBSD, you will need to run the following from the command line:

cd linux-and-osx/swrng
make -f Makefile.bsd
sudo make -f Makefile.bsd install

Non-root access on Linux

To enable a non-root user to access the SwiftRNG device, simply copy the supplied 80-swiftrng-usb-access.rules file to /etc/udev/rules.d/ location. You may need to reboot the system for the changes to take effect.