README

   1 HelenOS Continuous Integration Testing Scripts
   2 ==============================================
   3
   4 The purpose of this repository is to have a universal script for building
   5 and testing (almost) everything related to HelenOS. Currently, the script
   6 is able to:
   7  - fetch latest versions of HelenOS and Coastline
   8  - build HelenOS for all supported architectures
   9  - build all harbours (the full matrix)
  10  - run automated tests in QEMU (ia32/amd64 only)
  11
  12
  13 Running
  14 -------
  15
  16     # Fetch default branches and build everything.
  17     ./build.py
  18
  19     # Limit paralellism
  20     ./build.py --jobs 3
  21
  22     # Fetch from non-default branches
  23     ./build.py --helenos-repository lp:~your-name/helenos/your-branch
  24
  25
  26 Tests
  27 -----
  28
  29 See scripts in scenarios/ or the test-in-vm.sh script.
  30
  31 Simple test running malloc and checking its output looks like this:
  32
  33     xx_start_machine
  34     xx_cmd "tester malloc1" assert="Test passed" timeout=120 die_on="demo"
  35     xx_stop_machine
  36
  37 Test checking that we are able to launch gcc (needs special image):
  38
  39     # @needs gcc
  40     xx_start_machine
  41     xx_cmd "gcc" assert="no input files" timeout=20
  42     xx_stop_machine