systemd-machined

SYSTEMD-MACHINED.SERVICE(8) systemd-machined.service SYSTEMD-MACHINED.SERVICE(8)



NAME
       systemd-machined.service, systemd-machined - 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:

       •   Tools like ps(1) will show to which machine a specific process
           belongs in a column of its own, and so will gnome-system-monitor[1]
           or systemd-cgls(1).

       •   systemd's various tools (systemctl(1), journalctl(1), loginctl(1),
           hostnamectl(1), timedatectl(1), localectl(1), machinectl(1), ...)
           support the -M switch to operate on local containers instead of the
           host system.

       •   systemctl list-machines will show the system state of all local
           containers, connecting to the container's init system for that.

       •   systemctl's --recursive switch has the effect of not only showing the
           locally running services, but recursively showing the services of all
           registered containers.

       •   The machinectl command provides access to a number of useful
           operations on registered containers, such as introspecting them,
           rebooting, shutting them down, and getting a login prompt on them.

       •   The sd-bus(3) library exposes the sd_bus_open_system_machine(3) call
           to connect to the system bus of any registered container.

       •   The nss-mymachines(8) module makes sure all registered containers can
           be resolved via normal glibc gethostbyname(3) or getaddrinfo(3)
           calls.

       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




systemd 247                                          SYSTEMD-MACHINED.SERVICE(8)