1VMWARE(4)                  Kernel Interfaces Manual                  VMWARE(4)
2
3
4

NAME

6       vmware - VMware SVGA video driver
7

SYNOPSIS

9       Section "Device"
10         Identifier "devname"
11         Driver "vmware"
12         ...
13       EndSection
14

DESCRIPTION

16       vmware is an Xorg driver for VMware virtual video cards.
17

MODESETTING, XINERAMA AND RANDR12

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

3D ACCELERATION

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

CONFIGURATION DETAILS

36       Please refer to xorg.conf(5) for general configuration  details.   This
37       section only covers configuration details specific to this driver.
38
39       The driver auto-detects the version of any virtual VMware SVGA adapter.
40
41       The following driver Options are supported:
42
43       Option "HWCursor" "boolean"
44              Enable or disable the HW cursor.  Default: off.
45
46       Option "Xinerama" "boolean"
47              Disable or enable Xinerama support. Default: xinerama is enabled
48              if the hardware supports it.
49
50       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
60       Option "GuiLayout" "string"
61              A  synonym  to option "StaticXinerama", since the latter name is
62              somewhat misleading when RandR12 is favoured before Xinerarma.
63
64       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
70       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
76       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
81       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
87       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
93       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
103
104       SEE ALSO
105              Xorg(1), xorg.conf(5), Xserver(1), X(7), xrandr(1)
106

AUTHORS

108       Copyright (c) 1999-2007 VMware, Inc.
109
110
111
112X Version 11               xf86-video-vmware 13.4.0                  VMWARE(4)
Impressum