[src/trunk]: src/share/man/man4 Exploit the fact that wizd is currently runni...

[pooka <pooka%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/44e979041d75
branches:  trunk
changeset: 758797:44e979041d75
user:      pooka <pooka%NetBSD.org@localhost>
date:      Mon Nov 15 21:52:47 2010 +0000

description:
Exploit the fact that wizd is currently running and add a manpage
for the rump virtif.

diffstat:

 share/man/man4/Makefile |   6 +-
 share/man/man4/virt.4   |  83 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 86 insertions(+), 3 deletions(-)

diffs (107 lines):

diff -r fedb7e21c5b0 -r 44e979041d75 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Mon Nov 15 21:39:53 2010 +0000
+++ b/share/man/man4/Makefile   Mon Nov 15 21:52:47 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.533 2010/11/13 00:47:24 jnemeth Exp $
+#      $NetBSD: Makefile,v 1.534 2010/11/15 21:52:47 pooka Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -59,8 +59,8 @@
        ti.4 tl.4 tlp.4 tlphy.4 \
        tp.4 tr.4 tra.4 trm.4 tty.4 tun.4 tqphy.4 twa.4 twe.4 txp.4 \
        uark.4 ubsec.4 udp.4 uep.4 ug.4 uha.4 uk.4 ukphy.4 unix.4 userconf.4 \
-       vald.4 veriexec.4 vga.4 vge.4 viaide.4 video.4 vlan.4 vmmon.4 vmnet.4 \
-       vnd.4 vr.4 \
+       vald.4 veriexec.4 vga.4 vge.4 viaide.4 video.4 virt.4 vlan.4 vmmon.4 \
+       vmnet.4 vnd.4 vr.4 \
        wapbl.4 wb.4 wbsio.4 wd.4 wdc.4 wi.4 wm.4 wpi.4 \
        wscons.4 wsdisplay.4 wsfont.4 wskbd.4 wsmouse.4 wsmux.4 \
        xbox.4 xge.4 \
diff -r fedb7e21c5b0 -r 44e979041d75 share/man/man4/virt.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/virt.4     Mon Nov 15 21:52:47 2010 +0000
@@ -0,0 +1,83 @@
+.\"    $NetBSD: virt.4,v 1.1 2010/11/15 21:52:47 pooka Exp $
+.\"
+.\" Copyright (c) 2010 Antti Kantee
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd November 15, 2010
+.Dt VIRT 4
+.Os
+.Sh NAME
+.Nm virt
+.Nd rump virtual network interface
+.Sh SYNOPSIS
+.In rump/rump.h
+.Ft int
+.Fo rump_pub_virtif_create
+.Fa "int num"
+.Fc
+.Sh DESCRIPTION
+The
+.Nm
+interface acts as a link between a rump virtual kernel and a host
+.Xr tap 4
+interface.
+Interface number <n> always corresponds with the host tap interface tap<n>.
+All data sent by
+.Nm
+is written into
+.Pa /dev/tap<n>
+and all data read from
+.Pa /dev/tap<n>
+is passed as Ethernet input to the rump virtual kernel.
+.Pp
+A
+.Nm
+interface can be created in two ways:
+.Bl -bullet
+.It
+Programmatically by calling
+.Fn rump_pub_virtif_create .
+.It
+Dynamically at runtime with
+.Xr ifconfig 8
+or equivalent using the
+.Em create
+command.
+.El
+.Pp
+Destroying a
+.Nm
+interface is possible only through
+.Xr ifconfig 8
+.Em destroy .
+.Pp
+The host's
+.Xr tap 4
+interface can be further bridged with hardware interfaces to provide
+full internet access to a rump kernel.
+.Sh SEE ALSO
+.Xr rump 3 ,
+.Xr bridge 4 ,
+.Xr tap 4 ,
+.Xr brconfig 8 ,
+.Xr ifconfig 8