Distribution Checker Command Line Options
From ISP_RAS
Usage:
/opt/{lsb,moblin}/test/manager/utils/dist-checker.pl [OPTIONS] TESTS
Runs one or more of tests and produces a HTML report.
Examples:
Run a set of tests:
./dist-checker.pl -D -s 'LSB 4.0' cmdchk libchk
Run all automated certification tests from snaphots:
./dist-checker.pl -v2 -D -s 'LSB 4.0' -S 'snapshot' all
Options:
| -a,--arch <architecture> | Specify machine architecture manually.
Normally, the machine architecture is detected automatically. See --list for a list of supported architectures. If the platform architecture isn't detected or detected wrong but is listed as supported, please report to developers. |
| --cert | Get through certification process. |
| --check-only | Do some checks and exit. It may be useful to run dist-checker.pl with this option before running the tests to make sure all prerequisites are met. When runned with this option, a directory for logs and test results isn’t created. |
| --comment '<text>' | Any comments for this test run. |
| -D, --download | Allow downloading needed packages from the Internet.
Additional parameters are prefered download tool (‘curl’ or ‘wget’) and prefered transfer protocol (‘http’ or ‘ftp’), comma separated. For example, if you specify ‘-Dwget,ftp’, wget will be used for downloading and FTP protocol will be prefered to HTTP when possible. If unavailable, the alternative variant will be used. |
| --force-reinstall | Always reinstall packages.
By default Distribution Checker don’t reinstall already installed packages. |
| -h, --help | Show this help and exit. |
| -I,--ignore-unavailable | Ignore unknown and unavailable tests.
Normally, Distribution Checker will fail with an error message if a test name isn’t in the list of supported tests. |
| --list | Show a list of supported architectures, standards and testsuited. |
| -M, --mail-to <e-mail> | Send the results to the e-mail address given. |
| --not-run | Do some initialization, then exit (for debug). |
| -m,--package-manager <name> | Specify package manager manually. Supported are ‘rpm’ and ‘dpkg’.
Normally, the package manager is detected automatically. If it is not detected or detected wrong, please report to developers. |
| --post-cmd '<cmd>' | Run ‘cmd .../results.tgz’ where cmd command is specified by user. Use it for any purpose you wish. It may be uploading results to a remote server, or whatever else.
It is a good idea to write all actions down to a script file, then put this script as a parameter. Don’t forget to make the script executable and specify it with a full path. |
| -f,--profile <file> | Take settings from user profile <file>. See Distribution Checker Profile Syntax. |
| --report <result dir> | Build report for results in directoty <result dir>. |
| -s,--standard 'LSB 4.0' | Standard version to test against.
The standard version is automatically detected via the lsb_release command. See --list for a list of supported standards. You should usually quote parameter like ’LSB 4.0’ when it contains space. But for convenience spaces in standard name may be omitted: -s LSB4.0. |
| -S,--status <status> | Choose tests with this status. For example, status may be ’beta’ or ’snapshot’. The default is ’cert’. |
| -p,--std-profile <prof> | Use standard profile (e.g. ’core,c++’). This option limits set of tests.
Standard profiles are specific for each standard. See --list for information about what profiles are attributed to each test. |
| -r,--testrun-id <name> | Use <name> for subdirectory name in the results directory (/var/opt/{lsb,moblin}/test/manager/results). If not specified, this name is generated automatically basing on host name, architecture, current date and time. |
| --update | Download the latest test list (Manifest), problem database and test modules from server. |
| -v[0-3] | Set verbosity level: 0 - quiet, 1 - normal, 2 - verbose, 3 - debug.
Verbosity level affects console output and file <result_dir>/log. Regardless of the selected verbosity level, a verbose log is always available as <result_dir>/verbose_log. |
Proxy Settings:
| -x,--proxy [user:password@]host:port[,auth][,notunnel] | Setup proxy for both FTP and HTTP.
auth - authentication method. See ‘man curl’ for details. |
| --ftp-proxy ... | Setup proxy for FTP protocol. Parameters are the same as for --proxy. |
| --http-proxy ... | Setup proxy for HTTP protocol. Parameters are the same as for --proxy. |
| --no-proxy | Don’t use proxy at all. Additionaly, reset some proxy-related environment variables that influence wget and curl:
http_proxy, ftp_proxy, HTTP_PROXY, FTP_PROXY, HTTPS_PROXY, ALL_PROXY. |