···
1
+
# DO NOT port this expression to hadrian. It is not possible to build a GHC
2
+
# cross compiler with 9.4.* and hadrian.
3
+
{ lib, stdenv, pkgsBuildTarget, pkgsHostTarget, targetPackages
7
+
, autoconf, automake, coreutils, fetchpatch, fetchurl, perl, python3, m4, sphinx
8
+
, xattr, autoSignDarwinBinariesHook
11
+
, libiconv ? null, ncurses
12
+
, glibcLocales ? null
14
+
, # GHC can be built with system libffi or a bundled one.
17
+
, useLLVM ? !(stdenv.targetPlatform.isx86
18
+
|| stdenv.targetPlatform.isPower
19
+
|| stdenv.targetPlatform.isSparc
20
+
|| (stdenv.targetPlatform.isAarch64 && stdenv.targetPlatform.isDarwin))
21
+
, # LLVM is conceptually a run-time-only depedendency, but for
22
+
# non-x86, we need LLVM to bootstrap later stages, so it becomes a
23
+
# build-time dependency too.
24
+
buildTargetLlvmPackages, llvmPackages
26
+
, # If enabled, GHC will be built with the GPL-free but slightly slower native
27
+
# bignum backend instead of the faster but GPLed gmp backend.
28
+
enableNativeBignum ? !(lib.meta.availableOn stdenv.hostPlatform gmp)
31
+
, # If enabled, use -fPIC when compiling static libs.
32
+
enableRelocatedStaticLibs ? stdenv.targetPlatform != stdenv.hostPlatform
34
+
# aarch64 outputs otherwise exceed 2GB limit
35
+
, enableProfiledLibs ? !stdenv.targetPlatform.isAarch64
37
+
, # Whether to build dynamic libs for the standard library (on the target
38
+
# platform). Static libs are always built.
39
+
enableShared ? with stdenv.targetPlatform; !isWindows && !useiOSPrebuilt && !isStatic
41
+
, # Whether to build terminfo.
42
+
enableTerminfo ? !stdenv.targetPlatform.isWindows
44
+
, # What flavour to build. An empty string indicates no
45
+
# specific flavour and falls back to ghc default values.
46
+
ghcFlavour ? lib.optionalString (stdenv.targetPlatform != stdenv.hostPlatform)
47
+
(if useLLVM then "perf-cross" else "perf-cross-ncg")
49
+
, # Whether to build sphinx documentation.
51
+
# Docs disabled for musl and cross because it's a large task to keep
52
+
# all `sphinx` dependencies building in those environments.
53
+
# `sphinx` pulls in among others:
54
+
# Ruby, Python, Perl, Rust, OpenGL, Xorg, gtk, LLVM.
55
+
(stdenv.targetPlatform == stdenv.hostPlatform)
56
+
&& !stdenv.hostPlatform.isMusl
59
+
, enableHaddockProgram ?
60
+
# Disabled for cross; see note [HADDOCK_DOCS].
61
+
(stdenv.targetPlatform == stdenv.hostPlatform)
63
+
, # Whether to disable the large address space allocator
64
+
# necessary fix for iOS: https://www.reddit.com/r/haskell/comments/4ttdz1/building_an_osxi386_to_iosarm64_cross_compiler/d5qvd67/
65
+
disableLargeAddressSpace ? stdenv.targetPlatform.isiOS
68
+
assert !enableNativeBignum -> gmp != null;
70
+
# Cross cannot currently build the `haddock` program for silly reasons,
71
+
# see note [HADDOCK_DOCS].
72
+
assert (stdenv.targetPlatform != stdenv.hostPlatform) -> !enableHaddockProgram;
75
+
inherit (stdenv) buildPlatform hostPlatform targetPlatform;
77
+
inherit (bootPkgs) ghc;
79
+
# TODO(@Ericson2314) Make unconditional
80
+
targetPrefix = lib.optionalString
81
+
(targetPlatform != hostPlatform)
82
+
"${targetPlatform.config}-";
85
+
BuildFlavour = ${ghcFlavour}
86
+
ifneq \"\$(BuildFlavour)\" \"\"
87
+
include mk/flavours/\$(BuildFlavour).mk
89
+
BUILD_SPHINX_HTML = ${if enableDocs then "YES" else "NO"}
90
+
BUILD_SPHINX_PDF = NO
92
+
# Note [HADDOCK_DOCS]:
93
+
# Unfortunately currently `HADDOCK_DOCS` controls both whether the `haddock`
94
+
# program is built (which we generally always want to have a complete GHC install)
95
+
# and whether it is run on the GHC sources to generate hyperlinked source code
96
+
# (which is impossible for cross-compilation); see:
97
+
# https://gitlab.haskell.org/ghc/ghc/-/issues/20077
98
+
# This implies that currently a cross-compiled GHC will never have a `haddock`
99
+
# program, so it can never generate haddocks for any packages.
100
+
# If this is solved in the future, we'd like to unconditionally
101
+
# build the haddock program (removing the `enableHaddockProgram` option).
103
+
HADDOCK_DOCS = ${if enableHaddockProgram then "YES" else "NO"}
104
+
# Build haddocks for boot packages with hyperlinking
105
+
EXTRA_HADDOCK_OPTS += --hyperlinked-source --quickjump
107
+
DYNAMIC_GHC_PROGRAMS = ${if enableShared then "YES" else "NO"}
108
+
BIGNUM_BACKEND = ${if enableNativeBignum then "native" else "gmp"}
109
+
'' + lib.optionalString (targetPlatform != hostPlatform) ''
110
+
Stage1Only = ${if targetPlatform.system == hostPlatform.system then "NO" else "YES"}
111
+
CrossCompilePrefix = ${targetPrefix}
112
+
'' + lib.optionalString (!enableProfiledLibs) ''
113
+
GhcLibWays = "v dyn"
115
+
# -fexternal-dynamic-refs apparently (because it's not clear from the documentation)
116
+
# makes the GHC RTS able to load static libraries, which may be needed for TemplateHaskell.
117
+
# This solution was described in https://www.tweag.io/blog/2020-09-30-bazel-static-haskell
118
+
lib.optionalString enableRelocatedStaticLibs ''
119
+
GhcLibHcOpts += -fPIC -fexternal-dynamic-refs
120
+
GhcRtsHcOpts += -fPIC -fexternal-dynamic-refs
121
+
'' + lib.optionalString targetPlatform.useAndroidPrebuilt ''
122
+
EXTRA_CC_OPTS += -std=gnu99
125
+
# Splicer will pull out correct variations
126
+
libDeps = platform: lib.optional enableTerminfo ncurses
128
+
++ lib.optional (!enableNativeBignum) gmp
129
+
++ lib.optional (platform.libc != "glibc" && !targetPlatform.isWindows) libiconv;
131
+
# TODO(@sternenseemann): is buildTarget LLVM unnecessary?
132
+
# GHC doesn't seem to have {LLC,OPT}_HOST
134
+
pkgsBuildTarget.targetPackages.stdenv.cc
135
+
] ++ lib.optional useLLVM buildTargetLlvmPackages.llvm;
137
+
targetCC = builtins.head toolsForTarget;
139
+
# Sometimes we have to dispatch between the bintools wrapper and the unwrapped
140
+
# derivation for certain tools depending on the platform.
142
+
# GHC needs install_name_tool on all darwin platforms. On aarch64-darwin it is
143
+
# part of the bintools wrapper (due to codesigning requirements), but not on
145
+
install_name_tool =
146
+
if stdenv.targetPlatform.isAarch64
147
+
then targetCC.bintools
148
+
else targetCC.bintools.bintools;
149
+
# Same goes for strip.
151
+
# TODO(@sternenseemann): also use wrapper if linker == "bfd" or "gold"
152
+
if stdenv.targetPlatform.isAarch64 && stdenv.targetPlatform.isDarwin
153
+
then targetCC.bintools
154
+
else targetCC.bintools.bintools;
157
+
# Use gold either following the default, or to avoid the BFD linker due to some bugs / perf issues.
158
+
# But we cannot avoid BFD when using musl libc due to https://sourceware.org/bugzilla/show_bug.cgi?id=23856
159
+
# see #84670 and #49071 for more background.
160
+
useLdGold = targetPlatform.linker == "gold" ||
161
+
(targetPlatform.linker == "bfd" && (targetCC.bintools.bintools.hasGold or false) && !targetPlatform.isMusl);
163
+
# Makes debugging easier to see which variant is at play in `nix-store -q --tree`.
164
+
variantSuffix = lib.concatStrings [
165
+
(lib.optionalString stdenv.hostPlatform.isMusl "-musl")
166
+
(lib.optionalString enableNativeBignum "-native-bignum")
171
+
# C compiler, bintools and LLVM are used at build time, but will also leak into
172
+
# the resulting GHC's settings file and used at runtime. This means that we are
173
+
# currently only able to build GHC if hostPlatform == buildPlatform.
174
+
assert targetCC == pkgsHostTarget.targetPackages.stdenv.cc;
175
+
assert buildTargetLlvmPackages.llvm == llvmPackages.llvm;
176
+
assert stdenv.targetPlatform.isDarwin -> buildTargetLlvmPackages.clang == llvmPackages.clang;
178
+
stdenv.mkDerivation (rec {
180
+
pname = "${targetPrefix}ghc${variantSuffix}";
183
+
url = "https://downloads.haskell.org/ghc/${version}/ghc-${version}-src.tar.xz";
184
+
sha256 = "7227ef3b5e15a0d70b8f1a43aec32867e2a9b2d857cc0ed556aeed172d4db3a5";
187
+
enableParallelBuilding = true;
189
+
outputs = [ "out" "doc" ];
192
+
postPatch = "patchShebangs .";
194
+
# GHC needs the locale configured during the Haddock phase.
195
+
LANG = "en_US.UTF-8";
197
+
# GHC is a bit confused on its cross terminology.
198
+
# TODO(@sternenseemann): investigate coreutils dependencies and pass absolute paths
200
+
for env in $(env | grep '^TARGET_' | sed -E 's|\+?=.*||'); do
201
+
export "''${env#TARGET_}=''${!env}"
203
+
# GHC is a bit confused on its cross terminology, as these would normally be
204
+
# the *host* tools.
205
+
export CC="${targetCC}/bin/${targetCC.targetPrefix}cc"
206
+
export CXX="${targetCC}/bin/${targetCC.targetPrefix}c++"
207
+
# Use gold to work around https://sourceware.org/bugzilla/show_bug.cgi?id=16177
208
+
export LD="${targetCC.bintools}/bin/${targetCC.bintools.targetPrefix}ld${lib.optionalString useLdGold ".gold"}"
209
+
export AS="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}as"
210
+
export AR="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}ar"
211
+
export NM="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}nm"
212
+
export RANLIB="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}ranlib"
213
+
export READELF="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}readelf"
214
+
export STRIP="${bintoolsFor.strip}/bin/${bintoolsFor.strip.targetPrefix}strip"
215
+
'' + lib.optionalString (stdenv.targetPlatform.linker == "cctools") ''
216
+
export OTOOL="${targetCC.bintools.bintools}/bin/${targetCC.bintools.targetPrefix}otool"
217
+
export INSTALL_NAME_TOOL="${bintoolsFor.install_name_tool}/bin/${bintoolsFor.install_name_tool.targetPrefix}install_name_tool"
218
+
'' + lib.optionalString useLLVM ''
219
+
export LLC="${lib.getBin buildTargetLlvmPackages.llvm}/bin/llc"
220
+
export OPT="${lib.getBin buildTargetLlvmPackages.llvm}/bin/opt"
221
+
'' + lib.optionalString (useLLVM && stdenv.targetPlatform.isDarwin) ''
222
+
# LLVM backend on Darwin needs clang: https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/codegens.html#llvm-code-generator-fllvm
223
+
export CLANG="${buildTargetLlvmPackages.clang}/bin/${buildTargetLlvmPackages.clang.targetPrefix}clang"
226
+
echo -n "${buildMK}" > mk/build.mk
228
+
sed -i -e 's|-isysroot /Developer/SDKs/MacOSX10.5.sdk||' configure
229
+
'' + lib.optionalString (stdenv.isLinux && hostPlatform.libc == "glibc") ''
230
+
export LOCALE_ARCHIVE="${glibcLocales}/lib/locale/locale-archive"
231
+
'' + lib.optionalString (!stdenv.isDarwin) ''
232
+
export NIX_LDFLAGS+=" -rpath $out/lib/ghc-${version}"
233
+
'' + lib.optionalString stdenv.isDarwin ''
234
+
export NIX_LDFLAGS+=" -no_dtrace_dof"
236
+
# GHC tries the host xattr /usr/bin/xattr by default which fails since it expects python to be 2.7
237
+
export XATTR=${lib.getBin xattr}/bin/xattr
238
+
'' + lib.optionalString targetPlatform.useAndroidPrebuilt ''
239
+
sed -i -e '5i ,("armv7a-unknown-linux-androideabi", ("e-m:e-p:32:32-i64:64-v128:64:128-a:0:32-n32-S64", "cortex-a8", ""))' llvm-targets
240
+
'' + lib.optionalString targetPlatform.isMusl ''
241
+
echo "patching llvm-targets for musl targets..."
242
+
echo "Cloning these existing '*-linux-gnu*' targets:"
243
+
grep linux-gnu llvm-targets | sed 's/^/ /'
244
+
echo "(go go gadget sed)"
245
+
sed -i 's,\(^.*linux-\)gnu\(.*\)$,\0\n\1musl\2,' llvm-targets
246
+
echo "llvm-targets now contains these '*-linux-musl*' targets:"
247
+
grep linux-musl llvm-targets | sed 's/^/ /'
249
+
echo "And now patching to preserve '-musleabi' as done with '-gnueabi'"
250
+
# (aclocal.m4 is actual source, but patch configure as well since we don't re-gen)
251
+
for x in configure aclocal.m4; do
252
+
substituteInPlace $x \
253
+
--replace '*-android*|*-gnueabi*)' \
254
+
'*-android*|*-gnueabi*|*-musleabi*)'
257
+
# HACK: allow bootstrapping with GHC 8.10 which works fine, as we don't have
258
+
# binary 9.0 packaged. Bootstrapping with 9.2 is broken without hadrian.
260
+
substituteInPlace configure --replace \
261
+
'MinBootGhcVersion="9.0"' \
262
+
'MinBootGhcVersion="8.10"'
265
+
# TODO(@Ericson2314): Always pass "--target" and always prefix.
266
+
configurePlatforms = [ "build" "host" ]
267
+
++ lib.optional (targetPlatform != hostPlatform) "target";
269
+
# `--with` flags for libraries needed for RTS linker
271
+
"--datadir=$doc/share/doc/ghc"
272
+
"--with-curses-includes=${ncurses.dev}/include" "--with-curses-libraries=${ncurses.out}/lib"
273
+
] ++ lib.optionals (libffi != null) [
274
+
"--with-system-libffi"
275
+
"--with-ffi-includes=${targetPackages.libffi.dev}/include"
276
+
"--with-ffi-libraries=${targetPackages.libffi.out}/lib"
277
+
] ++ lib.optionals (targetPlatform == hostPlatform && !enableNativeBignum) [
278
+
"--with-gmp-includes=${targetPackages.gmp.dev}/include"
279
+
"--with-gmp-libraries=${targetPackages.gmp.out}/lib"
280
+
] ++ lib.optionals (targetPlatform == hostPlatform && hostPlatform.libc != "glibc" && !targetPlatform.isWindows) [
281
+
"--with-iconv-includes=${libiconv}/include"
282
+
"--with-iconv-libraries=${libiconv}/lib"
283
+
] ++ lib.optionals (targetPlatform != hostPlatform) [
284
+
"--enable-bootstrap-with-devel-snapshot"
285
+
] ++ lib.optionals useLdGold [
286
+
"CFLAGS=-fuse-ld=gold"
287
+
"CONF_GCC_LINKER_OPTS_STAGE1=-fuse-ld=gold"
288
+
"CONF_GCC_LINKER_OPTS_STAGE2=-fuse-ld=gold"
289
+
] ++ lib.optionals (disableLargeAddressSpace) [
290
+
"--disable-large-address-space"
293
+
# Make sure we never relax`$PATH` and hooks support for compatibility.
296
+
# Don’t add -liconv to LDFLAGS automatically so that GHC will add it itself.
297
+
dontAddExtraLibs = true;
299
+
nativeBuildInputs = [
300
+
perl autoconf automake m4 python3
301
+
ghc bootPkgs.alex bootPkgs.happy bootPkgs.hscolour
302
+
] ++ lib.optionals (stdenv.isDarwin && stdenv.isAarch64) [
303
+
autoSignDarwinBinariesHook
304
+
] ++ lib.optionals enableDocs [
308
+
# For building runtime libs
309
+
depsBuildTarget = toolsForTarget;
311
+
buildInputs = [ perl bash ] ++ (libDeps hostPlatform);
313
+
depsTargetTarget = map lib.getDev (libDeps targetPlatform);
314
+
depsTargetTargetPropagated = map (lib.getOutput "out") (libDeps targetPlatform);
316
+
# required, because otherwise all symbols from HSffi.o are stripped, and
317
+
# that in turn causes GHCi to abort
318
+
stripDebugFlags = [ "-S" ] ++ lib.optional (!targetPlatform.isDarwin) "--keep-file-symbols";
320
+
checkTarget = "test";
324
+
# In nixpkgs, musl based builds currently enable `pie` hardening by default
325
+
# (see `defaultHardeningFlags` in `make-derivation.nix`).
326
+
# But GHC cannot currently produce outputs that are ready for `-pie` linking.
327
+
# Thus, disable `pie` hardening, otherwise `recompile with -fPIE` errors appear.
329
+
# * https://github.com/NixOS/nixpkgs/issues/129247
330
+
# * https://gitlab.haskell.org/ghc/ghc/-/issues/19580
331
+
++ lib.optional stdenv.targetPlatform.isMusl "pie";
333
+
# big-parallel allows us to build with more than 2 cores on
334
+
# Hydra which already warrants a significant speedup
335
+
requiredSystemFeatures = [ "big-parallel" ];
338
+
# Install the bash completion file.
339
+
install -D -m 444 utils/completion/ghc.bash $out/share/bash-completion/completions/${targetPrefix}ghc
343
+
inherit bootPkgs targetPrefix;
345
+
inherit llvmPackages;
346
+
inherit enableShared;
348
+
# This is used by the haskell builder to query
349
+
# the presence of the haddock program.
350
+
hasHaddock = enableHaddockProgram;
352
+
# Our Cabal compiler name
353
+
haskellCompilerName = "ghc-${version}";
357
+
homepage = "http://haskell.org/ghc";
358
+
description = "The Glasgow Haskell Compiler";
359
+
maintainers = with lib.maintainers; [
361
+
] ++ lib.teams.haskell.members;
362
+
timeout = 24 * 3600;
363
+
inherit (ghc.meta) license platforms;
366
+
} // lib.optionalAttrs targetPlatform.useAndroidPrebuilt {
368
+
dontPatchELF = true;
369
+
noAuditTmpdir = true;