xref: /netbsd-src/share/man/man4/virt.4 (revision bc38e874412ecb00e47fdbfd62f388e3546b99b4)
1*bc38e874Spooka.\"	$NetBSD: virt.4,v 1.3 2013/07/03 19:21:12 pooka Exp $
2ab1e35f3Spooka.\"
3ab1e35f3Spooka.\" Copyright (c) 2010 Antti Kantee
4ab1e35f3Spooka.\" All rights reserved.
5ab1e35f3Spooka.\"
6ab1e35f3Spooka.\" Redistribution and use in source and binary forms, with or without
7ab1e35f3Spooka.\" modification, are permitted provided that the following conditions
8ab1e35f3Spooka.\" are met:
9ab1e35f3Spooka.\" 1. Redistributions of source code must retain the above copyright
10ab1e35f3Spooka.\"    notice, this list of conditions and the following disclaimer.
11ab1e35f3Spooka.\" 2. Redistributions in binary form must reproduce the above copyright
12ab1e35f3Spooka.\"    notice, this list of conditions and the following disclaimer in the
13ab1e35f3Spooka.\"    documentation and/or other materials provided with the distribution.
14ab1e35f3Spooka.\"
15ab1e35f3Spooka.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16ab1e35f3Spooka.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17ab1e35f3Spooka.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18ab1e35f3Spooka.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19ab1e35f3Spooka.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20ab1e35f3Spooka.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21ab1e35f3Spooka.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22ab1e35f3Spooka.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23ab1e35f3Spooka.\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24ab1e35f3Spooka.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25ab1e35f3Spooka.\"
26*bc38e874Spooka.Dd July 3, 2013
27ab1e35f3Spooka.Dt VIRT 4
28ab1e35f3Spooka.Os
29ab1e35f3Spooka.Sh NAME
30ab1e35f3Spooka.Nm virt
31*bc38e874Spooka.Nd rump kernel virtual network interface
32ab1e35f3Spooka.Sh DESCRIPTION
33ab1e35f3SpookaThe
34ab1e35f3Spooka.Nm
35*bc38e874Spookainterface acts as a link between a rump kernel and a host
36ab1e35f3Spooka.Xr tap 4
37ab1e35f3Spookainterface.
38ab1e35f3SpookaInterface number <n> always corresponds with the host tap interface tap<n>.
39ab1e35f3SpookaAll data sent by
40ab1e35f3Spooka.Nm
41ab1e35f3Spookais written into
42ab1e35f3Spooka.Pa /dev/tap<n>
43ab1e35f3Spookaand all data read from
44ab1e35f3Spooka.Pa /dev/tap<n>
45*bc38e874Spookais passed as Ethernet input to the rump kernel.
46ab1e35f3Spooka.Pp
47ab1e35f3SpookaA
48ab1e35f3Spooka.Nm
49*bc38e874Spookainterface can be created and destroyed in the normal fashion with
50*bc38e874Spooka.Xr ifconfig 8 .
51ab1e35f3Spooka.Pp
52ab1e35f3SpookaThe host's
53ab1e35f3Spooka.Xr tap 4
54ab1e35f3Spookainterface can be further bridged with hardware interfaces to provide
55d999ecb2Swizfull Internet access to a rump kernel.
56ab1e35f3Spooka.Sh SEE ALSO
57ab1e35f3Spooka.Xr rump 3 ,
58ab1e35f3Spooka.Xr bridge 4 ,
59ab1e35f3Spooka.Xr tap 4 ,
60ab1e35f3Spooka.Xr brconfig 8 ,
61ab1e35f3Spooka.Xr ifconfig 8
62