xref: /openbsd/share/man/man4/vic.4 (revision d89ec533)
1.\"	$OpenBSD: vic.4,v 1.25 2018/01/04 20:09:56 jmc Exp $
2.\"
3.\" Copyright (c) 2006 Reyk Floeter <reyk@openbsd.org>
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: January 4 2018 $
18.Dt VIC 4
19.Os
20.Sh NAME
21.Nm vic
22.Nd VMware VMXnet Virtual Interface Controller device
23.Sh SYNOPSIS
24.Cd vic* at pci?
25.Sh DESCRIPTION
26The
27.Nm
28driver provides support for the VMXnet virtual NIC available in virtual
29machines by VMware.
30It appears as a simple Ethernet device but is actually a virtual network
31interface to the underlying host operating system.
32.Pp
33This driver supports the
34.Ic vmxnet
35driver protocol, as an alternative to the emulated
36.Xr pcn 4
37and
38.Xr em 4
39interfaces also available in the VMware environment.
40The
41.Nm vic
42driver is optimized for the virtual machine, it can provide advanced
43capabilities depending on the underlying host operating system and
44the physical network interface controller of the host.
45.Pp
46The
47.Nm
48driver supports VMware virtual NICs provided by the following products:
49.Pp
50.Bl -bullet -compact -offset indent
51.It
52VMware ESX 2.0 and newer
53.It
54VMware GSX 2.5 and newer
55.It
56VMware Server 1.0 and newer
57.It
58VMware Workstation 4.5 and newer
59.It
60VMware Fusion 1.0 and newer
61.El
62.Pp
63The
64.Nm
65driver supports the following media types:
66.Bl -tag -width autoselect
67.It autoselect
68Enable autoselection of the media type and options.
69The driver always uses the fastest available speed and the media
70options provided by the underlying host of the virtual machine.
71.El
72.Pp
73For more information on configuring this device, see
74.Xr ifconfig 8 .
75.Sh EXAMPLES
76The following entry must be added to the VMware configuration file
77to provide the
78.Nm
79device:
80.Bd -literal -offset indent
81ethernet0.virtualDev = "vmxnet"
82.Ed
83.Sh SEE ALSO
84.Xr arp 4 ,
85.Xr em 4 ,
86.Xr ifmedia 4 ,
87.Xr intro 4 ,
88.Xr netintro 4 ,
89.Xr pci 4 ,
90.Xr pcn 4 ,
91.Xr vmx 4 ,
92.Xr hostname.if 5 ,
93.Xr ifconfig 8
94.Sh HISTORY
95The
96.Nm
97driver first appeared in
98.Ox 3.9 .
99.Sh AUTHORS
100.An -nosplit
101The
102.Nm
103driver was written by
104.An Reyk Floeter Aq Mt reyk@openbsd.org
105and
106.An David Gwynne Aq Mt dlg@openbsd.org .
107