Skip to content

Improve libc presence detection#6170

Merged
arcanis merged 1 commit intoyarnpkg:masterfrom
dstaley:ldd-content-libc
Mar 27, 2024
Merged

Improve libc presence detection#6170
arcanis merged 1 commit intoyarnpkg:masterfrom
dstaley:ldd-content-libc

Conversation

@dstaley
Copy link
Contributor

@dstaley dstaley commented Mar 16, 2024

What's the problem this PR addresses?

On certain Linux distributions, /usr/bin/ldd does not contain the string "GLIBC", but "libc". This is the case in popular distros such as openSUSE, Amazon Linux, Fedora, RHEL, Arch, and more. On these distributions, the current version of yarn falls back to process.report.getReport(), which is known to have performance issues in some instances.

How did you fix it?

Add a check for the presence of the value libc in addition to the existing check for GLIBC. This allows more Linux users to benefit from the fast-path that does not rely on process.report.getReport().

Checklist

  • I have set the packages that need to be released for my changes to be effective.
  • I will check that all automated PR checks pass before the PR gets reviewed.

@arcanis arcanis merged commit a3e5695 into yarnpkg:master Mar 27, 2024
@arcanis
Copy link
Member

arcanis commented Mar 27, 2024

Thanks!

@ItsHarper
Copy link
Contributor

ItsHarper commented Jul 1, 2025

libc is a fully generic term though, and does not refer to any particular implementation. Chimera Linux is a musl-based distribution, but /usr/lib/ldd contains the string libc. If you actually run ldd --version, you'll see that the full string is musl libc.

I haven't tested all the distributions you listed, but at least on Arch, ldd contains the string GNU libc, which is what this PR should have referenced.

Going to open a PR soon.

arcanis pushed a commit that referenced this pull request Jul 26, 2025
## What's the problem this PR addresses?

Two problems:

1. #6170 broke `libc` detection on at least Alpine Linux and Chimera
Linux (and probably on all other `musl`-based distributions as well) by
looking for the generic string `libc` in `/usr/bin/ldd`. On both Chimera
and Alpine, `ldd --version` prints `musl libc` among the output.

2. `getLibc()` was doing unnecessary work on OSes other than Windows,
Mac, and Linux (I originally thought it would have been crashing, but
that's incorrect). ~~It strongly appears to me that `getLibc()` would
throw an error on any OS other than Windows, Mac, and Linux, as the
other OSes supported by node have their own libc implementations that
are neither `glibc` nor `musl`.~~
...

## How did you fix it?

1. The strings `GNU libc` and `GNU C Library` are searched for instead
of just `libc`.
* By default, `ldd` contains the text `GNU libc` in its `--version`
output, but that can be easily customized at build time using a build
configuration option (see
[here](https://github.com/bminor/glibc/blob/632d895f3e5d98162f77b9c3c1da4ec19968b671/elf/ldd.bash.in#L37)
and
[here](https://github.com/bminor/glibc/blob/632d895f3e5d98162f77b9c3c1da4ec19968b671/INSTALL#L273-L278)).
As a fallback, the text `GNU C Library` is found in the header of the
`ldd` script, and it will probably remain there as long as that file
remains a script (as opposed to a compiled binary).

2. I made `getLibc()` immediately return `null` on all non-Linux
platforms (not just Windows and macOS).

...

## Checklist

<!--- Don't worry if you miss something, chores are automatically
tested. -->
<!--- This checklist exists to help you remember doing the chores when
you submit a PR. -->
<!--- Put an `x` in all the boxes that apply. -->
- [x] I have read the [Contributing
Guide](https://yarnpkg.com/advanced/contributing).

<!-- See
https://yarnpkg.com/advanced/contributing#preparing-your-pr-to-be-released
for more details. -->
<!-- Check with `yarn version check` and fix with `yarn version check
-i` -->
- [x] I have set the packages that need to be released for my changes to
be effective.

<!-- The "Testing chores" workflow validates that your PR follows our
guidelines. -->
<!-- If it doesn't pass, click on it to see details as to what your PR
might be missing. -->
- [x] I will check that all automated PR checks pass before the PR gets
reviewed.
Saadnajmi pushed a commit to Saadnajmi/berry that referenced this pull request Jul 26, 2025
## What's the problem this PR addresses?

Two problems:

1. yarnpkg#6170 broke `libc` detection on at least Alpine Linux and Chimera
Linux (and probably on all other `musl`-based distributions as well) by
looking for the generic string `libc` in `/usr/bin/ldd`. On both Chimera
and Alpine, `ldd --version` prints `musl libc` among the output.

2. `getLibc()` was doing unnecessary work on OSes other than Windows,
Mac, and Linux (I originally thought it would have been crashing, but
that's incorrect). ~~It strongly appears to me that `getLibc()` would
throw an error on any OS other than Windows, Mac, and Linux, as the
other OSes supported by node have their own libc implementations that
are neither `glibc` nor `musl`.~~
...

## How did you fix it?

1. The strings `GNU libc` and `GNU C Library` are searched for instead
of just `libc`.
* By default, `ldd` contains the text `GNU libc` in its `--version`
output, but that can be easily customized at build time using a build
configuration option (see
[here](https://github.com/bminor/glibc/blob/632d895f3e5d98162f77b9c3c1da4ec19968b671/elf/ldd.bash.in#L37)
and
[here](https://github.com/bminor/glibc/blob/632d895f3e5d98162f77b9c3c1da4ec19968b671/INSTALL#L273-L278)).
As a fallback, the text `GNU C Library` is found in the header of the
`ldd` script, and it will probably remain there as long as that file
remains a script (as opposed to a compiled binary).

2. I made `getLibc()` immediately return `null` on all non-Linux
platforms (not just Windows and macOS).

...

## Checklist

<!--- Don't worry if you miss something, chores are automatically
tested. -->
<!--- This checklist exists to help you remember doing the chores when
you submit a PR. -->
<!--- Put an `x` in all the boxes that apply. -->
- [x] I have read the [Contributing
Guide](https://yarnpkg.com/advanced/contributing).

<!-- See
https://yarnpkg.com/advanced/contributing#preparing-your-pr-to-be-released
for more details. -->
<!-- Check with `yarn version check` and fix with `yarn version check
-i` -->
- [x] I have set the packages that need to be released for my changes to
be effective.

<!-- The "Testing chores" workflow validates that your PR follows our
guidelines. -->
<!-- If it doesn't pass, click on it to see details as to what your PR
might be missing. -->
- [x] I will check that all automated PR checks pass before the PR gets
reviewed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants