machinectl.xml revision ac92ced5bb41def1d90f871d6c8cfec2b03c0c7d
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
681eb9cf2b831293a4f3d4c48a748d2e4a25d69eFilipe Brandenburger "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
681eb9cf2b831293a4f3d4c48a748d2e4a25d69eFilipe Brandenburger This file is part of systemd.
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering Copyright 2013 Zbigniew Jędrzejewski-Szmek
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering systemd is free software; you can redistribute it and/or modify it
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek under the terms of the GNU Lesser General Public License as published by
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering the Free Software Foundation; either version 2.1 of the License, or
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek (at your option) any later version.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek systemd is distributed in the hope that it will be useful, but
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek WITHOUT ANY WARRANTY; without even the implied warranty of
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek Lesser General Public License for more details.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek You should have received a copy of the GNU Lesser General Public License
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek along with systemd; If not, see <http://www.gnu.org/licenses/>.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek<refentry id="machinectl" conditional='ENABLE_MACHINED'
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering xmlns:xi="http://www.w3.org/2001/XInclude">
48f69d8fb4d0cf34d578352572c96d86e13caa79Lennart Poettering <refentryinfo>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </authorgroup>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </refentryinfo>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <refentrytitle>machinectl</refentrytitle>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <refpurpose>Control the systemd machine manager</refpurpose>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <refsynopsisdiv>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <arg choice="opt" rep="repeat">OPTIONS</arg>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <arg choice="opt" rep="repeat">NAME</arg>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </cmdsynopsis>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </refsynopsisdiv>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <para><command>machinectl</command> may be used to introspect and
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering control the state of the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering virtual machine and container registration manager
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <citerefentry><refentrytitle>systemd-machined.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <para>The following options are understood:</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <variablelist>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--property=</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When showing machine or image properties,
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering limit the output to certain properties as specified by the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering argument. If not specified, all set properties are shown. The
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering argument should be a property name, such as
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <literal>Name</literal>. If specified more than once, all
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering properties with the specified names are
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
b8bde11658366290521e3d03316378b482600323Jan Engelhardt <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When showing machine or image properties, show
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering all properties regardless of whether they are set or
b8bde11658366290521e3d03316378b482600323Jan Engelhardt <para>When listing VM or container images, do not suppress
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering images beginning in a dot character
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering (<literal>.</literal>).</para></listitem>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>Do not ellipsize process tree entries.</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
dca348bcbb462305864526c587495a14a76bfcdeJan Engelhardt <term><option>--no-ask-password</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>Do not query the user for authentication for
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--kill-who=</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When used with <command>kill</command>, choose
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering which processes to kill. Must be one of
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <option>leader</option>, or <option>all</option> to select
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering whether to kill only the leader process of the machine or all
b8bde11658366290521e3d03316378b482600323Jan Engelhardt processes of the machine. If omitted, defaults to
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <term><option>-s</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When used with <command>kill</command>, choose
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering which signal to send to selected processes. Must be one of the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering well-known signal specifiers, such as
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <constant>SIGTERM</constant>, <constant>SIGINT</constant> or
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <constant>SIGSTOP</constant>. If omitted, defaults to
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <constant>SIGTERM</constant>.</para></listitem>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When used with <command>bind</command> creates
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering the destination directory before applying the bind
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--read-only</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>When used with <command>bind</command> applies
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering a read-only bind mount.</para></listitem>
<citerefentry><refentrytitle>systemd-machined.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>-compatible
<term><command>bind</command> <replaceable>NAME</replaceable> <replaceable>PATH</replaceable> [<replaceable>PATH</replaceable>]</term>
<term><command>copy-to</command> <replaceable>NAME</replaceable> <replaceable>PATH</replaceable> [<replaceable>PATH</replaceable>]</term>
<term><command>copy-from</command> <replaceable>NAME</replaceable> <replaceable>PATH</replaceable> [<replaceable>PATH</replaceable>]</term>
<term><command>clone</command> <replaceable>NAME</replaceable> <replaceable>NAME</replaceable></term>
<term><command>rename</command> <replaceable>NAME</replaceable> <replaceable>NAME</replaceable></term>
<term><command>read-only</command> <replaceable>NAME</replaceable> [<replaceable>BOOL</replaceable>]</term>
<term><command>pull-tar</command> <replaceable>URL</replaceable> [<replaceable>NAME</replaceable>]</term>
is done via SHA256SUMS and SHA256SUMS.gpg files, that need to
<term><command>pull-raw</command> <replaceable>URL</replaceable> [<replaceable>NAME</replaceable>]</term>
<term><command>pull-dkr</command> <replaceable>REMOTE</replaceable> [<replaceable>NAME</replaceable>]</term>
<programlisting># machinectl pull-tar https://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-root.tar.gz
<programlisting># machinectl pull-raw --verify=no http://ftp.halifax.rwth-aachen.de/fedora/linux/releases/21/Cloud/Images/x86_64/Fedora-Cloud-Base-20141203-21.x86_64.raw.xz
<citerefentry><refentrytitle>systemd-machined.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,