[PATCH v2 9/9] testsuite: Update testsuite qemu-related documentation

[Uladzimir Bely <ubely@ilbers.de>]

Added examples of avocado tests that run custom commands and scripts
under previously qemu image built.

Signed-off-by: Uladzimir Bely <ubely@ilbers.de>
---
 testsuite/README.md | 41 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 39 insertions(+), 2 deletions(-)

diff --git a/testsuite/README.md b/testsuite/README.md
index 4f2a8da8..50698da5 100644
--- a/testsuite/README.md
+++ b/testsuite/README.md
@@ -48,6 +48,43 @@ $ avocado run ../testsuite/citest.py -t startvm,fast -p time_to_wait=300
 $ avocado run ../testsuite/citest.py -t startvm,full -p time_to_wait=300
 ```
 
-# Other
+# Running qemu images
 
-There is a tool start_vm.py which is the replacement for the bash script in isar/scripts directory.
+## Manual running
+
+There is a tool `start_vm.py` which is the replacement for the bash script in
+`isar/scripts` directory. It can be used to run image previously built:
+
+```
+./start_vm.py -a amd64 -b /build -d bullseye -i isar-image-base
+```
+
+# Tests for running commands under qemu images
+
+Package `isar-image-ci` configures `ci` user with non-interactive SSH access
+to the machine. Image `isar-image-ci` preinstalls this package.
+
+Example of test that runs qemu image and executes remote command under it:
+
+```
+    def test_getty_target(self):
+        self.init()
+        self.vm_start('amd64','bookworm', \
+            image='isar-image-ci',
+            cmd='systemctl is-active getty.target')
+```
+
+To run something more complex than simple command, custom test script
+can be executed instead of command:
+
+```
+    def test_getty_target(self):
+        self.init()
+        self.vm_start('amd64','bookworm', \
+            image='isar-image-ci',
+            script='test_getty_target.sh')
+```
+
+The default location of custom scripts is `isar/testsuite/`. It can be changed
+by passing `-p test_script_dir="custom_path"` to `avocado run`
+arguments.
-- 
2.20.1