aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/kbuild
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/kbuild')
-rw-r--r--Documentation/kbuild/kbuild.txt8
-rw-r--r--Documentation/kbuild/makefiles.txt24
2 files changed, 16 insertions, 16 deletions
diff --git a/Documentation/kbuild/kbuild.txt b/Documentation/kbuild/kbuild.txt
index 634c625da8ce..0d8addbb0fae 100644
--- a/Documentation/kbuild/kbuild.txt
+++ b/Documentation/kbuild/kbuild.txt
@@ -40,15 +40,15 @@ Set the directory to look for the kernel source when building external
40modules. 40modules.
41The directory can be specified in several ways: 41The directory can be specified in several ways:
421) Use "M=..." on the command line 421) Use "M=..." on the command line
432) Environmnet variable KBUILD_EXTMOD 432) Environment variable KBUILD_EXTMOD
443) Environmnet variable SUBDIRS 443) Environment variable SUBDIRS
45The possibilities are listed in the order they take precedence. 45The possibilities are listed in the order they take precedence.
46Using "M=..." will always override the others. 46Using "M=..." will always override the others.
47 47
48KBUILD_OUTPUT 48KBUILD_OUTPUT
49-------------------------------------------------- 49--------------------------------------------------
50Specify the output directory when building the kernel. 50Specify the output directory when building the kernel.
51The output directory can also be specificed using "O=...". 51The output directory can also be specified using "O=...".
52Setting "O=..." takes precedence over KBUILD_OUTPUT. 52Setting "O=..." takes precedence over KBUILD_OUTPUT.
53 53
54ARCH 54ARCH
@@ -90,7 +90,7 @@ The script will be called with the following arguments:
90 $3 - kernel map file 90 $3 - kernel map file
91 $4 - default install path (use root directory if blank) 91 $4 - default install path (use root directory if blank)
92 92
93The implmentation of "make install" is architecture specific 93The implementation of "make install" is architecture specific
94and it may differ from the above. 94and it may differ from the above.
95 95
96INSTALLKERNEL is provided to enable the possibility to 96INSTALLKERNEL is provided to enable the possibility to
diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index 31bfcbf958fc..8abd041b605d 100644
--- a/Documentation/kbuild/makefiles.txt
+++ b/Documentation/kbuild/makefiles.txt
@@ -285,12 +285,12 @@ more details, with real examples.
285--- 3.7 Compilation flags 285--- 3.7 Compilation flags
286 286
287 ccflags-y, asflags-y and ldflags-y 287 ccflags-y, asflags-y and ldflags-y
288 The three flags listed above apply only to the kbuild makefile where 288 These three flags apply only to the kbuild makefile in which they
289 they are assigned (i.e., per-directory). They are used for all the 289 are assigned. They are used for all the normal cc, as and ld
290 normal cc, as and ld invocation happening during a recursive build. 290 invocations happening during a recursive build.
291 Note: Flags with the same behaviour were previously named: 291 Note: Flags with the same behaviour were previously named:
292 EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS. They are still 292 EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS.
293 supported but their use is deprecated. 293 They are still supported but their usage is deprecated.
294 294
295 ccflags-y specifies options for compiling with $(CC). 295 ccflags-y specifies options for compiling with $(CC).
296 296
@@ -317,10 +317,10 @@ more details, with real examples.
317 317
318 subdir-ccflags-y, subdir-asflags-y 318 subdir-ccflags-y, subdir-asflags-y
319 The two flags listed above are similar to ccflags-y and asflags-y. 319 The two flags listed above are similar to ccflags-y and asflags-y.
320 The difference is that the subdir- variants affect the kbuild 320 The difference is that the subdir- variants have effect for the kbuild
321 file where they are present and all subdirectories. Options specified 321 file where they are present and all subdirectories.
322 using subdir-* are added to the commandline before the options 322 Options specified using subdir-* are added to the commandline before
323 specified using the non-subdir variants. 323 the options specified using the non-subdir variants.
324 324
325 Example: 325 Example:
326 subdir-ccflags-y := -Werror 326 subdir-ccflags-y := -Werror
@@ -1174,14 +1174,14 @@ When kbuild executes, the following steps are followed (roughly):
1174=== 7 Kbuild syntax for exported headers 1174=== 7 Kbuild syntax for exported headers
1175 1175
1176The kernel include a set of headers that is exported to userspace. 1176The kernel include a set of headers that is exported to userspace.
1177Many headers can be exported as-is but other headers requires a 1177Many headers can be exported as-is but other headers require a
1178minimal pre-processing before they are ready for user-space. 1178minimal pre-processing before they are ready for user-space.
1179The pre-processing does: 1179The pre-processing does:
1180- drop kernel specific annotations 1180- drop kernel specific annotations
1181- drop include of compiler.h 1181- drop include of compiler.h
1182- drop all sections that is kernel internat (guarded by ifdef __KERNEL__) 1182- drop all sections that are kernel internal (guarded by ifdef __KERNEL__)
1183 1183
1184Each relevant directory contain a file name "Kbuild" which specify the 1184Each relevant directory contains a file name "Kbuild" which specifies the
1185headers to be exported. 1185headers to be exported.
1186See subsequent chapter for the syntax of the Kbuild file. 1186See subsequent chapter for the syntax of the Kbuild file.
1187 1187