systemd-machined.service - Man Page

Virtual machine and container registration manager

Synopsis

systemd-machined.service

/usr/lib/systemd/systemd-machined

Description

systemd-machined is a system service that keeps track of locally running virtual machines and containers.

systemd-machined is useful for registering and keeping track of both OS containers (containers that share the host kernel but run a full init system of their own and behave in most regards like a full virtual operating system rather than just one virtualized app) and full virtual machines (virtualized hardware running normal operating systems and possibly different kernels).

systemd-machined should not be used for registering/keeping track of application sandbox containers. A machine in the context of systemd-machined is supposed to be an abstract term covering both OS containers and full virtual machines, but not application sandboxes.

Machines registered with machined are exposed in various ways in the system. For example:

See systemd-nspawn(1) for some examples on how to run containers with OS tools.

If you are interested in writing a VM or container manager that makes use of machined, please have look at Writing Virtual Machine or Container Managers[2]. Also see the New Control Group Interfaces[3].

The daemon provides both a C library interface (which is shared with systemd-logind.service(8)) as well as a D-Bus interface. The library interface may be used to introspect and watch the state of virtual machines/containers. The bus interface provides the same but in addition may also be used to register or terminate machines. For more information please consult sd-login(3) and org.freedesktop.machine1(5). and org.freedesktop.LogControl1(5)

A small companion daemon systemd-importd.service(8) is also available, which implements importing, exporting, and downloading of container and VM images.

For each container registered with systemd-machined.service that employs user namespacing, users/groups are synthesized for the used UIDs/GIDs. These are made available to the system using the User/Group Record Lookup API via Varlink[4], and thus may be resolved with userdbctl(1) or the usual glibc NSS calls.

See Also

systemd(1), machinectl(1), systemd-nspawn(1), nss-mymachines(8), systemd.special(7)

Notes

  1. gnome-system-monitor
    https://help.gnome.org/users/gnome-system-monitor/
  2. Writing Virtual Machine or Container Managers
    https://www.freedesktop.org/wiki/Software/systemd/writing-vm-managers
  3. New Control Group Interfaces
    https://www.freedesktop.org/wiki/Software/systemd/ControlGroupInterface/
  4. User/Group Record Lookup API via Varlink
    https://systemd.io/USER_GROUP_API

Referenced By

busctl(1), machinectl(1), nss-mymachines(8), nss-systemd(8), org.freedesktop.import1(5), org.freedesktop.machine1(5), sd_bus_default(3), sd_bus_set_address(3), sd_machine_get_class(3), sd_pid_get_owner_uid(3), systemd.directives(7), systemd-importd.service(8), systemd.index(7), systemd-nspawn(1), systemd.slice(5), userdbctl(1).

The man page systemd-machined(8) is an alias of systemd-machined.service(8).

systemd 246