ftrace: document updates
[linux-2.6] / scripts / Makefile.lib
1 # Backward compatibility
2 asflags-y  += $(EXTRA_AFLAGS)
3 ccflags-y  += $(EXTRA_CFLAGS)
4 cppflags-y += $(EXTRA_CPPFLAGS)
5 ldflags-y  += $(EXTRA_LDFLAGS)
6
7 # Figure out what we need to build from the various variables
8 # ===========================================================================
9
10 # When an object is listed to be built compiled-in and modular,
11 # only build the compiled-in version
12
13 obj-m := $(filter-out $(obj-y),$(obj-m))
14
15 # Libraries are always collected in one lib file.
16 # Filter out objects already built-in
17
18 lib-y := $(filter-out $(obj-y), $(sort $(lib-y) $(lib-m)))
19
20
21 # Handle objects in subdirs
22 # ---------------------------------------------------------------------------
23 # o if we encounter foo/ in $(obj-y), replace it by foo/built-in.o
24 #   and add the directory to the list of dirs to descend into: $(subdir-y)
25 # o if we encounter foo/ in $(obj-m), remove it from $(obj-m) 
26 #   and add the directory to the list of dirs to descend into: $(subdir-m)
27
28 # Determine modorder.
29 # Unfortunately, we don't have information about ordering between -y
30 # and -m subdirs.  Just put -y's first.
31 modorder        := $(patsubst %/,%/modules.order, $(filter %/, $(obj-y)) $(obj-m:.o=.ko))
32
33 __subdir-y      := $(patsubst %/,%,$(filter %/, $(obj-y)))
34 subdir-y        += $(__subdir-y)
35 __subdir-m      := $(patsubst %/,%,$(filter %/, $(obj-m)))
36 subdir-m        += $(__subdir-m)
37 obj-y           := $(patsubst %/, %/built-in.o, $(obj-y))
38 obj-m           := $(filter-out %/, $(obj-m))
39
40 # Subdirectories we need to descend into
41
42 subdir-ym       := $(sort $(subdir-y) $(subdir-m))
43
44 # if $(foo-objs) exists, foo.o is a composite object 
45 multi-used-y := $(sort $(foreach m,$(obj-y), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))), $(m))))
46 multi-used-m := $(sort $(foreach m,$(obj-m), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))), $(m))))
47 multi-used   := $(multi-used-y) $(multi-used-m)
48 single-used-m := $(sort $(filter-out $(multi-used-m),$(obj-m)))
49
50 # Build list of the parts of our composite objects, our composite
51 # objects depend on those (obviously)
52 multi-objs-y := $(foreach m, $(multi-used-y), $($(m:.o=-objs)) $($(m:.o=-y)))
53 multi-objs-m := $(foreach m, $(multi-used-m), $($(m:.o=-objs)) $($(m:.o=-y)))
54 multi-objs   := $(multi-objs-y) $(multi-objs-m)
55
56 # $(subdir-obj-y) is the list of objects in $(obj-y) which uses dir/ to
57 # tell kbuild to descend
58 subdir-obj-y := $(filter %/built-in.o, $(obj-y))
59
60 # $(obj-dirs) is a list of directories that contain object files
61 obj-dirs := $(dir $(multi-objs) $(subdir-obj-y))
62
63 # Replace multi-part objects by their individual parts, look at local dir only
64 real-objs-y := $(foreach m, $(filter-out $(subdir-obj-y), $(obj-y)), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))),$($(m:.o=-objs)) $($(m:.o=-y)),$(m))) $(extra-y)
65 real-objs-m := $(foreach m, $(obj-m), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))),$($(m:.o=-objs)) $($(m:.o=-y)),$(m)))
66
67 # Add subdir path
68
69 extra-y         := $(addprefix $(obj)/,$(extra-y))
70 always          := $(addprefix $(obj)/,$(always))
71 targets         := $(addprefix $(obj)/,$(targets))
72 modorder        := $(addprefix $(obj)/,$(modorder))
73 obj-y           := $(addprefix $(obj)/,$(obj-y))
74 obj-m           := $(addprefix $(obj)/,$(obj-m))
75 lib-y           := $(addprefix $(obj)/,$(lib-y))
76 subdir-obj-y    := $(addprefix $(obj)/,$(subdir-obj-y))
77 real-objs-y     := $(addprefix $(obj)/,$(real-objs-y))
78 real-objs-m     := $(addprefix $(obj)/,$(real-objs-m))
79 single-used-m   := $(addprefix $(obj)/,$(single-used-m))
80 multi-used-y    := $(addprefix $(obj)/,$(multi-used-y))
81 multi-used-m    := $(addprefix $(obj)/,$(multi-used-m))
82 multi-objs-y    := $(addprefix $(obj)/,$(multi-objs-y))
83 multi-objs-m    := $(addprefix $(obj)/,$(multi-objs-m))
84 subdir-ym       := $(addprefix $(obj)/,$(subdir-ym))
85 obj-dirs        := $(addprefix $(obj)/,$(obj-dirs))
86
87 # These flags are needed for modversions and compiling, so we define them here
88 # already
89 # $(modname_flags) #defines KBUILD_MODNAME as the name of the module it will 
90 # end up in (or would, if it gets compiled in)
91 # Note: It's possible that one object gets potentially linked into more
92 #       than one module. In that case KBUILD_MODNAME will be set to foo_bar,
93 #       where foo and bar are the name of the modules.
94 name-fix = $(subst $(comma),_,$(subst -,_,$1))
95 basename_flags = -D"KBUILD_BASENAME=KBUILD_STR($(call name-fix,$(basetarget)))"
96 modname_flags  = $(if $(filter 1,$(words $(modname))),\
97                  -D"KBUILD_MODNAME=KBUILD_STR($(call name-fix,$(modname)))")
98
99 _c_flags       = $(KBUILD_CFLAGS) $(ccflags-y) $(CFLAGS_$(basetarget).o)
100 _a_flags       = $(KBUILD_AFLAGS) $(asflags-y) $(AFLAGS_$(basetarget).o)
101 _cpp_flags     = $(KBUILD_CPPFLAGS) $(cppflags-y) $(CPPFLAGS_$(@F))
102
103 # If building the kernel in a separate objtree expand all occurrences
104 # of -Idir to -I$(srctree)/dir except for absolute paths (starting with '/').
105
106 ifeq ($(KBUILD_SRC),)
107 __c_flags       = $(_c_flags)
108 __a_flags       = $(_a_flags)
109 __cpp_flags     = $(_cpp_flags)
110 else
111
112 # -I$(obj) locates generated .h files
113 # $(call addtree,-I$(obj)) locates .h files in srctree, from generated .c files
114 #   and locates generated .h files
115 # FIXME: Replace both with specific CFLAGS* statements in the makefiles
116 __c_flags       = $(call addtree,-I$(obj)) $(call flags,_c_flags)
117 __a_flags       =                          $(call flags,_a_flags)
118 __cpp_flags     =                          $(call flags,_cpp_flags)
119 endif
120
121 c_flags        = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(KBUILD_CPPFLAGS) \
122                  $(__c_flags) $(modkern_cflags) \
123                  -D"KBUILD_STR(s)=\#s" $(basename_flags) $(modname_flags)
124
125 a_flags        = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(KBUILD_CPPFLAGS) \
126                  $(__a_flags) $(modkern_aflags)
127
128 cpp_flags      = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(__cpp_flags)
129
130 ld_flags       = $(LDFLAGS) $(ldflags-y)
131
132 # Finds the multi-part object the current object will be linked into
133 modname-multi = $(sort $(foreach m,$(multi-used),\
134                 $(if $(filter $(subst $(obj)/,,$*.o), $($(m:.o=-objs)) $($(m:.o=-y))),$(m:.o=))))
135
136 # Shipped files
137 # ===========================================================================
138
139 quiet_cmd_shipped = SHIPPED $@
140 cmd_shipped = cat $< > $@
141
142 $(obj)/%:: $(src)/%_shipped
143         $(call cmd,shipped)
144
145 # Commands useful for building a boot image
146 # ===========================================================================
147
148 #       Use as following:
149 #
150 #       target: source(s) FORCE
151 #               $(if_changed,ld/objcopy/gzip)
152 #
153 #       and add target to extra-y so that we know we have to
154 #       read in the saved command line
155
156 # Linking
157 # ---------------------------------------------------------------------------
158
159 quiet_cmd_ld = LD      $@
160 cmd_ld = $(LD) $(LDFLAGS) $(ldflags-y) $(LDFLAGS_$(@F)) \
161                $(filter-out FORCE,$^) -o $@ 
162
163 # Objcopy
164 # ---------------------------------------------------------------------------
165
166 quiet_cmd_objcopy = OBJCOPY $@
167 cmd_objcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@
168
169 # Gzip
170 # ---------------------------------------------------------------------------
171
172 quiet_cmd_gzip = GZIP    $@
173 cmd_gzip = gzip -f -9 < $< > $@
174
175