VMWARE(4) (xf86-video-vmware 13.3.0) VMWARE(4)
NAME
vmware - VMware SVGA video driver
SYNOPSIS
Section 34Device34
Identifier 34devname34
Driver 34vmware34
...
EndSection
DESCRIPTION
vmware is an Xorg driver for VMware virtual video cards.
MODESETTING, XINERAMA AND RANDR12
If the driver can connect to the 34vmwgfx34 kernel module on
linux, it will attempt to use kernel modesetting and will
then also use RandR12 for multiple output operation instead
of Xinerama. The X server log or the 34xrandr34 application
can be used to determine whether RandR12 or Xinerama is
actually used.
3D ACCELERATION
If the driver can connect to the 34vmwgfx34 kernel module on
linux, and the Virtual Machine is set up to use 3D accelera-
tion, the driver will try to use Gallium3D XA to accelerate
3D operations. It will also by default enable DRI, the
Direct Rendering Infrastructure, primarily for accelerated
OpenGL. If 3D acceleration is available, the driver will in
addition provide an additional XVideo adaptor for textured
video. Gallium3D XA,ibxatracker.so34 and the accelerated
OpenGL driver, 34vmwgfx_dri.so34 is provided by the mesa dis-
tribution.
CONFIGURATION DETAILS
Please refer to xorg.conf(5) for general configuration
details. This section only covers configuration details
specific to this driver.
The driver auto-detects the version of any virtual VMware
SVGA adapter.
The following driver Options are supported:
Option 34HWCursor34 34boolean34
Enable or disable the HW cursor. Default: off.
Option 34Xinerama34 34boolean34
Disable or enable Xinerama support. Default: xinerama
is enabled if the hardware supports it.
Page 1 X Version 11 (printed 5/24/22)
VMWARE(4) (xf86-video-vmware 13.3.0) VMWARE(4)
Option 34StaticXinerama34 34string34
Provide a static xinerama geometry that will be active
at server startup and will not be overridden at run-
time. The format is
"Width1xHeight1+Xoffset1+Yoffset1;Width2xHeight2+Xoffset2+Yoffset2"
and so on. Negative offsets are not supported. If the
driver is using RandR12, this option should be used to
place and enable outputs at driver startup time or else
when VMware tools is not used for that purpose. Also
please see option 34GuiLayout34.
Option 34GuiLayout34 34string34
A synonym to option 34StaticXinerama34, since the latter
name is somewhat misleading when RandR12 is favoured
before Xinerarma.
Option 34AddDefaultMode34 34boolean34
Provide a default mode with a resolution identical to
the resolution of the guest before the X server was
started. The X server will thus try to start without
changing resolution. Default: on.
Option 34RenderAccel34 34boolean34
Try to accelerate render operations if the operations
are reading from previously accelerated contents (3D or
video). This option is needed for 3D support. Default:
on if 3D acceleration is supported. Otherwise off.
Option 34DRI34 34boolean34
Enable the Direct Rendering Infrastructure. Default: on
if 3D acceleration is supported and 34RenderAccel34 is
enabled. Otherwise off.
Option 34DirectPresents34 34boolean34
Speed up OpenGL swapbuffers by skipping a copy opera-
tion. This provides some OpenGL swapbuffer speedups,
but may cause performance degradation and rendering
errors when 3D contents is read back for mixing with
software rendered contents. Default: off.
Option 34HwPresents34 34boolean34
This is a developer convenience option and should not
be used by distros or normal users. When enabled, it
copies software rendered contents to a 3D surface
before presenting it, so that the visible screen is
always present on a 3D surface. Default: off.
Option 34RenderCheck34 34boolean34
This is a developer convenience option and should not
be used by distros or normal users. When enabled, it
tries to use 3D acceleration for all XRender operations
where 3D acceleration is supported, resulting in a
Page 2 X Version 11 (printed 5/24/22)
VMWARE(4) (xf86-video-vmware 13.3.0) VMWARE(4)
considerable slowdown due to the increased number of
readbacks of accelerated contents from host to guest.
This option is used to verify that the accelerated
Xrender paths works correctly with the "rendercheck"
application. Default: off.
Copyright (c) 1999-2007 VMware, Inc.
Page 3 X Version 11 (printed 5/24/22)