VirtualBox

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


Ignore:
Timestamp:
Mar 4, 2013 10:32:22 AM (12 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
84076
Message:

Documentation: Backed out r82308, r82418 + r82419 (vbox-greeter documentation not needed yet).

File:
1 edited

Legend:

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

    r44874 r44906  
    252252      guest logons on platforms which support this framework. Virtually all
    253253      modern Linux/Unix distributions rely on PAM.</para>
    254 
    255       <para>For automated logons on Ubuntu (or Ubuntu-derived) distributions
    256       using LightDM as the display manager, please see
    257       <xref linkend="autologon_unix_lightdm" />.</para>
    258254
    259255      <para>The <computeroutput>pam_vbox.so</computeroutput> module itself
     
    410406          <computeroutput>debug</computeroutput> option.</para>
    411407        </note></para>
    412 
    413       <sect3 id="autologon_unix_lightdm">
    414         <title>VirtualBox Greeter for Ubuntu / LightDM</title>
    415 
    416         <para>Starting with version 4.2.6, VirtualBox comes with an own greeter
    417         module named vbox-greeter which can be used with LightDM 1.0.1 or later.
    418         LightDM is the default display manager since Ubuntu 10.11 and therefore
    419         also can be used for automated guest logons.</para>
    420 
    421         <para>vbox-greeter does not need the pam_vbox module described above
    422         in order to function -- it comes with its own authentication mechanism
    423         provided by LightDM. However, to provide maximum of flexibility both
    424         modules can be used together on the same guest.</para>
    425 
    426         <para>As for the pam_vbox module, vbox-greeter is shipped as part of
    427         the Guest Additions but it is not installed and/or activated on the
    428         guest OS by default For installing vbox-greeter automatically upon
    429         Guest Additions installation, use the
    430         <computeroutput>--with-autologon</computeroutput> switch when starting
    431         the VBoxLinuxAdditions.run file:<screen>
    432         # ./VBoxLinuxAdditions.run -- --with-autologon</screen></para>
    433 
    434         <para>For manual or postponed installation, the
    435         <computeroutput>vbox-greeter.desktop</computeroutput>
    436         file has to be copied from
    437         <computeroutput>/opt/VBoxGuestAdditions-&lt;version&gt;/shared/VBoxGuestAdditions/</computeroutput>
    438         to the <computeroutput>xgreeters</computeroutput> directory, usually
    439         <computeroutput>/usr/share/xgreeters/</computeroutput>.
    440         Please refer to your guest OS documentation for the correct LightDM
    441         greeter directory.</para>
    442 
    443         <para>The vbox-greeter module itself already was installed by the
    444         VirtualBox Guest Additions installer and resides in
    445         <computeroutput>/usr/sbin/</computeroutput>. To enable vbox-greeter as
    446         the standard greeter module, the file
    447         <computeroutput>/etc/lightdm/lightdm.conf</computeroutput> needs to be
    448         edited:</para>
    449 
    450         <para><screen>
    451         [SeatDefaults]
    452         greeter-session=vbox-greeter</screen></para>
    453 
    454         <note><para>The LightDM server needs to be fully restarted in order to
    455         get vbox-greeter used as the default greeter. As root, do a
    456         <computeroutput>service lightdm --full-restart</computeroutput> on
    457         Ubuntu, or simply restart the guest.</para></note>
    458 
    459         <note><para>vbox-greeter is independent of the graphical session chosen
    460         by the user (like Gnome, KDE, Unity etc). However it requires FLTK 1.3
    461         for representing its user interface.</para></note>
    462 
    463         <para>In addition to the guest property values of the
    464         pam_vbox module listed above, vbox-greeter has the following guest
    465         properties for further customizing its user interface, residing all in
    466         <computeroutput>/VirtualBox/GuestAdd/Greeter/</computeroutput>:</para>
    467 
    468         <orderedlist>
    469           <listitem>
    470             <para><computeroutput>HideRestart</computeroutput>: Set to "1" if
    471             vbox-greeter should hide the button to restart the guest. This
    472             property must be set read-only for the guest
    473             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    474           </listitem>
    475 
    476           <listitem>
    477             <para><computeroutput>HideShutdown</computeroutput>: Set to "1" if
    478             vbox-greeter should hide the button to shutdown the guest. This
    479             property must be set read-only for the guest
    480             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    481           </listitem>
    482 
    483           <listitem>
    484             <para><computeroutput>BannerPath</computeroutput>: Path to a .PNG
    485             file for using it as a banner on the top. The image size must be
    486             460 x 90 pixels, any bit depth. This property must be
    487             set read-only for the guest
    488             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    489           </listitem>
    490 
    491           <listitem>
    492             <para><computeroutput>UseTheming</computeroutput>: Set to "1" for
    493             turning on the following theming options. This property must be
    494             set read-only for the guest
    495             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    496           </listitem>
    497 
    498           <listitem>
    499             <para><computeroutput>Theme/BackgroundColor</computeroutput>:
    500             Hexadecimal RRGGBB color for the background. This property must be
    501             set read-only for the guest
    502             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    503           </listitem>
    504 
    505           <listitem>
    506             <para><computeroutput>Theme/LogonDialog/HeaderColor</computeroutput>:
    507             Hexadecimal RRGGBB foreground color for the header text. This
    508             property must be set read-only for the guest
    509             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    510           </listitem>
    511 
    512           <listitem>
    513             <para><computeroutput>Theme/LogonDialog/BackgroundColor</computeroutput>:
    514             Hexadecimal RRGGBB color for the logon dialog background. This
    515             property must be set read-only for the guest
    516             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    517           </listitem>
    518 
    519           <listitem>
    520             <para><computeroutput>Theme/LogonDialog/ButtonColor</computeroutput>:
    521             Hexadecimal RRGGBB background color for the logon dialog button. This
    522             property must be set read-only for the guest
    523             (<computeroutput>RDONLYGUEST</computeroutput>).</para>
    524           </listitem>
    525         </orderedlist>
    526 
    527         <note><para>The same restrictions for the guest properties above apply
    528         as for the ones specified in the pam_vbox section.</para></note>
    529       </sect3>
    530408    </sect2>
    531409  </sect1>
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