scripts/functions
author "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Sat Jul 07 09:58:14 2007 +0000 (2007-07-07)
changeset 210 98baeb928964
parent 182 223c84ec2d90
child 241 0aa95f4eed31
permissions -rw-r--r--
Silence "which" being verbose in some distros. (eg. Mandriva's which spawns "foobar was not found in /bin:/usr/bin:...." directly on stderr)
     1 # This file contains some usefull common functions
     2 # Copyright 2007 Yann E. MORIN
     3 # Licensed under the GPL v2. See COPYING in the root of this package
     4 
     5 # Prepare the fault handler
     6 CT_OnError() {
     7     ret=$?
     8     CT_DoLog ERROR "Build failed in step \"${CT_STEP_MESSAGE[${CT_STEP_COUNT}]}\""
     9     for((step=(CT_STEP_COUNT-1); step>1; step--)); do
    10         CT_DoLog ERROR "      called in step \"${CT_STEP_MESSAGE[${step}]}\""
    11     done
    12     CT_DoLog ERROR "Error happened in \"${BASH_SOURCE[1]}\" in function \"${FUNCNAME[1]}\" (line unknown, sorry)"
    13     for((depth=2; ${BASH_LINENO[$((${depth}-1))]}>0; depth++)); do
    14         CT_DoLog ERROR "      called from \"${BASH_SOURCE[${depth}]}\" at line # ${BASH_LINENO[${depth}-1]} in function \"${FUNCNAME[${depth}]}\""
    15     done
    16     [ "${CT_LOG_TO_FILE}" = "y" ] && CT_DoLog ERROR "Look at \"${CT_LOG_FILE}\" for more info on this error."
    17     CT_STEP_COUNT=1
    18     CT_DoEnd ERROR
    19     exit $ret
    20 }
    21 
    22 # Install the fault handler
    23 trap CT_OnError ERR
    24 
    25 # Inherit the fault handler in subshells and functions
    26 set -E
    27 
    28 # Make pipes fail on the _first_ failed command
    29 # Not supported on bash < 3.x, but we need it, so drop the obsoleting bash-2.x
    30 set -o pipefail
    31 
    32 # Don't hash commands' locations, and search every time it is requested.
    33 # This is slow, but needed because of the static/shared core gcc which shall
    34 # always match to shared if it exists, and only fallback to static if the
    35 # shared is not found
    36 set +o hashall
    37 
    38 # Log policy:
    39 #  - first of all, save stdout so we can see the live logs: fd #6
    40 exec 6>&1
    41 #  - then point stdout to the log file (temporary for now)
    42 tmp_log_file="${CT_TOP_DIR}/log.$$"
    43 exec >>"${tmp_log_file}"
    44 
    45 # The different log levels:
    46 CT_LOG_LEVEL_ERROR=0
    47 CT_LOG_LEVEL_WARN=1
    48 CT_LOG_LEVEL_INFO=2
    49 CT_LOG_LEVEL_EXTRA=3
    50 CT_LOG_LEVEL_DEBUG=4
    51 CT_LOG_LEVEL_ALL=5
    52 
    53 # A function to log what is happening
    54 # Different log level are available:
    55 #   - ERROR:   A serious, fatal error occurred
    56 #   - WARN:    A non fatal, non serious error occurred, take your responsbility with the generated build
    57 #   - INFO:    Informational messages
    58 #   - EXTRA:   Extra informational messages
    59 #   - DEBUG:   Debug messages
    60 #   - ALL:     Component's build messages
    61 # Usage: CT_DoLog <level> [message]
    62 # If message is empty, then stdin will be logged.
    63 CT_DoLog() {
    64     local max_level LEVEL level cur_l cur_L
    65     local l
    66     eval max_level="\${CT_LOG_LEVEL_${CT_LOG_LEVEL_MAX}}"
    67     # Set the maximum log level to DEBUG if we have none
    68     [ -z "${max_level}" ] && max_level=${CT_LOG_LEVEL_DEBUG}
    69 
    70     LEVEL="$1"; shift
    71     eval level="\${CT_LOG_LEVEL_${LEVEL}}"
    72 
    73     if [ $# -eq 0 ]; then
    74         cat -
    75     else
    76         echo "${1}"
    77     fi |( IFS="\n" # We want the full lines, even leading spaces
    78           CT_PROG_BAR_CPT=0
    79           indent=$((2*CT_STEP_COUNT))
    80           while read line; do
    81               case "${CT_LOG_SEE_TOOLS_WARN},${line}" in
    82                 y,*"warning:"*)         cur_L=WARN; cur_l=${CT_LOG_LEVEL_WARN};;
    83                 y,*"WARNING:"*)         cur_L=WARN; cur_l=${CT_LOG_LEVEL_WARN};;
    84                 *"error:"*)             cur_L=ERROR; cur_l=${CT_LOG_LEVEL_ERROR};;
    85                 *"make["?*"]:"*"Stop.") cur_L=ERROR; cur_l=${CT_LOG_LEVEL_ERROR};;
    86                 *)                      cur_L="${LEVEL}"; cur_l="${level}";;
    87               esac
    88               l="`printf \"[%-5s]%*s%s%s\" \"${cur_L}\" \"${indent}\" \" \" \"${line}\"`"
    89               # There will always be a log file, be it /dev/null
    90               echo -e "${l}"
    91               if [ ${cur_l} -le ${max_level} ]; then
    92                   echo -e "\r${l}" >&6
    93               fi
    94               if [ "${CT_LOG_PROGRESS_BAR}" = "y" ]; then
    95                   [ ${CT_PROG_BAR_CPT} -eq 0  ] && bar="/"
    96                   [ ${CT_PROG_BAR_CPT} -eq 10 ] && bar="-"
    97                   [ ${CT_PROG_BAR_CPT} -eq 20 ] && bar="\\"
    98                   [ ${CT_PROG_BAR_CPT} -eq 30 ] && bar="|"
    99                   printf "\r[%02d:%02d] %s " $((SECONDS/60)) $((SECONDS%60)) "${bar}" >&6
   100                   CT_PROG_BAR_CPT=$(((CT_PROG_BAR_CPT+1)%40))
   101               fi
   102           done
   103         )
   104 
   105     return 0
   106 }
   107 
   108 # Tail message to be logged whatever happens
   109 # Usage: CT_DoEnd <level>
   110 CT_DoEnd()
   111 {
   112     local level="$1"
   113     CT_STOP_DATE=`CT_DoDate +%s%N`
   114     CT_STOP_DATE_HUMAN=`CT_DoDate +%Y%m%d.%H%M%S`
   115     CT_DoLog "${level:-INFO}" "Build completed at ${CT_STOP_DATE_HUMAN}"
   116     elapsed=$((CT_STOP_DATE-CT_STAR_DATE))
   117     elapsed_min=$((elapsed/(60*1000*1000*1000)))
   118     elapsed_sec=`printf "%02d" $(((elapsed%(60*1000*1000*1000))/(1000*1000*1000)))`
   119     elapsed_csec=`printf "%02d" $(((elapsed%(1000*1000*1000))/(10*1000*1000)))`
   120     CT_DoLog ${level:-INFO} "(elapsed: ${elapsed_min}:${elapsed_sec}.${elapsed_csec})"
   121 }
   122 
   123 # Abort the execution with an error message
   124 # Usage: CT_Abort <message>
   125 CT_Abort() {
   126     CT_DoLog ERROR "$1"
   127     exit 1
   128 }
   129 
   130 # Test a condition, and print a message if satisfied
   131 # Usage: CT_Test <message> <tests>
   132 CT_Test() {
   133     local ret
   134     local m="$1"
   135     shift
   136     test "$@" && CT_DoLog WARN "$m"
   137     return 0
   138 }
   139 
   140 # Test a condition, and abort with an error message if satisfied
   141 # Usage: CT_TestAndAbort <message> <tests>
   142 CT_TestAndAbort() {
   143     local m="$1"
   144     shift
   145     test "$@" && CT_Abort "$m"
   146     return 0
   147 }
   148 
   149 # Test a condition, and abort with an error message if not satisfied
   150 # Usage: CT_TestAndAbort <message> <tests>
   151 CT_TestOrAbort() {
   152     local m="$1"
   153     shift
   154     test "$@" || CT_Abort "$m"
   155     return 0
   156 }
   157 
   158 # Test the presence of a tool, or abort if not found
   159 # Usage: CT_HasOrAbort <tool>
   160 CT_HasOrAbort() {
   161     CT_TestAndAbort "\"${1}\" not found and needed for successfull toolchain build." -z "`CT_Which \"${1}\"`"
   162     return 0
   163 }
   164 
   165 # Search a program: wrap "which" for those system where
   166 # "which" verbosely says there is no match (Mdk are such
   167 # suckers...)
   168 # Usage: CT_Which <filename>
   169 CT_Which() {
   170   which "$1" 2>/dev/null || true
   171 }
   172 
   173 # Get current date with nanosecond precision
   174 # On those system not supporting nanosecond precision, faked with rounding down
   175 # to the highest entire second
   176 # Usage: CT_DoDate <fmt>
   177 CT_DoDate() {
   178     date "$1" |sed -r -e 's/%N$/000000000/;'
   179 }
   180 
   181 CT_STEP_COUNT=1
   182 CT_STEP_MESSAGE[${CT_STEP_COUNT}]="<none>"
   183 # Memorise a step being done so that any error is caught
   184 # Usage: CT_DoStep <loglevel> <message>
   185 CT_DoStep() {
   186     local start=`CT_DoDate +%s%N`
   187     CT_DoLog "$1" "================================================================="
   188     CT_DoLog "$1" "$2"
   189     CT_STEP_COUNT=$((CT_STEP_COUNT+1))
   190     CT_STEP_LEVEL[${CT_STEP_COUNT}]="$1"; shift
   191     CT_STEP_START[${CT_STEP_COUNT}]="${start}"
   192     CT_STEP_MESSAGE[${CT_STEP_COUNT}]="$1"
   193     return 0
   194 }
   195 
   196 # End the step just being done
   197 # Usage: CT_EndStep
   198 CT_EndStep() {
   199     local stop=`CT_DoDate +%s%N`
   200     local duration=`printf "%032d" $((stop-${CT_STEP_START[${CT_STEP_COUNT}]})) |sed -r -e 's/([[:digit:]]{2})[[:digit:]]{7}$/\.\1/; s/^0+//; s/^\./0\./;'`
   201     local level="${CT_STEP_LEVEL[${CT_STEP_COUNT}]}"
   202     local message="${CT_STEP_MESSAGE[${CT_STEP_COUNT}]}"
   203     CT_STEP_COUNT=$((CT_STEP_COUNT-1))
   204     CT_DoLog "${level}" "${message}: done in ${duration}s"
   205     return 0
   206 }
   207 
   208 # Pushes into a directory, and pops back
   209 CT_Pushd() {
   210     pushd "$1" >/dev/null 2>&1
   211 }
   212 CT_Popd() {
   213     popd >/dev/null 2>&1
   214 }
   215 
   216 # Makes a path absolute
   217 # Usage: CT_MakeAbsolutePath path
   218 CT_MakeAbsolutePath() {
   219     # Try to cd in that directory
   220     if [ -d "$1" ]; then
   221         CT_Pushd "$1"
   222         pwd
   223         CT_Popd
   224     else
   225         # No such directory, fail back to guessing
   226         case "$1" in
   227             /*)  echo "$1";;
   228             *)   echo "`pwd`/$1";;
   229         esac
   230     fi
   231     
   232     return 0
   233 }
   234 
   235 # Creates a temporary directory
   236 # $1: variable to assign to
   237 # Usage: CT_MktempDir foo
   238 CT_MktempDir() {
   239     # Some mktemp do not allow more than 6 Xs
   240     eval "$1"="`mktemp -q -d \"${CT_BUILD_DIR}/.XXXXXX\"`"
   241     CT_TestOrAbort "Could not make temporary directory" -n "${!1}" -a -d "${!1}"
   242 }
   243 
   244 # Echoes the specified string on stdout until the pipe breaks.
   245 # Doesn't fail
   246 # $1: string to echo
   247 # Usage: CT_DoYes "" |make oldconfig
   248 CT_DoYes() {
   249     yes "$1" || true
   250 }
   251 
   252 # Get the file name extension of a component
   253 # Usage: CT_GetFileExtension <component_name-component_version>
   254 # If found, echoes the extension to stdout
   255 # If not found, echoes nothing on stdout.
   256 CT_GetFileExtension() {
   257     local ext
   258     local file="$1"
   259     local got_it=1
   260 
   261     CT_Pushd "${CT_TARBALLS_DIR}"
   262     # we need to also check for an empty extension for those very
   263     # peculiar components that don't have one (such as sstrip from
   264     # buildroot).
   265     for ext in .tar.gz .tar.bz2 .tgz .tar ''; do
   266         if [ -f "${file}${ext}" ]; then
   267             echo "${ext}"
   268             got_it=0
   269             break
   270         fi
   271     done
   272     CT_Popd
   273 
   274     return 0
   275 }
   276 
   277 # Download an URL using wget
   278 # Usage: CT_DoGetFileWget <URL>
   279 CT_DoGetFileWget() {
   280     # Need to return true because it is legitimate to not find the tarball at
   281     # some of the provided URLs (think about snapshots, different layouts for
   282     # different gcc versions, etc...)
   283     # Some (very old!) FTP server might not support the passive mode, thus
   284     # retry without
   285     # With automated download as we are doing, it can be very dangerous to use
   286     # -c to continue the downloads. It's far better to simply overwrite the
   287     # destination file
   288     wget -nc --progress=dot:binary --tries=3 --passive-ftp "$1" || wget -nc --progress=dot:binary --tries=3 "$1" || true
   289 }
   290 
   291 # Download an URL using curl
   292 # Usage: CT_DoGetFileCurl <URL>
   293 CT_DoGetFileCurl() {
   294 	# Note: comments about wget method are also valid here
   295 	# Plus: no good progreess indicator is available with curl,
   296 	#       so output is consigned to oblivion
   297 	curl --ftp-pasv -O --retry 3 "$1" >/dev/null || curl -O --retry 3 "$1" >/dev/null || true
   298 }
   299 
   300 # Wrapper function to call one of curl or wget
   301 # Usage: CT_DoGetFile <URL>
   302 CT_DoGetFile() {
   303     local _wget=`CT_Which wget`
   304     local _curl=`CT_Which curl`
   305     case "${_wget},${_curl}" in
   306         ,)  CT_DoError "Could find neither wget nor curl";;
   307         ,*) CT_DoGetFileCurl "$1" 2>&1 |CT_DoLog ALL;;
   308         *)  CT_DoGetFileWget "$1" 2>&1 |CT_DoLog ALL;;
   309     esac
   310 }
   311 
   312 # Download the file from one of the URLs passed as argument
   313 # Usage: CT_GetFile <filename> <url> [<url> ...]
   314 CT_GetFile() {
   315     local got_it
   316     local ext
   317     local url
   318     local file="$1"
   319     shift
   320 
   321     # Do we already have it?
   322     ext=`CT_GetFileExtension "${file}"`
   323     if [ -n "${ext}" ]; then
   324         CT_DoLog DEBUG "Already have \"${file}\""
   325         return 0
   326     fi
   327 
   328     CT_Pushd "${CT_TARBALLS_DIR}"
   329     # File not yet downloaded, try to get it
   330     got_it=0
   331     # We'd rather have a bzip2'ed tarball, then gzipped, and finally plain tar.
   332     # Try local copy first, if it exists
   333     for ext in .tar.bz2 .tar.gz .tgz .tar; do
   334         if [ -r "${CT_LOCAL_TARBALLS_DIR}/${file}${ext}" -a \
   335              "${CT_FORCE_DOWNLOAD}" != "y" ]; then
   336             CT_DoLog EXTRA "Copying \"${file}\" from local copy"
   337             cp -v "${CT_LOCAL_TARBALLS_DIR}/${file}${ext}" "${file}${ext}" |CT_DoLog ALL
   338             return 0
   339         fi
   340     done
   341     # Try to download it
   342     CT_DoLog EXTRA "Retrieving \"${file}\""
   343     for ext in .tar.bz2 .tar.gz .tgz .tar; do
   344         # Try all urls in turn
   345         for url in "$@"; do
   346             case "${url}" in
   347                 *)  CT_DoLog DEBUG "Trying \"${url}/${file}${ext}\""
   348                     CT_DoGetFile "${url}/${file}${ext}"
   349                     ;;
   350             esac
   351             [ -f "${file}${ext}" ] && return 0 || true
   352         done
   353     done
   354     CT_Popd
   355 
   356     CT_Abort "Could not download \"${file}\", and not present in \"${CT_LOCAL_TARBALLS_DIR}\""
   357 }
   358 
   359 # Extract a tarball and patch the resulting sources if necessary.
   360 # Some tarballs need to be extracted in specific places. Eg.: glibc addons
   361 # must be extracted in the glibc directory; uCLibc locales must be extracted
   362 # in the extra/locale sub-directory of uClibc.
   363 CT_ExtractAndPatch() {
   364     local file="$1"
   365     local base_file=`echo "${file}" |cut -d - -f 1`
   366     local ver_file=`echo "${file}" |cut -d - -f 2-`
   367     local official_patch_dir
   368     local custom_patch_dir
   369     local libc_addon
   370     local ext=`CT_GetFileExtension "${file}"`
   371     CT_TestAndAbort "\"${file}\" not found in \"${CT_TARBALLS_DIR}\"" -z "${ext}"
   372     local full_file="${CT_TARBALLS_DIR}/${file}${ext}"
   373 
   374     CT_Pushd "${CT_SRC_DIR}"
   375 
   376     # Add-ons need a little love, really.
   377     case "${file}" in
   378         glibc-[a-z]*-*)
   379             CT_TestAndAbort "Trying to extract the C-library addon/locales \"${file}\" when C-library not yet extracted" ! -d "${CT_LIBC_FILE}"
   380             cd "${CT_LIBC_FILE}"
   381             libc_addon=y
   382             [ -f ".${file}.extracted" ] && return 0
   383             touch ".${file}.extracted"
   384             ;;
   385         uClibc-locale-*)
   386             CT_TestAndAbort "Trying to extract the C-library addon/locales \"${file}\" when C-library not yet extracted" ! -d "${CT_LIBC_FILE}"
   387             cd "${CT_LIBC_FILE}/extra/locale"
   388             libc_addon=y
   389             [ -f ".${file}.extracted" ] && return 0
   390             touch ".${file}.extracted"
   391             ;;
   392     esac
   393 
   394     # If the directory exists, then consider extraction and patching done
   395     if [ -d "${file}" ]; then
   396         CT_DoLog DEBUG "Already extracted \"${file}\""
   397         return 0
   398     fi
   399 
   400     CT_DoLog EXTRA "Extracting \"${file}\""
   401     case "${ext}" in
   402         .tar.bz2)     tar xvjf "${full_file}" |CT_DoLog ALL;;
   403         .tar.gz|.tgz) tar xvzf "${full_file}" |CT_DoLog ALL;;
   404         .tar)         tar xvf  "${full_file}" |CT_DoLog ALL;;
   405         *)            CT_Abort "Don't know how to handle \"${file}\": unknown extension" ;;
   406     esac
   407 
   408     # Snapshots might not have the version number in the extracted directory
   409     # name. This is also the case for some (old) packages, such as libfloat.
   410     # Overcome this issue by symlink'ing the directory.
   411     if [ ! -d "${file}" -a "${libc_addon}" != "y" ]; then
   412         case "${ext}" in
   413             .tar.bz2)     base=`tar tjf "${full_file}" |head -n 1 |cut -d / -f 1 || true`;;
   414             .tar.gz|.tgz) base=`tar tzf "${full_file}" |head -n 1 |cut -d / -f 1 || true`;;
   415             .tar)         base=`tar tf  "${full_file}" |head -n 1 |cut -d / -f 1 || true`;;
   416         esac
   417         CT_TestOrAbort "There was a problem when extracting \"${file}\"" -d "${base}" -o "${base}" != "${file}"
   418         ln -s "${base}" "${file}"
   419     fi
   420 
   421     # Kludge: outside this function, we wouldn't know if we had just extracted
   422     # a libc addon, or a plain package. Apply patches now.
   423     CT_DoLog EXTRA "Patching \"${file}\""
   424 
   425     if [ "${libc_addon}" = "y" ]; then
   426         # Some addons tarball directly contian the correct addon directory,
   427         # while others have the addon directory named ofter the tarball.
   428         # Fix that bu always using the short name (eg: linuxthreads, ports, etc...)
   429         addon_short_name=`echo "${file}" |sed -r -e 's/^[^-]+-//; s/-[^-]+$//;'`
   430         [ -d "${addon_short_name}" ] || ln -s "${file}" "${addon_short_name}"
   431         # If libc addon, we're already in the correct place
   432     else
   433         cd "${file}"
   434     fi
   435 
   436     official_patch_dir=
   437     custom_patch_dir=
   438     [ "${CUSTOM_PATCH_ONLY}" = "y" ] || official_patch_dir="${CT_LIB_DIR}/patches/${base_file}/${ver_file}"
   439     [ "${CT_CUSTOM_PATCH}" = "y" ] && custom_patch_dir="${CT_CUSTOM_PATCH_DIR}/${base_file}/${ver_file}"
   440     for patch_dir in "${official_patch_dir}" "${custom_patch_dir}"; do
   441         if [ -n "${patch_dir}" -a -d "${patch_dir}" ]; then
   442             for p in "${patch_dir}"/*.patch; do
   443                 if [ -f "${p}" ]; then
   444                     CT_DoLog DEBUG "Applying patch \"${p}\""
   445                     patch -g0 -F1 -p1 -f <"${p}" |CT_DoLog ALL
   446                     CT_TestAndAbort "Failed while applying patch file \"${p}\"" ${PIPESTATUS[0]} -ne 0
   447                 fi
   448             done
   449         fi
   450     done
   451 
   452     CT_Popd
   453 }
   454 
   455 # Two wrappers to call config.(guess|sub) either from CT_TOP_DIR or CT_LIB_DIR.
   456 # Those from CT_TOP_DIR, if they exist, will be be more recent than those from CT_LIB_DIR.
   457 CT_DoConfigGuess() {
   458     if [ -x "${CT_TOP_DIR}/tools/config.guess" ]; then
   459         "${CT_TOP_DIR}/tools/config.guess"
   460     else
   461         "${CT_LIB_DIR}/tools/config.guess"
   462     fi
   463 }
   464 
   465 CT_DoConfigSub() {
   466     if [ -x "${CT_TOP_DIR}/tools/config.sub" ]; then
   467         "${CT_TOP_DIR}/tools/config.sub" "$@"
   468     else
   469         "${CT_LIB_DIR}/tools/config.sub" "$@"
   470     fi
   471 }
   472 
   473 # Compute the target triplet from what is provided by the user
   474 # Usage: CT_DoBuildTargetTriplet
   475 # In fact this function takes the environment variables to build the target
   476 # triplet. It is needed both by the normal build sequence, as well as the
   477 # sample saving sequence.
   478 CT_DoBuildTargetTriplet() {
   479     case "${CT_ARCH_BE},${CT_ARCH_LE}" in
   480         y,) target_endian_eb=eb; target_endian_el=;;
   481         ,y) target_endian_eb=; target_endian_el=el;;
   482     esac
   483     case "${CT_ARCH}" in
   484         arm)  CT_TARGET="${CT_ARCH}${target_endian_eb}";;
   485         mips) CT_TARGET="${CT_ARCH}${target_endian_el}";;
   486         x86*) # Much love for this one :-(
   487               arch="${CT_ARCH_ARCH}"
   488               [ -z "${arch}" ] && arch="${CT_ARCH_TUNE}"
   489               case "${CT_ARCH}" in
   490                   x86_64)  CT_TARGET=x86_64;;
   491               	  *)  case "${arch}" in
   492                           "")                                       CT_TARGET=i386;;
   493                           i386|i486|i586|i686)                      CT_TARGET="${arch}";;
   494                           winchip*)                                 CT_TARGET=i486;;
   495                           pentium|pentium-mmx|c3*)                  CT_TARGET=i586;;
   496                           nocona|athlon*64|k8|athlon-fx|opteron)    CT_TARGET=x86_64;;
   497                           pentiumpro|pentium*|athlon*)              CT_TARGET=i686;;
   498                           *)                                        CT_TARGET=i586;;
   499                       esac;;
   500               esac;;
   501     esac
   502     case "${CT_TARGET_VENDOR}" in
   503         "") CT_TARGET="${CT_TARGET}-unknown";;
   504         *)  CT_TARGET="${CT_TARGET}-${CT_TARGET_VENDOR}";;
   505     esac
   506     case "${CT_KERNEL}" in
   507         linux*)  CT_TARGET="${CT_TARGET}-linux";;
   508     esac
   509     case "${CT_LIBC}" in
   510         glibc)  CT_TARGET="${CT_TARGET}-gnu";;
   511         uClibc) CT_TARGET="${CT_TARGET}-uclibc";;
   512     esac
   513     CT_TARGET=`CT_DoConfigSub "${CT_TARGET}"`
   514 }
   515 
   516 # This function does pause the build until the user strikes "Return"
   517 # Usage: CT_DoPause [optional_message]
   518 CT_DoPause() {
   519     local foo
   520     local message="${1:-Pausing for your pleasure}"
   521     CT_DoLog INFO "${message}"
   522     read -p "Press \"Enter\" to continue, or Ctrl-C to stop..." foo >&6
   523     return 0
   524 }
   525 
   526 # This function saves the state of the toolchain to be able to restart
   527 # at any one point
   528 # Usage: CT_DoSaveState <next_step_name>
   529 CT_DoSaveState() {
   530 	[ "${CT_DEBUG_CT_SAVE_STEPS}" = "y" ] || return 0
   531     local state_name="$1"
   532     local state_dir="${CT_STATE_DIR}/${state_name}"
   533 
   534     CT_DoLog DEBUG "Saving state to restart at step \"${state_name}\"..."
   535     rm -rf "${state_dir}"
   536     mkdir -p "${state_dir}"
   537 
   538     case "${CT_DEBUG_CT_SAVE_STEPS_GZIP}" in
   539         y)  tar_opt=czf; tar_ext=".tar.gz";;
   540         *)  tar_opt=cf;  tar_ext=".tar";;
   541     esac
   542 
   543     CT_DoLog DEBUG "  Saving environment and aliases"
   544     # We must omit shell functions
   545     # 'isgrep' is here because I don't seem to
   546     # be able to remove the functions names.
   547     set |awk '
   548          BEGIN { _p = 1; }
   549          $0~/^[^ ] ()/ { _p = 0; }
   550          _p == 1
   551          $0 == "}" { _p = 1; }
   552          ' |egrep -v '^[^ ]+ \(\)' >"${state_dir}/env.sh"
   553 
   554     CT_DoLog DEBUG "  Saving CT_CC_CORE_STATIC_PREFIX_DIR=\"${CT_CC_CORE_STATIC_PREFIX_DIR}\""
   555     CT_Pushd "${CT_CC_CORE_STATIC_PREFIX_DIR}"
   556     tar ${tar_opt} "${state_dir}/cc_core_static_prefix_dir${tar_ext}" .
   557     CT_Popd
   558 
   559     CT_DoLog DEBUG "  Saving CT_CC_CORE_SHARED_PREFIX_DIR=\"${CT_CC_CORE_SHARED_PREFIX_DIR}\""
   560     CT_Pushd "${CT_CC_CORE_SHARED_PREFIX_DIR}"
   561     tar ${tar_opt} "${state_dir}/cc_core_shared_prefix_dir${tar_ext}" .
   562     CT_Popd
   563 
   564     CT_DoLog DEBUG "  Saving CT_PREFIX_DIR=\"${CT_PREFIX_DIR}\""
   565     CT_Pushd "${CT_PREFIX_DIR}"
   566     tar ${tar_opt} "${state_dir}/prefix_dir${tar_ext}" --exclude '*.log' .
   567     CT_Popd
   568 
   569     if [ "${CT_LOG_TO_FILE}" = "y" ]; then
   570         CT_DoLog DEBUG "  Saving log file"
   571         exec >/dev/null
   572         case "${CT_DEBUG_CT_SAVE_STEPS_GZIP}" in
   573             y)  gzip -3 -c "${CT_LOG_FILE}"  >"${state_dir}/log.gz";;
   574             *)  cat "${CT_LOG_FILE}" >"${state_dir}/log";;
   575         esac
   576         exec >>"${CT_LOG_FILE}"
   577     fi
   578 }
   579 
   580 # This function restores a previously saved state
   581 # Usage: CT_DoLoadState <state_name>
   582 CT_DoLoadState(){
   583     local state_name="$1"
   584     local state_dir="${CT_STATE_DIR}/${state_name}"
   585     local old_RESTART="${CT_RESTART}"
   586     local old_STOP="${CT_STOP}"
   587 
   588     CT_TestOrAbort "The previous build did not reach the point where it could be restarted at \"${CT_RESTART}\"" -d "${state_dir}"
   589 
   590     # We need to do something special with the log file!
   591     if [ "${CT_LOG_TO_FILE}" = "y" ]; then
   592         exec >"${state_dir}/tail.log"
   593     fi
   594     CT_DoLog INFO "Restoring state at step \"${state_name}\", as requested."
   595 
   596     case "${CT_DEBUG_CT_SAVE_STEPS_GZIP}" in
   597         y)  tar_opt=xzf; tar_ext=".tar.gz";;
   598         *)  tar_opt=cf;  tar_ext=".tar";;
   599     esac
   600 
   601     CT_DoLog DEBUG "  Removing previous build directories"
   602     chmod -R u+rwX "${CT_PREFIX_DIR}" "${CT_CC_CORE_SHARED_PREFIX_DIR}" "${CT_CC_CORE_STATIC_PREFIX_DIR}"
   603     rm -rf         "${CT_PREFIX_DIR}" "${CT_CC_CORE_SHARED_PREFIX_DIR}" "${CT_CC_CORE_STATIC_PREFIX_DIR}"
   604     mkdir -p       "${CT_PREFIX_DIR}" "${CT_CC_CORE_SHARED_PREFIX_DIR}" "${CT_CC_CORE_STATIC_PREFIX_DIR}"
   605 
   606     CT_DoLog DEBUG "  Restoring CT_PREFIX_DIR=\"${CT_PREFIX_DIR}\""
   607     CT_Pushd "${CT_PREFIX_DIR}"
   608     tar ${tar_opt} "${state_dir}/prefix_dir${tar_ext}"
   609     CT_Popd
   610 
   611     CT_DoLog DEBUG "  Restoring CT_CC_CORE_SHARED_PREFIX_DIR=\"${CT_CC_CORE_SHARED_PREFIX_DIR}\""
   612     CT_Pushd "${CT_CC_CORE_SHARED_PREFIX_DIR}"
   613     tar ${tar_opt} "${state_dir}/cc_core_shared_prefix_dir${tar_ext}"
   614     CT_Popd
   615 
   616     CT_DoLog DEBUG "  Restoring CT_CC_CORE_STATIC_PREFIX_DIR=\"${CT_CC_CORE_STATIC_PREFIX_DIR}\""
   617     CT_Pushd "${CT_CC_CORE_STATIC_PREFIX_DIR}"
   618     tar ${tar_opt} "${state_dir}/cc_core_static_prefix_dir${tar_ext}"
   619     CT_Popd
   620 
   621     # Restore the environment, discarding any error message
   622     # (for example, read-only bash internals)
   623     CT_DoLog DEBUG "  Restoring environment"
   624     . "${state_dir}/env.sh" >/dev/null 2>&1 || true
   625 
   626     # Restore the new RESTART and STOP steps
   627     CT_RESTART="${old_RESTART}"
   628     CT_STOP="${old_STOP}"
   629     unset old_stop old_restart
   630 
   631     if [ "${CT_LOG_TO_FILE}" = "y" ]; then
   632         CT_DoLog DEBUG "  Restoring log file"
   633         exec >/dev/null
   634         case "${CT_DEBUG_CT_SAVE_STEPS_GZIP}" in
   635             y)  zcat "${state_dir}/log.gz" >"${CT_LOG_FILE}";;
   636             *)  cat "${state_dir}/log" >"${CT_LOG_FILE}";;
   637         esac
   638         cat "${state_dir}/tail.log" >>"${CT_LOG_FILE}"
   639         exec >>"${CT_LOG_FILE}"
   640         rm -f "${state_dir}/tail.log"
   641     fi
   642 }