The Tcpdump Group git mirrors - tcpdump/blob - build_common.sh

   1 #!/bin/sh -e
   2
   3 # The only purpose of the above shebang is to orient shellcheck right.
   4 # To make CI scripts maintenance simpler, copies of this file in the
   5 # libpcap, tcpdump and tcpslice git repositories should be identical.
   6 # Please mind that Solaris /bin/sh before 11 does not support the $()
   7 # command substitution syntax, hence the SC2006 directives.
   8
   9 # A poor man's mktemp(1) for OSes that don't have one (e.g. AIX 7, Solaris 9).
  10 mktempdir_diy() {
  11     while true; do
  12         # /bin/sh implements $RANDOM in AIX 7, but not in Solaris before 11,
  13         # thus use dd and od instead.
  14         # shellcheck disable=SC2006
  15         mktempdir_diy_suffix=`dd if=/dev/urandom bs=4 count=1 2>/dev/null | od -t x -A n | head -1 | tr -d '\t '`
  16         [ -z "$mktempdir_diy_suffix" ] && return 1
  17         mktempdir_diy_path="${TMPDIR:-/tmp}/${1:?}.${mktempdir_diy_suffix}"
  18         # "test -e" would be more appropriate, but it is not available in
  19         # Solaris /bin/sh before 11.
  20         if [ ! -d "$mktempdir_diy_path" ]; then
  21             mkdir "$mktempdir_diy_path"
  22             chmod go= "$mktempdir_diy_path"
  23             echo "$mktempdir_diy_path"
  24             break
  25         fi
  26         # Try again (very unlikely, just in case).
  27     done
  28 }
  29
  30 mktempdir() {
  31     mktempdir_prefix=${1:-tmp}
  32     # shellcheck disable=SC2006
  33     case `os_id` in
  34     Darwin-*|FreeBSD-*|NetBSD-*)
  35         # In these operating systems mktemp(1) always appends an implicit
  36         # ".XXXXXXXX" suffix to the requested template when creating a
  37         # temporary directory.
  38         mktemp -d -t "$mktempdir_prefix"
  39         ;;
  40     SunOS-5.10|SunOS-5.11)
  41         # Although the suffix is optional, specify it for consistent results.
  42         mktemp -d -t "${mktempdir_prefix}.XXXXXXXX"
  43         ;;
  44     SunOS-*|AIX-*)
  45         mktempdir_diy "$mktempdir_prefix"
  46         ;;
  47     *)
  48         # At least Linux and OpenBSD implementations require explicit trailing
  49         # X'es in the template, so make it the same suffix as above.
  50         mktemp -d -t "${mktempdir_prefix}.XXXXXXXX"
  51         ;;
  52     esac
  53 }
  54
  55 print_sysinfo() {
  56     uname -a
  57     printf 'OS identification: '
  58     os_id
  59     date
  60 }
  61
  62 # Try to make the current C compiler print its version information (usually
  63 # multi-line) to stdout.
  64 # shellcheck disable=SC2006
  65 cc_version_nocache() {
  66     : "${CC:?}"
  67     case `basename "$CC"` in
  68     gcc*|egcc*|clang*)
  69         # GCC and Clang recognize --version, print to stdout and exit with 0.
  70         "$CC" --version
  71         ;;
  72     xl*)
  73         # XL C 12.1 and 13.1 recognize "-qversion", print to stdout and exit
  74         # with 0. XL C 12.1 on an unknown command-line flag displays its man
  75         # page and waits.
  76         # XL C 16.1 recognizes "-qversion" and "--version", prints to stdout
  77         # and exits with 0. Community Edition also prints a banner to stderr.
  78         "$CC" -qversion 2>/dev/null
  79         ;;
  80     sun*)
  81         # Sun compilers recognize -V, print to stderr and exit with an error.
  82         "$CC" -V 2>&1 || :
  83         ;;
  84     cc)
  85         case `os_id` in
  86         SunOS-*)
  87             # Most likely Sun C.
  88             "$CC" -V 2>&1 || :
  89             ;;
  90         Darwin-*)
  91             # Most likely Clang.
  92             "$CC" --version
  93             ;;
  94         Linux-*|FreeBSD-*|NetBSD-*|OpenBSD-*)
  95             # Most likely Clang or GCC.
  96             "$CC" --version
  97             ;;
  98         esac
  99         ;;
 100     *)
 101         "$CC" --version || "$CC" -V || :
 102         ;;
 103     esac
 104 }
 105
 106 # shellcheck disable=SC2006
 107 cc_version() {
 108     echo "${cc_version_cached:=`cc_version_nocache`}"
 109 }
 110
 111 print_cc_version() {
 112     cc_version
 113     printf 'Compiler identification: '
 114     cc_id
 115 }
 116
 117 # For the current C compiler try to print a short and uniform identification
 118 # string (such as "gcc-9.3.0") that is convenient to use in a case statement.
 119 # shellcheck disable=SC2006
 120 cc_id_nocache() {
 121     cc_id_firstline=`cc_version | head -1`
 122     : "${cc_id_firstline:?}"
 123
 124     cc_id_guessed=`echo "$cc_id_firstline" | sed 's/^.*clang version \([0-9\.]*\).*$/clang-\1/'`
 125     if [ "$cc_id_firstline" != "$cc_id_guessed" ]; then
 126         echo "$cc_id_guessed"
 127         return
 128     fi
 129
 130     cc_id_guessed=`echo "$cc_id_firstline" | sed 's/^IBM XL C.*, V\([0-9\.]*\).*$/xlc-\1/'`
 131     if [ "$cc_id_firstline" != "$cc_id_guessed" ]; then
 132         echo "$cc_id_guessed"
 133         return
 134     fi
 135
 136     cc_id_guessed=`echo "$cc_id_firstline" | sed 's/^.* Sun C \([0-9\.]*\) .*$/suncc-\1/'`
 137     if [ "$cc_id_firstline" != "$cc_id_guessed" ]; then
 138         echo "$cc_id_guessed"
 139         return
 140     fi
 141
 142     cc_id_guessed=`echo "$cc_id_firstline" | sed 's/^.* (.*) \([0-9\.]*\)$/gcc-\1/'`
 143     if [ "$cc_id_firstline" != "$cc_id_guessed" ]; then
 144         echo "$cc_id_guessed"
 145         return
 146     fi
 147 }
 148
 149 # shellcheck disable=SC2006
 150 cc_id() {
 151     echo "${cc_id_cached:=`cc_id_nocache`}"
 152 }
 153
 154 # Call this function each time CC has changed.
 155 discard_cc_cache() {
 156     cc_version_cached=
 157     cc_id_cached=
 158 }
 159
 160 # For the current C compiler try to print CFLAGS value that tells to treat
 161 # warnings as errors.
 162 # shellcheck disable=SC2006
 163 cc_werr_cflags() {
 164     case `cc_id` in
 165     gcc-*|clang-*)
 166         echo '-Werror'
 167         ;;
 168     xlc-*)
 169         # XL C 12.1 and 13.1 recognize "-qhalt=w". XL C 16.1 recognizes that
 170         # and "-Werror".
 171         echo '-qhalt=w'
 172         ;;
 173     suncc-*)
 174         echo '-errwarn=%all'
 175         ;;
 176     esac
 177 }
 178
 179 # Tell whether "gcc" is a symlink to Clang (this is the case on macOS).
 180 # shellcheck disable=SC2006
 181 gcc_is_clang_in_disguise() {
 182     case `cc_id`/`basename "${CC:?}"` in
 183     clang-*/gcc)
 184         return 0
 185         ;;
 186     esac
 187     return 1
 188 }
 189
 190 # shellcheck disable=SC2006
 191 os_id() {
 192     # OS does not change between builds or in the middle of a build, so it is
 193     # fine to cache uname output.
 194     : "${os_id_sysname:=`uname -s`}"
 195     printf '%s-' "$os_id_sysname"
 196     : "${os_id_release:=`uname -r`}"
 197     case "$os_id_sysname" in
 198     AIX)
 199         : "${os_id_version:=`uname -v`}"
 200         echo "${os_id_version}.${os_id_release}"
 201         ;;
 202     Darwin|NetBSD|OpenBSD|SunOS)
 203         echo "$os_id_release"
 204         ;;
 205     FreeBSD|Linux)
 206         # Meaningful version is usually the substring before the first dash.
 207         echo "$os_id_release" | sed 's/^\([0-9\.]*\).*$/\1/'
 208         ;;
 209     *)
 210         echo 'UNKNOWN'
 211         ;;
 212     esac
 213 }
 214
 215 increment() {
 216     # No arithmetic expansion in Solaris /bin/sh before 11.
 217     echo "${1:?} + 1" | bc
 218 }
 219
 220 # Display text in magenta.
 221 echo_magenta() {
 222     # ANSI magenta, the imploded text, ANSI reset, newline.
 223     printf '\033[35;1m%s\033[0m\n' "$*"
 224 }
 225
 226 # Run a command after displaying it.
 227 run_after_echo() {
 228     : "${1:?}" # Require at least one argument.
 229     printf '$ %s\n' "$*"
 230     "$@"
 231 }
 232
 233 print_so_deps() {
 234     # shellcheck disable=SC2006
 235     case `os_id` in
 236     Darwin-*)
 237         run_after_echo otool -L "${1:?}"
 238         ;;
 239     *)
 240         run_after_echo ldd "${1:?}"
 241         ;;
 242     esac
 243 }
 244
 245 # Beware that setting MATRIX_DEBUG for tcpdump or tcpslice will produce A LOT
 246 # of additional output there and in any nested libpcap builds. Multiplied by
 247 # the matrix size, the full output log size might exceed limits of some CI
 248 # systems (as it had previously happened with Travis CI). Use with caution on
 249 # a reduced matrix.
 250 handle_matrix_debug() {
 251     [ "$MATRIX_DEBUG" != yes ] && return
 252     echo '$ cat Makefile [...]'
 253     sed '/^# DO NOT DELETE THIS LINE -- mkdep uses it.$/q' <Makefile
 254     run_after_echo cat config.h
 255     [ "$CMAKE" = yes ] || run_after_echo cat config.log
 256 }
 257
 258 purge_directory() {
 259     # shellcheck disable=SC2006
 260     if [ "`os_id`" = SunOS-5.11 ]; then
 261         # In Solaris 11 /bin/sh the pathname expansion of "*" always includes
 262         # "." and "..", so the straightforward rm would always fail.
 263         (
 264             cd "${1:?}"
 265             for pd_each in *; do
 266                 if [ "$pd_each" != . ] && [ "$pd_each" != .. ]; then
 267                     rm -rf "$pd_each"
 268                 fi
 269             done
 270         )
 271     else
 272         rm -rf "${1:?}"/*
 273     fi
 274 }
 275
 276 # vi: set tabstop=4 softtabstop=0 expandtab shiftwidth=4 smarttab autoindent :