Changes between Version 5 and Version 6 of Building/FAQ

Mar 10, 2009 12:06:51 PM (11 years ago)



  • Building/FAQ

    v5 v6  
    1 [[PageOutline]]
    3 = Frequently asked questions about building GHC =
    5 This page collects questions and advice about building GHC from source.  It is particularly prone to going out of date.  Please help keep it relevant and accurate.  At the moment it's fairly un-structured; please feel free to add structure if that'd make it easier to follow.
    7 Platform-specific guidance belongs under one of the platform-specific help pages linked from the [wiki:Building Building guide contents page].
    10 == Space in TMPDIR ==
    12 One difficulty that comes up from time to time is running out of space
    13 in {{{TMPDIR}}}.  (It is impossible for the configuration stuff to
    14 compensate for the vagaries of different sysadmin approaches to temp
    15 space.)
    17 The quickest way around it is {{{setenv TMPDIR /usr/tmp}}} or
    18 even {{{setenv TMPDIR .}}} (or the equivalent incantation with your shell
    19 of choice).
    21 The best way around it is to say
    22 {{{
    23 export TMPDIR=<dir>
    24 }}}
    25 in your {{{}}} file.  Then GHC and the other
    26 tools will use the appropriate directory in all cases.
    29 == Warning "warning: assignment from incompatible pointer type" ==
    31 You may occasionally see a warning from the C compiler when compiling some
    32 Haskell code, eg. "warning: assignment from
    33 incompatible pointer type".  These are usually harmless, but it's a good idea to
    34 report it on the mailing list so that we can fix it.
    36 == Warning "ar: filename `GlaIOMonad__1_2s.o` truncated to `GlaIOMonad_`" ==
    38 Similarly, {{{ar}}}chiving warning messages like the following are not a problem:
    39 {{{
    40 ar: filename GlaIOMonad__1_2s.o truncated to GlaIOMonad_
    41 ar: filename GlaIOMonad__2_2s.o truncated to GlaIOMonad_
    42 ...
    43 }}}
    45 == GCC 4 issues ==
    47 It has been observed on Gentoo systems that GCC 4 may fail, complaining about there being no {{{-nopie}}} option. You can either use GCC 3, re-emerge ghc or just edit your {{{/usr/bin/ghc}}} script to remove the {{{-nopie}}} flag (the latter is by far the quickest and is perfectly safe).
    49 == Cpp variations ==
    51 GHC's sources go through {{{cpp}}} before being compiled, and {{{cpp}}} varies
    52 a bit from one Unix to another.  One particular gotcha is macro calls
    53 like this:
    54 {{{
    55 SLIT("Hello, world")
    56 }}}
    57 Some {{{cpp}}}s treat the comma inside the string as separating two macro
    58 arguments, so you get
    59 {{{
    60 :731: macro `SLIT' used with too many (2) args
    61 }}}
    62 Alas, {{{cpp}}} doesn't tell you the offending file!
    63 Workaround: don't put weird things in string args to {{{cpp}}} macros.
    66 == Cabal/Distribution/Compat/FilePath.hs: No such file or directory ==
    68 You may see this:
    69   {{{
    70 Distribution/Compat/FilePath.hs:2:
    71   error: Cabal/Distribution/Compat/FilePath.hs: No such file or directory
    72 make[1]: *** [depend] Error 1
    73 make: *** [stage1] Error 1
    74   }}}
    75 '''Possible Solution'''::
    76 Be sure you have run {{{sh darcs-all get}}} to get all necessary packages. Don't forget to run {{{sh boot}}} again after you pull in new packages.
    78 == xargs: /usr/bin/ar: terminated by signal 11 ==
    80 You may see this when compiling libraries:
    81 {{{
    82 (echo Control/Concurrent_stub.o System/CPUTime_hsc.o System/Time_hsc.o ;
    83 /usr/bin/find Control/Applicative_split Control/Arrow_split
    84 Control/Concurrent_split Control/Concurrent/Chan_split
    85    ...long mess...
    86 Text/PrettyPrint/HughesPJ_split Text/Printf_split Text/Read_split
    87 Text/Read/Lex_split Text/Show_split Text/Show/Functions_split -name '*.o'
    88 -print) | xargs /usr/bin/ar q libHSbase.a
    89 /usr/bin/ar: creating libHSbase.a
    90 xargs: /usr/bin/ar: terminated by signal 11
    91 make[2]: *** [libHSbase.a] Error 125
    92 make[2]: *** Deleting file `libHSbase.a'
    93 make[1]: *** [all] Error 1
    94 }}}
    95 What is happening is that the ghc build system is linking thousands and
    96 thousands of tiny .o files into `libHSbase.a`. GNU `ar` isn't optimised for
    97 this use-case and it takes far more memory than it really needs to. So
    98 what happens is that ar takes >500Mb of memory and your virtual
    99 machine / virtual server probably isn't configured with that much memory
    100 and so the linux kernel OOM killer terminates the ar process.
    102 To make this worse, since there are so many .o files, it takes several
    103 invocations of ar to link them all. On each invocation `ar` is building
    104 the symbol index (-q is ignored) and this is what takes the most time
    105 and memory. It's a good deal quicker to use a custom program (100 lines
    106 of Haskell) to build `libHSbase.a` and then use `ranlib` just once to build
    107 the symbol index.
    109 [Duncan Coutts] I submitted a patch to gnu `binutils` to make ar take less memory when
    110 linking 1000's of files so it now only takes around 100Mb rather than
    111 500Mb when linking `libHSbase.a`. That patch is included in version 2.17 I
    112 think (in other words most systems don't have it yet).
    114 What you can do in the mean time is either configure your virtual
    115 machine with more memory or turn off the split-objs feature when you
    116 configure ghc. Just add `SplitObjs=NO` to your `mk/` file (which
    117 may not exist to start with). (The Gentoo ebuild does this
    118 automatically)