From b999ee2ed730c85cfdb049096ef19b0cc3906f75 Mon Sep 17 00:00:00 2001
From: mlarkin <mlarkin@openbsd.org>
Date: Tue, 24 Sep 2024 19:34:01 +0000
Subject: [PATCH] vmd(8) manpage change for shutdown behaviour

Document the shutdown behaviour for vmd(8). Suggested via bugs@
via eric at mulh.net.

ok jmc@, bluhm@
---
 usr.sbin/vmd/vmd.8 | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/usr.sbin/vmd/vmd.8 b/usr.sbin/vmd/vmd.8
index 6818a2112c4..04dc8e688d1 100644
--- a/usr.sbin/vmd/vmd.8
+++ b/usr.sbin/vmd/vmd.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vmd.8,v 1.10 2022/01/05 17:39:25 jmc Exp $
+.\"	$OpenBSD: vmd.8,v 1.11 2024/09/24 19:34:01 mlarkin Exp $
 .\"
 .\" Copyright (c) 2015 Mike Larkin <mlarkin@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: January 5 2022 $
+.Dd $Mdocdate: September 24 2024 $
 .Dt VMD 8
 .Os
 .Sh NAME
@@ -63,6 +63,23 @@ such as stopping VMs, and retrieving information from
 .Xr vmm 4
 about running VMs.
 .Pp
+When the host machine is shut down,
+.Nm
+sends each running VM a shutdown request via the
+.Xr vmmci 4
+device.
+If the VM(s) are
+.Xr vmmci 4
+aware, this provides each VM the chance to shutdown cleanly in anticipation
+of host shutdown.
+During shutdown,
+.Nm
+will wait 30 seconds for the VM(s) to terminate cleanly before forcibly
+stopping them.
+This 30 second default can be changed by
+.Dq rcctl set vmd timeout n
+where 'n' is the desired timeout in seconds.
+.Pp
 The options are as follows:
 .Bl -tag -width Dssmacro=value
 .It Fl D Ar macro Ns = Ns Ar value
@@ -108,6 +125,7 @@ socket used for communication with
 .El
 .Sh SEE ALSO
 .Xr vmm 4 ,
+.Xr vmmci 4 ,
 .Xr vm.conf 5 ,
 .Xr rc.conf 8 ,
 .Xr vmctl 8
-- 
2.20.1