Use command line --config to read a custom configuration from a file.
Note this option is for the avocado application, so it has
effect for all subcommands.

Example:

$ avocado --config /var/tmp/avocado.conf config
Config files read (in order):
/home/rmoura/Work/avocado/etc/avocado/avocado.conf
/home/rmoura/Work/avocado/etc/avocado/conf.d/gdb.conf
/var/tmp/avocado.conf
...

Also, update man-page about the new option --config.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

The default UI has changed a bit, so let's update the documentation to
match it.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Those are not necessary in the avocado options and can
safely stay as a config file only option.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Remove another seldomly used option, --job-log-level, and
move the opportunity to set the value to the config file.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Add command line `--job-results-dir` to the Avocado runner, so we can
store the job results in a different directory than the one
configured.

Remove `--logdir` from the main avocado application,
this option is obsolete and actually it was not working.

Update the manual page regarding this change.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

From the current command line `--disable-output-check` replace it
with the new command line `--output-check {on,off}`, defaults to `on`.

Use `--output-check=off` to behave like ``--disable-output-check`.

Also, validate the value from command line `--output-check-record`.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Some typos found during automated inspection of the code.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Add support to inspect and find tests inside a directory, recursively,
by using the method `discover_url`. It takes a url (path) and
returns the tests parameters it discovers.

The loader object has the .discover() method, that can be used
to inspect the location, and the .validate() method, that will
discover any problems on the user's input.

We are also changing the behavior of avocado to error out on
invalid inputs (missing paths or files that are not avocado
tests). Therefore, the concept of MISSING or NOT_A_TEST both
disappear from the UI. Unittests were updated to reflect the
new status quo.
Signed-off-by: NRudá Moura <rmoura@redhat.com>
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Implement runner command line option `--sysinfo` to turn on or off
any reports created and related to the execution of sysinfo, like
profilers, command lines utilities and other hardware logs. Default: on.

Example: avocado run --sysinfo=off passtest

There is a new configuration options inside [sysinfo.collect]
named "enabled" which will turn the feature on and off too.
It accepts a boolean value and the default is to enable sysinfo.

The command line option overwrites the configuration value.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Minor improvement to the initial description in the man page
and update links to point to the (new) project page everywhere.
Signed-off-by: NAdemar de Souza Reis Jr <areis@redhat.com>

Avocado itself is released under GPLv2 (explicit version), but most of the code
is currently licensed under GPLv2+, so make that clear in the documentation.
Signed-off-by: NAdemar de Souza Reis Jr <areis@redhat.com>

As a subcommand (option, really) of the plugin command. The generated
distro file is supposed to be portable and be named canonically based
on the name, version, release and arch.

Changes from v0:
 * Return proper exit status when required command line arguments are
   missing
Signed-off-by: NCleber Rosa <crosa@redhat.com>

At this stage, the distro plugin is very simplistic and prints the
detected distribution of the current machine. One could algue that
this is rather useless, but, with the component isolation work this
command is going to be helpful for troubleshooting purposes.

Also, this plugin is a placeholder where other functionality will
live, including (but not limited to):

 * the ability to create "distro definition" files, akin to
   autotest's autotest-distro-def-create.
 * the ability to view "distro definition" files, akin to
   autotest's autotest-distro-def-view.
 * the ability to download "distro definition" files from a
   repository
 * (maybe) the ability to push a distro definition file to
   avocado-server. This may be delegated to a full blown REST
   client though.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Instead of leaving our own users in doc references, replace
/home/$USER to simply $HOME.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

As discussed in the Trello card

https://trello.com/c/WsDMg7RP/161-initial-support-for-avocado-config-files-server-and-client

Move settings.ini to avocado.conf. The basic idea is
that the name is more intuitive.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Due the concept of "drop-in" tests didn't match the actual
purpose of running any script or binary as a test in Avocado, we're
going to use the term "simple test" (defined in SimpleTest class)
to contrast with "native test", which are Python modules that
uses Avocado's API.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

This patch adds support for multiple yaml files by merging the values
together. Merge overrides the nodes value and appends missing children
iteratively. It's deterministic AND order dependant (yaml1 yaml2 migh
not provide the same results as yaml2 yaml1!).
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

Add documentation manual page part for the command line
feature `--wrapper`.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Developers using Avocado's GDB support may also need to use their custom
build of gdbserver.

This implements the same logic and options as the previous commit does
for the GDB binary, including API level changes.

Changes from v1:
   * use `avocado.utils.process.find_command` as the first default
     location for the gdbserver binary, falling back to the hard coded
     default of `/usr/bin/gdbserver` if that fails.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Developers using Avocado's GDB support may need to use their custom
build of GDB, or simply their system has GDB at a different location.
So, allow users to optionally specify the path to the GDB binary.

Also, allow GDB API users to pass extra options to GDB via the command
line.

Changes from v1:
   * use `avocado.utils.process.find_command` as the first default
     location for the gdb binary, falling back to the hard coded
     default of `/usr/bin/gdb` if that fails.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

This feature allows custom GDB commands to be executed before the
actual binary is run. What it can do then, is only limited by the
user's goals.

This is intended to allow complex applications, such as QEMU,
to be debugged inside Avocado tests. Configuring GDB for QEMU,
for example, involves passing signals to the application that
would otherwise result in an event that would stop the debugger.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Introduce the documentation regarding the new remote plugin.
Include information about using the remote plugin in the manual page.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Update the manual page of avocado to match the current status of the multiplexer,
regarding command line options for global filters.

Fix information on command line option -c | --content. It's about variables.

Plus:  cosmetic fixes around.
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

And not the (original) author of the man page.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Such as the ability to run any number of applications inside the
debugger transparently.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

This syncs the manpage with the latest changes of command line options
and plugins (for example, the new multiplex).
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Update documentation regarding the last update on argument parsing.
Like option --silent goes to run subcommand and there's no
need to quote for multiples test names.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

This page is intended as a basic offline aid for new users of avocado.
Signed-off-by: NCleber Rosa <crosa@redhat.com>