Skip to content

docs: document glibc >= 2.34 prerequisite (fixes #28)#86

Merged
junjihashimoto merged 1 commit into
mainfrom
docs/glibc-prerequisite
Jul 1, 2026
Merged

docs: document glibc >= 2.34 prerequisite (fixes #28)#86
junjihashimoto merged 1 commit into
mainfrom
docs/glibc-prerequisite

Conversation

@junjihashimoto

Copy link
Copy Markdown
Contributor

Closes #28.

lake build on Ubuntu 20.04 (glibc 2.31) aborts with:

.../bin/cadical: /lib/x86_64-linux-gnu/libc.so.6:
  version `GLIBC_2.34' not found (required by .../cadical)

cadical is the SAT solver bundled with the Lean 4.28
toolchain
(used by bv_decide / omega), linked against
glibc 2.34 — so anything older can't load it. This is a
Lean-toolchain requirement, not a Sparkle bug (nothing in
Sparkle's own code can change it).

But the README Quick Start and docs/Tutorial.md Prerequisites
listed no minimum OS/glibc, so a 20.04 user hit the error with
zero guidance. This adds a prerequisite note to both:

  • glibc ≥ 2.34 → Ubuntu 22.04+ / Debian 12+ / Fedora 35+ /
    macOS / WSL2, or use the Docker path.
  • Reproduces the exact error string so it's greppable by the
    next person who searches for it.

No code change — docs only.

Issue #28: `lake build` on Ubuntu 20.04 (glibc 2.31) aborts with

    .../bin/cadical: /lib/x86_64-linux-gnu/libc.so.6:
      version `GLIBC_2.34' not found

`cadical` is the SAT solver bundled with the Lean 4.28 toolchain
(used by `bv_decide` / `omega`); it's linked against glibc 2.34,
so anything older can't load it.  This is a Lean-toolchain
requirement, not something Sparkle can fix in code — but the
README Quick Start and Tutorial Prerequisites didn't mention any
minimum OS/glibc, so a 20.04 user hit the error with no guidance.

Add a prerequisite note to both (glibc >= 2.34 → Ubuntu 22.04+ /
Debian 12+ / Fedora 35+ / macOS / WSL2, or use Docker),
reproducing the exact error string so it's greppable.
@junjihashimoto junjihashimoto merged commit b3b68d1 into main Jul 1, 2026
6 checks passed
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.

GLIBC_2.34 ia requied

1 participant