Merge pull request #47455 from apinnick/BZ2053705-force-vm-shutdown

BZ2053705: Force stop VM

Author: apinnick

modules/virt-virtctl-commands.adoc

@@ -38,11 +38,17 @@ The following table contains the `virtctl` commands used throughout the {VirtPro
 |Command |Description
 
 |`virtctl start <vm_name>`
-|Start a virtual machine. Optionally, start the virtual machine in a paused state by running `virtctl start --paused <vm_name>`. This enables you to interrupt the boot process from the VNC console.
+|Start a virtual machine.
+
+|`virtctl start --paused <vm_name>`
+|Start a virtual machine in a paused state. This option enables you to interrupt the boot process from the VNC console.
 
 |`virtctl stop <vm_name>`
 |Stop a virtual machine.
 
+|`virtctl stop <vm_name> --grace-period 0 --force`
+|Force stop a virtual machine. This option might cause data inconsistency or data loss.
+
 |`virtctl pause vm\|vmi <object_name>`
 |Pause a virtual machine or virtual machine instance. The machine state is kept
 in memory.
@@ -82,9 +88,6 @@ the specified port of the node.
 |`virtctl version`
 |Display the client and server version information.
 
-|`virtctl help`
-|Display a descriptive list of `virtctl` commands.
-
 |`virtctl fslist <vmi_name>`
 |Return a full list of file systems available on the guest machine.
 

virt/virtual_machines/virt-controlling-vm-states.adoc

@@ -8,11 +8,7 @@ toc::[]
 
 You can stop, start, restart, and unpause virtual machines from the web console.
 
-[NOTE]
-====
-To control virtual machines from the command-line interface (CLI), use the
-xref:../../virt/virt-using-the-cli-tools.html#virt-using-the-cli-tools[`virtctl` client].
-====
+You can use xref:../../virt/virt-using-the-cli-tools.html#virt-using-the-cli-tools[`virtctl`] to manage virtual machine states and perform other actions from the CLI. For example, you can use `virtctl` to force stop a VM or expose a port.
 
 include::modules/virt-starting-vm-web.adoc[leveloffset=+1]
 

virt/virtual_machines/virt-manage-vmis.adoc

@@ -6,11 +6,18 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-If you have standalone virtual machine instances (VMIs) that were created independently outside of the {VirtProductName} environment, you can manage them by using the web console or the command-line interface (CLI).
+If you have standalone virtual machine instances (VMIs) that were created independently outside of the {VirtProductName} environment, you can manage them by using the web console or by using `oc` or xref:../../virt/virt-using-the-cli-tools.html#virt-using-the-cli-tools[`virtctl`] commands from the command-line interface (CLI).
+
+The `virtctl` command provides more virtualization options than the `oc` command. For example, you can use `virtctl` to pause a VM or expose a port.
 
 include::modules/virt-about-vmis.adoc[leveloffset=+1]
+
 include::modules/virt-listing-vmis-cli.adoc[leveloffset=+1]
+
 include::modules/virt-listing-vmis-web.adoc[leveloffset=+1]
+
 include::modules/virt-editing-vmis-web.adoc[leveloffset=+1]
+
 include::modules/virt-deleting-vmis-cli.adoc[leveloffset=+1]
+
 include::modules/virt-deleting-vmis-web.adoc[leveloffset=+1]