File: guestadd-resizing-linux.dita

package info (click to toggle)
virtualbox 7.1.12-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 565,672 kB
  • sloc: ansic: 2,330,854; cpp: 2,193,228; asm: 230,777; python: 223,895; xml: 86,771; sh: 25,541; makefile: 8,158; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,782; javascript: 1,692; objc: 1,131; lex: 931; php: 906; sed: 899; yacc: 707
file content (63 lines) | stat: -rw-r--r-- 2,699 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="guestadd-resizing-linux">
  <title>X11/Wayland Desktop Environments</title>
  
  <body>
    <p>
        The Guest Additions provide services for controlling the guest
        system's monitor topology. Monitor topology means the resolution
        of each virtual monitor and its state (disabled/enabled). The
        resolution of a virtual monitor can be modified from the host
        side either by resizing the window that hosts the virtual
        monitor, by using the <b outputclass="bold">View</b> menu
        or the <userinput>VBoxManage controlvm
        <varname>vmname</varname> setscreenlayout</userinput>
        command. On guest operating systems with X11/Wayland desktops
        this is put into effect by either of the following two services:
      </p>
    <pre xml:space="preserve">        VBoxClient --vmsvga
        VBoxDRMClient
      </pre>
    <p>
        The following are some details about guest screen resolution
        control functionality:
      </p>
    <ul>
      <li>
        <p>
            On X11/Wayland desktops the resizing service is started
            during desktop session initialization, that is desktop
            login. On X11 desktops <codeph>VBoxClient --vmsvga</codeph>
            handles screen topology through the RandR extension. On
            Wayland clients <codeph>VBoxDRMClient</codeph> is used. The
            decision is made automatically at each desktop session
            start.
          </p>
      </li>
      <li>
        <p>
            On 32-bit guest operating systems
            <userinput>VBoxDRMClient</userinput> is always used, in order to
            work around bugs.
          </p>
      </li>
      <li>
        <p>
            Since the monitor topology control services are initialized
            during the desktop session start, it is impossible to
            control the monitor resolution of display managers such as
            GDM or LightDM. This default behavior can be changed by
            setting the guest property
            <codeph>/VirtualBox/GuestAdd/DRMResize</codeph> of the
            virtual machine to any value. See
            <xref href="guestadd-guestprops.dita#guestadd-guestprops"/> for details of how to
            update guest properties. When this guest property is set
            then <userinput>VBoxDRMClient</userinput> is started during the
            guest OS boot and stays active all the time, for both the
            display manager login screen and the desktop session.
          </p>
      </li>
    </ul>
  </body>
</topic>