t/ax/depcomp.sh

   1 #! /bin/sh
   2 # Copyright (C) 2012 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 expects ./defs has already been included has already been included..
  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       $MAKE ${1+"$@"} >output 2>&1 || { cat output; return 1; }
 165       cat output
 166       $FGREP 'unknown directive' output && return 1
 167       rm -f output
 168       # Checks for stray files possibly left around by less common
 169       # depmodes.
 170       find . -name '*.[ud]' | grep . && return 1
 171       return 0
 172     }
 173     ;;
 174   no)
 175     po=Po objext='$(OBJEXT)' a=a
 176     normalized_target=foo
 177     LIBPRIMARY=LIBRARIES LINKADD=LDADD NOUNDEF=
 178     libbaz_ldflags=
 179     echo bin_PROGRAMS = foo >> Makefile.am
 180     make_ok ()
 181     {
 182       $MAKE ${1+"$@"}
 183     }
 184     ;;
 185   *)
 186     fatal_ "invalid value '$depcomp_with_libtool' for variable" \
 187            "\$depcomp_with_libtool"
 188     ;;
 189 esac
 190
 191 cat >> Makefile.am <<END
 192 SUBDIRS = src
 193 # We include subfoo only to be sure that the munging in depcomp
 194 # doesn't remove too much from the object file name.
 195 ${normalized_target}_SOURCES = foo.c sub/subfoo.c foo.h sub/subfoo.h
 196 ${normalized_target}_LDFLAGS = $NOUNDEF
 197 ${normalized_target}_${LINKADD} = src/libbaz.$a
 198
 199 .PHONY: grep-test
 200 grep-test:
 201 ## For debugging.
 202         cat \$(DEPDIR)/foo.$po || :
 203         cat \$(DEPDIR)/subfoo.$po || :
 204         cat src/\$(DEPDIR)/baz.$po || :
 205         cat src/sub2/\$(DEPDIR)/sub2foo.$po || :
 206 ## Checks done here.
 207         grep '^foo.$objext.*:' \$(DEPDIR)/foo.$po
 208         grep '^subfoo\.$objext.*:' \$(DEPDIR)/subfoo.$po
 209         grep '^baz\.$objext.*:' src/\$(DEPDIR)/baz.$po
 210         grep '^sub2/sub2foo\.$objext.*:' src/sub2/\$(DEPDIR)/sub2foo.$po
 211 END
 212
 213 cat > src/Makefile.am <<END
 214 AUTOMAKE_OPTIONS = subdir-objects
 215 noinst_${LIBPRIMARY} = libbaz.$a
 216 # We include sub2foo only to be sure that the munging in depcomp
 217 # doesn't remove too much from the object file name.
 218 libbaz_${a}_SOURCES = baz.c sub2/sub2foo.c baz.h sub2/sub2foo.h
 219 $libbaz_ldflags
 220 END
 221
 222 cat > foo.c <<'END'
 223 #include "foo.h"
 224 #include "src/baz.h"
 225 #include <stdlib.h>
 226 int main (void)
 227 {
 228   printf ("foo bar\n");
 229   exit (EXIT_SUCCESS + subfoo () + baz ());
 230 }
 231 END
 232
 233 cat > foo.h <<'END'
 234 #include <stdio.h>
 235 #include "sub/subfoo.h"
 236 END
 237
 238 cat > sub/subfoo.c <<'END'
 239 #include "sub/subfoo.h"
 240 int subfoo (void) { return 0; }
 241 END
 242
 243 echo '/* empty */' > src/sub2/sub2foo.h
 244
 245 cat > sub/subfoo.h <<'END'
 246 #include <stdio.h>
 247 extern int subfoo (void);
 248 END
 249
 250 cat > src/baz.c <<'END'
 251 #include "baz.h"
 252 int baz (void) { return 0; }
 253 END
 254
 255 cat > src/baz.h <<'END'
 256 extern int baz (void);
 257 END
 258
 259 cat > src/sub2/sub2foo.c <<'END'
 260 #include "sub2foo.h"
 261 int sub2foo (void) { return 0; }
 262 END
 263
 264 test $depcomp_with_libtool = no || libtoolize \
 265   || fatal_ "libtoolize failed"
 266 $ACLOCAL && $AUTOCONF && $AUTOMAKE -a \
 267   || fatal_ "autotools failed"
 268 test -f build-aux/depcomp \
 269   || fatal_ "depcomp script not installed"
 270
 271 # To offer extra coverage for the depmodes (like "aix" of "hp2") where the
 272 # name of the compiler-generated depfiles can depend on whether libtool is
 273 # in use *and* on which kind of libraries libtool is building (static,
 274 # shared, or both), we would like to run the libtool-oriented tests thrice:
 275 # once after having run configure with the '--disable-shared' option, once
 276 # after having run it with the '--enable-shared' options, and once by
 277 # leaving it to configure to automatically select which kind of library (or
 278 # libraries) to build.
 279 #
 280 # But doing such three-fold checks unconditionally for all the depmodes
 281 # would slow down the already too slow libtool tests unacceptably (up to a
 282 # 150-200% factor), with no real gain in coverage for most of the depmodes.
 283 # So, since the depmodes that would benefit from the extra tests are never
 284 # forced to configure in out tests below, but can only be automatically
 285 # selected by '--enable-dependency-tracking', we make this threefold check
 286 # only in this later case.
 287
 288 if test $depmode,$depcomp_with_libtool = auto,yes; then
 289   do_all_tests ()
 290   {
 291     do_test default
 292     do_test noshared --disable-shared
 293     do_test nostatic --disable-static
 294   }
 295 else
 296   do_all_tests () { do_test; }
 297 fi
 298
 299 case $depmode in
 300   auto)
 301     displayed_depmode='..*' # At least one character long.
 302     cfg_deptrack=--enable-dependency-tracking ;;
 303   disabled)
 304     displayed_depmode=none
 305     cfg_deptrack=--disable-dependency-tracking ;;
 306   *)
 307     displayed_depmode="(cached) $depmode"
 308     cfg_deptrack="$cachevar=$depmode"
 309     # Sanity check: ensure the cache variable we force is truly
 310     # used by configure.
 311     $FGREP $cachevar configure \
 312       || fatal_ "configure lacks required cache variable '$cachevar'";;
 313 esac
 314
 315 cd_top
 316
 317 do_test ()
 318 {
 319   cd_top
 320   if test $vpath = no; then
 321     pfx="in-tree build"
 322   else
 323     pfx="$vpath VPATH"
 324   fi
 325   if test $# -gt 0; then
 326     subdir=$1; shift
 327     pfx="$pfx, $subdir"
 328     test -d $subdir || mkdir $subdir || fatal_ "creating directory $subdir"
 329     cd $subdir
 330   fi
 331   pfx="[$pfx]"
 332   case $vpath in
 333     simple)
 334       mkdir -p vpath-simple/build
 335       cd vpath-simple/build
 336       setup_srcdir ..
 337       ;;
 338     long)
 339       mkdir -p vpath-long/src vpath-long/wrk
 340       cd vpath-long/wrk
 341       setup_srcdir ../src/$longpath
 342       ;;
 343     absolute)
 344       mkdir -p vpath-abs/build
 345       cd vpath-abs/build
 346       absdir=$(cd .. && pwd) || fatal_ "getting absolute directory"
 347       setup_srcdir "$absdir/vpath-abs"
 348       unset absdir
 349       ;;
 350     no)
 351       mkdir intree
 352       cd intree
 353       setup_srcdir .
 354       ;;
 355     *)
 356       fatal_ "invalid value '$vpath' for variable \$vpath"
 357       ;;
 358   esac
 359
 360   command_ok_ \
 361     "$pfx configure" \
 362     "$srcdir/configure" $cfg_deptrack ${1+"$@"} >stdout
 363   cat stdout
 364
 365   command_ok_ \
 366     "$pfx right depmode selected" \
 367     grep "^checking dependency style .*\.\.\. $displayed_depmode$" stdout
 368   rm -f stdout
 369
 370   command_ok_ "$pfx simple make" make_ok
 371   # Some bugs in VPATH builds only kick in during a rebuild.
 372   command_ok_ "$pfx clean & rebuild" eval '$MAKE clean && make_ok'
 373
 374   if test $depmode = disabled; then
 375       command_ok_ "$pfx no dependency files generated" check_no_depfiles
 376       r=ok \
 377         && grep "[ $tab]depmode=none" Makefile \
 378         && rewrite "$srcdir"/src/sub2/sub2foo.h echo 'choke me' \
 379         && delete "$srcdir"/sub/subfoo.h \
 380         && make_ok \
 381         || r='not ok'
 382       result_ "$r" "$pfx dependency tracking is truly disabled"
 383   elif grep "[ $tab]depmode=none" Makefile; then
 384     skip_row_ 2 -r "automatic dependency tracking couldn't be activated"
 385   else
 386     command_ok_ "$pfx generated $po files look correct" $MAKE grep-test
 387     r=ok \
 388       && : "Some checks in the subdir." \
 389       && $sleep \
 390       && : "Ensure rebuild rules really kick in." \
 391       && rewrite "$srcdir"/src/sub2/sub2foo.h echo 'choke me' \
 392       && cd src \
 393       && not $MAKE  \
 394       && cd .. \
 395       && : "Ensure the deleted header bug is fixed." \
 396       && delete "$srcdir"/src/sub2/sub2foo.h \
 397       && edit "$srcdir"/src/sub2/sub2foo.c -e 1d \
 398       && cd src \
 399       && make_ok \
 400       && : "Now do similar checks for the parent directory." \
 401       && cd .. \
 402       && rewrite "$srcdir"/sub/subfoo.h echo 'choke me' \
 403       && not $MAKE \
 404       && delete "$srcdir"/sub/subfoo.h \
 405       && edit "$srcdir"/sub/subfoo.c -e 1d \
 406       && edit "$srcdir"/foo.h -e 2d \
 407       && make_ok \
 408       || r='not ok'
 409     result_ "$r" "$pfx dependency tracking works"
 410   fi
 411
 412   command_ok_ "$pfx make distclean" check_distclean
 413   cd_top
 414 }
 415
 416 for vpath in no simple long absolute; do
 417   do_all_tests
 418 done
 419
 420 :