X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fmachinectl.xml;h=2f2e2571f597fec5ad62f3bc4008b9f25fda77c5;hp=2e7fa3bf8d4892e537e401d087d51a0fb1429b3c;hb=14f27b4e3b009d10bb9a3b43b74585c73a7c7626;hpb=f366d58dc1fe51b300167446597750d29687c3c5 diff --git a/man/machinectl.xml b/man/machinectl.xml index 2e7fa3bf8..2f2e2571f 100644 --- a/man/machinectl.xml +++ b/man/machinectl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + machinectl @@ -71,57 +72,6 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - - - - - - Do not pipe output into a - pager. - - - - - - Do not query the user - for authentication for privileged - operations. - - - - - - - Execute the 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. - - - - - - - Execute the operation on a - local container. Specify a container - name to connect to. - - @@ -162,7 +112,7 @@ When used with - kill-machine, + kill, choose which processes to kill. Must be one of , or to select whether @@ -177,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 @@ -188,6 +138,20 @@ SIGTERM. + + + + Do not print the legend, + i.e. the column headers and the + footer. + + + + + + + + The following commands are understood: @@ -239,14 +203,45 @@ - terminate ID... + login ID - Terminates a virtual - machine or container. This kills all - processes of the virtual machine or - container and deallocates all - resources attached to that - instance. + 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. + + + + reboot ID... + + 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 ID... + + 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. @@ -265,29 +260,16 @@ - reboot ID... + terminate ID... - 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. + Terminates a virtual + machine or container. This kills all + processes of the virtual machine or + container and deallocates all + resources attached to that + instance. - - login ID - - 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. - @@ -299,25 +281,7 @@ 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 - . - $SYSTEMD_LESS - $SYSTEMD_LESS overrides the - default options passed to less - (FRSXMK). - - - + See Also