X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fmachinectl.xml;h=ca4d52b8135c3b981d5ddf6a5c072a7ae0392541;hp=8a96d423b9602e1c98d4753d9e965bfbcea222b6;hb=773e264d13cac53cbf7e0b174e1883dabb4c9bc2;hpb=7b870f607bcb8f445d4d29a776d12d9de3bf1487 diff --git a/man/machinectl.xml b/man/machinectl.xml index 8a96d423b..ca4d52b81 100644 --- a/man/machinectl.xml +++ b/man/machinectl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + machinectl @@ -86,12 +87,48 @@ 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. + + When showing - session/user properties, limit the + machine properties, limit the output to certain properties as specified by the argument. If not specified, all set properties are @@ -108,7 +145,7 @@ When showing - unit/job/manager properties, show all + machine properties, show all properties regardless of whether they are set or not. @@ -117,37 +154,22 @@ - 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-session, + kill, choose which processes to kill. Must be one of , or to select whether to kill only the leader process of the - session or all processes of the - session. If omitted, defaults to + machine or all processes of the + machine. If omitted, defaults to . @@ -156,11 +178,10 @@ When used with - kill-session or - kill-user, choose + kill, choose which signal to send to selected - processes. Must be one of the well-known - signal specifiers, such as + processes. Must be one of the + well-known signal specifiers, such as SIGTERM, SIGINT or SIGSTOP. If @@ -168,26 +189,6 @@ SIGTERM. - - - - - 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. - - - - - - - Acquire privileges via - PolicyKit before executing the - operation. - The following commands are understood: @@ -202,7 +203,7 @@ - status [ID...] + status ID... Show terse runtime status information about one or more @@ -215,7 +216,7 @@ - show [ID...] + show ID... Show properties of one or more registered virtual machines or @@ -239,7 +240,7 @@ - terminate [ID...] + terminate ID... Terminates a virtual machine or container. This kills all @@ -250,7 +251,7 @@ - kill [ID...] + kill ID... Send a signal to one or more processes of the virtual @@ -263,6 +264,31 @@ to select the signal to send. + + + 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. + + + + 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. + @@ -274,27 +300,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-nspawn1, + systemd.special7