Difference between pages "Install/Media" and "News:New OpenGL management in Funtoo"

< Install(Difference between pages)
m
 
(upgrade process & post upgrade)
 
Line 1: Line 1:
== Install Media ==
+
{{News
Most any live or minimal install media iso images can install funtoo.  Funtoo suggests sysrescuecd.  Images may be burned to cd, or loaded on a usb thumb drive by either dd or unetbootin. Unetbootin has linux, windows, and mac binaries so anyone can install funtoo from live usb media.
+
|Summary=Funtoo is switching to an improved system for managing multiple OpenGL providers (Mesa/Xorg, AMD and nVidia). The update may involve blockers and file collisions.
 +
|News Format=Extended
 +
|News Category=Packages
 +
|Author=Mgorny
 +
|Publication Status=Draft
 +
|Publication Date=2015/02/28
 +
}}
 +
== New OpenGL management ==
 +
=== System principles ===
 +
The new OpenGL management design assumes that the reference OpenGL implementation (mesa/Xorg) is to be used to build packages. After switching to the new system, all packages will use the mesa/Xorg headers and link to the mesa/Xorg libraries. This improves portability of software built on Funtoo and solves some of the build failures when non-standard OpenGL provider was enabled.
  
{{TableStart}}
+
The third-party OpenGL libraries and modules provided by proprietary driver vendors can be enabled for run-time program use. They will not affect how the program is built. However, they will be loaded by the dynamic loader when starting executables. The Xorg server will also load the modules provided by blob driver vendor if appropriate.
<tr class="info"><th>distro</th><th>gui</th><th>uefi support</th><th>unetbootin support</th><th>architecture specific</th><th>notes</th></tr>
+
<tr><td>[http://www.sysresccd.org/Download Sysrescuecd]</td><td>yes</td><td>yes</td><td>no</td><td>no</td><td>recommended media</td></tr>
+
<tr><td>[http://www.ubuntu.com/download/desktop Ubuntu]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>must download specific architecture</td></tr>
+
<tr><td>[https://www.debian.org/CD/live/ Debian]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>must download specific architecture</td></tr>
+
<tr><td>[https://fedoraproject.org/wiki/FedoraLiveCD Fedora]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>untested</td></tr>
+
<tr><td>[http://wiki.centos.org/Download CentOS]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>untested</td></tr>
+
<tr><td>[https://software.opensuse.org/132/en open suse]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>link in the green outline displays live iso images</td></tr>
+
<tr><td>[http://www.mageia.org/en/downloads/ mageia]</td><td>yes</td><td>unknown</td><td>yes</td><td>yes</td><td>untested</td></tr>
+
<tr><td>[https://get.gentoo.org/ Gentoo minimal install]</td><td>no</td><td>unknown</td><td>probably</td><td>yes</td><td>must download specific architecture</td></tr>
+
{{TableEnd}}
+
  
i [[User:Threesixes|Threesixes]] ([[User talk:Threesixes|talk]]) suggest we target top 10 distros live media setups.... http://distrowatch.com/dwres.php?resource=popularity  not sure if there is a unetbootin page or not
+
=== Implementation ===
 +
The reference implementation (mesa/Xorg) packages install headers and libraries into standard system locations (/usr/include, /usr/lib*). The compiler and linker finds them using the usual rules and uses them.
 +
 
 +
The third-party OpenGL vendors install libraries and server extension modules into vendor-named subdirectories of /usr/lib*/opengl. Those files are not used directly.
 +
 
 +
{{Package|app-admin/eselect-opengl}} is used to select OpenGL implementation used at run-time. The choice of implementation is controlled via dynamic linker configuration (ld.so.conf) and Xorg server configuration. If the reference implementation is selected, the eselect module outputs null configuration that causes the linker and server to use the standard paths. If an another implementation is selected, the configuration prepends /usr/lib*/opengl paths to linker and server configuration, causing them to prefer the third-party libraries over reference.
 +
 
 +
== Upgrade information ==
 +
=== Before upgrade ===
 +
Please note that the OpenGL subsystem upgrade is a lock-step update involving file collisions and blockers. This means that a few packages need to be upgraded consecutively during a single emerge run, and during that process the OpenGL support may become temporarily broken. If the upgrade is interrupted, your system may require manual attention.
 +
 
 +
Therefore, before upgrading please make sure that you can upgrade all the following packages, if installed:
 +
* x11-base/xorg-server to 1.16.4-r1 or newer,
 +
* media-libs/mesa to 10.3.4-r1 or newer,
 +
* x11-proto/glproto to 1.4.17-r1 or newer,
 +
* x11-drivers/ati-drivers to 14.9-r2 or newer,
 +
* app-emulation/emul-linux-x86-opengl to 20140508-r1 or newer.
 +
 
 +
If you need to use an older version of one of those packages long-term, please report a bug so that we can backport the support for the new system to it.
 +
 
 +
Additionally, please make sure to not enable FEATURES=collision-protect for the upgrade since it will involve replacing some of externally created symlinks with package files. FEATURES=protect-owned (enabled by default) is fine.
 +
 
 +
=== The upgrade process ===
 +
Normally, the upgrade should be performed as part of a regular @world upgrade.
 +
 
 +
However, if one desires to perform the upgrade stand-alone, he needs to pass all installed packages from the following list to emerge:
 +
* app-admin/eselect-opengl,
 +
* app-emulation/emul-linux-x86-opengl,
 +
* media-libs/mesa,
 +
* x11-base/xorg-server,
 +
* x11-drivers/ati-drivers,
 +
* x11-proto/glproto.
 +
 
 +
=== Post upgrade ===
 +
There should be no manual steps needed after the upgrade. The currently selected OpenGL implementation will be activated automatically.
 +
 
 +
{{NewsFooter}}

Revision as of 19:24, February 28, 2015

New OpenGL management in Funtoo

Funtoo is switching to an improved system for managing multiple OpenGL providers (Mesa/Xorg, AMD and nVidia). The update may involve blockers and file collisions.

By Mgorny / February 28, 2015

New OpenGL management

System principles

The new OpenGL management design assumes that the reference OpenGL implementation (mesa/Xorg) is to be used to build packages. After switching to the new system, all packages will use the mesa/Xorg headers and link to the mesa/Xorg libraries. This improves portability of software built on Funtoo and solves some of the build failures when non-standard OpenGL provider was enabled.

The third-party OpenGL libraries and modules provided by proprietary driver vendors can be enabled for run-time program use. They will not affect how the program is built. However, they will be loaded by the dynamic loader when starting executables. The Xorg server will also load the modules provided by blob driver vendor if appropriate.

Implementation

The reference implementation (mesa/Xorg) packages install headers and libraries into standard system locations (/usr/include, /usr/lib*). The compiler and linker finds them using the usual rules and uses them.

The third-party OpenGL vendors install libraries and server extension modules into vendor-named subdirectories of /usr/lib*/opengl. Those files are not used directly.

Package:Eselect (OpenGL) is used to select OpenGL implementation used at run-time. The choice of implementation is controlled via dynamic linker configuration (ld.so.conf) and Xorg server configuration. If the reference implementation is selected, the eselect module outputs null configuration that causes the linker and server to use the standard paths. If an another implementation is selected, the configuration prepends /usr/lib*/opengl paths to linker and server configuration, causing them to prefer the third-party libraries over reference.

Upgrade information

Before upgrade

Please note that the OpenGL subsystem upgrade is a lock-step update involving file collisions and blockers. This means that a few packages need to be upgraded consecutively during a single emerge run, and during that process the OpenGL support may become temporarily broken. If the upgrade is interrupted, your system may require manual attention.

Therefore, before upgrading please make sure that you can upgrade all the following packages, if installed:

  • x11-base/xorg-server to 1.16.4-r1 or newer,
  • media-libs/mesa to 10.3.4-r1 or newer,
  • x11-proto/glproto to 1.4.17-r1 or newer,
  • x11-drivers/ati-drivers to 14.9-r2 or newer,
  • app-emulation/emul-linux-x86-opengl to 20140508-r1 or newer.

If you need to use an older version of one of those packages long-term, please report a bug so that we can backport the support for the new system to it.

Additionally, please make sure to not enable FEATURES=collision-protect for the upgrade since it will involve replacing some of externally created symlinks with package files. FEATURES=protect-owned (enabled by default) is fine.

The upgrade process

Normally, the upgrade should be performed as part of a regular @world upgrade.

However, if one desires to perform the upgrade stand-alone, he needs to pass all installed packages from the following list to emerge:

  • app-admin/eselect-opengl,
  • app-emulation/emul-linux-x86-opengl,
  • media-libs/mesa,
  • x11-base/xorg-server,
  • x11-drivers/ati-drivers,
  • x11-proto/glproto.

Post upgrade

There should be no manual steps needed after the upgrade. The currently selected OpenGL implementation will be activated automatically.

blog comments powered by Disqus