fscm/toolchain repository overview

⁠GNU Toolchain for Docker

An image with a GNU base Toolchain.

⁠Supported tags

• slim
• full, latest

⁠What is a Toolchain?

from wikipedia.org⁠

⁠What is included?

The image contains the following tools and libraries:

• Attr
• Autoconf
• Automake
• Binutils (1)
• Bison
• BZip2
• C Library (glibc) (1)
• Expat
• Gettext
• GCC (1)
• GDBM
• Libevent
• Libtool (1)
• Libuuid
• Libuv
• M4 (1)
• Make (1)
• Ncurses
• OpenSSL
• Patch
• Perl
• Pkg-config (1)
• Python3
• Readline
• SQLite
• Xz
• Zlib (1)

The tools and libraries marked with a (1) are the only ones present on the slim variant of The Docker image.

⁠Getting Started

There are a couple of things needed for the script to work.

⁠Prerequisites

Docker, either the Community Edition (CE) or Enterprise Edition (EE), needs to be installed on your local computer.

⁠Docker

Docker installation instructions can be found here⁠.

⁠Usage

The toolchain can be used in two different ways...

⁠Instantiate a Container

The toolchain can be used directly from the image by instantiating a container and executing the desired tool(s) on the container shell.

To start a container with this image - and have a shell - use the following command (the container will be deleted after exiting the shell):

docker container run --rm --interactive --tty fscm/toolchain sh

This will allow you to run any of the tools inside the this image. To take the most out of this method you can add you project code to the running container by defining your project folder as a working folder inside the container.

To start a container with this image and your project folder available inside use the following command:

docker container run --volume LOCAL_PROJECT_PATH:/work:rw --rm --interactive --tty fscm/toolchain sh

⁠Copy the Toolchain

The toolchain can also be used with your favorite image. The toolchain can be copied over to another image when using a Dockerfile. To use the toolchain in another image when building your own image use the following code in your Dockerfile:

ENV PATH="/usr/local/toolchain/bin:${PATH}"
COPY --from=fscm/toolchain "/usr/local/toolchain" "/usr/local/"

An example of a Dockerfile that copies the toolchain:

FROM fscm/centos

ENV PATH="/usr/local/toolchain/bin:${PATH}"

COPY --from=fscm/toolchain "/usr/local/toolchain" "/usr/local/toolchain"

RUN gcc --version

⁠Build

Build instructions can be found here⁠.

⁠Versioning

This project uses SemVer⁠ for versioning. For the versions available, see the tags on this repository⁠.

⁠Authors

• Frederico Martins - fscm⁠

See also the list of contributors⁠ who participated in this project.