mirror of
https://github.com/cirruslabs/tart-guest-agent.git
synced 2026-09-30 03:41:55 +02:00
edi-oai
30203835e3
* Exec RPC: support "user[:group]" format with names or numeric IDs * Allow exec with unregistered UIDs when a group is specified * Ignore "nestif" linter error
Guest agent for Tart VMs
A guest agent for Tart VMS is a lightweight background service that runs inside the virtual machine and enables enhanced communication between the host and guest and other useful features, such as automatic disk resizing.
Currently implemented features:
- Automatic disk resizing for macOS VMs with recovery partition removed (
--resize-disk)- needs to be invoked as a launchd global daemon
- Clipboard sharing for macOS VMs using our in-house SPICE vdagent implementation (
--run-vdagent)- needs to be invoked as a launchd global agent
tart execsupport (--run-rpc)- it's recommended to invoke it as a launchd global agent because fewer privileges will be available to commands started via
tart exec - however, you can also invoke it as a launchd global daemon if running commands started via
tart execasrootis desired
- it's recommended to invoke it as a launchd global agent because fewer privileges will be available to commands started via
tart ip --resolver=agentsupport (--run-rpc)- allows resolving VM's IP address without relying on DHCP leases and/or an ARP table
To run all features appropriate for a given context, use component groups:
--run-daemon- implies
--resize-disk - example usage:
tart-guest-daemon.plist
- implies
--run-agent- implies
--run-vdagent --run-rpc - example usage:
tart-guest-agent.plist
- implies