X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fmachinectl.xml;h=eef1740f95eb37243cbd22371d25b0b06d7f84b8;hb=13790add4bf648fed816361794d8277a75253410;hp=37fefeadc8123f55aae1221a63a00297e7d6058b;hpb=f7f74d8ec46532f13a1dc418d550eaf76b339fa3;p=elogind.git diff --git a/man/machinectl.xml b/man/machinectl.xml index 37fefeadc..eef1740f9 100644 --- a/man/machinectl.xml +++ b/man/machinectl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + machinectl @@ -71,21 +72,6 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - - @@ -117,31 +103,16 @@ - Do not ellipsize cgroup - members. + Do not ellipsize + process tree entries. - - - - Do not pipe output into a - pager. - - - - - - Do not query the user - for authentication for privileged - operations. - - When used with - kill-machine, + kill, choose which processes to kill. Must be one of , or to select whether @@ -156,7 +127,7 @@ When used with - kill-machine choose + kill, choose which signal to send to selected processes. Must be one of the well-known signal specifiers, such as @@ -168,25 +139,38 @@ - - - - Execute operation - remotely. Specify a hostname, or - username and hostname separated by @, - to connect to. This will use SSH to - talk to the remote machine manager - instance. + + + Do not print the legend, + i.e. the column headers and the + footer. + + + + + + When used with + bind creates the + destination directory before applying + the bind mount. + - - + - Acquire privileges via - PolicyKit before executing the - operation. + When used with + bind applies a + read-only bind + mount. + + + + + + + The following commands are understood: @@ -201,7 +185,7 @@ - status [ID...] + status NAME... Show terse runtime status information about one or more @@ -214,14 +198,14 @@ - show [ID...] + show NAME... Show properties of one or more registered virtual machines or containers or the manager itself. If no argument is specified, properties of the manager will be shown. If an - ID is specified, properties of this + NAME is specified, properties of this virtual machine or container are shown. By default, empty properties are suppressed. Use @@ -238,18 +222,49 @@ - terminate [ID...] + login NAME + + Open a terminal login + session to a container. This will + create a TTY connection to a specific + container and asks for the execution of a + getty on it. Note that this is only + supported for containers running + systemd1 + as init system. + - Terminates a virtual - machine or container. This kills all - processes of the virtual machine or - container and deallocates all - resources attached to that - instance. + + reboot NAME... + + Reboot one or more + containers. This will trigger a reboot + by sending SIGINT to the container's + init process, which is roughly + equivalent to pressing Ctrl+Alt+Del on + a non-containerized system, and is + compatible with containers running any + init system. + + + + poweroff NAME... + + Power off one or more + containers. This will trigger a reboot + by sending SIGRTMIN+4 to the + container's init process, which causes + systemd-compatible init systems to + shut down cleanly. This operation does + not work on containers that do not run + a + systemd1-compatible + init system, such as + sysvinit. - kill [ID...] + kill NAME... Send a signal to one or more processes of the virtual @@ -262,6 +277,70 @@ to select the signal to send. + + + terminate NAME... + + Terminates a virtual + machine or container. This kills all + processes of the virtual machine or + container and deallocates all + resources attached to that + instance. + + + + bind NAME PATH [PATH] + + Bind mounts a + directory from the host into the + specified container. The first + directory argument is the source + directory on the host, the second + directory argument the source + directory on the host. When the latter + is omitted the destination path in the + container is the same as the source + path on the host. When combined with + the + switch a ready-only bind mount is + created. When combined with the + switch the + destination path is first created + before the mount is applied. Note that + this option is currently only + supported for + systemd-nspawn1 + containers. + + + + copy-to NAME PATH [PATH] + + Copies files or + directories from the host system into + a running container. Takes a container + name, followed by the source path on + the host and the destination path in + the container. If the destination path + is omitted the same as the source path + is used. + + + + + copy-from NAME PATH [PATH] + + Copies files or + directories from a container into the + host system. Takes a container name, + followed by the source path in the + container the destination path on the + host. If the destination path is + omitted the same as the source path is + used. + + @@ -273,28 +352,14 @@ code otherwise. - - Environment - - - - $SYSTEMD_PAGER - Pager to use when - is not given; - overrides $PAGER. Setting - this to an empty string or the value - cat is equivalent to passing - . - - - + See Also systemd-machined.service8, - systemd-logind.service8, - systemd.special7. + systemd-nspawn1, + systemd.special7