diff options
-rw-r--r-- | Documentation/kbuild/kbuild.txt | 29 |
1 files changed, 15 insertions, 14 deletions
diff --git a/Documentation/kbuild/kbuild.txt b/Documentation/kbuild/kbuild.txt index 923f9ddee8f6..f3355b6812df 100644 --- a/Documentation/kbuild/kbuild.txt +++ b/Documentation/kbuild/kbuild.txt | |||
@@ -3,7 +3,7 @@ Environment variables | |||
3 | KCPPFLAGS | 3 | KCPPFLAGS |
4 | -------------------------------------------------- | 4 | -------------------------------------------------- |
5 | Additional options to pass when preprocessing. The preprocessing options | 5 | Additional options to pass when preprocessing. The preprocessing options |
6 | will be used in all cases where kbuild do preprocessing including | 6 | will be used in all cases where kbuild does preprocessing including |
7 | building C files and assembler files. | 7 | building C files and assembler files. |
8 | 8 | ||
9 | KAFLAGS | 9 | KAFLAGS |
@@ -16,7 +16,7 @@ Additional options to the C compiler. | |||
16 | 16 | ||
17 | KBUILD_VERBOSE | 17 | KBUILD_VERBOSE |
18 | -------------------------------------------------- | 18 | -------------------------------------------------- |
19 | Set the kbuild verbosity. Can be assinged same values as "V=...". | 19 | Set the kbuild verbosity. Can be assigned same values as "V=...". |
20 | See make help for the full list. | 20 | See make help for the full list. |
21 | Setting "V=..." takes precedence over KBUILD_VERBOSE. | 21 | Setting "V=..." takes precedence over KBUILD_VERBOSE. |
22 | 22 | ||
@@ -35,14 +35,14 @@ KBUILD_OUTPUT | |||
35 | -------------------------------------------------- | 35 | -------------------------------------------------- |
36 | Specify the output directory when building the kernel. | 36 | Specify the output directory when building the kernel. |
37 | The output directory can also be specificed using "O=...". | 37 | The output directory can also be specificed using "O=...". |
38 | Setting "O=..." takes precedence over KBUILD_OUTPUT | 38 | Setting "O=..." takes precedence over KBUILD_OUTPUT. |
39 | 39 | ||
40 | ARCH | 40 | ARCH |
41 | -------------------------------------------------- | 41 | -------------------------------------------------- |
42 | Set ARCH to the architecture to be built. | 42 | Set ARCH to the architecture to be built. |
43 | In most cases the name of the architecture is the same as the | 43 | In most cases the name of the architecture is the same as the |
44 | directory name found in the arch/ directory. | 44 | directory name found in the arch/ directory. |
45 | But some architectures suach as x86 and sparc has aliases. | 45 | But some architectures such as x86 and sparc have aliases. |
46 | x86: i386 for 32 bit, x86_64 for 64 bit | 46 | x86: i386 for 32 bit, x86_64 for 64 bit |
47 | sparc: sparc for 32 bit, sparc64 for 64 bit | 47 | sparc: sparc for 32 bit, sparc64 for 64 bit |
48 | 48 | ||
@@ -63,7 +63,7 @@ CF is often used on the command-line like this: | |||
63 | INSTALL_PATH | 63 | INSTALL_PATH |
64 | -------------------------------------------------- | 64 | -------------------------------------------------- |
65 | INSTALL_PATH specifies where to place the updated kernel and system map | 65 | INSTALL_PATH specifies where to place the updated kernel and system map |
66 | images. Default is /boot, but you can set it to other values | 66 | images. Default is /boot, but you can set it to other values. |
67 | 67 | ||
68 | 68 | ||
69 | MODLIB | 69 | MODLIB |
@@ -90,7 +90,7 @@ INSTALL_MOD_STRIP will used as the options to the strip command. | |||
90 | 90 | ||
91 | INSTALL_FW_PATH | 91 | INSTALL_FW_PATH |
92 | -------------------------------------------------- | 92 | -------------------------------------------------- |
93 | INSTALL_FW_PATH specify where to install the firmware blobs. | 93 | INSTALL_FW_PATH specifies where to install the firmware blobs. |
94 | The default value is: | 94 | The default value is: |
95 | 95 | ||
96 | $(INSTALL_MOD_PATH)/lib/firmware | 96 | $(INSTALL_MOD_PATH)/lib/firmware |
@@ -99,7 +99,7 @@ The value can be overridden in which case the default value is ignored. | |||
99 | 99 | ||
100 | INSTALL_HDR_PATH | 100 | INSTALL_HDR_PATH |
101 | -------------------------------------------------- | 101 | -------------------------------------------------- |
102 | INSTALL_HDR_PATH specify where to install user space headers when | 102 | INSTALL_HDR_PATH specifies where to install user space headers when |
103 | executing "make headers_*". | 103 | executing "make headers_*". |
104 | The default value is: | 104 | The default value is: |
105 | 105 | ||
@@ -112,22 +112,23 @@ The value can be overridden in which case the default value is ignored. | |||
112 | 112 | ||
113 | KBUILD_MODPOST_WARN | 113 | KBUILD_MODPOST_WARN |
114 | -------------------------------------------------- | 114 | -------------------------------------------------- |
115 | KBUILD_MODPOST_WARN can be set to avoid error out in case of undefined | 115 | KBUILD_MODPOST_WARN can be set to avoid errors in case of undefined |
116 | symbols in the final module linking stage. | 116 | symbols in the final module linking stage. It changes such errors |
117 | into warnings. | ||
117 | 118 | ||
118 | KBUILD_MODPOST_FINAL | 119 | KBUILD_MODPOST_NOFINAL |
119 | -------------------------------------------------- | 120 | -------------------------------------------------- |
120 | KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules. | 121 | KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules. |
121 | This is solely usefull to speed up test compiles. | 122 | This is solely useful to speed up test compiles. |
122 | 123 | ||
123 | KBUILD_EXTRA_SYMBOLS | 124 | KBUILD_EXTRA_SYMBOLS |
124 | -------------------------------------------------- | 125 | -------------------------------------------------- |
125 | For modules use symbols from another modules. | 126 | For modules that use symbols from other modules. |
126 | See more details in modules.txt. | 127 | See more details in modules.txt. |
127 | 128 | ||
128 | ALLSOURCE_ARCHS | 129 | ALLSOURCE_ARCHS |
129 | -------------------------------------------------- | 130 | -------------------------------------------------- |
130 | For tags/TAGS/cscope targets, you can specify more than one archs | 131 | For tags/TAGS/cscope targets, you can specify more than one arch |
131 | to be included in the databases, separated by blankspace. e.g. | 132 | to be included in the databases, separated by blank space. E.g.: |
132 | 133 | ||
133 | $ make ALLSOURCE_ARCHS="x86 mips arm" tags | 134 | $ make ALLSOURCE_ARCHS="x86 mips arm" tags |