mgl@1965: 
mgl@1965: Helper Makefile for testing gcc toolchains using the gcc-testsuite
mgl@1965: ==================================================================
mgl@1965: 
mgl@1965: Requirements
mgl@1965: ------------
mgl@1965: 
mgl@1965: * DejaGnu 'runtest' v1.4.4+
mgl@1965: * Make v3.81+
mgl@1965: 
mgl@1965: 
mgl@1965: Configuration
mgl@1965: -------------
mgl@1965: 
mgl@1965: Edit default.cfg to reflect your toolchain and target configuration.
mgl@1965: 
mgl@1965: Alternatively, override configuration variables on the command line.
mgl@1965: 
mgl@1965: Available config variables:
mgl@1965: 
mgl@1965: DG_TOOLNAME
yann@1966:   The name of the tool you want to test.
yann@1966:   Currently supported: gcc or g++
yann@1966:   Default: gcc
yann@1966: 
mgl@1965: DG_TARGET_HOSTNAME
yann@1966:   The hostname or IP of the machine to execute run-tests
yann@1966:   Default: 127.0.0.1
yann@1966: 
mgl@1965: DG_TARGET_USERNAME
yann@1966:   Execute the run-test as this user on DG_TARGET_HOSTNAME
yann@1966:   Default: root
yann@1966: 
mgl@1965: DG_C_TESTS
mgl@1965: DG_CPP_TESTS
yann@1966:   The C/C++ tests you want to check
yann@1966:   Default: (empty, means all tests)
mgl@1965: 
mgl@1965: 
mgl@1965: Run examples
mgl@1965: ------------
mgl@1965: 
mgl@1965: The first two examples require a networked target with ssh access and automatic
mgl@1965: ssh login (see section below). Target SW should be compiled with the toolchain 
mgl@1965: to be tested.
mgl@1965: 
mgl@1965: Run default gcc compile/execution tests:
mgl@1965: $ make DG_TOOLNAME=gcc DG_TARGET_HOSTNAME=192.168.17.93 DG_TARGET_USERNAME=root
mgl@1965: 
mgl@1965: Run default g++ compile/execution tests:
mgl@1965: $ make DG_TOOLNAME=g++ DG_TARGET_HOSTNAME=192.168.17.93 DG_TARGET_USERNAME=root
mgl@1965: 
mgl@1965: Run selected gcc compile only tests (no target required):
mgl@1965: $ make DG_TOOLNAME=gcc DG_C_TESTS="compile.exp noncompile.exp" 
mgl@1965: 
mgl@1965: 
mgl@1965: SSH automatic login configuration example
mgl@1965: -----------------------------------------
mgl@1965: 
mgl@1965: On host do: 
mgl@1965: ssh-keygen -t rsa (then simply press enter thru all steps)
yann@1966: ssh-copy-id -i ~/.ssh/id_rsa.pub <username>@<target IP>
mgl@1965: 
mgl@1965: Now automatic ssh login should work - test by doing a simple ssh session to target.
mgl@1965: 
mgl@1965: Note: The procedure might be slightly different for your particular target.
mgl@1965: 
mgl@1965: 
yann@1966: Getting rid of the test-suite
yann@1966: -----------------------------
yann@1966: 
yann@1966: If you no longer have a need for the test-suite, then you can remove it altogether
yann@1966: from your toolchain. Just delete the test-suite/ dub-dir.
yann@1966: 
yann@1966: 
mgl@1965: Author
mgl@1965: ------
mgl@1965: Martin Lund <mgl@doredevelopment.dk>
yann@1966:   Initial content
yann@1966: 
yann@1966: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
yann@1966:   Getting rid of the test-suite
yann@1966:   Minor fixes