xref: /openbsd/share/man/man4/hvn.4 (revision 4cfece93)
1.\"	$OpenBSD: hvn.4,v 1.5 2016/10/07 14:42:27 jmc Exp $
2.\"
3.\" Copyright (c) 2016 Mike Belopuhov
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: October 7 2016 $
18.Dt HVN 4
19.Os
20.Sh NAME
21.Nm hvn
22.Nd Hyper-V networking interface
23.Sh SYNOPSIS
24.Cd "hvn* at hyperv?"
25.Sh DESCRIPTION
26The
27.Nm
28driver provides support for a Network Virtual Service Client (NetVSC),
29a virtual networking interface that relays device requests to the Virtual
30Service Provider (VSP) in the management operating system via the VMBus.
31.Pp
32NetVSC emulates an RNDIS 1.0 compliant device on top of a custom NVS
33protocol operating over the VMBus channel ring.
34.Pp
35Individual networking interfaces can be renamed by issuing a
36.Cm Rename-VMNetworkAdapter
37PowerShell command in the management domain.
38In order to enable sending and receiving of IEEE 802.1q (VLAN) frames,
39the virtual port needs to be put into
40.Em Trunk
41mode with the
42.Cm Set-VMNetworkAdapterVlan
43command.
44.Sh SEE ALSO
45.Xr autoconf 4 ,
46.Xr hyperv 4 ,
47.Xr intro 4
48.Sh HISTORY
49The
50.Nm
51driver first appeared in
52.Ox 6.1 .
53.Sh AUTHORS
54The
55.Nm
56driver was written by
57.An Mike Belopuhov Aq Mt mikeb@openbsd.org
58based on the
59.Fx
60driver by the Microsoft BSD Integration Services Team
61.Aq Mt bsdic@microsoft.com .
62