RISCOS Build client

This repository contains a WebSockets client for the RISC OS Build service at https://build.riscos.online/.

Usage

To use the tool:

./riscos-build-online -i <source-file-or-zip> -o <output-prefix>

Will run the build on the service, and report the results to the console. The final output binary will be written to the output-prefix. On non-RISC OS builds, this will be suffixed by ,xxx for the filetype that was generated. On RISC OS builds, the file named will be given the type of the returned data.

The return code from the tool will be propagated from the build.

Other options that can be used:

• -q: Only write the output from the build process to the terminal.
• -Q: Write no output to the terminal except errors.
• -b: Write all the build process's output to a file.
• -s: Specifies the server URI to connect together.
• -t: Specifies the timeout in seconds for the remote execution.
• -a: Enables or disables the use of ANSI text formatting (default 'on').

Prerequisites

There are two submodules required for this tool to work; they will be static linked with the resulting binary. To ensure that they are present, use:

git submodule update --init

The libwsclient needs libtoolize to be present to run the autogen process. On MacOS this was installable with brew install libtool but not located where the scripts could find it. This could be fixed with:

ln -s /usr/local/bin/glibtoolize /usr/local/bin/libtoolize

Building on Linux/MacOS

Once prerequisites are installed, you should just be able to run:

make

to get a build tool called riscos-build-online.

Building a deb:

make deb

to get a distributable deb containing the tool.

Building on RISC OS

The template environment files are required, together with standard C and TCPIPLibs. Before running the build, the submodules must be checked out as well.

The directory RISC OS contains the files necessary to build the source. Running !BuildAll will build both the libraries and the client itself. The build scripts will construct a RISC OS-style source directory based on the original names.

The RISC OS client has not been heavily tested; it runs the simple 'Hello World' script that is the testfile in the root of the repository.

Quite a few shortcuts were taken in making the client work:

• libwsclient isn't C89 compatible, so the sed tool fixes up the current issues, and truncates values that require long longs.
• libwsclient uses pthreads, which isn't available, so it's been completely stubbed out, and the necessary functions are called directly. This is possible because libwsclient, when used for a single operation has a linear flow.
• libwsclient calls getaddrinfo, which I haven't implemented yet, so I threw together a fake routine which does enough to get an address and therefore a connection.

License

This code is licensed under the BSD license. The distributed binary is under the GPL 3 clause license, due to the inclusion of the libwsclient library.