icecc-create-env man page

icecc-create-env ā€” Create an Icrecream environment tarball


icecc-create-env --gcc gcc-path g++-path [--addfile file]... icecc-create-env --clang clang-path compiler-wrapper [--addfile file]...


icecc-create-env is an Icecream helper that creates a new .tar.gz archive with all the files (compiler, tools and libraries) needed to setup a build environment.

Specifying --gcc or --clang as first argument decides which compiler (GCC or Clang) is copied in the archive.

The resulting archive has a random file name like ddaea39ca1a7c88522b185eca04da2d8.tar.gz, which can then be renamed. See icecream(7) for more information on using the environment tarballs.

Note that in the usual case it is not necessary to invoke icecc-create-env manually, as it will be called automatically for the native compiler used whenever necessary.


--gcc gcc-path g++-path

GCC is used in the archive.

gcc-path and g++-path represent respectively the paths to the gcc and g++ executables.

--clang clang-path compiler-wrapper

Clang is used in the archive.

clang-path represents the path to the clang executable; compiler-wrapper is the path to a compiler wrapper, usually /usr/lib/icecc/compilerwrapper, used with old Icecream clients which hardcode /usr/bin/gcc and /usr/bin/g++ and thus would not use Clang.

--addfile file

Add file to the environment archive; can be specified multiple times.

See Also

icecream(7), icecc-scheduler(1), iceccd(1)


Pino Toscano


June 5rd, 2013