Detail how VM guests acquire a nameserver for local interfaces.

OK mlarkin@, krw@. Thanks!

1 files changed, 13 insertions, 4 deletions

diff --git a/usr.sbin/vmctl/vmctl.8 b/usr.sbin/vmctl/vmctl.8
index 9487ad3aba6..b66eddeae84 100644
--- a/usr.sbin/vmctl/vmctl.8
+++ b/usr.sbin/vmctl/vmctl.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vmctl.8,v 1.33 2017/09/01 03:37:35 mlarkin Exp $
+.\"	$OpenBSD: vmctl.8,v 1.34 2017/09/05 22:06:49 edd 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: September 1 2017 $
+.Dd $Mdocdate: September 5 2017 $
 .Dt VMCTL 8
 .Os
 .Sh NAME
@@ -212,9 +212,9 @@ any other interfaces specified with the -i option (thus, local interfaces,
 if requested, are numbered starting at vio0 inside the guest VM).
 .Pp
 When using local interfaces, the DHCP configuration offered to the guest VM
-specifies a default route to the corresponding host
+specifies the address of the corresponding host
 .Xr tap 4
-interface.
+interface as both the default route and the (sole) nameserver.
 Guest VM traffic can optionally be NATed through the host
 with an entry in the host machine's
 .Pa /etc/pf.conf
@@ -224,6 +224,15 @@ pass out on $ext_if from 100.64.0.0/10 to any nat-to $ext_if
 .Ed
 .Pp
 If NATing is desired, the net.inet.ip.forwarding sysctl must also be set to 1.
+.Pp
+If desired, DNS queries originating from Guest VMs can be redirected to a
+different DNS server with an entry in the host machine's
+.Pa /etc/pf.conf
+similar to the following:
+.Bd -literal -offset indent
+pass in proto udp from 100.64.0.0/10 to any port domain \e
+      rdr-to $dns_server port domain
+.Ed
 .Sh FILES
 .Bl -tag -width "/etc/var/run/vmd.sockXX" -compact
 .It Pa /etc/vm.conf