UCS-TEST(1)

SYNOPSIS
ucs-test [options]

DESCRIPTION
This manual page documents briefly the ucs-test comannd to run tests on UCS systems.

OPTIONS
A summary of options is included below.

-h, --help
    Show a help message and exit.

  Test selection

-s SECTION, --section=SECTION
    Run tests only from the specified section.

-p TAG, --prohibit=TAG
    Skip tests with this tag. The option may be used multiple times to skip multiple tags.

-r TAG, --require=TAG
    Only run tests with this tag. The option may be used multiple times to require multiple tags.

-g TAG, --ignore=TAG
    Ignore tag by not requiring nor prohibiting it. The option may be used multiple times to ignore multiple tags.

-E EXPOSURE, --exposure=EXPOSURE
    Run more dangerous tests. Allowed values are safe (default), careful and dangerous.

  Output options

-n, --dry-run
    Only show which tests would run.

-f, --filtered
    Hide tests with unmatched pre-conditions from the output instead of printing them as skipped.

-F FORMAT, --format=FORMAT
    Select output format. Available formats include text (default), tap, html, jenkins.

-v, --verbose
    Increase verbosity. May be used multiple times.

-i, --interactive
    Run test connected to terminal. Otherwise the tests runs with the standard input connected to /dev/null and the output redirected to the logfile.

-c, --count
    Prefix tests by count.

-l LOGFILE, --logfile=LOGFILE
    Path to log file. Without this option a file like /var/log/univention/test_XXX.log is used where XXX is replaced by the unix epoche.

EXAMPLE
ucs-test -s updater -e dangerous -vvv

FILES

/usr/share/ucs-test/
    Base directory for tests.

/var/log/univention/test_XXX.log
    Logfile of test case output.

AUTHOR
Copyright (c) 2012-2026 Univention GmbH, Germany