avocado.utils.remote: Changes to the .run() method

Make the run() method to return a CmdResult object,
to make it symmetrical to the process.run() result.
Also, turn on logging of outputs for commands executed
on remote connections.

The reason why we want to do that is to increase the
debugging output we have for commands executed over
the fabric SSH connections. This way we can obtain
better, richer outputs in test logs that use our
fabric wrappers.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.test: Save whiteboard to a file in the results dir

For convenience, save the contents of the whiteboard
into a file 'whiteboard', inside the test results.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
docs: Document new save whiteboard convenience feature

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
selftests/functional: Add whiteboard creation test

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
selftests/unit: Add unittest for whiteboard save

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
Manpage: Update information regarding global filters and multiplexer.

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: Rudá Moura <rmoura@redhat.com>
avocado/utils/process.py: sync SubProcess and GDBSubProcess API

The init method on SubProcess got new parameters. Even if not
implemented in GDBSubProcess, those two ducks must quack alike.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
GDB: stdout support in avocado.utils.process API

Avocado's GDB support when using avocado.utils.process API
now properly populates the command result stdout attribute.

This now allows tests that run programs and check its output
(stdout only, not stderr) to work transparently under GDB.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
Merge pull request #232 from lmr/remote-changes-sprint14

avocado.utils.remote: Changes to the .run() method
Merge pull request #233 from ruda/manpage_multiplex_filters

Manpage: Update information regarding global filters and multiplexer.
Merge pull request #234 from clebergnu/gdb_basic_stdout

GDB stdout support