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