checkbox-invocation(1)

NAME
checkbox-qt, checkbox-cli, checkbox-urwid, checkbox-gtk - Application for system testing

SYNOPSIS
checkbox [OPTIONS]

DESCRIPTION
Checkbox provides tests to confirm that your system is working properly. Once you are finished running the tests, you can view a summary report for your system.

OPTIONS

-c config, --config=config
    Configuration override parameters.

-l file, --log=file
    The file to write the log to.

--log-level
    One of debug, info, warning, error or critical.

--version
    Print version information and exit.

--help
    Print a usage message briefly summarizing these command-line options.

ENVIRONMENT VARIABLES
The behavior of checkbox is affected by the following environment variables.

The locale for category LC_foo is specified by examining the three environment variables LC_ALL, LC_foo, LANG, in that order. The first of these variables that is set specifies the locale. For example, if LC_ALL is not set, but LC_MESSAGES is set to pt_BR, then the Brazilian Portuguese locale is used for the LC_MESSAGES category. The C locale is used if none of these environment variables are set, if the locale catalog is not installed.

CHECKBOX_OPTIONS
    This variable specifies default options to be placed in front of any explicit options. For example, if CHECKBOX_OPTIONS is '--log-level=debug', checkbox behaves as if the option had been specified before any explicit options. Option specifications are separated by whitespace. A backslash escapes the next character, so it can be used to specify an option containing whitespace or a backslash.

CHECKBOX_DATA
    Specifies the directory containing variable data such as persisting state for example. Some plugins in checkbox might also choose to store their own data under that directory.

CHECKBOX_SHARE
    This variable specifies the directory containing shared files such as plugins and jobs for example. It might also contain static files used by plugins such as data files and scripts.

FILES

/etc/checkbox.d/checkbox.ini
    The base checkbox configuration file.

/etc/checkbox.d/checkbox-cli.ini
    The command-line configuration file.

/etc/checkbox.d/checkbox-urwid.ini
    The command-line configuration file (urwid version).

/etc/checkbox.d/checkbox-gtk.ini
    The GTK configuration file.

/etc/checkbox.d/checkbox-qt.ini
    The QT configuration file.

AUTHOR
checkbox and the accompanying tools are developed by Marc Tardif <marc.tardif@canonical.com>.