t/ax/depcomp.sh

   1 #! /bin/sh
   2 # Copyright (C) 2012-2013 Free Software Foundation, Inc.
   3 #
   4 # This program is free software; you can redistribute it and/or modify
   5 # it under the terms of the GNU General Public License as published by
   6 # the Free Software Foundation; either version 2, or (at your option)
   7 # any later version.
   8 #
   9 # This program is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 # GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License
  15 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 # Check dependency tracking in various flavours.
  18 # Contains both libtool and non-libtool case.
  19 # Sourced by the various (autogenerated) 'depcomp*.tap' tests.
  20 # Examples of reported failures that motivated those test are
  21 # listed below.
  22
  23 # -------------------------------------------------------------------------
  24
  25 # <http://lists.gnu.org/archive/html/automake-patches/2011-04/msg00028.html>
  26 #
  27 # Here's the bug: makedepend will prefix VPATH to the object file name,
  28 # thus the second make will invoke depcomp with object='../../src/foo.o',
  29 # causing errors such as:
  30 #
  31 #  touch: cannot touch '../../src/.deps/foo.TPo': No such file or directory
  32 #  makedepend: error:  cannot open "../../src/.deps/foo.TPo"
  33 #  ../../depcomp: line 560: ../../src/.deps/foo.TPo: No such file or directory
  34
  35 # -------------------------------------------------------------------------
  36
  37 # <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=8473>
  38 # <http://lists.gnu.org/archive/html/automake-patches/2011-04/msg00079.html>
  39 #
  40 # Here's the bug: hp depmode will prefix VPATH to the object file name,
  41 # thus the second gmake will invoke depcomp with object='../../src/foo.o',
  42 # causing errors such as (broken on multiple lines for clarity):
  43 #
  44 #   cpp: "", line 0: error 4066: Cannot create
  45 #        "../../gllib/.deps/nonblocking.TPo" file for
  46 #        "-M../../gllib/.deps/nonblocking.TPo" option.
  47 #        (No such file or directory[errno=2])
  48 #
  49
  50 # -------------------------------------------------------------------------
  51
  52 # <http://lists.gnu.org/archive/html/automake-patches/2011-04/msg00140.html>
  53 # <http://lists.gnu.org/archive/html/automake-patches/2011-05/msg00019.html>
  54 #
  55 # A partial failure of an earlier version of this test; some bad
  56 # post-processing of the '*.Po' files led to the following broken
  57 # contents of 'src/sub/.deps/subfoo.Po':
  58 #
  59 #  > sub/subfoo.o: ../../depmod-data.dir/src/sub/subfoo.c \
  60 #  >   ../../depmod-data.dir/src/foo.h
  61 #  > ../../depmod-data.dir/src/sub/subfoo.c \:
  62 #  >   ../../depmod-data.dir/src/foo.h:
  63 #
  64 # which caused make to die with an error like:
  65 #
  66 #  "sub/.deps/subfoo.Po:3: *** missing separator.  Stop."
  67
  68 # -------------------------------------------------------------------------
  69
  70 # This code expects test-init.sh has already been included in advance.
  71
  72 ocwd=$(pwd) || fatal_ "getting current working directory"
  73 longpath=this-is/a-path/which-has/quite-a/definitely/truly/long_long_name
  74 cachevar=am_cv_CC_dependencies_compiler_type
  75
  76 srctree=depmod-1.0
  77 mkdir $srctree
  78 cd $srctree
  79
  80 cd_top ()
  81 {
  82   cd "$ocwd" || fatal_ "cannot chdir back to top directory"
  83 }
  84
  85 delete ()
  86 {
  87   test -f "$1" || fatal_ "$1: file does not exist"
  88   rm -f "$1" || fatal_ "$1: couldn't remove"
  89 }
  90
  91 edit ()
  92 {
  93   file=$1; shift
  94   sed "$@" <"$file" > t && mv -f t "$file" \
  95     || fatal_ "$file: editing of file failed"
  96 }
  97
  98 rewrite ()
  99 {
 100   file=$1; shift
 101   "$@" > "$file" || fatal_ "$file: couldn't rewrite"
 102 }
 103
 104 setup_srcdir ()
 105 {
 106   srcdir=$1 # This is intended to be global.
 107   mkdir -p "$srcdir" \
 108     || fatal_ "couldn't create source directory '$srcdir'"
 109   cp -pR "$ocwd/$srctree"/* "$srcdir"/ \
 110     || fatal_ "couldn't populate source directory '$srcdir'"
 111 }
 112
 113
 114 check_no_depfiles ()
 115 {
 116   find . -name '*.Plo' -o -name '*.Po' | grep . && return 1
 117   return 0
 118 }
 119
 120 check_distclean ()
 121 {
 122   # "make distcleancheck" can only run from a VPATH build.
 123   if test $vpath = no; then
 124     make_ok distclean && check_no_depfiles
 125   else
 126     $MAKE distcleancheck
 127   fi
 128 }
 129
 130 cat > configure.ac <<END
 131 AC_INIT([$me], [1.0])
 132 AC_CONFIG_AUX_DIR([build-aux])
 133 AM_INIT_AUTOMAKE
 134 AC_PROG_CC
 135 AM_PROG_CC_C_O
 136 AM_PROG_AR
 137 $(if test $depcomp_with_libtool = yes; then
 138     echo AC_PROG_LIBTOOL
 139   else
 140     echo AC_PROG_RANLIB
 141   fi)
 142 AC_CONFIG_FILES([Makefile src/Makefile])
 143 AC_OUTPUT
 144 END
 145
 146 mkdir build-aux sub src src/sub2
 147
 148 case $depcomp_with_libtool in
 149   yes)
 150     po=Plo objext=lo a=la
 151     normalized_target=libfoo_la
 152     # On platforms requiring that no undefined symbols exist in order
 153     # to build shared libraries (e.g. Windows DLLs), you have to
 154     # explicitly declare that the libtool library you are building
 155     # does not actually have any undefined symbols, for libtool to
 156     # even try to build it as a shared library.  Without that
 157     # explicit declaration, libtool falls back to a static library
 158     # only, regardless of any --enable-shared flags etc.
 159     LIBPRIMARY=LTLIBRARIES LINKADD=LIBADD NOUNDEF=-no-undefined
 160     libbaz_ldflags="libbaz_${a}_LDFLAGS = $NOUNDEF"
 161     echo lib_LTLIBRARIES = libfoo.la >> Makefile.am
 162     make_ok ()
 163     {
 164       run_make -M -- ${1+"$@"}
 165       $FGREP 'unknown directive' output && return 1
 166       rm -f output
 167       # Checks for stray files possibly left around by less common
 168       # depmodes.
 169       find . -name '*.[ud]' | grep . && return 1
 170       return 0
 171     }
 172     ;;
 173   no)
 174     po=Po objext='$(OBJEXT)' a=a
 175     normalized_target=foo
 176     LIBPRIMARY=LIBRARIES LINKADD=LDADD NOUNDEF=
 177     libbaz_ldflags=
 178     echo bin_PROGRAMS = foo >> Makefile.am
 179     make_ok ()
 180     {
 181       $MAKE ${1+"$@"}
 182     }
 183     ;;
 184   *)
 185     fatal_ "invalid value '$depcomp_with_libtool' for variable" \
 186            "\$depcomp_with_libtool"
 187     ;;
 188 esac
 189
 190 cat >> Makefile.am <<END
 191 SUBDIRS = src
 192 # We include subfoo only to be sure that the munging in depcomp
 193 # doesn't remove too much from the object file name.
 194 ${normalized_target}_SOURCES = foo.c sub/subfoo.c foo.h sub/subfoo.h
 195 ${normalized_target}_LDFLAGS = $NOUNDEF
 196 ${normalized_target}_${LINKADD} = src/libbaz.$a
 197
 198 .PHONY: grep-test
 199 grep-test:
 200 ## For debugging.
 201         cat \$(DEPDIR)/foo.$po || :
 202         cat \$(DEPDIR)/subfoo.$po || :
 203         cat src/\$(DEPDIR)/baz.$po || :
 204         cat src/sub2/\$(DEPDIR)/sub2foo.$po || :
 205 ## Checks done here.
 206         grep '^foo.$objext.*:' \$(DEPDIR)/foo.$po
 207         grep '^subfoo\.$objext.*:' \$(DEPDIR)/subfoo.$po
 208         grep '^baz\.$objext.*:' src/\$(DEPDIR)/baz.$po
 209         grep '^sub2/sub2foo\.$objext.*:' src/sub2/\$(DEPDIR)/sub2foo.$po
 210 END
 211
 212 cat > src/Makefile.am <<END
 213 AUTOMAKE_OPTIONS = subdir-objects
 214 noinst_${LIBPRIMARY} = libbaz.$a
 215 # We include sub2foo only to be sure that the munging in depcomp
 216 # doesn't remove too much from the object file name.
 217 libbaz_${a}_SOURCES = baz.c sub2/sub2foo.c baz.h sub2/sub2foo.h
 218 $libbaz_ldflags
 219 END
 220
 221 cat > foo.c <<'END'
 222 #include "foo.h"
 223 #include "src/baz.h"
 224 #include <stdlib.h>
 225 int main (void)
 226 {
 227   printf ("foo bar\n");
 228   exit (EXIT_SUCCESS + subfoo () + baz ());
 229 }
 230 END
 231
 232 cat > foo.h <<'END'
 233 #include <stdio.h>
 234 #include "sub/subfoo.h"
 235 END
 236
 237 cat > sub/subfoo.c <<'END'
 238 #include "sub/subfoo.h"
 239 int subfoo (void) { return 0; }
 240 END
 241
 242 echo '/* empty */' > src/sub2/sub2foo.h
 243
 244 cat > sub/subfoo.h <<'END'
 245 #include <stdio.h>
 246 extern int subfoo (void);
 247 END
 248
 249 cat > src/baz.c <<'END'
 250 #include "baz.h"
 251 int baz (void) { return 0; }
 252 END
 253
 254 cat > src/baz.h <<'END'
 255 extern int baz (void);
 256 END
 257
 258 cat > src/sub2/sub2foo.c <<'END'
 259 #include "sub2foo.h"
 260 int sub2foo (void) { return 0; }
 261 END
 262
 263 test $depcomp_with_libtool = no || libtoolize \
 264   || fatal_ "libtoolize failed"
 265 $ACLOCAL && $AUTOCONF && $AUTOMAKE -a \
 266   || fatal_ "autotools failed"
 267 test -f build-aux/depcomp \
 268   || fatal_ "depcomp script not installed"
 269
 270 # To offer extra coverage for the depmodes (like "aix" of "hp2") where the
 271 # name of the compiler-generated depfiles can depend on whether libtool is
 272 # in use *and* on which kind of libraries libtool is building (static,
 273 # shared, or both), we would like to run the libtool-oriented tests thrice:
 274 # once after having run configure with the '--disable-shared' option, once
 275 # after having run it with the '--enable-shared' options, and once by
 276 # leaving it to configure to automatically select which kind of library (or
 277 # libraries) to build.
 278 #
 279 # But doing such three-fold checks unconditionally for all the depmodes
 280 # would slow down the already too slow libtool tests unacceptably (up to a
 281 # 150-200% factor), with no real gain in coverage for most of the depmodes.
 282 # So, since the depmodes that would benefit from the extra tests are never
 283 # forced to configure in out tests below, but can only be automatically
 284 # selected by '--enable-dependency-tracking', we make this threefold check
 285 # only in this later case.
 286
 287 if test $depmode,$depcomp_with_libtool = auto,yes; then
 288   do_all_tests ()
 289   {
 290     do_test default
 291     do_test noshared --disable-shared
 292     do_test nostatic --disable-static
 293   }
 294 else
 295   do_all_tests () { do_test; }
 296 fi
 297
 298 case $depmode in
 299   auto)
 300     displayed_depmode='..*' # At least one character long.
 301     cfg_deptrack=--enable-dependency-tracking ;;
 302   disabled)
 303     displayed_depmode=none
 304     cfg_deptrack=--disable-dependency-tracking ;;
 305   *)
 306     displayed_depmode="(cached) $depmode"
 307     cfg_deptrack="$cachevar=$depmode"
 308     # Sanity check: ensure the cache variable we force is truly
 309     # used by configure.
 310     $FGREP $cachevar configure \
 311       || fatal_ "configure lacks required cache variable '$cachevar'";;
 312 esac
 313
 314 cd_top
 315
 316 do_test ()
 317 {
 318   cd_top
 319   if test $vpath = no; then
 320     pfx="in-tree build"
 321   else
 322     pfx="$vpath VPATH"
 323   fi
 324   if test $# -gt 0; then
 325     subdir=$1; shift
 326     pfx="$pfx, $subdir"
 327     test -d $subdir || mkdir $subdir || fatal_ "creating directory $subdir"
 328     cd $subdir
 329   fi
 330   pfx="[$pfx]"
 331   case $vpath in
 332     simple)
 333       mkdir -p vpath-simple/build
 334       cd vpath-simple/build
 335       setup_srcdir ..
 336       ;;
 337     long)
 338       mkdir -p vpath-long/src vpath-long/wrk
 339       cd vpath-long/wrk
 340       setup_srcdir ../src/$longpath
 341       ;;
 342     absolute)
 343       mkdir -p vpath-abs/build
 344       cd vpath-abs/build
 345       absdir=$(cd .. && pwd) || fatal_ "getting absolute directory"
 346       setup_srcdir "$absdir/vpath-abs"
 347       unset absdir
 348       ;;
 349     no)
 350       mkdir intree
 351       cd intree
 352       setup_srcdir .
 353       ;;
 354     *)
 355       fatal_ "invalid value '$vpath' for variable \$vpath"
 356       ;;
 357   esac
 358
 359   command_ok_ \
 360     "$pfx configure" \
 361     "$srcdir/configure" $cfg_deptrack ${1+"$@"} >stdout
 362   cat stdout
 363
 364   command_ok_ \
 365     "$pfx right depmode selected" \
 366     grep "^checking dependency style .*\.\.\. $displayed_depmode$" stdout
 367   rm -f stdout
 368
 369   command_ok_ "$pfx simple make" make_ok
 370   # Some bugs in VPATH builds only kick in during a rebuild.
 371   command_ok_ "$pfx clean & rebuild" eval '$MAKE clean && make_ok'
 372
 373   if test $depmode = disabled; then
 374       command_ok_ "$pfx no dependency files generated" check_no_depfiles
 375       r=ok \
 376         && grep "[ $tab]depmode=none" Makefile \
 377         && rewrite "$srcdir"/src/sub2/sub2foo.h echo 'choke me' \
 378         && delete "$srcdir"/sub/subfoo.h \
 379         && make_ok \
 380         || r='not ok'
 381       result_ "$r" "$pfx dependency tracking is truly disabled"
 382   elif grep "[ $tab]depmode=none" Makefile; then
 383     skip_row_ 2 -r "automatic dependency tracking couldn't be activated"
 384   else
 385     command_ok_ "$pfx generated $po files look correct" $MAKE grep-test
 386     r=ok \
 387       && : "Some checks in the subdir." \
 388       && $sleep \
 389       && : "Ensure rebuild rules really kick in." \
 390       && rewrite "$srcdir"/src/sub2/sub2foo.h echo 'choke me' \
 391       && cd src \
 392       && not $MAKE  \
 393       && cd .. \
 394       && : "Ensure the deleted header bug is fixed." \
 395       && delete "$srcdir"/src/sub2/sub2foo.h \
 396       && edit "$srcdir"/src/sub2/sub2foo.c -e 1d \
 397       && cd src \
 398       && make_ok \
 399       && : "Now do similar checks for the parent directory." \
 400       && cd .. \
 401       && rewrite "$srcdir"/sub/subfoo.h echo 'choke me' \
 402       && not $MAKE \
 403       && delete "$srcdir"/sub/subfoo.h \
 404       && edit "$srcdir"/sub/subfoo.c -e 1d \
 405       && edit "$srcdir"/foo.h -e 2d \
 406       && make_ok \
 407       || r='not ok'
 408     result_ "$r" "$pfx dependency tracking works"
 409   fi
 410
 411   command_ok_ "$pfx make distclean" check_distclean
 412   cd_top
 413 }
 414
 415 for vpath in no simple long absolute; do
 416   do_all_tests
 417 done
 418
 419 :