VirtualBox

Ignore:
Timestamp:
Sep 11, 2020 12:46:28 PM (4 years ago)
Author:
vboxsync
Message:

Docs/GAs: Correcting tab widths.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/user_GuestAdditions.xml

    r86092 r86093  
    23962396  <sect1 id="guestadd-resizing">
    23972397
    2398       <title>Controlling Virtual Monitor Topology</title>
    2399 
    2400       <sect2 id="guestadd-resizing-linux">
    2401 
    2402           <title>X11/Wayland Desktop Environments</title>
    2403 
    2404           <para>
    2405               The Guest Additions provide necessary services to enable controlling
    2406               the guest system's monitor topology. My monitor topology the resolution
    2407               of each virtual monitor and its state are meant (disabled/enabled). The
    2408               resolution of a virtual monitor can be modified from the host side either
    2409               by resizing the window that hosts the virtual monitor or thru the view menu.
    2410               On guest operating systems with X11/Wayland desktops this is achieved by
    2411               either of two following services:
    2412         </para>
    2413 
    2414         <screen>
    2415             VBoxClient --vmsvga
    2416             VBoxDRMClient
    2417         </screen>
    2418 
    2419         <para>
    2420             Here are some details about guest screen resolution control functionality:
    2421         </para>
    2422 
    2423         <itemizedlist>
    2424 
    2425             <listitem>
    2426                 <para>
    2427                     On X11/Wayland desktops the resizing service is started during
    2428                     desktop session initialization, that is desktop login. On X11 desktops
    2429                     VBoxClient --vmsvga service handles screen topology thru xrandr calls.
    2430                     On Wayland clients VBoxDRMClient is used. The decision of choosing either
    2431                     of these clients is done automatically at each desktop session start.
    2432                 </para>
    2433             </listitem>
    2434             <listitem>
    2435                 <para>
    2436                     On 32 bit guest OSs VBoxDRMClient, which is run during desktop
    2437                     session start, is used. The guest OS bitness check and choice
    2438                     of the service is done automatically.
    2439                 </para>
    2440             </listitem>
    2441             <listitem>
    2442                 <para>
    2443                     Since the mentioned monitor topology control services are initialized during
    2444                     the desktop session start, display managers' (gdm, lightdm, etc.) resolution
    2445                     cannot be controlled. This default behavior can be changed by setting the
    2446                     following guest property of the virtual machine to any value.
    2447                     <screen>
    2448                         /VirtualBox/GuestAdd/DRMResize
    2449                     </screen>
    2450                     Please refer to <xref linkend="guestadd-guestprops" /> for how to set/delete
    2451                     guest properties. When this guest property is set then VBoxDRMClient is started
    2452                     during the guest OS boot and stays active for both display manager's login screen
    2453                     and desktop session.
    2454                 </para>
    2455             </listitem>
    2456 
    2457         </itemizedlist>
    2458 
    2459         <sect3 id="guestadd-resizing-linux-limitations">
    2460 
    2461             <title>Known Limitations</title>
    2462             <para>
    2463                 VBoxDRMClient is not able to handle arbitrary guest monitor topologies. Specifically,
    2464                 disabling a guest monitor (except the last one) invalidates the monitor topology. That
    2465                 is, when the guest is configured to have 4 monitors, disabling 2nd or 3rd monitor is not
    2466                 recommended.
    2467             </para>
    2468 
    2469         </sect3>
     2398    <title>Controlling Virtual Monitor Topology</title>
     2399
     2400    <sect2 id="guestadd-resizing-linux">
     2401
     2402      <title>X11/Wayland Desktop Environments</title>
     2403
     2404      <para>
     2405        The Guest Additions provide necessary services to enable controlling
     2406        the guest system's monitor topology. My monitor topology the resolution
     2407        of each virtual monitor and its state are meant (disabled/enabled). The
     2408        resolution of a virtual monitor can be modified from the host side either
     2409        by resizing the window that hosts the virtual monitor or thru the view menu.
     2410        On guest operating systems with X11/Wayland desktops this is achieved by
     2411        either of two following services:
     2412      </para>
     2413
     2414      <screen>
     2415        VBoxClient --vmsvga
     2416        VBoxDRMClient
     2417      </screen>
     2418
     2419      <para>
     2420        Here are some details about guest screen resolution control functionality:
     2421      </para>
     2422
     2423      <itemizedlist>
     2424
     2425        <listitem>
     2426          <para>
     2427            On X11/Wayland desktops the resizing service is started during
     2428            desktop session initialization, that is desktop login. On X11 desktops
     2429            VBoxClient --vmsvga service handles screen topology thru xrandr calls.
     2430            On Wayland clients VBoxDRMClient is used. The decision of choosing either
     2431            of these clients is done automatically at each desktop session start.
     2432          </para>
     2433        </listitem>
     2434        <listitem>
     2435          <para>
     2436            On 32 bit guest OSs VBoxDRMClient, which is run during desktop
     2437            session start, is used. The guest OS bitness check and choice
     2438            of the service is done automatically.
     2439          </para>
     2440        </listitem>
     2441        <listitem>
     2442          <para>
     2443            Since the mentioned monitor topology control services are initialized during
     2444            the desktop session start, display managers' (gdm, lightdm, etc.) resolution
     2445            cannot be controlled. This default behavior can be changed by setting the
     2446            following guest property of the virtual machine to any value.
     2447            <screen>
     2448              /VirtualBox/GuestAdd/DRMResize
     2449            </screen>
     2450            Please refer to <xref linkend="guestadd-guestprops" /> for how to set/delete
     2451            guest properties. When this guest property is set then VBoxDRMClient is started
     2452            during the guest OS boot and stays active for both display manager's login screen
     2453            and desktop session.
     2454          </para>
     2455        </listitem>
     2456
     2457      </itemizedlist>
     2458
     2459      <sect3 id="guestadd-resizing-linux-limitations">
     2460
     2461        <title>Known Limitations</title>
     2462        <para>
     2463          VBoxDRMClient is not able to handle arbitrary guest monitor topologies. Specifically,
     2464          disabling a guest monitor (except the last one) invalidates the monitor topology. That
     2465          is, when the guest is configured to have 4 monitors, disabling 2nd or 3rd monitor is not
     2466          recommended.
     2467        </para>
     2468
     2469      </sect3>
    24702470
    24712471    </sect2>
    2472     <!-- <sect2 id="guestadd-resizing-wayland"> -->
    2473     <!-- </sec2> -->
    2474 
    2475     <!-- <sect2 id="guestadd-resizing-display-managers"> -->
    2476     <!-- </sec2> -->
    2477 
    2478     <!-- <sect2 id="guestadd-resizing-32-bit-vms"> -->
    2479     <!-- </sec2> -->
    24802472
    24812473  </sect1>
    24822474
    2483 
    24842475</chapter>
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette