Mercurialcrosstool-ng / file revision
summary | shortlog | changelog | graph | tags | branches | files | changeset | file | latest | revisions | annotate | diff | raw | help
scripts/build/binutils/binutils.sh
author Michael Hope <michael.hope@linaro.org>
Wed Nov 16 10:06:21 2011 +1300 (2011-11-16)
changeset 2765 6c5658b8b588
parent 2702 293d8334b913
child 2779 fc8b56c5c483
permissions -rw-r--r--
scripts: add support for building manuals

Add support for building the HTML and PDF manuals for the major
components. Implement for binutils, GCC, GDB, and GLIBC.

Always build all manuals and install a subset. Be explicit about the
subset to reduce the clutter and to avoid getting copies of common
manuals like bfd from all of the sourceware based components. Downside of
being explicit is that you need to update it when a new component
comes along.

Build the manuals as part of the last GCC build, namely 'cc' for glibc
based ones and cc_core_pass_2 for baremetal.

An example of the output is at:
http://people.linaro.org/~michaelh/incoming/crosstool-NG/

Signed-off-by: Michael Hope <michael.hope@linaro.org>
[yann.morin.1998@anciens.enib.fr: depends on ! remove docs; gold manual install]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr> 
     1 # This file adds functions to build binutils

     2 # Copyright 2007 Yann E. MORIN

     3 # Licensed under the GPL v2. See COPYING in the root of this package

     4 

     5 # Download binutils

     6 do_binutils_get() {

     7     CT_GetFile "binutils-${CT_BINUTILS_VERSION}"                                        \

     8                {ftp,http}://{ftp.gnu.org/gnu,ftp.kernel.org/pub/linux/devel}/binutils   \

     9                ftp://gcc.gnu.org/pub/binutils/{releases,snapshots}

    10 }

    11 

    12 # Extract binutils

    13 do_binutils_extract() {

    14     CT_Extract "binutils-${CT_BINUTILS_VERSION}"

    15     CT_Patch "binutils" "${CT_BINUTILS_VERSION}"

    16 }

    17 

    18 # Build binutils

    19 do_binutils() {

    20     local -a extra_config

    21     local -a extra_make_flags

    22     local -a binutils_tools

    23     local -a manuals_for

    24     local -a manuals_install

    25 

    26     mkdir -p "${CT_BUILD_DIR}/build-binutils"

    27     cd "${CT_BUILD_DIR}/build-binutils"

    28 

    29     CT_DoStep INFO "Installing binutils"

    30 

    31     CT_DoLog EXTRA "Configuring binutils"

    32 

    33     binutils_tools=( ar as ld strip )

    34     if [ "${CT_BINUTILS_HAS_GOLD}" = "y" ]; then

    35         case "${CT_BINUTILS_LINKERS_LIST}" in

    36             ld)

    37                 extra_config+=( --enable-ld=yes --enable-gold=no )

    38                 binutils_tools+=( ld.bfd )

    39                 ;;

    40             gold)

    41                 extra_config+=( --enable-ld=no --enable-gold=yes )

    42                 binutils_tools+=( ld.gold )

    43                 ;;

    44             ld,gold)

    45                 extra_config+=( --enable-ld=default --enable-gold=yes )

    46                 binutils_tools+=( ld.bfd ld.gold )

    47                 ;;

    48             gold,ld)

    49                 extra_config+=( --enable-ld=yes --enable-gold=default )

    50                 binutils_tools+=( ld.bfd ld.gold )

    51                 ;;

    52         esac

    53         if [ "${CT_BINUTILS_GOLD_THREADED}" = "y" ]; then

    54             extra_config+=( --enable-threads )

    55         fi

    56     fi

    57     if [ "${CT_BINUTILS_PLUGINS}" = "y" ]; then

    58         extra_config+=( --enable-plugins )

    59     fi

    60     if [ "${CT_BINUTILS_HAS_PKGVERSION_BUGURL}" = "y" ]; then

    61         extra_config+=("--with-pkgversion=${CT_PKGVERSION}")

    62         [ -n "${CT_TOOLCHAIN_BUGURL}" ] && extra_config+=("--with-bugurl=${CT_TOOLCHAIN_BUGURL}")

    63     fi

    64 

    65     CT_DoLog DEBUG "Extra config passed: '${extra_config[*]}'"

    66 

    67     CT_DoExecLog CFG                                            \

    68     CFLAGS="${CT_CFLAGS_FOR_HOST}"                              \

    69     CXXFLAGS="${CT_CFLAGS_FOR_HOST}"                            \

    70     "${CT_SRC_DIR}/binutils-${CT_BINUTILS_VERSION}/configure"   \

    71         --build=${CT_BUILD}                                     \

    72         --host=${CT_HOST}                                       \

    73         --target=${CT_TARGET}                                   \

    74         --prefix=${CT_PREFIX_DIR}                               \

    75         --disable-nls                                           \

    76         --disable-multilib                                      \

    77         --disable-werror                                        \

    78         "${extra_config[@]}"                                    \

    79         ${CT_ARCH_WITH_FLOAT}                                   \

    80         ${BINUTILS_SYSROOT_ARG}                                 \

    81         "${CT_BINUTILS_EXTRA_CONFIG_ARRAY[@]}"

    82 

    83     if [ "${CT_STATIC_TOOLCHAIN}" = "y" ]; then

    84         extra_make_flags+=("LDFLAGS=-static -all-static")

    85         CT_DoLog EXTRA "Prepare binutils for static build"

    86         CT_DoExecLog ALL make ${JOBSFLAGS} configure-host

    87     fi

    88 

    89     CT_DoLog EXTRA "Building binutils"

    90     CT_DoExecLog ALL make "${extra_make_flags[@]}" ${JOBSFLAGS}

    91 

    92     CT_DoLog EXTRA "Installing binutils"

    93     CT_DoExecLog ALL make install

    94 

    95     if [ "${CT_BUILD_MANUALS}" = "y" ]; then

    96         CT_DoLog EXTRA "Building and installing the binutils manuals"

    97         manuals_for=( gas binutils ld gprof )

    98         if [ "${CT_BINUTILS_LINKER_GOLD}" = "y" ]; then

    99             manuals_for+=( gold )

   100         fi

   101         manuals_install=( "${manuals_for[@]/#/install-pdf-}" )

   102         manuals_install+=( "${manuals_for[@]/#/install-html-}" )

   103         CT_DoExecLog ALL make ${JOBSFLAGS} pdf html

   104         CT_DoExecLog ALL make "${manuals_install[@]}"

   105     fi

   106 

   107     # Install the wrapper if needed

   108     if [ "${CT_BINUTILS_LD_WRAPPER}" = "y" ]; then

   109         CT_DoLog EXTRA "Installing ld wrapper"

   110         rm -f "${CT_PREFIX_DIR}/bin/${CT_TARGET}-ld"

   111         rm -f "${CT_PREFIX_DIR}/${CT_TARGET}/bin/ld"

   112         sed -r -e "s/@@DEFAULT_LD@@/${CT_BINUTILS_LINKER_DEFAULT}/" \

   113             "${CT_LIB_DIR}/scripts/build/binutils/binutils-ld.in"   \

   114             >"${CT_PREFIX_DIR}/bin/${CT_TARGET}-ld"

   115         chmod +x "${CT_PREFIX_DIR}/bin/${CT_TARGET}-ld"

   116         cp -a "${CT_PREFIX_DIR}/bin/${CT_TARGET}-ld"    \

   117               "${CT_PREFIX_DIR}/${CT_TARGET}/bin/ld"

   118 

   119         # If needed, force using ld.bfd during the toolchain build

   120         if [ "${CT_BINUTILS_FORCE_LD_BFD}" = "y" ]; then

   121             export CTNG_LD_IS=bfd

   122         fi

   123     fi

   124 

   125     # Make those new tools available to the core C compilers to come.

   126     # Note: some components want the ${TARGET}-{ar,as,ld,strip} commands as

   127     # well. Create that.

   128     mkdir -p "${CT_CC_CORE_STATIC_PREFIX_DIR}/${CT_TARGET}/bin"

   129     mkdir -p "${CT_CC_CORE_STATIC_PREFIX_DIR}/bin"

   130     mkdir -p "${CT_CC_CORE_SHARED_PREFIX_DIR}/${CT_TARGET}/bin"

   131     mkdir -p "${CT_CC_CORE_SHARED_PREFIX_DIR}/bin"

   132     for t in "${binutils_tools[@]}"; do

   133         ln -sv "${CT_PREFIX_DIR}/bin/${CT_TARGET}-${t}" "${CT_CC_CORE_STATIC_PREFIX_DIR}/${CT_TARGET}/bin/${t}"

   134         ln -sv "${CT_PREFIX_DIR}/bin/${CT_TARGET}-${t}" "${CT_CC_CORE_STATIC_PREFIX_DIR}/bin/${CT_TARGET}-${t}"

   135         ln -sv "${CT_PREFIX_DIR}/bin/${CT_TARGET}-${t}" "${CT_CC_CORE_SHARED_PREFIX_DIR}/${CT_TARGET}/bin/${t}"

   136         ln -sv "${CT_PREFIX_DIR}/bin/${CT_TARGET}-${t}" "${CT_CC_CORE_SHARED_PREFIX_DIR}/bin/${CT_TARGET}-${t}"

   137     done 2>&1 |CT_DoLog ALL

   138 

   139     CT_EndStep

   140 }

   141 

   142 # Now on for the target libraries

   143 do_binutils_target() {

   144     local -a extra_config

   145     local -a targets

   146     local -a build_targets

   147     local -a install_targets

   148     local t

   149 

   150     [ "${CT_BINUTILS_FOR_TARGET_IBERTY}" = "y" ] && targets+=("libiberty")

   151     [ "${CT_BINUTILS_FOR_TARGET_BFD}"    = "y" ] && targets+=("bfd")

   152     for t in "${targets[@]}"; do

   153         build_targets+=("all-${t}")

   154         install_targets+=("install-${t}")

   155     done

   156 

   157     if [ "${#targets[@]}" -ne 0 ]; then

   158         CT_DoStep INFO "Installing binutils for target"

   159         mkdir -p "${CT_BUILD_DIR}/build-binutils-for-target"

   160         CT_Pushd "${CT_BUILD_DIR}/build-binutils-for-target"

   161 

   162         CT_DoLog EXTRA "Configuring binutils for target"

   163 

   164         if [ "${CT_BINUTILS_HAS_PKGVERSION_BUGURL}" = "y" ]; then

   165             extra_config+=("--with-pkgversion=${CT_PKGVERSION}")

   166             [ -n "${CT_TOOLCHAIN_BUGURL}" ] && extra_config+=("--with-bugurl=${CT_TOOLCHAIN_BUGURL}")

   167         fi

   168 

   169         CT_DoExecLog CFG                                            \

   170         "${CT_SRC_DIR}/binutils-${CT_BINUTILS_VERSION}/configure"   \

   171             --build=${CT_BUILD}                                     \

   172             --host=${CT_TARGET}                                     \

   173             --target=${CT_TARGET}                                   \

   174             --prefix=/usr                                           \

   175             --disable-werror                                        \

   176             --enable-shared                                         \

   177             --enable-static                                         \

   178             --disable-nls                                           \

   179             --disable-multilib                                      \

   180             "${extra_config[@]}"                                    \

   181             ${CT_ARCH_WITH_FLOAT}                                   \

   182             "${CT_BINUTILS_EXTRA_CONFIG[@]}"

   183 

   184         CT_DoLog EXTRA "Building binutils' libraries (${targets[*]}) for target"

   185         CT_DoExecLog ALL make ${JOBSFLAGS} "${build_targets[@]}"

   186         CT_DoLog EXTRA "Installing binutils' libraries (${targets[*]}) for target"

   187         CT_DoExecLog ALL make DESTDIR="${CT_SYSROOT_DIR}" "${install_targets[@]}"

   188 

   189         CT_Popd

   190         CT_EndStep

   191     fi

   192 }
crosstool-ng