|Home -> Relay Shell|
This component of the virtual lab is considered to be
confidential, so it is not available for download. However,
the documentation is still published for completeness.
In the source code repository, the relay shell
can be found in "nonfree/software/". A binary can be found in "bin/".
The relay shell is also discussed in the administrator's
Compiling the relay shell software
The instructions are the same as for the board
server software. Most of the relay shell code is shared with
the board server. The relay shell-specific module is:
No configuration files are needed for the relay shell. You can test the relay shell by running it directly:usermod -s /usr/bin/relay username
You will see a message like:/usr/bin/relay
The relay server will not start up properly unless the mutual exclusion daemon is running. This daemon should be launched on system boot.rversion 0.1 Relay software build Jul 18 2008 11:44:39
Bit files are given timestamped file names that include the board name and bit file identifier (BID), such as:Aug 11 14:52:01 localhost relay: User (c): "setuart 0 115200"
In this case, the board name is burchtest and the bid is 672. The bit file is compressed using zlib. It does not have a standard gzip header, so it can only be decompressed by using zlib directly. However, this can be done using a simple Python program:/home/vluser/2008-08-11--14-52-01--burchtest-672.biz
(Run this program with a .biz file as a parameter; a .bit file will be produced in the same directory as the input.)import zlib, sys, os inname = sys.argv[ 1 ] outname = os.path.splitext(inname)[ 0 ] + '.bit' file(outname, 'wb').write(zlib.decompress(file(inname, 'rb').read()))
|Copyright (C) Jack Whitham 1997-2011|