1VMWARE(4) Kernel Interfaces Manual VMWARE(4)
2
6 vmware - VMware SVGA video driver
7
9 Section "Device"
10 Identifier "devname"
11 Driver "vmware"
12 ...
13 EndSection
14
16 vmware is an Xorg driver for VMware virtual video cards.
17
19 If the driver can connect to the "vmwgfx" kernel module on linux, it
20 will attempt to use kernel modesetting and will then also use RandR12
21 for multiple output operation instead of Xinerama. The X server log or
22 the "xrandr" application can be used to determine whether RandR12 or
23 Xinerama is actually used.
24
26 If the driver can connect to the "vmwgfx" kernel module on linux, and
27 the Virtual Machine is set up to use 3D acceleration, the driver will
28 try to use Gallium3D XA to accelerate 3D operations. It will also by
29 default enable DRI, the Direct Rendering Infrastructure, primarily for
30 accelerated OpenGL. If 3D acceleration is available, the driver will
31 in addition provide an additional XVideo adaptor for textured video.
32 Gallium3D XA, "libxatracker.so" and the accelerated OpenGL driver,
33 "vmwgfx_dri.so" is provided by the mesa distribution.
34
36 Please refer to xorg.conf(5) for general configuration details. This
37 section only covers configuration details specific to this driver.
38 The driver auto-detects the version of any virtual VMware SVGA adapter.
40 The following driver Options are supported:
42 Option "HWCursor" "boolean"
44 Enable or disable the HW cursor. Default: off.
45 Option "Xinerama" "boolean"
47 Disable or enable Xinerama support. Default: xinerama is enabled
48 if the hardware supports it.
49 Option "StaticXinerama" "string"
51 Provide a static xinerama geometry that will be active at server
52 startup and will not be overridden at runtime. The format is
53 "Width1xHeight1+Xoffset1+Yoffset1;Width2xHeight2+Xoffset2+Yoff‐
54 set2" and so on. Negative offsets are not supported. If the
55 driver is using RandR12, this option should be used to place and
56 enable outputs at driver startup time or else when VMware tools
57 is not used for that purpose. Also please see option "GuiLay‐
58 out".
59 Option "GuiLayout" "string"
61 A synonym to option "StaticXinerama", since the latter name is
62 somewhat misleading when RandR12 is favoured before Xinerarma.
63 Option "AddDefaultMode" "boolean"
65 Provide a default mode with a resolution identical to the reso‐
66 lution of the guest before the X server was started. The X
67 server will thus try to start without changing resolution. De‐
68 fault: on.
69 Option "RenderAccel" "boolean"
71 Try to accelerate render operations if the operations are read‐
72 ing from previously accelerated contents (3D or video). This op‐
73 tion is needed for 3D support. Default: on if 3D acceleration is
74 supported. Otherwise off.
75 Option "DRI" "boolean"
77 Enable the Direct Rendering Infrastructure. Default: on if 3D
78 acceleration is supported and "RenderAccel" is enabled. Other‐
79 wise off.
80 Option "DirectPresents" "boolean"
82 Speed up OpenGL swapbuffers by skipping a copy operation. This
83 provides some OpenGL swapbuffer speedups, but may cause perfor‐
84 mance degradation and rendering errors when 3D contents is read
85 back for mixing with software rendered contents. Default: off.
86 Option "HwPresents" "boolean"
88 This is a developer convenience option and should not be used by
89 distros or normal users. When enabled, it copies software ren‐
90 dered contents to a 3D surface before presenting it, so that the
91 visible screen is always present on a 3D surface. Default: off.
92 Option "RenderCheck" "boolean"
94 This is a developer convenience option and should not be used by
95 distros or normal users. When enabled, it tries to use 3D accel‐
96 eration for all XRender operations where 3D acceleration is sup‐
97 ported, resulting in a considerable slowdown due to the in‐
98 creased number of readbacks of accelerated contents from host to
99 guest. This option is used to verify that the accelerated Xren‐
100 der paths works correctly with the "rendercheck" application.
101 Default: off.
102 SEE ALSO
105 Xorg(1), xorg.conf(5), Xserver(1), X(7), xrandr(1)
106
108 Copyright (c) 1999-2007 VMware, Inc.
109X Version 11 xf86-video-vmware 13.4.0 VMWARE(4)