diff options
| -rw-r--r-- | Documentation/kbuild/kbuild.txt | 8 | ||||
| -rw-r--r-- | Documentation/kbuild/makefiles.txt | 24 |
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 | |||
| 40 | modules. | 40 | modules. |
| 41 | The directory can be specified in several ways: | 41 | The directory can be specified in several ways: |
| 42 | 1) Use "M=..." on the command line | 42 | 1) Use "M=..." on the command line |
| 43 | 2) Environmnet variable KBUILD_EXTMOD | 43 | 2) Environment variable KBUILD_EXTMOD |
| 44 | 3) Environmnet variable SUBDIRS | 44 | 3) Environment variable SUBDIRS |
| 45 | The possibilities are listed in the order they take precedence. | 45 | The possibilities are listed in the order they take precedence. |
| 46 | Using "M=..." will always override the others. | 46 | Using "M=..." will always override the others. |
| 47 | 47 | ||
| 48 | KBUILD_OUTPUT | 48 | KBUILD_OUTPUT |
| 49 | -------------------------------------------------- | 49 | -------------------------------------------------- |
| 50 | Specify the output directory when building the kernel. | 50 | Specify the output directory when building the kernel. |
| 51 | The output directory can also be specificed using "O=...". | 51 | The output directory can also be specified using "O=...". |
| 52 | Setting "O=..." takes precedence over KBUILD_OUTPUT. | 52 | Setting "O=..." takes precedence over KBUILD_OUTPUT. |
| 53 | 53 | ||
| 54 | ARCH | 54 | ARCH |
| @@ -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 | ||
| 93 | The implmentation of "make install" is architecture specific | 93 | The implementation of "make install" is architecture specific |
| 94 | and it may differ from the above. | 94 | and it may differ from the above. |
| 95 | 95 | ||
| 96 | INSTALLKERNEL is provided to enable the possibility to | 96 | INSTALLKERNEL 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 | ||
| 1176 | The kernel include a set of headers that is exported to userspace. | 1176 | The kernel include a set of headers that is exported to userspace. |
| 1177 | Many headers can be exported as-is but other headers requires a | 1177 | Many headers can be exported as-is but other headers require a |
| 1178 | minimal pre-processing before they are ready for user-space. | 1178 | minimal pre-processing before they are ready for user-space. |
| 1179 | The pre-processing does: | 1179 | The 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 | ||
| 1184 | Each relevant directory contain a file name "Kbuild" which specify the | 1184 | Each relevant directory contains a file name "Kbuild" which specifies the |
| 1185 | headers to be exported. | 1185 | headers to be exported. |
| 1186 | See subsequent chapter for the syntax of the Kbuild file. | 1186 | See subsequent chapter for the syntax of the Kbuild file. |
| 1187 | 1187 | ||
