2005-04-17 02:20:36 +04:00
# ==========================================================================
# Building
# ==========================================================================
src := $( obj)
2006-03-06 01:14:10 +03:00
PHONY := __build
2005-04-17 02:20:36 +04:00
__build :
2007-05-29 00:47:48 +04:00
# Init all relevant variables used in kbuild files so
# 1) they have correct type
# 2) they do not inherit any value from the environment
obj-y :=
obj-m :=
lib-y :=
lib-m :=
always :=
targets :=
subdir-y :=
subdir-m :=
EXTRA_AFLAGS :=
EXTRA_CFLAGS :=
EXTRA_CPPFLAGS :=
EXTRA_LDFLAGS :=
2007-10-16 00:25:06 +04:00
asflags-y :=
ccflags-y :=
cppflags-y :=
ldflags-y :=
2007-05-29 00:47:48 +04:00
2005-04-17 02:20:36 +04:00
# Read .config if it exist, otherwise ignore
2006-06-09 09:12:39 +04:00
- i n c l u d e i n c l u d e / c o n f i g / a u t o . c o n f
2005-04-17 02:20:36 +04:00
2006-01-22 15:34:15 +03:00
i n c l u d e s c r i p t s / K b u i l d . i n c l u d e
2007-10-15 00:26:53 +04:00
# For backward compatibility check that these variables does not change
save-cflags := $( CFLAGS)
2005-07-26 00:26:04 +04:00
# The filename Kbuild has precedence over Makefile
2005-07-28 00:11:01 +04:00
kbuild-dir := $( if $( filter /%,$( src) ) ,$( src) ,$( srctree) /$( src) )
2007-10-15 00:26:53 +04:00
kbuild-file := $( if $( wildcard $( kbuild-dir) /Kbuild) ,$( kbuild-dir) /Kbuild,$( kbuild-dir) /Makefile)
i n c l u d e $( kbuild -file )
# If the save-* variables changed error out
i f e q ( $( KBUILD_NOPEDANTIC ) , )
ifneq ( " $( save-cflags) " ," $( CFLAGS) " )
$( error CFLAGS was changed in " $( kbuild-file) " . Fix it to use EXTRA_CFLAGS)
endif
e n d i f
2005-04-17 02:20:36 +04:00
i n c l u d e s c r i p t s / M a k e f i l e . l i b
i f d e f h o s t - p r o g s
i f n e q ( $( hostprogs -y ) , $( host -progs ) )
$(warning kbuild : $( obj ) /Makefile - Usage of host -progs is deprecated . Please replace with hostprogs -y !)
hostprogs-y += $( host-progs)
e n d i f
e n d i f
# Do not include host rules unles needed
i f n e q ( $( hostprogs -y ) $( hostprogs -m ) , )
i n c l u d e s c r i p t s / M a k e f i l e . h o s t
e n d i f
i f n e q ( $( KBUILD_SRC ) , )
# Create output directory if not already present
_dummy := $( shell [ -d $( obj) ] || mkdir -p $( obj) )
# Create directories for object files if directory does not exist
# Needed when obj-y := dir/file.o syntax is used
_dummy := $( foreach d,$( obj-dirs) , $( shell [ -d $( d) ] || mkdir -p $( d) ) )
e n d i f
i f n d e f o b j
$(warning kbuild : Makefile .build is included improperly )
e n d i f
# ===========================================================================
i f n e q ( $( strip $ ( lib -y ) $ ( lib -m ) $ ( lib -n ) $ ( lib -) ) , )
lib-target := $( obj) /lib.a
e n d i f
i f n e q ( $( strip $ ( obj -y ) $ ( obj -m ) $ ( obj -n ) $ ( obj -) $ ( lib -target ) ) , )
builtin-target := $( obj) /built-in.o
e n d i f
2007-12-07 15:04:30 +03:00
modorder-target := $( obj) /modules.order
2005-04-17 02:20:36 +04:00
# We keep a list of all modules in $(MODVERDIR)
__build : $( if $ ( KBUILD_BUILTIN ) ,$ ( builtin -target ) $ ( lib -target ) $ ( extra -y ) ) \
2007-12-07 15:04:30 +03:00
$( if $( KBUILD_MODULES) ,$( obj-m) $( modorder-target) ) \
2005-04-17 02:20:36 +04:00
$( subdir-ym) $( always)
@:
# Linus' kernel sanity checking tool
i f n e q ( $( KBUILD_CHECKSRC ) , 0 )
ifeq ( $( KBUILD_CHECKSRC) ,2)
quiet_cmd_force_checksrc = CHECK $<
cmd_force_checksrc = $( CHECK) $( CHECKFLAGS) $( c_flags) $< ;
else
quiet_cmd_checksrc = CHECK $<
cmd_checksrc = $( CHECK) $( CHECKFLAGS) $( c_flags) $< ;
endif
e n d i f
# Compile C sources (.c)
# ---------------------------------------------------------------------------
# Default is built-in, unless we know otherwise
modkern_cflags := $( CFLAGS_KERNEL)
quiet_modtag := $( empty) $( empty)
$(real-objs-m) : modkern_cflags := $( CFLAGS_MODULE )
$(real-objs-m : .o =.i ) : modkern_cflags := $( CFLAGS_MODULE )
$(real-objs-m : .o =.s ) : modkern_cflags := $( CFLAGS_MODULE )
$(real-objs-m : .o =.lst ): modkern_cflags := $( CFLAGS_MODULE )
$(real-objs-m) : quiet_modtag := [M ]
$(real-objs-m : .o =.i ) : quiet_modtag := [M ]
$(real-objs-m : .o =.s ) : quiet_modtag := [M ]
$(real-objs-m : .o =.lst ): quiet_modtag := [M ]
$(obj-m) : quiet_modtag := [M ]
# Default for not multi-part modules
2006-07-01 11:58:02 +04:00
modname = $( basetarget)
2005-04-17 02:20:36 +04:00
$(multi-objs-m) : modname = $( modname -multi )
$(multi-objs-m : .o =.i ) : modname = $( modname -multi )
$(multi-objs-m : .o =.s ) : modname = $( modname -multi )
$(multi-objs-m : .o =.lst ) : modname = $( modname -multi )
$(multi-objs-y) : modname = $( modname -multi )
$(multi-objs-y : .o =.i ) : modname = $( modname -multi )
$(multi-objs-y : .o =.s ) : modname = $( modname -multi )
$(multi-objs-y : .o =.lst ) : modname = $( modname -multi )
quiet_cmd_cc_s_c = CC $( quiet_modtag) $@
2006-03-08 10:58:33 +03:00
cmd_cc_s_c = $( CC) $( c_flags) -fverbose-asm -S -o $@ $<
2005-04-17 02:20:36 +04:00
2007-05-06 11:23:45 +04:00
$(obj)/%.s : $( src ) /%.c FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,cc_s_c)
quiet_cmd_cc_i_c = CPP $( quiet_modtag) $@
cmd_cc_i_c = $( CPP) $( c_flags) -o $@ $<
2007-05-06 11:23:45 +04:00
$(obj)/%.i : $( src ) /%.c FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,cc_i_c)
kbuild: support for %.symtypes files
Here is a patch that adds a new -T option to genksyms for generating dumps of
the type definition that makes up the symbol version hashes. This allows to
trace modversion changes back to what caused them. The dump format is the
name of the type defined, followed by its definition (which is almost C):
s#list_head struct list_head { s#list_head * next , * prev ; }
The s#, u#, e#, and t# prefixes stand for struct, union, enum, and typedef.
The exported symbols do not define types, and thus do not have an x# prefix:
nfs4_acl_get_whotype int nfs4_acl_get_whotype ( char * , t#u32 )
The symbol type defintion of a single file can be generated with:
make fs/jbd/journal.symtypes
If KBUILD_SYMTYPES is defined, all the *.symtypes of all object files that
export symbols are generated.
The single *.symtypes files can be combined into a single file after a kernel
build with a script like the following:
for f in $(find -name '*.symtypes' | sort); do
f=${f#./}
echo "/* ${f%.symtypes}.o */"
cat $f
echo
done \
| sed -e '\:UNKNOWN:d' \
-e 's:[,;] }:}:g' \
-e 's:\([[({]\) :\1:g' \
-e 's: \([])},;]\):\1:g' \
-e 's: $::' \
$f \
| awk '
/^.#/ { if (defined[$1] == $0) {
print $1
next
}
defined[$1] = $0
}
{ print }
'
When the kernel ABI changes, diffing individual *.symtype files, or the
combined files, against each other will show which symbol changes caused the
ABI changes. This can save a tremendous amount of time.
Dump the types that make up modversions
Signed-off-by: Andreas Gruenbacher <agruen@suse.de>
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
2006-05-09 22:37:30 +04:00
quiet_cmd_cc_symtypes_c = SYM $( quiet_modtag) $@
cmd_cc_symtypes_c = \
$( CPP) -D__GENKSYMS__ $( c_flags) $< \
| $( GENKSYMS) -T $@ >/dev/null; \
test -s $@ || rm -f $@
2007-05-06 11:23:45 +04:00
$(obj)/%.symtypes : $( src ) /%.c FORCE
kbuild: support for %.symtypes files
Here is a patch that adds a new -T option to genksyms for generating dumps of
the type definition that makes up the symbol version hashes. This allows to
trace modversion changes back to what caused them. The dump format is the
name of the type defined, followed by its definition (which is almost C):
s#list_head struct list_head { s#list_head * next , * prev ; }
The s#, u#, e#, and t# prefixes stand for struct, union, enum, and typedef.
The exported symbols do not define types, and thus do not have an x# prefix:
nfs4_acl_get_whotype int nfs4_acl_get_whotype ( char * , t#u32 )
The symbol type defintion of a single file can be generated with:
make fs/jbd/journal.symtypes
If KBUILD_SYMTYPES is defined, all the *.symtypes of all object files that
export symbols are generated.
The single *.symtypes files can be combined into a single file after a kernel
build with a script like the following:
for f in $(find -name '*.symtypes' | sort); do
f=${f#./}
echo "/* ${f%.symtypes}.o */"
cat $f
echo
done \
| sed -e '\:UNKNOWN:d' \
-e 's:[,;] }:}:g' \
-e 's:\([[({]\) :\1:g' \
-e 's: \([])},;]\):\1:g' \
-e 's: $::' \
$f \
| awk '
/^.#/ { if (defined[$1] == $0) {
print $1
next
}
defined[$1] = $0
}
{ print }
'
When the kernel ABI changes, diffing individual *.symtype files, or the
combined files, against each other will show which symbol changes caused the
ABI changes. This can save a tremendous amount of time.
Dump the types that make up modversions
Signed-off-by: Andreas Gruenbacher <agruen@suse.de>
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
2006-05-09 22:37:30 +04:00
$( call if_changed_dep,cc_symtypes_c)
2005-04-17 02:20:36 +04:00
# C (.c) files
# The C file is compiled and updated dependency information is generated.
# (See cmd_cc_o_c + relevant part of rule_cc_o_c)
quiet_cmd_cc_o_c = CC $( quiet_modtag) $@
i f n d e f C O N F I G _ M O D V E R S I O N S
cmd_cc_o_c = $( CC) $( c_flags) -c -o $@ $<
e l s e
# When module versioning is enabled the following steps are executed:
# o compile a .tmp_<file>.o from <file>.c
# o if .tmp_<file>.o doesn't contain a __ksymtab version, i.e. does
# not export symbols, we just rename .tmp_<file>.o to <file>.o and
# are done.
# o otherwise, we calculate symbol versions using the good old
# genksyms on the preprocessed source and postprocess them in a way
# that they are usable as a linker script
# o generate <file>.o from .tmp_<file>.o using the linker to
# replace the unresolved symbols __crc_exported_symbol with
# the actual value of the checksum generated by genksyms
cmd_cc_o_c = $( CC) $( c_flags) -c -o $( @D) /.tmp_$( @F) $<
cmd_modversions = \
if $( OBJDUMP) -h $( @D) /.tmp_$( @F) | grep -q __ksymtab; then \
$( CPP) -D__GENKSYMS__ $( c_flags) $< \
kbuild: support for %.symtypes files
Here is a patch that adds a new -T option to genksyms for generating dumps of
the type definition that makes up the symbol version hashes. This allows to
trace modversion changes back to what caused them. The dump format is the
name of the type defined, followed by its definition (which is almost C):
s#list_head struct list_head { s#list_head * next , * prev ; }
The s#, u#, e#, and t# prefixes stand for struct, union, enum, and typedef.
The exported symbols do not define types, and thus do not have an x# prefix:
nfs4_acl_get_whotype int nfs4_acl_get_whotype ( char * , t#u32 )
The symbol type defintion of a single file can be generated with:
make fs/jbd/journal.symtypes
If KBUILD_SYMTYPES is defined, all the *.symtypes of all object files that
export symbols are generated.
The single *.symtypes files can be combined into a single file after a kernel
build with a script like the following:
for f in $(find -name '*.symtypes' | sort); do
f=${f#./}
echo "/* ${f%.symtypes}.o */"
cat $f
echo
done \
| sed -e '\:UNKNOWN:d' \
-e 's:[,;] }:}:g' \
-e 's:\([[({]\) :\1:g' \
-e 's: \([])},;]\):\1:g' \
-e 's: $::' \
$f \
| awk '
/^.#/ { if (defined[$1] == $0) {
print $1
next
}
defined[$1] = $0
}
{ print }
'
When the kernel ABI changes, diffing individual *.symtype files, or the
combined files, against each other will show which symbol changes caused the
ABI changes. This can save a tremendous amount of time.
Dump the types that make up modversions
Signed-off-by: Andreas Gruenbacher <agruen@suse.de>
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
2006-05-09 22:37:30 +04:00
| $( GENKSYMS) $( if $( KBUILD_SYMTYPES) , \
-T $( @D) /$( @F:.o= .symtypes) ) -a $( ARCH) \
2005-04-17 02:20:36 +04:00
> $( @D) /.tmp_$( @F:.o= .ver) ; \
\
$( LD) $( LDFLAGS) -r -o $@ $( @D) /.tmp_$( @F) \
-T $( @D) /.tmp_$( @F:.o= .ver) ; \
rm -f $( @D) /.tmp_$( @F) $( @D) /.tmp_$( @F:.o= .ver) ; \
else \
2005-07-15 00:12:40 +04:00
mv -f $( @D) /.tmp_$( @F) $@ ; \
2005-04-17 02:20:36 +04:00
fi ;
e n d i f
d e f i n e r u l e _ c c _ o _ c
2006-01-30 12:04:27 +03:00
$( call echo-cmd,checksrc) $( cmd_checksrc) \
$( call echo-cmd,cc_o_c) $( cmd_cc_o_c) ; \
2005-04-17 02:20:36 +04:00
$( cmd_modversions) \
2006-07-23 21:37:44 +04:00
scripts/basic/fixdep $( depfile) $@ '$(call make-cmd,cc_o_c)' > \
$( dot-target) .tmp; \
2005-04-17 02:20:36 +04:00
rm -f $( depfile) ; \
2006-07-23 21:37:44 +04:00
mv -f $( dot-target) .tmp $( dot-target) .cmd
2005-04-17 02:20:36 +04:00
e n d e f
# Built-in and composite module parts
2007-05-06 11:23:45 +04:00
$(obj)/%.o : $( src ) /%.c FORCE
2005-04-17 02:20:36 +04:00
$( call cmd,force_checksrc)
$( call if_changed_rule,cc_o_c)
# Single-part modules are special since we need to mark them in $(MODVERDIR)
2007-05-06 11:23:45 +04:00
$(single-used-m) : $( obj ) /%.o : $( src ) /%.c FORCE
2005-04-17 02:20:36 +04:00
$( call cmd,force_checksrc)
$( call if_changed_rule,cc_o_c)
@{ echo $( @:.o= .ko) ; echo $@ ; } > $( MODVERDIR) /$( @F:.o= .mod)
quiet_cmd_cc_lst_c = MKLST $@
cmd_cc_lst_c = $( CC) $( c_flags) -g -c -o $* .o $< && \
$( CONFIG_SHELL) $( srctree) /scripts/makelst $* .o \
System.map $( OBJDUMP) > $@
2007-05-06 11:23:45 +04:00
$(obj)/%.lst : $( src ) /%.c FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,cc_lst_c)
# Compile assembler sources (.S)
# ---------------------------------------------------------------------------
modkern_aflags := $( AFLAGS_KERNEL)
$(real-objs-m) : modkern_aflags := $( AFLAGS_MODULE )
$(real-objs-m : .o =.s ): modkern_aflags := $( AFLAGS_MODULE )
quiet_cmd_as_s_S = CPP $( quiet_modtag) $@
cmd_as_s_S = $( CPP) $( a_flags) -o $@ $<
2007-05-06 11:23:45 +04:00
$(obj)/%.s : $( src ) /%.S FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,as_s_S)
quiet_cmd_as_o_S = AS $( quiet_modtag) $@
cmd_as_o_S = $( CC) $( a_flags) -c -o $@ $<
2007-05-06 11:23:45 +04:00
$(obj)/%.o : $( src ) /%.S FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,as_o_S)
targets += $( real-objs-y) $( real-objs-m) $( lib-y)
targets += $( extra-y) $( MAKECMDGOALS) $( always)
# Linker scripts preprocessor (.lds.S -> .lds)
# ---------------------------------------------------------------------------
quiet_cmd_cpp_lds_S = LDS $@
cmd_cpp_lds_S = $( CPP) $( cpp_flags) -D__ASSEMBLY__ -o $@ $<
2007-05-06 11:23:45 +04:00
$(obj)/%.lds : $( src ) /%.lds .S FORCE
2005-04-17 02:20:36 +04:00
$( call if_changed_dep,cpp_lds_S)
# Build the compiled-in targets
# ---------------------------------------------------------------------------
# To build objects in subdirs, we need to descend into the directories
$(sort $(subdir-obj-y)) : $( subdir -ym ) ;
#
# Rule to compile a set of .o files into one .o file
#
i f d e f b u i l t i n - t a r g e t
quiet_cmd_link_o_target = LD $@
# If the list of objects to link is empty, just create an empty built-in.o
cmd_link_o_target = $( if $( strip $( obj-y) ) ,\
$( LD) $( ld_flags) -r -o $@ $( filter $( obj-y) , $^) ,\
rm -f $@ ; $( AR) rcs $@ )
$(builtin-target) : $( obj -y ) FORCE
$( call if_changed,link_o_target)
targets += $( builtin-target)
e n d i f # builtin-target
2007-12-07 15:04:30 +03:00
#
# Rule to create modules.order file
#
# Create commands to either record .ko file or cat modules.order from
# a subdirectory
modorder-cmds = \
$( foreach m, $( modorder) , \
$( if $( filter %/modules.order, $m ) , \
cat $m ; , echo kernel/$m ; ) )
$(modorder-target) : $( subdir -ym ) FORCE
$( Q) ( cat /dev/null; $( modorder-cmds) ) > $@
2005-04-17 02:20:36 +04:00
#
# Rule to compile a set of .o files into one .a file
#
i f d e f l i b - t a r g e t
quiet_cmd_link_l_target = AR $@
2007-09-30 22:14:58 +04:00
cmd_link_l_target = rm -f $@ ; $( AR) rcs $@ $( lib-y)
2005-04-17 02:20:36 +04:00
$(lib-target) : $( lib -y ) FORCE
$( call if_changed,link_l_target)
targets += $( lib-target)
e n d i f
#
# Rule to link composite objects
#
# Composite objects are specified in kbuild makefile as follows:
# <composite-object>-objs := <list of .o files>
# or
# <composite-object>-y := <list of .o files>
link_multi_deps = \
$( filter $ ( addprefix $ ( obj ) /, \
$($(subst $(obj)/,,$(@ : .o =-objs ))) \
$($(subst $(obj)/,,$(@ : .o =-y )))), $^)
quiet_cmd_link_multi-y = LD $@
cmd_link_multi-y = $( LD) $( ld_flags) -r -o $@ $( link_multi_deps)
quiet_cmd_link_multi-m = LD [ M] $@
2007-07-23 12:12:08 +04:00
cmd_link_multi-m = $( cmd_link_multi-y)
2005-04-17 02:20:36 +04:00
# We would rather have a list of rules like
# foo.o: $(foo-objs)
# but that's not so easy, so we rather make all composite objects depend
# on the set of all their parts
$(multi-used-y) : %.o : $( multi -objs -y ) FORCE
$( call if_changed,link_multi-y)
$(multi-used-m) : %.o : $( multi -objs -m ) FORCE
$( call if_changed,link_multi-m)
@{ echo $( @:.o= .ko) ; echo $( link_multi_deps) ; } > $( MODVERDIR) /$( @F:.o= .mod)
targets += $( multi-used-y) $( multi-used-m)
# Descending
# ---------------------------------------------------------------------------
2006-03-06 01:14:10 +03:00
PHONY += $( subdir-ym)
2005-04-17 02:20:36 +04:00
$(subdir-ym) :
$( Q) $( MAKE) $( build) = $@
# Add FORCE to the prequisites of a target to force it to be always rebuilt.
# ---------------------------------------------------------------------------
2006-03-06 01:14:10 +03:00
PHONY += FORCE
2005-04-17 02:20:36 +04:00
FORCE :
# Read all saved command lines and dependencies for the $(targets) we
# may be building above, using $(if_changed{,_dep}). As an
# optimization, we don't need to read them if the target does not
# exist, we will rebuild anyway in that case.
targets := $( wildcard $( sort $( targets) ) )
cmd_files := $( wildcard $( foreach f,$( targets) ,$( dir $( f) ) .$( notdir $( f) ) .cmd) )
i f n e q ( $( cmd_files ) , )
include $( cmd_files)
e n d i f
2006-03-06 01:14:10 +03:00
# Declare the contents of the .PHONY variable as phony. We keep that
# information in a variable se we can use it in if_changed and friends.
.PHONY : $( PHONY )
