From 19751a4fa4dd4678297e9269a68d3ad2fcb35e81 Mon Sep 17 00:00:00 2001
From: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
Date: Thu, 17 Oct 2024 02:43:27 +0900
Subject: [PATCH 1/4] Modify libglvnd information
---
docs/maintainer/knowledge_base.md | 41 +++++--------------------------
docs/maintainer/maintainer_faq.md | 8 +++++-
2 files changed, 13 insertions(+), 36 deletions(-)
diff --git a/docs/maintainer/knowledge_base.md b/docs/maintainer/knowledge_base.md
index 144e0f9cc0..14521dff0b 100644
--- a/docs/maintainer/knowledge_base.md
+++ b/docs/maintainer/knowledge_base.md
@@ -697,12 +697,7 @@ practice has been deprecated.) To add a new CDT, make a PR on the
1. When there are system specific configurations are used by the library.
Some examples include:
- 1. OpenGL: if we provided the OpenGL loader library `libglvnd`.
- and the user's system is not using `libglvnd`, then we cannot load the vendor-specific
- implementations losing out on accelerator/hardware optimized performance.
- (This is only on old distributions and we may finally be able to package `libglvnd`
- ourselves)
- 2. linux-pam: This is a library that allows pluggable authentication modules and the
+ 1. linux-pam: This is a library that allows pluggable authentication modules and the
configuration files for these modules usually live in `/etc/pam.d`. The issue is that
the pluggable modules live in a distro specific location. For example:
`/usr/lib/x86_64-linux-gnu/security/`. The default modules are built into the
@@ -715,9 +710,9 @@ practice has been deprecated.) To add a new CDT, make a PR on the
For example: a new `glibc` package means we would have to edit the elf interpreter of
all the conda package binaries.
-
+
-#### What's are some good examples?
+#### What are some good examples?
1. The OpenCL loader (`ocl-icd` together with `ocl-icd-system`) provides an OpenCL
loading library. The loader will look at OpenCL implementations given in
@@ -730,42 +725,18 @@ practice has been deprecated.) To add a new CDT, make a PR on the
run OpenCL because we have a conda packaged installation, but if there is a system wide
implementation that is accelerated by specific hardware, we can use those.
-In conda-forge the primary usages of CDTs is currently for packages that link against libGL.
-
-#### libGL
+### libGL
-In addition to the required compilers `{{ compiler('c') }}` and/or `{{ compiler('cxx') }}`,
-the following CDT packages are required for linking against libGL:
+Note that packages dependent on libGL should no longer use CDTs. Instead, use the host dependency `libgl-devel` from the [libglvnd-feedstock](https://github.com/conda-forge/libglvnd-feedstock).
```yaml
requirements:
- build:
- - {{ cdt('mesa-libgl-devel') }} # [linux]
- - {{ cdt('mesa-dri-drivers') }} # [linux]
- - {{ cdt('libselinux') }} # [linux]
- - {{ cdt('libxdamage') }} # [linux]
- - {{ cdt('libxxf86vm') }} # [linux]
- - {{ cdt('libxext') }} # [linux]
host:
- - xorg-libxfixes # [linux]
-```
-
-If you need a fully functional binary in the test phase, you have to also provide the shared
-libraries via `yum_requirements.txt` (see [yum_requirements.txt](#yum-deps)).
-
-```text
-mesa-libGL
-mesa-dri-drivers
-libselinux
-libXdamage
-libXxf86vm
-libXext
+ - libgl-devel # [linux]
```
-You will need to re-render the feedstock after making these changes.
-
diff --git a/docs/maintainer/maintainer_faq.md b/docs/maintainer/maintainer_faq.md
index a83b1b99c6..208d6da6fa 100644
--- a/docs/maintainer/maintainer_faq.md
+++ b/docs/maintainer/maintainer_faq.md
@@ -131,7 +131,13 @@ Error:
ImportError: libGL.so.1: cannot open shared object file: No such file or directory
```
-If you saw this error while building a package in your feedstock, create a [yum_requirements.txt](knowledge_base.md#yum-deps) file and add `mesa-libGL`. See also [CDTs: `libgl`](./knowledge_base.md#libgl).
+If you saw this error while building a package in your feedstock, add the Linux host dependency `libgl-devel`, provided by the [libglvnd-feedstock](https://github.com/conda-forge/libglvnd-feedstock).
+
+```yaml
+requirements:
+ host:
+ - libgl-devel # [linux]
+```
If you are seeing this error after installing a package locally, then you are missing an [OpenGL](https://en.wikipedia.org/wiki/OpenGL) provider in your system dependencies. This is more likely to happen in headless systems with no graphics (servers, Docker images, etc). To fix it, you must install a provider like [Mesa](https://www.mesa3d.org/) with your system package manager.
From b28ca0589667b40b8690da16f1e451d98e58c2a5 Mon Sep 17 00:00:00 2001
From: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
Date: Thu, 17 Oct 2024 02:46:00 +0900
Subject: [PATCH 2/4] Minor update
---
docs/maintainer/knowledge_base.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/maintainer/knowledge_base.md b/docs/maintainer/knowledge_base.md
index 14521dff0b..8e959b5a68 100644
--- a/docs/maintainer/knowledge_base.md
+++ b/docs/maintainer/knowledge_base.md
@@ -729,7 +729,7 @@ practice has been deprecated.) To add a new CDT, make a PR on the
### libGL
-Note that packages dependent on libGL should no longer use CDTs. Instead, use the host dependency `libgl-devel` from the [libglvnd-feedstock](https://github.com/conda-forge/libglvnd-feedstock).
+Note that packages dependent on OpenGL and/or libGL should no longer use CDTs. Instead, use the host dependency `libgl-devel` from the [libglvnd-feedstock](https://github.com/conda-forge/libglvnd-feedstock).
```yaml
requirements:
From a3cf048c463721e2e5f5e32d0ae8a0763c208f15 Mon Sep 17 00:00:00 2001
From: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
Date: Thu, 17 Oct 2024 02:53:10 +0900
Subject: [PATCH 3/4] Add more OpenGL information
---
docs/maintainer/knowledge_base.md | 2 ++
docs/maintainer/maintainer_faq.md | 2 ++
2 files changed, 4 insertions(+)
diff --git a/docs/maintainer/knowledge_base.md b/docs/maintainer/knowledge_base.md
index 8e959b5a68..338d18112d 100644
--- a/docs/maintainer/knowledge_base.md
+++ b/docs/maintainer/knowledge_base.md
@@ -737,6 +737,8 @@ requirements:
- libgl-devel # [linux]
```
+Other OpenGL API variants such as `libegl-devel`, `libgles-devel`, `libglx-devel`, and `libopengl-devel` are also available, and will automatically add non-development `run_exports` dependencies.
+
diff --git a/docs/maintainer/maintainer_faq.md b/docs/maintainer/maintainer_faq.md
index 208d6da6fa..2e5e0829af 100644
--- a/docs/maintainer/maintainer_faq.md
+++ b/docs/maintainer/maintainer_faq.md
@@ -139,6 +139,8 @@ requirements:
- libgl-devel # [linux]
```
+Other OpenGL API variants such as `libegl-devel`, `libgles-devel`, `libglx-devel`, and `libopengl-devel` are also available, and will automatically add non-development `run_exports` dependencies.
+
If you are seeing this error after installing a package locally, then you are missing an [OpenGL](https://en.wikipedia.org/wiki/OpenGL) provider in your system dependencies. This is more likely to happen in headless systems with no graphics (servers, Docker images, etc). To fix it, you must install a provider like [Mesa](https://www.mesa3d.org/) with your system package manager.
From 9e5f58bb272e2d0c72fdcb72fd0b107c7c06f4cf Mon Sep 17 00:00:00 2001
From: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
Date: Thu, 17 Oct 2024 08:14:48 +0900
Subject: [PATCH 4/4] Restore IDs
---
docs/maintainer/knowledge_base.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/maintainer/knowledge_base.md b/docs/maintainer/knowledge_base.md
index 338d18112d..9609fb8ab8 100644
--- a/docs/maintainer/knowledge_base.md
+++ b/docs/maintainer/knowledge_base.md
@@ -710,9 +710,9 @@ practice has been deprecated.) To add a new CDT, make a PR on the
For example: a new `glibc` package means we would have to edit the elf interpreter of
all the conda package binaries.
-
+
-#### What are some good examples?
+#### What's are some good examples?
1. The OpenCL loader (`ocl-icd` together with `ocl-icd-system`) provides an OpenCL
loading library. The loader will look at OpenCL implementations given in