graphics: add ghaf-open command to launch applications

[humaidq-tii]

This allows the user/tester to view and launch applications from the terminal, locally or remotely. It will also show the output of the launched application.

This works with applications inside or outside app VMs.

Description of changes

• Add ghaf-open command
• Command lists available applications (launchers) when no or invalid argument is given
• Arguments can be passed to the application

Checklist for things done

• [x] Summary of the proposed changes in the PR description
• [x] More detailed description in the commit message(s)
• [x] Commits are squashed into relevant entities - avoid a lot of minimal dev time commits in the PR
• [x] Contribution guidelines followed
• [ ] Ghaf documentation updated with the commit - https://tiiuae.github.io/ghaf/
• [ ] PR linked to architecture documentation and requirement(s) (ticket id)
• [x] Test procedure described (or includes tests). Select one or more:
  • [x] Tested on Lenovo X1 x86_64
  • [x] Tested on Jetson Orin NX or AGX aarch64
  • [ ] Tested on Polarfire riscv64
• [x] Author has run nix flake check --accept-flake-config and it passes
• [ ] All automatic Github Action checks pass - see actions
• [ ] Author has added reviewers and removed PR draft status

Testing

• Run the command with no argument, should list applications.
• Run the command with a valid application, should launch.
  • Applications should all be launchable just like clicking on it.
  • Any application that has an output, will be displayed in standard output.
  • Arguments are passed to the application (typically works well only for local applications).
  • Command should work remotely over ssh, GUIs should appear properly on the device.
• Should work on both X1 carbon and Orin.
  • On X1 carbon the command is available in gui-vm.
  • On Orin the command is available in ghaf-host.

This can be used in ci-automations, the command will exit code 1 if application name is not available on the system.

[barnabakos]

2 commits up to: 7af1b39225894307752560638d9c82aebf097318 rebased to current tip of Ghaf main without conflicts: 9d1a8faa23b11d9cc2ef15da01d9e6d2938fcb07

platforms: Lenovo X1 Carbon & NVIDIA Jetson AGX Orin; cross-compile; flash script

• ci-test-automation suite: ok
• starting apps: ok
• regression / ad-hoc testing: ok

works:

• list applications
• open app; also with arguments
• open apps over ssh; also with arguments
• app output shown

notes:

• running "ghaf-open" without arguments have exit code 1 possibly it should not be handled as an error

issues on Lenovo X1 Carbon:

• first start & close of the "VPN" app doesn't exit the ghaf-open command; same after every boot

[humaidq-tii]

• running "ghaf-open" without arguments have exit code 1 possibly it should not be handled as an error

application is a mandatory argument, and typically if a mandatory argument is not provided it should exit with error. I have added a -l option to list applications that does not have exit code 1. It only lists available applications, so it should also be easier to be used as part of a script/automation.

issues on Lenovo X1 Carbon:

• first start & close of the "VPN" app doesn't exit the ghaf-open command; same after every boot

This is behaviour of the VPN app, the first run seems to execute gpclient. This behaviour may change with #695 as gpclient will be setup as a separate service. We can consider this not a bug in this ghaf-open, as it simply runs the launcher entry.