Makefile 45 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384
  1. VERSION = 2
  2. PATCHLEVEL = 6
  3. SUBLEVEL = 17
  4. EXTRAVERSION =
  5. NAME=Crazed Snow-Weasel
  6. # *DOCUMENTATION*
  7. # To see a list of typical targets execute "make help"
  8. # More info can be located in ./README
  9. # Comments in this file are targeted only to the developer, do not
  10. # expect to learn how to build the kernel reading this file.
  11. # Do not print "Entering directory ..."
  12. MAKEFLAGS += --no-print-directory
  13. # We are using a recursive build, so we need to do a little thinking
  14. # to get the ordering right.
  15. #
  16. # Most importantly: sub-Makefiles should only ever modify files in
  17. # their own directory. If in some directory we have a dependency on
  18. # a file in another dir (which doesn't happen often, but it's often
  19. # unavoidable when linking the built-in.o targets which finally
  20. # turn into vmlinux), we will call a sub make in that other dir, and
  21. # after that we are sure that everything which is in that other dir
  22. # is now up to date.
  23. #
  24. # The only cases where we need to modify files which have global
  25. # effects are thus separated out and done before the recursive
  26. # descending is started. They are now explicitly listed as the
  27. # prepare rule.
  28. # To put more focus on warnings, be less verbose as default
  29. # Use 'make V=1' to see the full commands
  30. ifdef V
  31. ifeq ("$(origin V)", "command line")
  32. KBUILD_VERBOSE = $(V)
  33. endif
  34. endif
  35. ifndef KBUILD_VERBOSE
  36. KBUILD_VERBOSE = 0
  37. endif
  38. # Call checker as part of compilation of C files
  39. # Use 'make C=1' to enable checking (sparse, by default)
  40. # Override with 'make C=1 CHECK=checker_executable CHECKFLAGS=....'
  41. ifdef C
  42. ifeq ("$(origin C)", "command line")
  43. KBUILD_CHECKSRC = $(C)
  44. endif
  45. endif
  46. ifndef KBUILD_CHECKSRC
  47. KBUILD_CHECKSRC = 0
  48. endif
  49. # Use make M=dir to specify directory of external module to build
  50. # Old syntax make ... SUBDIRS=$PWD is still supported
  51. # Setting the environment variable KBUILD_EXTMOD take precedence
  52. ifdef SUBDIRS
  53. KBUILD_EXTMOD ?= $(SUBDIRS)
  54. endif
  55. ifdef M
  56. ifeq ("$(origin M)", "command line")
  57. KBUILD_EXTMOD := $(M)
  58. endif
  59. endif
  60. # kbuild supports saving output files in a separate directory.
  61. # To locate output files in a separate directory two syntaxes are supported.
  62. # In both cases the working directory must be the root of the kernel src.
  63. # 1) O=
  64. # Use "make O=dir/to/store/output/files/"
  65. #
  66. # 2) Set KBUILD_OUTPUT
  67. # Set the environment variable KBUILD_OUTPUT to point to the directory
  68. # where the output files shall be placed.
  69. # export KBUILD_OUTPUT=dir/to/store/output/files/
  70. # make
  71. #
  72. # The O= assignment takes precedence over the KBUILD_OUTPUT environment
  73. # variable.
  74. # KBUILD_SRC is set on invocation of make in OBJ directory
  75. # KBUILD_SRC is not intended to be used by the regular user (for now)
  76. ifeq ($(KBUILD_SRC),)
  77. # OK, Make called in directory where kernel src resides
  78. # Do we want to locate output files in a separate directory?
  79. ifdef O
  80. ifeq ("$(origin O)", "command line")
  81. KBUILD_OUTPUT := $(O)
  82. endif
  83. endif
  84. # That's our default target when none is given on the command line
  85. PHONY := _all
  86. _all:
  87. ifneq ($(KBUILD_OUTPUT),)
  88. # Invoke a second make in the output directory, passing relevant variables
  89. # check that the output directory actually exists
  90. saved-output := $(KBUILD_OUTPUT)
  91. KBUILD_OUTPUT := $(shell cd $(KBUILD_OUTPUT) && /bin/pwd)
  92. $(if $(KBUILD_OUTPUT),, \
  93. $(error output directory "$(saved-output)" does not exist))
  94. PHONY += $(MAKECMDGOALS)
  95. $(filter-out _all,$(MAKECMDGOALS)) _all:
  96. $(if $(KBUILD_VERBOSE:1=),@)$(MAKE) -C $(KBUILD_OUTPUT) \
  97. KBUILD_SRC=$(CURDIR) \
  98. KBUILD_EXTMOD="$(KBUILD_EXTMOD)" -f $(CURDIR)/Makefile $@
  99. # Leave processing to above invocation of make
  100. skip-makefile := 1
  101. endif # ifneq ($(KBUILD_OUTPUT),)
  102. endif # ifeq ($(KBUILD_SRC),)
  103. # We process the rest of the Makefile if this is the final invocation of make
  104. ifeq ($(skip-makefile),)
  105. # If building an external module we do not care about the all: rule
  106. # but instead _all depend on modules
  107. PHONY += all
  108. ifeq ($(KBUILD_EXTMOD),)
  109. _all: all
  110. else
  111. _all: modules
  112. endif
  113. srctree := $(if $(KBUILD_SRC),$(KBUILD_SRC),$(CURDIR))
  114. TOPDIR := $(srctree)
  115. # FIXME - TOPDIR is obsolete, use srctree/objtree
  116. objtree := $(CURDIR)
  117. src := $(srctree)
  118. obj := $(objtree)
  119. VPATH := $(srctree)$(if $(KBUILD_EXTMOD),:$(KBUILD_EXTMOD))
  120. export srctree objtree VPATH TOPDIR
  121. # SUBARCH tells the usermode build what the underlying arch is. That is set
  122. # first, and if a usermode build is happening, the "ARCH=um" on the command
  123. # line overrides the setting of ARCH below. If a native build is happening,
  124. # then ARCH is assigned, getting whatever value it gets normally, and
  125. # SUBARCH is subsequently ignored.
  126. SUBARCH := $(shell uname -m | sed -e s/i.86/i386/ -e s/sun4u/sparc64/ \
  127. -e s/arm.*/arm/ -e s/sa110/arm/ \
  128. -e s/s390x/s390/ -e s/parisc64/parisc/ \
  129. -e s/ppc.*/powerpc/ -e s/mips.*/mips/ )
  130. # Cross compiling and selecting different set of gcc/bin-utils
  131. # ---------------------------------------------------------------------------
  132. #
  133. # When performing cross compilation for other architectures ARCH shall be set
  134. # to the target architecture. (See arch/* for the possibilities).
  135. # ARCH can be set during invocation of make:
  136. # make ARCH=ia64
  137. # Another way is to have ARCH set in the environment.
  138. # The default ARCH is the host where make is executed.
  139. # CROSS_COMPILE specify the prefix used for all executables used
  140. # during compilation. Only gcc and related bin-utils executables
  141. # are prefixed with $(CROSS_COMPILE).
  142. # CROSS_COMPILE can be set on the command line
  143. # make CROSS_COMPILE=ia64-linux-
  144. # Alternatively CROSS_COMPILE can be set in the environment.
  145. # Default value for CROSS_COMPILE is not to prefix executables
  146. # Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile
  147. ARCH ?= $(SUBARCH)
  148. CROSS_COMPILE ?=
  149. # Architecture as present in compile.h
  150. UTS_MACHINE := $(ARCH)
  151. KCONFIG_CONFIG ?= .config
  152. # SHELL used by kbuild
  153. CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
  154. else if [ -x /bin/bash ]; then echo /bin/bash; \
  155. else echo sh; fi ; fi)
  156. HOSTCC = gcc
  157. HOSTCXX = g++
  158. HOSTCFLAGS = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer
  159. HOSTCXXFLAGS = -O2
  160. # Decide whether to build built-in, modular, or both.
  161. # Normally, just do built-in.
  162. KBUILD_MODULES :=
  163. KBUILD_BUILTIN := 1
  164. # If we have only "make modules", don't compile built-in objects.
  165. # When we're building modules with modversions, we need to consider
  166. # the built-in objects during the descend as well, in order to
  167. # make sure the checksums are up to date before we record them.
  168. ifeq ($(MAKECMDGOALS),modules)
  169. KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1)
  170. endif
  171. # If we have "make <whatever> modules", compile modules
  172. # in addition to whatever we do anyway.
  173. # Just "make" or "make all" shall build modules as well
  174. ifneq ($(filter all _all modules,$(MAKECMDGOALS)),)
  175. KBUILD_MODULES := 1
  176. endif
  177. ifeq ($(MAKECMDGOALS),)
  178. KBUILD_MODULES := 1
  179. endif
  180. export KBUILD_MODULES KBUILD_BUILTIN
  181. export KBUILD_CHECKSRC KBUILD_SRC KBUILD_EXTMOD
  182. # Beautify output
  183. # ---------------------------------------------------------------------------
  184. #
  185. # Normally, we echo the whole command before executing it. By making
  186. # that echo $($(quiet)$(cmd)), we now have the possibility to set
  187. # $(quiet) to choose other forms of output instead, e.g.
  188. #
  189. # quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
  190. # cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $<
  191. #
  192. # If $(quiet) is empty, the whole command will be printed.
  193. # If it is set to "quiet_", only the short version will be printed.
  194. # If it is set to "silent_", nothing will be printed at all, since
  195. # the variable $(silent_cmd_cc_o_c) doesn't exist.
  196. #
  197. # A simple variant is to prefix commands with $(Q) - that's useful
  198. # for commands that shall be hidden in non-verbose mode.
  199. #
  200. # $(Q)ln $@ :<
  201. #
  202. # If KBUILD_VERBOSE equals 0 then the above command will be hidden.
  203. # If KBUILD_VERBOSE equals 1 then the above command is displayed.
  204. ifeq ($(KBUILD_VERBOSE),1)
  205. quiet =
  206. Q =
  207. else
  208. quiet=quiet_
  209. Q = @
  210. endif
  211. # If the user is running make -s (silent mode), suppress echoing of
  212. # commands
  213. ifneq ($(findstring s,$(MAKEFLAGS)),)
  214. quiet=silent_
  215. endif
  216. export quiet Q KBUILD_VERBOSE
  217. # Look for make include files relative to root of kernel src
  218. MAKEFLAGS += --include-dir=$(srctree)
  219. # We need some generic definitions
  220. include $(srctree)/scripts/Kbuild.include
  221. # Do not use make's built-in rules and variables
  222. # This increases performance and avoid hard-to-debug behavour
  223. MAKEFLAGS += -rR
  224. # Make variables (CC, etc...)
  225. AS = $(CROSS_COMPILE)as
  226. LD = $(CROSS_COMPILE)ld
  227. CC = $(CROSS_COMPILE)gcc
  228. CPP = $(CC) -E
  229. AR = $(CROSS_COMPILE)ar
  230. NM = $(CROSS_COMPILE)nm
  231. STRIP = $(CROSS_COMPILE)strip
  232. OBJCOPY = $(CROSS_COMPILE)objcopy
  233. OBJDUMP = $(CROSS_COMPILE)objdump
  234. AWK = awk
  235. GENKSYMS = scripts/genksyms/genksyms
  236. DEPMOD = /sbin/depmod
  237. KALLSYMS = scripts/kallsyms
  238. PERL = perl
  239. CHECK = sparse
  240. CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ -Wbitwise $(CF)
  241. MODFLAGS = -DMODULE
  242. CFLAGS_MODULE = $(MODFLAGS)
  243. AFLAGS_MODULE = $(MODFLAGS)
  244. LDFLAGS_MODULE = -r
  245. CFLAGS_KERNEL =
  246. AFLAGS_KERNEL =
  247. # Use LINUXINCLUDE when you must reference the include/ directory.
  248. # Needed to be compatible with the O= option
  249. LINUXINCLUDE := -Iinclude \
  250. $(if $(KBUILD_SRC),-Iinclude2 -I$(srctree)/include) \
  251. -include include/linux/autoconf.h
  252. CPPFLAGS := -D__KERNEL__ $(LINUXINCLUDE)
  253. CFLAGS := -Wall -Wundef -Wstrict-prototypes -Wno-trigraphs \
  254. -fno-strict-aliasing -fno-common
  255. AFLAGS := -D__ASSEMBLY__
  256. # Read KERNELRELEASE from include/config/kernel.release (if it exists)
  257. KERNELRELEASE = $(shell cat include/config/kernel.release 2> /dev/null)
  258. KERNELVERSION = $(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION)
  259. export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION
  260. export ARCH CONFIG_SHELL HOSTCC HOSTCFLAGS CROSS_COMPILE AS LD CC
  261. export CPP AR NM STRIP OBJCOPY OBJDUMP MAKE AWK GENKSYMS PERL UTS_MACHINE
  262. export HOSTCXX HOSTCXXFLAGS LDFLAGS_MODULE CHECK CHECKFLAGS
  263. export CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS LDFLAGS
  264. export CFLAGS CFLAGS_KERNEL CFLAGS_MODULE
  265. export AFLAGS AFLAGS_KERNEL AFLAGS_MODULE
  266. # When compiling out-of-tree modules, put MODVERDIR in the module
  267. # tree rather than in the kernel tree. The kernel tree might
  268. # even be read-only.
  269. export MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions
  270. # Files to ignore in find ... statements
  271. RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o -name CVS -o -name .pc -o -name .hg -o -name .git \) -prune -o
  272. export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn --exclude CVS --exclude .pc --exclude .hg --exclude .git
  273. # ===========================================================================
  274. # Rules shared between *config targets and build targets
  275. # Basic helpers built in scripts/
  276. PHONY += scripts_basic
  277. scripts_basic:
  278. $(Q)$(MAKE) $(build)=scripts/basic
  279. # To avoid any implicit rule to kick in, define an empty command.
  280. scripts/basic/%: scripts_basic ;
  281. PHONY += outputmakefile
  282. # outputmakefile generates a Makefile in the output directory, if using a
  283. # separate output directory. This allows convenient use of make in the
  284. # output directory.
  285. outputmakefile:
  286. ifneq ($(KBUILD_SRC),)
  287. $(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile \
  288. $(srctree) $(objtree) $(VERSION) $(PATCHLEVEL)
  289. endif
  290. # To make sure we do not include .config for any of the *config targets
  291. # catch them early, and hand them over to scripts/kconfig/Makefile
  292. # It is allowed to specify more targets when calling make, including
  293. # mixing *config targets and build targets.
  294. # For example 'make oldconfig all'.
  295. # Detect when mixed targets is specified, and make a second invocation
  296. # of make so .config is not included in this case either (for *config).
  297. no-dot-config-targets := clean mrproper distclean \
  298. cscope TAGS tags help %docs check% \
  299. kernelrelease kernelversion
  300. config-targets := 0
  301. mixed-targets := 0
  302. dot-config := 1
  303. ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
  304. ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
  305. dot-config := 0
  306. endif
  307. endif
  308. ifeq ($(KBUILD_EXTMOD),)
  309. ifneq ($(filter config %config,$(MAKECMDGOALS)),)
  310. config-targets := 1
  311. ifneq ($(filter-out config %config,$(MAKECMDGOALS)),)
  312. mixed-targets := 1
  313. endif
  314. endif
  315. endif
  316. ifeq ($(mixed-targets),1)
  317. # ===========================================================================
  318. # We're called with mixed targets (*config and build targets).
  319. # Handle them one by one.
  320. %:: FORCE
  321. $(Q)$(MAKE) -C $(srctree) KBUILD_SRC= $@
  322. else
  323. ifeq ($(config-targets),1)
  324. # ===========================================================================
  325. # *config targets only - make sure prerequisites are updated, and descend
  326. # in scripts/kconfig to make the *config target
  327. # Read arch specific Makefile to set KBUILD_DEFCONFIG as needed.
  328. # KBUILD_DEFCONFIG may point out an alternative default configuration
  329. # used for 'make defconfig'
  330. include $(srctree)/arch/$(ARCH)/Makefile
  331. export KBUILD_DEFCONFIG
  332. config %config: scripts_basic outputmakefile FORCE
  333. $(Q)mkdir -p include/linux include/config
  334. $(Q)$(MAKE) $(build)=scripts/kconfig $@
  335. else
  336. # ===========================================================================
  337. # Build targets only - this includes vmlinux, arch specific targets, clean
  338. # targets and others. In general all targets except *config targets.
  339. ifeq ($(KBUILD_EXTMOD),)
  340. # Additional helpers built in scripts/
  341. # Carefully list dependencies so we do not try to build scripts twice
  342. # in parallel
  343. PHONY += scripts
  344. scripts: scripts_basic include/config/auto.conf
  345. $(Q)$(MAKE) $(build)=$(@)
  346. # Objects we will link into vmlinux / subdirs we need to visit
  347. init-y := init/
  348. drivers-y := drivers/ sound/
  349. net-y := net/
  350. libs-y := lib/
  351. core-y := usr/
  352. endif # KBUILD_EXTMOD
  353. ifeq ($(dot-config),1)
  354. # In this section, we need .config
  355. # Read in dependencies to all Kconfig* files, make sure to run
  356. # oldconfig if changes are detected.
  357. -include include/config/auto.conf.cmd
  358. -include include/config/auto.conf
  359. # To avoid any implicit rule to kick in, define an empty command
  360. $(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
  361. # If .config is newer than include/config/auto.conf, someone tinkered
  362. # with it and forgot to run make oldconfig.
  363. # if auto.conf.cmd is missing then we are probably in a cleaned tree so
  364. # we execute the config step to be sure to catch updated Kconfig files
  365. include/config/auto.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
  366. ifeq ($(KBUILD_EXTMOD),)
  367. $(Q)$(MAKE) -f $(srctree)/Makefile silentoldconfig
  368. else
  369. $(error kernel configuration not valid - run 'make prepare' in $(srctree) to update it)
  370. endif
  371. else
  372. # Dummy target needed, because used as prerequisite
  373. include/config/auto.conf: ;
  374. endif
  375. # The all: target is the default when no target is given on the
  376. # command line.
  377. # This allow a user to issue only 'make' to build a kernel including modules
  378. # Defaults vmlinux but it is usually overridden in the arch makefile
  379. all: vmlinux
  380. ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
  381. CFLAGS += -Os
  382. else
  383. CFLAGS += -O2
  384. endif
  385. ifdef CONFIG_FRAME_POINTER
  386. CFLAGS += -fno-omit-frame-pointer $(call cc-option,-fno-optimize-sibling-calls,)
  387. else
  388. CFLAGS += -fomit-frame-pointer
  389. endif
  390. ifdef CONFIG_UNWIND_INFO
  391. CFLAGS += -fasynchronous-unwind-tables
  392. endif
  393. ifdef CONFIG_DEBUG_INFO
  394. CFLAGS += -g
  395. endif
  396. include $(srctree)/arch/$(ARCH)/Makefile
  397. # arch Makefile may override CC so keep this after arch Makefile is included
  398. NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
  399. CHECKFLAGS += $(NOSTDINC_FLAGS)
  400. # warn about C99 declaration after statement
  401. CFLAGS += $(call cc-option,-Wdeclaration-after-statement,)
  402. # disable pointer signed / unsigned warnings in gcc 4.0
  403. CFLAGS += $(call cc-option,-Wno-pointer-sign,)
  404. # Default kernel image to build when no specific target is given.
  405. # KBUILD_IMAGE may be overruled on the command line or
  406. # set in the environment
  407. # Also any assignments in arch/$(ARCH)/Makefile take precedence over
  408. # this default value
  409. export KBUILD_IMAGE ?= vmlinux
  410. #
  411. # INSTALL_PATH specifies where to place the updated kernel and system map
  412. # images. Default is /boot, but you can set it to other values
  413. export INSTALL_PATH ?= /boot
  414. #
  415. # INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
  416. # relocations required by build roots. This is not defined in the
  417. # makefile but the argument can be passed to make if needed.
  418. #
  419. MODLIB = $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
  420. export MODLIB
  421. #
  422. # INSTALL_MOD_STRIP, if defined, will cause modules to be
  423. # stripped after they are installed. If INSTALL_MOD_STRIP is '1', then
  424. # the default option --strip-debug will be used. Otherwise,
  425. # INSTALL_MOD_STRIP will used as the options to the strip command.
  426. ifdef INSTALL_MOD_STRIP
  427. ifeq ($(INSTALL_MOD_STRIP),1)
  428. mod_strip_cmd = $STRIP) --strip-debug
  429. else
  430. mod_strip_cmd = $(STRIP) $(INSTALL_MOD_STRIP)
  431. endif # INSTALL_MOD_STRIP=1
  432. else
  433. mod_strip_cmd = true
  434. endif # INSTALL_MOD_STRIP
  435. export mod_strip_cmd
  436. ifeq ($(KBUILD_EXTMOD),)
  437. core-y += kernel/ mm/ fs/ ipc/ security/ crypto/ block/
  438. vmlinux-dirs := $(patsubst %/,%,$(filter %/, $(init-y) $(init-m) \
  439. $(core-y) $(core-m) $(drivers-y) $(drivers-m) \
  440. $(net-y) $(net-m) $(libs-y) $(libs-m)))
  441. vmlinux-alldirs := $(sort $(vmlinux-dirs) $(patsubst %/,%,$(filter %/, \
  442. $(init-n) $(init-) \
  443. $(core-n) $(core-) $(drivers-n) $(drivers-) \
  444. $(net-n) $(net-) $(libs-n) $(libs-))))
  445. init-y := $(patsubst %/, %/built-in.o, $(init-y))
  446. core-y := $(patsubst %/, %/built-in.o, $(core-y))
  447. drivers-y := $(patsubst %/, %/built-in.o, $(drivers-y))
  448. net-y := $(patsubst %/, %/built-in.o, $(net-y))
  449. libs-y1 := $(patsubst %/, %/lib.a, $(libs-y))
  450. libs-y2 := $(patsubst %/, %/built-in.o, $(libs-y))
  451. libs-y := $(libs-y1) $(libs-y2)
  452. # Build vmlinux
  453. # ---------------------------------------------------------------------------
  454. # vmlinux is built from the objects selected by $(vmlinux-init) and
  455. # $(vmlinux-main). Most are built-in.o files from top-level directories
  456. # in the kernel tree, others are specified in arch/$(ARCH)Makefile.
  457. # Ordering when linking is important, and $(vmlinux-init) must be first.
  458. #
  459. # vmlinux
  460. # ^
  461. # |
  462. # +-< $(vmlinux-init)
  463. # | +--< init/version.o + more
  464. # |
  465. # +--< $(vmlinux-main)
  466. # | +--< driver/built-in.o mm/built-in.o + more
  467. # |
  468. # +-< kallsyms.o (see description in CONFIG_KALLSYMS section)
  469. #
  470. # vmlinux version (uname -v) cannot be updated during normal
  471. # descending-into-subdirs phase since we do not yet know if we need to
  472. # update vmlinux.
  473. # Therefore this step is delayed until just before final link of vmlinux -
  474. # except in the kallsyms case where it is done just before adding the
  475. # symbols to the kernel.
  476. #
  477. # System.map is generated to document addresses of all kernel symbols
  478. vmlinux-init := $(head-y) $(init-y)
  479. vmlinux-main := $(core-y) $(libs-y) $(drivers-y) $(net-y)
  480. vmlinux-all := $(vmlinux-init) $(vmlinux-main)
  481. vmlinux-lds := arch/$(ARCH)/kernel/vmlinux.lds
  482. # Rule to link vmlinux - also used during CONFIG_KALLSYMS
  483. # May be overridden by arch/$(ARCH)/Makefile
  484. quiet_cmd_vmlinux__ ?= LD $@
  485. cmd_vmlinux__ ?= $(LD) $(LDFLAGS) $(LDFLAGS_vmlinux) -o $@ \
  486. -T $(vmlinux-lds) $(vmlinux-init) \
  487. --start-group $(vmlinux-main) --end-group \
  488. $(filter-out $(vmlinux-lds) $(vmlinux-init) $(vmlinux-main) FORCE ,$^)
  489. # Generate new vmlinux version
  490. quiet_cmd_vmlinux_version = GEN .version
  491. cmd_vmlinux_version = set -e; \
  492. if [ ! -r .version ]; then \
  493. rm -f .version; \
  494. echo 1 >.version; \
  495. else \
  496. mv .version .old_version; \
  497. expr 0$$(cat .old_version) + 1 >.version; \
  498. fi; \
  499. $(MAKE) $(build)=init
  500. # Generate System.map
  501. quiet_cmd_sysmap = SYSMAP
  502. cmd_sysmap = $(CONFIG_SHELL) $(srctree)/scripts/mksysmap
  503. # Link of vmlinux
  504. # If CONFIG_KALLSYMS is set .version is already updated
  505. # Generate System.map and verify that the content is consistent
  506. # Use + in front of the vmlinux_version rule to silent warning with make -j2
  507. # First command is ':' to allow us to use + in front of the rule
  508. define rule_vmlinux__
  509. :
  510. $(if $(CONFIG_KALLSYMS),,+$(call cmd,vmlinux_version))
  511. $(call cmd,vmlinux__)
  512. $(Q)echo 'cmd_$@ := $(cmd_vmlinux__)' > $(@D)/.$(@F).cmd
  513. $(Q)$(if $($(quiet)cmd_sysmap), \
  514. echo ' $($(quiet)cmd_sysmap) System.map' &&) \
  515. $(cmd_sysmap) $@ System.map; \
  516. if [ $$? -ne 0 ]; then \
  517. rm -f $@; \
  518. /bin/false; \
  519. fi;
  520. $(verify_kallsyms)
  521. endef
  522. ifdef CONFIG_KALLSYMS
  523. # Generate section listing all symbols and add it into vmlinux $(kallsyms.o)
  524. # It's a three stage process:
  525. # o .tmp_vmlinux1 has all symbols and sections, but __kallsyms is
  526. # empty
  527. # Running kallsyms on that gives us .tmp_kallsyms1.o with
  528. # the right size - vmlinux version (uname -v) is updated during this step
  529. # o .tmp_vmlinux2 now has a __kallsyms section of the right size,
  530. # but due to the added section, some addresses have shifted.
  531. # From here, we generate a correct .tmp_kallsyms2.o
  532. # o The correct .tmp_kallsyms2.o is linked into the final vmlinux.
  533. # o Verify that the System.map from vmlinux matches the map from
  534. # .tmp_vmlinux2, just in case we did not generate kallsyms correctly.
  535. # o If CONFIG_KALLSYMS_EXTRA_PASS is set, do an extra pass using
  536. # .tmp_vmlinux3 and .tmp_kallsyms3.o. This is only meant as a
  537. # temporary bypass to allow the kernel to be built while the
  538. # maintainers work out what went wrong with kallsyms.
  539. ifdef CONFIG_KALLSYMS_EXTRA_PASS
  540. last_kallsyms := 3
  541. else
  542. last_kallsyms := 2
  543. endif
  544. kallsyms.o := .tmp_kallsyms$(last_kallsyms).o
  545. define verify_kallsyms
  546. $(Q)$(if $($(quiet)cmd_sysmap), \
  547. echo ' $($(quiet)cmd_sysmap) .tmp_System.map' &&) \
  548. $(cmd_sysmap) .tmp_vmlinux$(last_kallsyms) .tmp_System.map
  549. $(Q)cmp -s System.map .tmp_System.map || \
  550. (echo Inconsistent kallsyms data; \
  551. echo Try setting CONFIG_KALLSYMS_EXTRA_PASS; \
  552. rm .tmp_kallsyms* ; /bin/false )
  553. endef
  554. # Update vmlinux version before link
  555. # Use + in front of this rule to silent warning about make -j1
  556. # First command is ':' to allow us to use + in front of this rule
  557. cmd_ksym_ld = $(cmd_vmlinux__)
  558. define rule_ksym_ld
  559. :
  560. +$(call cmd,vmlinux_version)
  561. $(call cmd,vmlinux__)
  562. $(Q)echo 'cmd_$@ := $(cmd_vmlinux__)' > $(@D)/.$(@F).cmd
  563. endef
  564. # Generate .S file with all kernel symbols
  565. quiet_cmd_kallsyms = KSYM $@
  566. cmd_kallsyms = $(NM) -n $< | $(KALLSYMS) \
  567. $(if $(CONFIG_KALLSYMS_ALL),--all-symbols) > $@
  568. .tmp_kallsyms1.o .tmp_kallsyms2.o .tmp_kallsyms3.o: %.o: %.S scripts FORCE
  569. $(call if_changed_dep,as_o_S)
  570. .tmp_kallsyms%.S: .tmp_vmlinux% $(KALLSYMS)
  571. $(call cmd,kallsyms)
  572. # .tmp_vmlinux1 must be complete except kallsyms, so update vmlinux version
  573. .tmp_vmlinux1: $(vmlinux-lds) $(vmlinux-all) FORCE
  574. $(call if_changed_rule,ksym_ld)
  575. .tmp_vmlinux2: $(vmlinux-lds) $(vmlinux-all) .tmp_kallsyms1.o FORCE
  576. $(call if_changed,vmlinux__)
  577. .tmp_vmlinux3: $(vmlinux-lds) $(vmlinux-all) .tmp_kallsyms2.o FORCE
  578. $(call if_changed,vmlinux__)
  579. # Needs to visit scripts/ before $(KALLSYMS) can be used.
  580. $(KALLSYMS): scripts ;
  581. # Generate some data for debugging strange kallsyms problems
  582. debug_kallsyms: .tmp_map$(last_kallsyms)
  583. .tmp_map%: .tmp_vmlinux% FORCE
  584. ($(OBJDUMP) -h $< | $(AWK) '/^ +[0-9]/{print $$4 " 0 " $$2}'; $(NM) $<) | sort > $@
  585. .tmp_map3: .tmp_map2
  586. .tmp_map2: .tmp_map1
  587. endif # ifdef CONFIG_KALLSYMS
  588. # vmlinux image - including updated kernel symbols
  589. vmlinux: $(vmlinux-lds) $(vmlinux-init) $(vmlinux-main) $(kallsyms.o) FORCE
  590. $(call if_changed_rule,vmlinux__)
  591. $(Q)rm -f .old_version
  592. # The actual objects are generated when descending,
  593. # make sure no implicit rule kicks in
  594. $(sort $(vmlinux-init) $(vmlinux-main)) $(vmlinux-lds): $(vmlinux-dirs) ;
  595. # Handle descending into subdirectories listed in $(vmlinux-dirs)
  596. # Preset locale variables to speed up the build process. Limit locale
  597. # tweaks to this spot to avoid wrong language settings when running
  598. # make menuconfig etc.
  599. # Error messages still appears in the original language
  600. PHONY += $(vmlinux-dirs)
  601. $(vmlinux-dirs): prepare scripts
  602. $(Q)$(MAKE) $(build)=$@
  603. # Build the kernel release string
  604. # The KERNELRELEASE is stored in a file named include/config/kernel.release
  605. # to be used when executing for example make install or make modules_install
  606. #
  607. # Take the contents of any files called localversion* and the config
  608. # variable CONFIG_LOCALVERSION and append them to KERNELRELEASE.
  609. # LOCALVERSION from the command line override all of this
  610. nullstring :=
  611. space := $(nullstring) # end of line
  612. ___localver = $(objtree)/localversion* $(srctree)/localversion*
  613. __localver = $(sort $(wildcard $(___localver)))
  614. # skip backup files (containing '~')
  615. _localver = $(foreach f, $(__localver), $(if $(findstring ~, $(f)),,$(f)))
  616. localver = $(subst $(space),, \
  617. $(shell cat /dev/null $(_localver)) \
  618. $(patsubst "%",%,$(CONFIG_LOCALVERSION)))
  619. # If CONFIG_LOCALVERSION_AUTO is set scripts/setlocalversion is called
  620. # and if the SCM is know a tag from the SCM is appended.
  621. # The appended tag is determined by the SCM used.
  622. #
  623. # Currently, only git is supported.
  624. # Other SCMs can edit scripts/setlocalversion and add the appropriate
  625. # checks as needed.
  626. ifdef CONFIG_LOCALVERSION_AUTO
  627. _localver-auto = $(shell $(CONFIG_SHELL) \
  628. $(srctree)/scripts/setlocalversion $(srctree))
  629. localver-auto = $(LOCALVERSION)$(_localver-auto)
  630. endif
  631. localver-full = $(localver)$(localver-auto)
  632. # Store (new) KERNELRELASE string in include/config/kernel.release
  633. kernelrelease = $(KERNELVERSION)$(localver-full)
  634. include/config/kernel.release: include/config/auto.conf FORCE
  635. $(Q)rm -f $@
  636. $(Q)echo $(kernelrelease) > $@
  637. # Things we need to do before we recursively start building the kernel
  638. # or the modules are listed in "prepare".
  639. # A multi level approach is used. prepareN is processed before prepareN-1.
  640. # archprepare is used in arch Makefiles and when processed asm symlink,
  641. # version.h and scripts_basic is processed / created.
  642. # Listed in dependency order
  643. PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3
  644. # prepare-all is deprecated, use prepare as valid replacement
  645. PHONY += prepare-all
  646. # prepare3 is used to check if we are building in a separate output directory,
  647. # and if so do:
  648. # 1) Check that make has not been executed in the kernel src $(srctree)
  649. # 2) Create the include2 directory, used for the second asm symlink
  650. prepare3: include/config/kernel.release
  651. ifneq ($(KBUILD_SRC),)
  652. @echo ' Using $(srctree) as source for kernel'
  653. $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
  654. echo " $(srctree) is not clean, please run 'make mrproper'";\
  655. echo " in the '$(srctree)' directory.";\
  656. /bin/false; \
  657. fi;
  658. $(Q)if [ ! -d include2 ]; then mkdir -p include2; fi;
  659. $(Q)ln -fsn $(srctree)/include/asm-$(ARCH) include2/asm
  660. endif
  661. # prepare2 creates a makefile if using a separate output directory
  662. prepare2: prepare3 outputmakefile
  663. prepare1: prepare2 include/linux/version.h include/asm \
  664. include/config/auto.conf
  665. ifneq ($(KBUILD_MODULES),)
  666. $(Q)mkdir -p $(MODVERDIR)
  667. $(Q)rm -f $(MODVERDIR)/*
  668. endif
  669. archprepare: prepare1 scripts_basic
  670. prepare0: archprepare FORCE
  671. $(Q)$(MAKE) $(build)=.
  672. # All the preparing..
  673. prepare prepare-all: prepare0
  674. # Leave this as default for preprocessing vmlinux.lds.S, which is now
  675. # done in arch/$(ARCH)/kernel/Makefile
  676. export CPPFLAGS_vmlinux.lds += -P -C -U$(ARCH)
  677. # FIXME: The asm symlink changes when $(ARCH) changes. That's
  678. # hard to detect, but I suppose "make mrproper" is a good idea
  679. # before switching between archs anyway.
  680. include/asm:
  681. @echo ' SYMLINK $@ -> include/asm-$(ARCH)'
  682. $(Q)if [ ! -d include ]; then mkdir -p include; fi;
  683. @ln -fsn asm-$(ARCH) $@
  684. # Generate some files
  685. # ---------------------------------------------------------------------------
  686. # KERNELRELEASE can change from a few different places, meaning version.h
  687. # needs to be updated, so this check is forced on all builds
  688. uts_len := 64
  689. define filechk_version.h
  690. if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \
  691. echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2; \
  692. exit 1; \
  693. fi; \
  694. (echo \#define UTS_RELEASE \"$(KERNELRELEASE)\"; \
  695. echo \#define LINUX_VERSION_CODE `expr $(VERSION) \\* 65536 + $(PATCHLEVEL) \\* 256 + $(SUBLEVEL)`; \
  696. echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))'; \
  697. )
  698. endef
  699. include/linux/version.h: $(srctree)/Makefile include/config/kernel.release FORCE
  700. $(call filechk,version.h)
  701. # ---------------------------------------------------------------------------
  702. PHONY += depend dep
  703. depend dep:
  704. @echo '*** Warning: make $@ is unnecessary now.'
  705. # ---------------------------------------------------------------------------
  706. # Modules
  707. ifdef CONFIG_MODULES
  708. # By default, build modules as well
  709. all: modules
  710. # Build modules
  711. PHONY += modules
  712. modules: $(vmlinux-dirs) $(if $(KBUILD_BUILTIN),vmlinux)
  713. @echo ' Building modules, stage 2.';
  714. $(Q)$(MAKE) -rR -f $(srctree)/scripts/Makefile.modpost
  715. # Target to prepare building external modules
  716. PHONY += modules_prepare
  717. modules_prepare: prepare scripts
  718. # Target to install modules
  719. PHONY += modules_install
  720. modules_install: _modinst_ _modinst_post
  721. PHONY += _modinst_
  722. _modinst_:
  723. @if [ -z "`$(DEPMOD) -V 2>/dev/null | grep module-init-tools`" ]; then \
  724. echo "Warning: you may need to install module-init-tools"; \
  725. echo "See http://www.codemonkey.org.uk/docs/post-halloween-2.6.txt";\
  726. sleep 1; \
  727. fi
  728. @rm -rf $(MODLIB)/kernel
  729. @rm -f $(MODLIB)/source
  730. @mkdir -p $(MODLIB)/kernel
  731. @ln -s $(srctree) $(MODLIB)/source
  732. @if [ ! $(objtree) -ef $(MODLIB)/build ]; then \
  733. rm -f $(MODLIB)/build ; \
  734. ln -s $(objtree) $(MODLIB)/build ; \
  735. fi
  736. $(Q)$(MAKE) -rR -f $(srctree)/scripts/Makefile.modinst
  737. # If System.map exists, run depmod. This deliberately does not have a
  738. # dependency on System.map since that would run the dependency tree on
  739. # vmlinux. This depmod is only for convenience to give the initial
  740. # boot a modules.dep even before / is mounted read-write. However the
  741. # boot script depmod is the master version.
  742. ifeq "$(strip $(INSTALL_MOD_PATH))" ""
  743. depmod_opts :=
  744. else
  745. depmod_opts := -b $(INSTALL_MOD_PATH) -r
  746. endif
  747. PHONY += _modinst_post
  748. _modinst_post: _modinst_
  749. if [ -r System.map -a -x $(DEPMOD) ]; then $(DEPMOD) -ae -F System.map $(depmod_opts) $(KERNELRELEASE); fi
  750. else # CONFIG_MODULES
  751. # Modules not configured
  752. # ---------------------------------------------------------------------------
  753. modules modules_install: FORCE
  754. @echo
  755. @echo "The present kernel configuration has modules disabled."
  756. @echo "Type 'make config' and enable loadable module support."
  757. @echo "Then build a kernel with module support enabled."
  758. @echo
  759. @exit 1
  760. endif # CONFIG_MODULES
  761. ###
  762. # Cleaning is done on three levels.
  763. # make clean Delete most generated files
  764. # Leave enough to build external modules
  765. # make mrproper Delete the current configuration, and all generated files
  766. # make distclean Remove editor backup files, patch leftover files and the like
  767. # Directories & files removed with 'make clean'
  768. CLEAN_DIRS += $(MODVERDIR)
  769. CLEAN_FILES += vmlinux System.map \
  770. .tmp_kallsyms* .tmp_version .tmp_vmlinux* .tmp_System.map
  771. # Directories & files removed with 'make mrproper'
  772. MRPROPER_DIRS += include/config include2
  773. MRPROPER_FILES += .config .config.old include/asm .version .old_version \
  774. include/linux/autoconf.h include/linux/version.h \
  775. Module.symvers tags TAGS cscope*
  776. # clean - Delete most, but leave enough to build external modules
  777. #
  778. clean: rm-dirs := $(CLEAN_DIRS)
  779. clean: rm-files := $(CLEAN_FILES)
  780. clean-dirs := $(addprefix _clean_,$(srctree) $(vmlinux-alldirs))
  781. PHONY += $(clean-dirs) clean archclean
  782. $(clean-dirs):
  783. $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
  784. clean: archclean $(clean-dirs)
  785. $(call cmd,rmdirs)
  786. $(call cmd,rmfiles)
  787. @find . $(RCS_FIND_IGNORE) \
  788. \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
  789. -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
  790. -o -name '*.symtypes' \) \
  791. -type f -print | xargs rm -f
  792. # mrproper - Delete all generated files, including .config
  793. #
  794. mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS))
  795. mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
  796. mrproper-dirs := $(addprefix _mrproper_,Documentation/DocBook scripts)
  797. PHONY += $(mrproper-dirs) mrproper archmrproper
  798. $(mrproper-dirs):
  799. $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
  800. mrproper: clean archmrproper $(mrproper-dirs)
  801. $(call cmd,rmdirs)
  802. $(call cmd,rmfiles)
  803. # distclean
  804. #
  805. PHONY += distclean
  806. distclean: mrproper
  807. @find $(srctree) $(RCS_FIND_IGNORE) \
  808. \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
  809. -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \
  810. -o -name '.*.rej' -o -size 0 \
  811. -o -name '*%' -o -name '.*.cmd' -o -name 'core' \) \
  812. -type f -print | xargs rm -f
  813. # Packaging of the kernel to various formats
  814. # ---------------------------------------------------------------------------
  815. # rpm target kept for backward compatibility
  816. package-dir := $(srctree)/scripts/package
  817. %pkg: include/config/kernel.release FORCE
  818. $(Q)$(MAKE) $(build)=$(package-dir) $@
  819. rpm: include/config/kernel.release FORCE
  820. $(Q)$(MAKE) $(build)=$(package-dir) $@
  821. # Brief documentation of the typical targets used
  822. # ---------------------------------------------------------------------------
  823. boards := $(wildcard $(srctree)/arch/$(ARCH)/configs/*_defconfig)
  824. boards := $(notdir $(boards))
  825. help:
  826. @echo 'Cleaning targets:'
  827. @echo ' clean - remove most generated files but keep the config'
  828. @echo ' mrproper - remove all generated files + config + various backup files'
  829. @echo ''
  830. @echo 'Configuration targets:'
  831. @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
  832. @echo ''
  833. @echo 'Other generic targets:'
  834. @echo ' all - Build all targets marked with [*]'
  835. @echo '* vmlinux - Build the bare kernel'
  836. @echo '* modules - Build all modules'
  837. @echo ' modules_install - Install all modules to INSTALL_MOD_PATH (default: /)'
  838. @echo ' dir/ - Build all files in dir and below'
  839. @echo ' dir/file.[ois] - Build specified target only'
  840. @echo ' dir/file.ko - Build module including final link'
  841. @echo ' rpm - Build a kernel as an RPM package'
  842. @echo ' tags/TAGS - Generate tags file for editors'
  843. @echo ' cscope - Generate cscope index'
  844. @echo ' kernelrelease - Output the release version string'
  845. @echo ' kernelversion - Output the version stored in Makefile'
  846. @echo ''
  847. @echo 'Static analysers'
  848. @echo ' checkstack - Generate a list of stack hogs'
  849. @echo ' namespacecheck - Name space analysis on compiled kernel'
  850. @echo ''
  851. @echo 'Kernel packaging:'
  852. @$(MAKE) $(build)=$(package-dir) help
  853. @echo ''
  854. @echo 'Documentation targets:'
  855. @$(MAKE) -f $(srctree)/Documentation/DocBook/Makefile dochelp
  856. @echo ''
  857. @echo 'Architecture specific targets ($(ARCH)):'
  858. @$(if $(archhelp),$(archhelp),\
  859. echo ' No architecture specific help defined for $(ARCH)')
  860. @echo ''
  861. @$(if $(boards), \
  862. $(foreach b, $(boards), \
  863. printf " %-24s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \
  864. echo '')
  865. @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
  866. @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
  867. @echo ' make C=1 [targets] Check all c source with $$CHECK (sparse by default)'
  868. @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
  869. @echo ''
  870. @echo 'Execute "make" or "make all" to build all targets marked with [*] '
  871. @echo 'For further info see the ./README file'
  872. # Documentation targets
  873. # ---------------------------------------------------------------------------
  874. %docs: scripts_basic FORCE
  875. $(Q)$(MAKE) $(build)=Documentation/DocBook $@
  876. else # KBUILD_EXTMOD
  877. ###
  878. # External module support.
  879. # When building external modules the kernel used as basis is considered
  880. # read-only, and no consistency checks are made and the make
  881. # system is not used on the basis kernel. If updates are required
  882. # in the basis kernel ordinary make commands (without M=...) must
  883. # be used.
  884. #
  885. # The following are the only valid targets when building external
  886. # modules.
  887. # make M=dir clean Delete all automatically generated files
  888. # make M=dir modules Make all modules in specified dir
  889. # make M=dir Same as 'make M=dir modules'
  890. # make M=dir modules_install
  891. # Install the modules built in the module directory
  892. # Assumes install directory is already created
  893. # We are always building modules
  894. KBUILD_MODULES := 1
  895. PHONY += crmodverdir
  896. crmodverdir:
  897. $(Q)mkdir -p $(MODVERDIR)
  898. $(Q)rm -f $(MODVERDIR)/*
  899. PHONY += $(objtree)/Module.symvers
  900. $(objtree)/Module.symvers:
  901. @test -e $(objtree)/Module.symvers || ( \
  902. echo; \
  903. echo " WARNING: Symbol version dump $(objtree)/Module.symvers"; \
  904. echo " is missing; modules will have no dependencies and modversions."; \
  905. echo )
  906. module-dirs := $(addprefix _module_,$(KBUILD_EXTMOD))
  907. PHONY += $(module-dirs) modules
  908. $(module-dirs): crmodverdir $(objtree)/Module.symvers
  909. $(Q)$(MAKE) $(build)=$(patsubst _module_%,%,$@)
  910. modules: $(module-dirs)
  911. @echo ' Building modules, stage 2.';
  912. $(Q)$(MAKE) -rR -f $(srctree)/scripts/Makefile.modpost
  913. PHONY += modules_install
  914. modules_install: _emodinst_ _emodinst_post
  915. install-dir := $(if $(INSTALL_MOD_DIR),$(INSTALL_MOD_DIR),extra)
  916. PHONY += _emodinst_
  917. _emodinst_:
  918. $(Q)mkdir -p $(MODLIB)/$(install-dir)
  919. $(Q)$(MAKE) -rR -f $(srctree)/scripts/Makefile.modinst
  920. # Run depmod only is we have System.map and depmod is executable
  921. quiet_cmd_depmod = DEPMOD $(KERNELRELEASE)
  922. cmd_depmod = if [ -r System.map -a -x $(DEPMOD) ]; then \
  923. $(DEPMOD) -ae -F System.map \
  924. $(if $(strip $(INSTALL_MOD_PATH)), \
  925. -b $(INSTALL_MOD_PATH) -r) \
  926. $(KERNELRELEASE); \
  927. fi
  928. PHONY += _emodinst_post
  929. _emodinst_post: _emodinst_
  930. $(call cmd,depmod)
  931. clean-dirs := $(addprefix _clean_,$(KBUILD_EXTMOD))
  932. PHONY += $(clean-dirs) clean
  933. $(clean-dirs):
  934. $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
  935. clean: rm-dirs := $(MODVERDIR)
  936. clean: $(clean-dirs)
  937. $(call cmd,rmdirs)
  938. @find $(KBUILD_EXTMOD) $(RCS_FIND_IGNORE) \
  939. \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
  940. -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \) \
  941. -type f -print | xargs rm -f
  942. help:
  943. @echo ' Building external modules.'
  944. @echo ' Syntax: make -C path/to/kernel/src M=$$PWD target'
  945. @echo ''
  946. @echo ' modules - default target, build the module(s)'
  947. @echo ' modules_install - install the module'
  948. @echo ' clean - remove generated files in module directory only'
  949. @echo ''
  950. # Dummies...
  951. PHONY += prepare scripts
  952. prepare: ;
  953. scripts: ;
  954. endif # KBUILD_EXTMOD
  955. # Generate tags for editors
  956. # ---------------------------------------------------------------------------
  957. #We want __srctree to totally vanish out when KBUILD_OUTPUT is not set
  958. #(which is the most common case IMHO) to avoid unneeded clutter in the big tags file.
  959. #Adding $(srctree) adds about 20M on i386 to the size of the output file!
  960. ifeq ($(src),$(obj))
  961. __srctree =
  962. else
  963. __srctree = $(srctree)/
  964. endif
  965. ifeq ($(ALLSOURCE_ARCHS),)
  966. ifeq ($(ARCH),um)
  967. ALLINCLUDE_ARCHS := $(ARCH) $(SUBARCH)
  968. else
  969. ALLINCLUDE_ARCHS := $(ARCH)
  970. endif
  971. else
  972. #Allow user to specify only ALLSOURCE_PATHS on the command line, keeping existing behavour.
  973. ALLINCLUDE_ARCHS := $(ALLSOURCE_ARCHS)
  974. endif
  975. ALLSOURCE_ARCHS := $(ARCH)
  976. define find-sources
  977. ( find $(__srctree) $(RCS_FIND_IGNORE) \
  978. \( -name include -o -name arch \) -prune -o \
  979. -name $1 -print; \
  980. for ARCH in $(ALLSOURCE_ARCHS) ; do \
  981. find $(__srctree)arch/$${ARCH} $(RCS_FIND_IGNORE) \
  982. -name $1 -print; \
  983. done ; \
  984. find $(__srctree)security/selinux/include $(RCS_FIND_IGNORE) \
  985. -name $1 -print; \
  986. find $(__srctree)include $(RCS_FIND_IGNORE) \
  987. \( -name config -o -name 'asm-*' \) -prune \
  988. -o -name $1 -print; \
  989. for ARCH in $(ALLINCLUDE_ARCHS) ; do \
  990. find $(__srctree)include/asm-$${ARCH} $(RCS_FIND_IGNORE) \
  991. -name $1 -print; \
  992. done ; \
  993. find $(__srctree)include/asm-generic $(RCS_FIND_IGNORE) \
  994. -name $1 -print )
  995. endef
  996. define all-sources
  997. $(call find-sources,'*.[chS]')
  998. endef
  999. define all-kconfigs
  1000. $(call find-sources,'Kconfig*')
  1001. endef
  1002. define all-defconfigs
  1003. $(call find-sources,'defconfig')
  1004. endef
  1005. quiet_cmd_cscope-file = FILELST cscope.files
  1006. cmd_cscope-file = (echo \-k; echo \-q; $(all-sources)) > cscope.files
  1007. quiet_cmd_cscope = MAKE cscope.out
  1008. cmd_cscope = cscope -b
  1009. cscope: FORCE
  1010. $(call cmd,cscope-file)
  1011. $(call cmd,cscope)
  1012. quiet_cmd_TAGS = MAKE $@
  1013. define cmd_TAGS
  1014. rm -f $@; \
  1015. ETAGSF=`etags --version | grep -i exuberant >/dev/null && \
  1016. echo "-I __initdata,__exitdata,__acquires,__releases \
  1017. -I EXPORT_SYMBOL,EXPORT_SYMBOL_GPL \
  1018. --extra=+f --c-kinds=+px"`; \
  1019. $(all-sources) | xargs etags $$ETAGSF -a; \
  1020. if test "x$$ETAGSF" = x; then \
  1021. $(all-kconfigs) | xargs etags -a \
  1022. --regex='/^config[ \t]+\([a-zA-Z0-9_]+\)/\1/'; \
  1023. $(all-defconfigs) | xargs etags -a \
  1024. --regex='/^#?[ \t]?\(CONFIG_[a-zA-Z0-9_]+\)/\1/'; \
  1025. fi
  1026. endef
  1027. TAGS: FORCE
  1028. $(call cmd,TAGS)
  1029. quiet_cmd_tags = MAKE $@
  1030. define cmd_tags
  1031. rm -f $@; \
  1032. CTAGSF=`ctags --version | grep -i exuberant >/dev/null && \
  1033. echo "-I __initdata,__exitdata,__acquires,__releases \
  1034. -I EXPORT_SYMBOL,EXPORT_SYMBOL_GPL \
  1035. --extra=+f --c-kinds=+px"`; \
  1036. $(all-sources) | xargs ctags $$CTAGSF -a
  1037. endef
  1038. tags: FORCE
  1039. $(call cmd,tags)
  1040. # Scripts to check various things for consistency
  1041. # ---------------------------------------------------------------------------
  1042. includecheck:
  1043. find * $(RCS_FIND_IGNORE) \
  1044. -name '*.[hcS]' -type f -print | sort \
  1045. | xargs $(PERL) -w scripts/checkincludes.pl
  1046. versioncheck:
  1047. find * $(RCS_FIND_IGNORE) \
  1048. -name '*.[hcS]' -type f -print | sort \
  1049. | xargs $(PERL) -w scripts/checkversion.pl
  1050. namespacecheck:
  1051. $(PERL) $(srctree)/scripts/namespace.pl
  1052. endif #ifeq ($(config-targets),1)
  1053. endif #ifeq ($(mixed-targets),1)
  1054. PHONY += checkstack kernelrelease kernelversion
  1055. checkstack:
  1056. $(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \
  1057. $(PERL) $(src)/scripts/checkstack.pl $(ARCH)
  1058. kernelrelease:
  1059. $(if $(wildcard include/config/kernel.release), $(Q)echo $(KERNELRELEASE), \
  1060. $(error kernelrelease not valid - run 'make prepare' to update it))
  1061. kernelversion:
  1062. @echo $(KERNELVERSION)
  1063. # Single targets
  1064. # ---------------------------------------------------------------------------
  1065. # Single targets are compatible with:
  1066. # - build whith mixed source and output
  1067. # - build with separate output dir 'make O=...'
  1068. # - external modules
  1069. #
  1070. # target-dir => where to store outputfile
  1071. # build-dir => directory in kernel source tree to use
  1072. ifeq ($(KBUILD_EXTMOD),)
  1073. build-dir = $(patsubst %/,%,$(dir $@))
  1074. target-dir = $(dir $@)
  1075. else
  1076. zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
  1077. build-dir = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
  1078. target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
  1079. endif
  1080. %.s: %.c prepare scripts FORCE
  1081. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1082. %.i: %.c prepare scripts FORCE
  1083. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1084. %.o: %.c prepare scripts FORCE
  1085. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1086. %.lst: %.c prepare scripts FORCE
  1087. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1088. %.s: %.S prepare scripts FORCE
  1089. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1090. %.o: %.S prepare scripts FORCE
  1091. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1092. %.symtypes: %.c prepare scripts FORCE
  1093. $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
  1094. # Modules
  1095. / %/: prepare scripts FORCE
  1096. $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
  1097. $(build)=$(build-dir)
  1098. %.ko: prepare scripts FORCE
  1099. $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
  1100. $(build)=$(build-dir) $(@:.ko=.o)
  1101. $(Q)$(MAKE) -rR -f $(srctree)/scripts/Makefile.modpost
  1102. # FIXME Should go into a make.lib or something
  1103. # ===========================================================================
  1104. quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs)))
  1105. cmd_rmdirs = rm -rf $(rm-dirs)
  1106. quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
  1107. cmd_rmfiles = rm -f $(rm-files)
  1108. a_flags = -Wp,-MD,$(depfile) $(AFLAGS) $(AFLAGS_KERNEL) \
  1109. $(NOSTDINC_FLAGS) $(CPPFLAGS) \
  1110. $(modkern_aflags) $(EXTRA_AFLAGS) $(AFLAGS_$(basetarget).o)
  1111. quiet_cmd_as_o_S = AS $@
  1112. cmd_as_o_S = $(CC) $(a_flags) -c -o $@ $<
  1113. # read all saved command lines
  1114. targets := $(wildcard $(sort $(targets)))
  1115. cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
  1116. ifneq ($(cmd_files),)
  1117. $(cmd_files): ; # Do not try to update included dependency files
  1118. include $(cmd_files)
  1119. endif
  1120. # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.clean obj=dir
  1121. # Usage:
  1122. # $(Q)$(MAKE) $(clean)=dir
  1123. clean := -f $(if $(KBUILD_SRC),$(srctree)/)scripts/Makefile.clean obj
  1124. endif # skip-makefile
  1125. PHONY += FORCE
  1126. FORCE:
  1127. # Declare the contents of the .PHONY variable as phony. We keep that
  1128. # information in a variable se we can use it in if_changed and friends.
  1129. .PHONY: $(PHONY)