VirtualBox

Changeset 95214 in vbox for trunk/doc/manual/en_US


Ignore:
Timestamp:
Jun 7, 2022 6:09:45 PM (3 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
151724
Message:

Documentation: Add info about updated resize mechanism for Linux VMSVGA guests, bugref:10134.

File:
1 edited

Legend:

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

    r92540 r95214  
    796796          them in a setting which our installer does not handle
    797797          correctly, see <xref linkend="guestxorgsetup" />.
     798        </para>
     799
     800        <para>
     801          Starting from &product-name; 7, Linux guest screen resize
     802          functionality for guests running VMSVGA graphics configuration
     803          has been changed. Since then, this functionality consists
     804          of a standalone daemon called VBoxDRMClient and its Desktop
     805          Environment helper counterpart.
     806        </para>
     807
     808        <para>
     809          VBoxDRMClient is running as a root process and, in fact, is
     810          a bridge between host and guest's vmwgfx driver. This means that
     811          VBoxDRMClient listens to screen resize hints from host and
     812          forwards them to vmwgfx driver. This allows to make guest screen resize
     813          functionality available before user performed graphical log-in.
     814        </para>
     815
     816        <para>
     817          In order to perform Desktop Environment specific actions, such
     818          as setting primary screen in multi monitor setup, a Desktop Environment
     819          helper is used. Once user performed graphical log-in operation,
     820          helper daemon starts in scope of user session and attempts to
     821          connect to VBoxDRMClient using IPC connection. Once VBoxDRMClient received
     822          corresponding command from host, it is forwarded to helper daemon
     823          over IPC and action then performed.
     824        </para>
     825
     826        <para>
     827          By default, VBoxDRMClient allows any process to connect to its IPC
     828          socket. This can be restricted once two actions are taken. Starting
     829          from &product-name; 7, Guest Additions Linux installer will also
     830          create 'vboxdrmipc' user group. Corresponding user needs to be added
     831          into this group. The last action is to set the following guest property:
     832
     833<screen>VBoxManage guestproperty set "VM name" /VirtualBox/GuestAdd/DRMIpcRestricted 1 \
     834--flags RDONLYGUEST</screen>
     835        </para>
     836
     837        <para>
     838          Note, it is important to set RDONLYGUEST flag to the property, so
     839          it cannot be changed from inside guest. All actions are required. If one of
     840          them is missing, all processes will have access to IPC socket. Restricted
     841          mode can be disabled by deleting guest property:
     842
     843<screen>VBoxManage guestproperty unset "VM name" /VirtualBox/GuestAdd/DRMIpcRestricted</screen>
    798844        </para>
    799845
Note: See TracChangeset for help on using the changeset viewer.

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