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