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=5efa3a542a5766570ba4dca973217eab343661fe;hb=18ead1b00dff180a97507d014325cb46198e6657;hpb=fbce11397f4d19821a9dfe66ee3ebe11cad90057 diff --git a/man/machinectl.xml b/man/machinectl.xml index 5efa3a542..2f2e2571f 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,19 @@ - - - - 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. - - - + + - Acquire privileges via - PolicyKit before executing the - operation. - + + + The following commands are understood: @@ -201,7 +166,7 @@ - status [ID...] + status ID... Show terse runtime status information about one or more @@ -214,7 +179,7 @@ - show [ID...] + show ID... Show properties of one or more registered virtual machines or @@ -238,18 +203,49 @@ - terminate [ID...] + 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. + - 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 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. - kill [ID...] + kill ID... Send a signal to one or more processes of the virtual @@ -262,6 +258,18 @@ to select the signal to send. + + + terminate 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. + + @@ -273,28 +281,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