1 #
   2 # This file and its contents are supplied under the terms of the
   3 # Common Development and Distribution License ("CDDL"), version 1.0.
   4 # You may only use this file in accordance with the terms of version
   5 # 1.0 of the CDDL.
   6 #
   7 # A full copy of the text of the CDDL should have accompanied this
   8 # source.  A copy of the CDDL is also available via the Internet at
   9 # http://www.illumos.org/license/CDDL.
  10 #
  11 
  12 #
  13 # Copyright 2014 Garrett D'Amore <garrett@damore.org>
  14 # Copyright (c) 2012 by Delphix. All rights reserved.
  15 #
  16 
  17 Utils Unit Test Suite README
  18 
  19 1. What the Utils Unit Test Suite tests
  20 2. Building and installing the Utils Unit Test Suite
  21 3. Running the Utils Unit Test Suite
  22 4. Test results
  23 
  24 --------------------------------------------------------------------------------
  25 
  26 1. What the Utils Unit Test Suite tests
  27 
  28 The Utils unit test suite is for testing standard shell / POSIX utilities.
  29 For example utilities such as "printf" are tested.
  30 
  31 2. Building and installing the Utils Unit Test Suite
  32 
  33 The Utils Unit Test Suite runs under the testrunner framework (which can be
  34 installed as pkg:/system/test/testrunner). To build both the Utils Unit Test
  35 Suite and the testrunner without running a full nightly:
  36 
  37         build_machine$ bldenv [-d] <your_env_file>
  38         build_machine$ cd $SRC/test
  39         build_machine$ dmake install
  40         build_machine$ cd $SRC/pkg
  41         build_machine$ dmake install
  42 
  43 Then set the publisher on the test machine to point to your repository and
  44 install the Utils Unit Test Suite.
  45 
  46         test_machine# pkg install pkg:/system/test/utiltest
  47 
  48 Note, the framework will be installed automatically, as the Utils Unit Test
  49 Suite depends on it.
  50 
  51 3. Running the Utils Unit Test Suite
  52 
  53 The pre-requisites for running the OS Unit Test Suite are:
  54         - Any user may perform these tests.
  55 
  56 Once the pre-requisites are satisfied, simply run the ostest script:
  57 
  58         test_machine$ /opt/util-tests/bin/utiltest
  59 
  60 4. Test results
  61 
  62 While the OS Unit Test Suite is running, one informational line is printed at
  63 the end of each test, and a results summary is printed at the end of the run.
  64 The results summary includes the location of the complete logs, which is of the
  65 form /var/tmp/test_results/<ISO 8601 date>.