Tribblix: manual page: vmware.7

VMWARE(7) Standards, Environments, and Macros VMWARE(7)

NAME

vmware - VMware SVGA video driver

SYNOPSIS

Section "Device"
Identifier "devname"
Driver "vmware"
...
EndSection

DESCRIPTION

vmware is an Xorg driver for VMware virtual video cards.

MODESETTING, XINERAMA AND RANDR12
If the driver can connect to the "vmwgfx" 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 "xrandr" application can be used to determine whether RandR12
or Xinerama is actually used.

3D ACCELERATION
If the driver can connect to the "vmwgfx" kernel module on linux, and
the Virtual Machine is set up to use 3D acceleration, 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.so" and the accelerated OpenGL
driver, "vmwgfx_dri.so" is provided by the mesa distribution.

CONFIGURATION DETAILS

Please refer to xorg.conf(4) 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 "HWCursor" "boolean"
Enable or disable the HW cursor. Default: off.

Option "Xinerama" "boolean"
Disable or enable Xinerama support. Default: xinerama is
enabled if the hardware supports it.

Option "StaticXinerama" "string"
Provide a static xinerama geometry that will be active at
server startup and will not be overridden at runtime. 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
"GuiLayout".

Option "GuiLayout" "string"
A synonym to option "StaticXinerama", since the latter name is
somewhat misleading when RandR12 is favoured before Xinerarma.

Option "AddDefaultMode" "boolean"
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 "RenderAccel" "boolean"
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 "DRI" "boolean"
Enable the Direct Rendering Infrastructure. Default: on if 3D
acceleration is supported and "RenderAccel" is enabled.
Otherwise off.

Option "DirectPresents" "boolean"
Speed up OpenGL swapbuffers by skipping a copy operation. 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 "HwPresents" "boolean"
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 "RenderCheck" "boolean"
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 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.

NAME

SYNOPSIS

DESCRIPTION

CONFIGURATION DETAILS

SEE ALSO

AUTHORS