The following options are understood:
-p, --property=
When showing machine or image properties, limit the output to
certain properties as specified by the argument. If not
specified, all set properties are shown. The argument should
be a property name, such as "Name". If specified more than
once, all properties with the specified names are shown.
-a, --all
When showing machine or image properties, show all properties
regardless of whether they are set or not.
When listing VM or container images, do not suppress images
beginning in a dot character (".").
When cleaning VM or container images, remove all images, not
just hidden ones.
--value
When printing properties with show, only print the value, and
skip the property name and "=".
-l, --full
Do not ellipsize process tree entries or table. This implies
--max-addresses=full.
--kill-who=
When used with kill, choose which processes to kill. Must be
one of leader, or all to select whether to kill only the
leader process of the machine or all processes of the
machine. If omitted, defaults to all.
-s, --signal=
When used with kill, choose which signal to send to selected
processes. Must be one of the well-known signal specifiers
such as SIGTERM, SIGINT or SIGSTOP. If omitted, defaults to
SIGTERM.
The special value "help" will list the known values and the
program will exit immediately, and the special value "list"
will list known values along with the numerical signal
numbers and the program will exit immediately.
--uid=
When used with the shell command, chooses the user ID to open
the interactive shell session as. If the argument to the
shell command also specifies a user name, this option is
ignored. If the name is not specified in either way, "root"
will be used by default. Note that this switch is not
supported for the login command (see below).
-E NAME[=VALUE], --setenv=NAME[=VALUE]
When used with the shell command, sets an environment
variable for the executed shell. This option may be used more
than once to set multiple variables. When "=" and VALUE are
omitted, the value of the variable with the same name in the
program environment will be used.
Note that this option is not supported for the login command.
--mkdir
When used with bind, creates the destination file or
directory before applying the bind mount. Note that even
though the name of this option suggests that it is suitable
only for directories, this option also creates the
destination file node to mount over if the object to mount is
not a directory, but a regular file, device node, socket or
FIFO.
--read-only
When used with bind, creates a read-only bind mount.
When used with clone, import-raw or import-tar a read-only
container or VM image is created.
-n, --lines=
When used with status, controls the number of journal lines
to show, counting from the most recent ones. Takes a positive
integer argument. Defaults to 10.
-o, --output=
When used with status, controls the formatting of the journal
entries that are shown. For the available choices, see
journalctl(1). Defaults to "short".
--verify=
When downloading a container or VM image, specify whether the
image shall be verified before it is made available. Takes
one of "no", "checksum" and "signature". If "no", no
verification is done. If "checksum" is specified, the
download is checked for integrity after the transfer is
complete, but no signatures are verified. If "signature" is
specified, the checksum is verified and the image's signature
is checked against a local keyring of trustable vendors. It
is strongly recommended to set this option to "signature" if
the server and protocol support this. Defaults to
"signature".
--force
When downloading a container or VM image, and a local copy by
the specified local machine name already exists, delete it
first and replace it by the newly downloaded image.
--format=
When used with the export-tar or export-raw commands,
specifies the compression format to use for the resulting
file. Takes one of "uncompressed", "xz", "gzip", "bzip2". By
default, the format is determined automatically from the
image file name passed.
--max-addresses=
When used with the list-machines command, limits the number
of ip addresses output for every machine. Defaults to 1. All
addresses can be requested with "all" as argument to
--max-addresses=. If the argument to --max-addresses= is less
than the actual number of addresses, "..."follows the last
address.
-q, --quiet
Suppresses additional informational output while running.
-H, --host=
Execute the operation remotely. Specify a hostname, or a
username and hostname separated by "@", to connect to. The
hostname may optionally be suffixed by a port ssh is
listening on, separated by ":", and then a container name,
separated by "/", which connects directly to a specific
container on the specified host. This will use SSH to talk to
the remote machine manager instance. Container names may be
enumerated with machinectl -H HOST. Put IPv6 addresses in
brackets.
-M, --machine=
Connect to systemd-machined.service(8) running in a local
container, to perform the specified operation within the
container.
--no-pager
Do not pipe output into a pager.
--no-legend
Do not print the legend, i.e. column headers and the footer
with hints.
--no-ask-password
Do not query the user for authentication for privileged
operations.
-h, --help
Print a short help text and exit.
--version
Print a short version string and exit.
