Release Process for Linaro glibc

This process describes how to produce a source tarball from git. This is the process for glibc, which is relevant to glibc 2.20 and later. Previous toolchain releases used eglibc.

Prepare Sources

  1. Check out a fresh source tree:
    git clone ssh://
    cd glibc
    git checkout linaro/2.xx/master
  2. Check that we are up to date with the latest stable branch from upstream.
    git merge origin/release/2.xx/master
  3. Add a ChangeLog entry to the start of ChangeLog.linaro:

    20XX-XX-XX  First Last  <email@address>
            glibc Linaro 2.XX-20XX.XX[-X] released.
            * version.h (VERSION): Update.
    Note on release numbers: The main release for a given month's milestone is called 2.X-20XX.XX (e.g. 2.17-2013.06). Subsequent respins (if necessary) carry an additional respin number, starting at 1 (e.g. 2.17-2013.06-1).
  4. Edit version.h:

    #define VERSION "2.XX-20XX.XX"
  5. Check in the changes, and tag them
    git add -u
    git commit -m "version.h: Update VERSION for 20XX.XX[-X] release."
    git tag -a -m "Linaro glibc 2.XX 20XX.XX release" linaro_glibc-2_XX-20XX_XX[-X]_release
    git push --tags

Create the tarballs

  1. Export the sources
    git archive --format=tar --prefix=glibc-linaro-2.XX-20XX.XX-X/ HEAD | \
        xz >../glibc-linaro-2.XX-20XX.XX-X.tar.xz

Bump the development version number

  1. Edit version.h:

    #define VERSION "2.XX-20XX.XX-Y-git"

    (where Y is the number of the next respin, or 1 if this was the main release).

  2. Add this to the start of ChangeLog.linaro:

    20XX-XX-XX  First Last  <email@address>
            * version.h (VERSION): Bump for development.
  3. Check in the changes
    git add -u
    git commit -m"version.h: Bump version."
    git push

Verify the release

  1. Build and test the release sources as thoroughly as possible.
    • Build glibc and run the testsuite on ARM
    • Build glibc and run the testsuite AArch64.

Publishing the release

See WorkingGroups/ToolChain/PublishingARelease.

WorkingGroups/ToolChain/GlibcReleaseProcess (last modified 2015-02-10 23:48:22)