Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2024-10-01 01:25:40 -04:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'pwmarcz-vmexec'

Browse Source
This commit is contained in:
Andrew David Wong 2020-01-26 08:07:30 -06:00
commit fbdbd16fd6
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
developer/debugging/vm-interface.md
View File

@ -193,6 +193,18 @@ Other Qrexec services installed by default:
can send icon for the same window multiple times to replace previous one (for can send icon for the same window multiple times to replace previous one (for
example for animated icons) example for animated icons)
- `qubes.VMShell` - call any command in the VM; the command(s) is passed one per line - `qubes.VMShell` - call any command in the VM; the command(s) is passed one per line
- `qubes.VMShell+WaitForSession` waits for full VM startup first
- `qubes.VMExec` - call any command in the VM, without using shell, the command
needs to be passed as argument and encoded as follows:
- the executable name and arguments are separated by `+`
- everything except alphanumeric characters, `.` and `_` needs to be
escaped
- bytes are escaped as `-HH` (where `HH` is hex code, capital letters only)
- `-` itself can be escaped as `--`
- example: to run `ls -a /home/user`, use
`qubes.VMExec+ls+--a+-2Fhome-2Fuser`
- `qubes.VMExecGUI` - a variant of `qubes.VMExec` that waits for full VM
startup first
Currently Qubes still calls few tools in VM directly, not using service Currently Qubes still calls few tools in VM directly, not using service
abstraction. This will change in the future. Those tools are: abstraction. This will change in the future. Those tools are: