[LTP] kirk breaking change

[Andrea Cervesato]

Hello all,

soon we are going to merge an important PR for kirk:
https://github.com/linux-test-project/kirk/pull/71 .

This PR will introduce the possibility to customize SUT interfaces
via plugin system, in a way that users might use multiple communication
channels to initialize, communicate and teardown the system under test.

A practical example might be:

- run a VM via shell commands
- communicate with VM via SSH or any other supported protocols
- when VM is crashing/freezing during a test, kirk will reboot the VM
  and continue with the next tests run

In the past we adopted workarounds, such as the "reset" command for
SSH, or the `--run-command` option, but they were not integrated with
the kirk API enough to provide a full support for kernel crash or other
corner cases. For this reason, we will support SUT custom
implementations which will permits to use multiple channels and avoid
any issues when complex scenarios are showing up.

This will come with a difference in the command line that will
eventually break CI(s) if you are using `master` branch (this is is NOT
a good practice, btw).

kirk executions which use the default behaviour (run on host) won't have
any issues:

	kirk --run-suite syscalls

But when a different communication protocol is used. For instance, SSH:

	kirk --run-suite syscalls \
	     --sut ssh:host=myhost.com:user=root:key_file=myhost_id_rsa

you will need to update command line into:

	kirk --run-suite syscalls \
	     --sut default:com=ssh \
	     --com ssh:host=myhost.com:user=root:key_file=myhost_id_rsa

This will tell to kirk: "use SSH communication channel with the default
internal SUT and execute the syscalls testing suite".

If you want to implement your own SUT communication, due to complex
testing scenarios, what you will need is to inherit SUT class and to
implement its methods. kirk will discover any custom implementation via
`--plugins` option.

The PR will come also with an updated documentation that will be
available at https://kirk.readthedocs.io/en/latest/


Kind regards,
-- 
Andrea Cervesato
SUSE QE Automation Engineer Linux
andrea.cervesato@suse.com