kbuild: show hint if subdir-y/m is used to visit module Makefile
authorMasahiro Yamada <yamada.masahiro@socionext.com>
Thu, 8 Aug 2019 11:21:11 +0000 (20:21 +0900)
committerMasahiro Yamada <yamada.masahiro@socionext.com>
Fri, 9 Aug 2019 16:45:31 +0000 (01:45 +0900)
commitc07d8d47bca1b325102fa2be3a463075f7b051d9
tree4b74298449e30cd5c1526b373bf5bfde0dda4ad9
parent4f2c8f3089f538f556c86f26603a062865e4aa94
kbuild: show hint if subdir-y/m is used to visit module Makefile

Since commit ff9b45c55b26 ("kbuild: modpost: read modules.order instead
of $(MODVERDIR)/*.mod"), a module is no longer built in the following
pattern:

  [Makefile]
  subdir-y := some-module

  [some-module/Makefile]
  obj-m := some-module.o

You cannot write Makefile this way in upstream because modules.order is
not correctly generated. subdir-y is used to descend to a sub-directory
that builds tools, device trees, etc.

For external modules, the modules order does not matter. So, the
Makefile above was known to work.

I believe the Makefile should be re-written as follows:

  [Makefile]
  obj-m := some-module/

  [some-module/Makefile]
  obj-m := some-module.o

However, people will have no idea if their Makefile suddenly stops
working. In fact, I received questions from multiple people.

Show a warning for a while if obj-m is specified in a Makefile visited
by subdir-y or subdir-m.

I touched the %/ rule to avoid false-positive warnings for the single
target.

Cc: Jan Kiszka <jan.kiszka@siemens.com>
Cc: Tom Stonecypher <thomas.edwardx.stonecypher@intel.com>
Signed-off-by: Masahiro Yamada <yamada.masahiro@socionext.com>
Tested-by: Jan Kiszka <jan.kiszka@siemens.com>
Makefile
scripts/Makefile.build