Module Name: src
Committed By: pooka
Date: Mon Nov 15 21:52:47 UTC 2010
Modified Files:
src/share/man/man4: Makefile
Added Files:
src/share/man/man4: virt.4
Log Message:
Exploit the fact that wizd is currently running and add a manpage
for the rump virtif.
To generate a diff of this commit:
cvs rdiff -u -r1.533 -r1.534 src/share/man/man4/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man4/virt.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/Makefile
diff -u src/share/man/man4/Makefile:1.533 src/share/man/man4/Makefile:1.534
--- src/share/man/man4/Makefile:1.533 Sat Nov 13 00:47:24 2010
+++ src/share/man/man4/Makefile Mon Nov 15 21:52:47 2010
@@ -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 \
Added files:
Index: src/share/man/man4/virt.4
diff -u /dev/null src/share/man/man4/virt.4:1.1
--- /dev/null Mon Nov 15 21:52:47 2010
+++ src/share/man/man4/virt.4 Mon Nov 15 21:52:47 2010
@@ -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
