| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="guestadd-resizing-linux">
|
|---|
| 4 | <title>X11/Wayland Desktop Environments</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | The Guest Additions provide services for controlling the guest
|
|---|
| 9 | system's monitor topology. Monitor topology means the resolution
|
|---|
| 10 | of each virtual monitor and its state (disabled/enabled). The
|
|---|
| 11 | resolution of a virtual monitor can be modified from the host
|
|---|
| 12 | side either by resizing the window that hosts the virtual
|
|---|
| 13 | monitor, by using the <b outputclass="bold">View</b> menu
|
|---|
| 14 | or the <userinput>VBoxManage controlvm
|
|---|
| 15 | <varname>vmname</varname> setscreenlayout</userinput>
|
|---|
| 16 | command. On guest operating systems with X11/Wayland desktops
|
|---|
| 17 | this is put into effect by either of the following two services:
|
|---|
| 18 | </p>
|
|---|
| 19 | <pre xml:space="preserve"> VBoxClient --vmsvga
|
|---|
| 20 | VBoxDRMClient
|
|---|
| 21 | </pre>
|
|---|
| 22 | <p>
|
|---|
| 23 | The following are some details about guest screen resolution
|
|---|
| 24 | control functionality:
|
|---|
| 25 | </p>
|
|---|
| 26 | <ul>
|
|---|
| 27 | <li>
|
|---|
| 28 | <p>
|
|---|
| 29 | On X11/Wayland desktops the resizing service is started
|
|---|
| 30 | during desktop session initialization, that is desktop
|
|---|
| 31 | login. On X11 desktops <codeph>VBoxClient --vmsvga</codeph>
|
|---|
| 32 | handles screen topology through the RandR extension. On
|
|---|
| 33 | Wayland clients <codeph>VBoxDRMClient</codeph> is used. The
|
|---|
| 34 | decision is made automatically at each desktop session
|
|---|
| 35 | start.
|
|---|
| 36 | </p>
|
|---|
| 37 | </li>
|
|---|
| 38 | <li>
|
|---|
| 39 | <p>
|
|---|
| 40 | On 32-bit guest operating systems
|
|---|
| 41 | <userinput>VBoxDRMClient</userinput> is always used, in order to
|
|---|
| 42 | work around bugs.
|
|---|
| 43 | </p>
|
|---|
| 44 | </li>
|
|---|
| 45 | <li>
|
|---|
| 46 | <p>
|
|---|
| 47 | Since the monitor topology control services are initialized
|
|---|
| 48 | during the desktop session start, it is impossible to
|
|---|
| 49 | control the monitor resolution of display managers such as
|
|---|
| 50 | GDM or LightDM. This default behavior can be changed by
|
|---|
| 51 | setting the guest property
|
|---|
| 52 | <codeph>/VirtualBox/GuestAdd/DRMResize</codeph> of the
|
|---|
| 53 | virtual machine to any value. See
|
|---|
| 54 | <xref href="guestadd-guestprops.dita#guestadd-guestprops"/> for details of how to
|
|---|
| 55 | update guest properties. When this guest property is set
|
|---|
| 56 | then <userinput>VBoxDRMClient</userinput> is started during the
|
|---|
| 57 | guest OS boot and stays active all the time, for both the
|
|---|
| 58 | display manager login screen and the desktop session.
|
|---|
| 59 | </p>
|
|---|
| 60 | </li>
|
|---|
| 61 | </ul>
|
|---|
| 62 | </body>
|
|---|
| 63 | </topic>
|
|---|
