xref: /openbsd-src/share/man/man4/vic.4 (revision 1faa961b9eedeab046daef12bb86090b126b6561)
1*1faa961bSjmc.\"	$OpenBSD: vic.4,v 1.25 2018/01/04 20:09:56 jmc Exp $
25bef76a1Sreyk.\"
35bef76a1Sreyk.\" Copyright (c) 2006 Reyk Floeter <reyk@openbsd.org>
45bef76a1Sreyk.\"
55bef76a1Sreyk.\" Permission to use, copy, modify, and distribute this software for any
65bef76a1Sreyk.\" purpose with or without fee is hereby granted, provided that the above
75bef76a1Sreyk.\" copyright notice and this permission notice appear in all copies.
85bef76a1Sreyk.\"
95bef76a1Sreyk.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
105bef76a1Sreyk.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
115bef76a1Sreyk.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
125bef76a1Sreyk.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
135bef76a1Sreyk.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
145bef76a1Sreyk.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
155bef76a1Sreyk.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
165bef76a1Sreyk.\"
17*1faa961bSjmc.Dd $Mdocdate: January 4 2018 $
185bef76a1Sreyk.Dt VIC 4
195bef76a1Sreyk.Os
205bef76a1Sreyk.Sh NAME
215bef76a1Sreyk.Nm vic
22d9445554Sjmc.Nd VMware VMXnet Virtual Interface Controller device
235bef76a1Sreyk.Sh SYNOPSIS
245bef76a1Sreyk.Cd vic* at pci?
255bef76a1Sreyk.Sh DESCRIPTION
265bef76a1SreykThe
275bef76a1Sreyk.Nm
28ae07b13aSdlgdriver provides support for the VMXnet virtual NIC available in virtual
295bef76a1Sreykmachines by VMware.
30ef25378dSjmcIt appears as a simple Ethernet device but is actually a virtual network
31ef25378dSjmcinterface to the underlying host operating system.
325bef76a1Sreyk.Pp
33f89b8deaSjmcThis driver supports the
345bef76a1Sreyk.Ic vmxnet
35f89b8deaSjmcdriver protocol, as an alternative to the emulated
365bef76a1Sreyk.Xr pcn 4
37ae07b13aSdlgand
38ae07b13aSdlg.Xr em 4
39ae07b13aSdlginterfaces also available in the VMware environment.
405bef76a1SreykThe
415bef76a1Sreyk.Nm vic
425bef76a1Sreykdriver is optimized for the virtual machine, it can provide advanced
435bef76a1Sreykcapabilities depending on the underlying host operating system and
445bef76a1Sreykthe physical network interface controller of the host.
455bef76a1Sreyk.Pp
465bef76a1SreykThe
475bef76a1Sreyk.Nm
484eea1d00Sjmcdriver supports VMware virtual NICs provided by the following products:
495bef76a1Sreyk.Pp
505bef76a1Sreyk.Bl -bullet -compact -offset indent
515bef76a1Sreyk.It
52b18b5420SbradVMware ESX 2.0 and newer
53e422efd1Sbrad.It
54b18b5420SbradVMware GSX 2.5 and newer
55e422efd1Sbrad.It
56851d7ff4SreykVMware Server 1.0 and newer
57851d7ff4Sreyk.It
58851d7ff4SreykVMware Workstation 4.5 and newer
592735bc04Sdlg.It
60b18b5420SbradVMware Fusion 1.0 and newer
615bef76a1Sreyk.El
62826df575Sjmc.Pp
63826df575SjmcThe
64826df575Sjmc.Nm
65826df575Sjmcdriver supports the following media types:
66826df575Sjmc.Bl -tag -width autoselect
67826df575Sjmc.It autoselect
68826df575SjmcEnable autoselection of the media type and options.
69826df575SjmcThe driver always uses the fastest available speed and the media
70826df575Sjmcoptions provided by the underlying host of the virtual machine.
71826df575Sjmc.El
72826df575Sjmc.Pp
73826df575SjmcFor more information on configuring this device, see
74826df575Sjmc.Xr ifconfig 8 .
75172bc90dSjmc.Sh EXAMPLES
769dc2929eSjmcThe following entry must be added to the VMware configuration file
779dc2929eSjmcto provide the
789dc2929eSjmc.Nm
799dc2929eSjmcdevice:
8071d0bb18Sfkr.Bd -literal -offset indent
8171d0bb18Sfkrethernet0.virtualDev = "vmxnet"
8271d0bb18Sfkr.Ed
835bef76a1Sreyk.Sh SEE ALSO
845bef76a1Sreyk.Xr arp 4 ,
85ae07b13aSdlg.Xr em 4 ,
865bef76a1Sreyk.Xr ifmedia 4 ,
875bef76a1Sreyk.Xr intro 4 ,
885bef76a1Sreyk.Xr netintro 4 ,
895bef76a1Sreyk.Xr pci 4 ,
905bef76a1Sreyk.Xr pcn 4 ,
913af69170Sreyk.Xr vmx 4 ,
925bef76a1Sreyk.Xr hostname.if 5 ,
935bef76a1Sreyk.Xr ifconfig 8
94*1faa961bSjmc.Sh HISTORY
95*1faa961bSjmcThe
96*1faa961bSjmc.Nm
97*1faa961bSjmcdriver first appeared in
98*1faa961bSjmc.Ox 3.9 .
995bef76a1Sreyk.Sh AUTHORS
1005bef76a1Sreyk.An -nosplit
1015bef76a1SreykThe
1025bef76a1Sreyk.Nm
1035bef76a1Sreykdriver was written by
104e5cc2e7eSschwarze.An Reyk Floeter Aq Mt reyk@openbsd.org
105ae07b13aSdlgand
106e5cc2e7eSschwarze.An David Gwynne Aq Mt dlg@openbsd.org .
107