2009-12-07 15:38:33 +00:00
|
|
|
Output files
|
|
|
|
|
|
|
|
modules.order
|
|
|
|
--------------------------------------------------
|
|
|
|
This file records the order in which modules appear in Makefiles. This
|
|
|
|
is used by modprobe to deterministically resolve aliases that match
|
|
|
|
multiple modules.
|
|
|
|
|
|
|
|
modules.builtin
|
|
|
|
--------------------------------------------------
|
|
|
|
This file lists all modules that are built into the kernel. This is used
|
|
|
|
by modprobe to not fail when trying to load something builtin.
|
|
|
|
|
|
|
|
|
2008-12-29 12:45:52 +00:00
|
|
|
Environment variables
|
|
|
|
|
|
|
|
KCPPFLAGS
|
|
|
|
--------------------------------------------------
|
|
|
|
Additional options to pass when preprocessing. The preprocessing options
|
2009-01-08 18:59:34 +00:00
|
|
|
will be used in all cases where kbuild does preprocessing including
|
2008-12-29 12:45:52 +00:00
|
|
|
building C files and assembler files.
|
|
|
|
|
|
|
|
KAFLAGS
|
|
|
|
--------------------------------------------------
|
kbuild: allow assignment to {A,C,LD}FLAGS_MODULE on the command line
It is now possible to assign options to AS, CC and LD
on the command line - which is only used when building modules.
{A,C,LD}FLAGS_MODULE was all used both in the top-level Makefile
in the arch makefiles, thus users had no way to specify
additional options to AS, CC, LD when building modules
without overriding the original value.
Introduce a new set of variables KBUILD_{A,C,LD}FLAGS_MODULE
that is used by arch specific files and free up
{A,C,LD}FLAGS_MODULE so they can be assigned on
the command line.
All arch Makefiles that used the old variables has been updated.
Note: Previously we had a MODFLAGS variable for both
AS and CC. But in favour of consistency this was dropped.
So in some cases arch Makefile has one assignmnet replaced by
two assignmnets.
Note2: MODFLAGS was not documented and is dropped
without any notice. I do not expect much/any breakage
from this.
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
Cc: Denys Vlasenko <vda.linux@googlemail.com>
Cc: Haavard Skinnemoen <hskinnemoen@atmel.com>
Cc: Mike Frysinger <vapier@gentoo.org>
Cc: Tony Luck <tony.luck@intel.com>
Cc: Geert Uytterhoeven <geert@linux-m68k.org>
Cc: Ralf Baechle <ralf@linux-mips.org>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Martin Schwidefsky <schwidefsky@de.ibm.com>
Cc: Chen Liqin <liqin.chen@sunplusct.com>
Acked-by: Mike Frysinger <vapier@gentoo.org> [blackfin]
Acked-by: Haavard Skinnemoen <haavard.skinnemoen@atmel.com> [avr32]
Signed-off-by: Michal Marek <mmarek@suse.cz>
2010-07-28 15:33:09 +00:00
|
|
|
Additional options to the assembler (for built-in and modules).
|
|
|
|
|
|
|
|
AFLAGS_MODULE
|
|
|
|
--------------------------------------------------
|
2011-03-31 01:57:33 +00:00
|
|
|
Additional module specific options to use for $(AS).
|
2008-12-29 12:45:52 +00:00
|
|
|
|
2010-07-28 17:11:27 +00:00
|
|
|
AFLAGS_KERNEL
|
|
|
|
--------------------------------------------------
|
2011-03-31 01:57:33 +00:00
|
|
|
Additional options for $(AS) when used for assembler
|
2010-07-28 17:11:27 +00:00
|
|
|
code for code that is compiled as built-in.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
KCFLAGS
|
|
|
|
--------------------------------------------------
|
kbuild: allow assignment to {A,C,LD}FLAGS_MODULE on the command line
It is now possible to assign options to AS, CC and LD
on the command line - which is only used when building modules.
{A,C,LD}FLAGS_MODULE was all used both in the top-level Makefile
in the arch makefiles, thus users had no way to specify
additional options to AS, CC, LD when building modules
without overriding the original value.
Introduce a new set of variables KBUILD_{A,C,LD}FLAGS_MODULE
that is used by arch specific files and free up
{A,C,LD}FLAGS_MODULE so they can be assigned on
the command line.
All arch Makefiles that used the old variables has been updated.
Note: Previously we had a MODFLAGS variable for both
AS and CC. But in favour of consistency this was dropped.
So in some cases arch Makefile has one assignmnet replaced by
two assignmnets.
Note2: MODFLAGS was not documented and is dropped
without any notice. I do not expect much/any breakage
from this.
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
Cc: Denys Vlasenko <vda.linux@googlemail.com>
Cc: Haavard Skinnemoen <hskinnemoen@atmel.com>
Cc: Mike Frysinger <vapier@gentoo.org>
Cc: Tony Luck <tony.luck@intel.com>
Cc: Geert Uytterhoeven <geert@linux-m68k.org>
Cc: Ralf Baechle <ralf@linux-mips.org>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Martin Schwidefsky <schwidefsky@de.ibm.com>
Cc: Chen Liqin <liqin.chen@sunplusct.com>
Acked-by: Mike Frysinger <vapier@gentoo.org> [blackfin]
Acked-by: Haavard Skinnemoen <haavard.skinnemoen@atmel.com> [avr32]
Signed-off-by: Michal Marek <mmarek@suse.cz>
2010-07-28 15:33:09 +00:00
|
|
|
Additional options to the C compiler (for built-in and modules).
|
|
|
|
|
2010-07-28 17:11:27 +00:00
|
|
|
CFLAGS_KERNEL
|
|
|
|
--------------------------------------------------
|
2011-03-31 01:57:33 +00:00
|
|
|
Additional options for $(CC) when used to compile
|
2010-07-28 17:11:27 +00:00
|
|
|
code that is compiled as built-in.
|
|
|
|
|
kbuild: allow assignment to {A,C,LD}FLAGS_MODULE on the command line
It is now possible to assign options to AS, CC and LD
on the command line - which is only used when building modules.
{A,C,LD}FLAGS_MODULE was all used both in the top-level Makefile
in the arch makefiles, thus users had no way to specify
additional options to AS, CC, LD when building modules
without overriding the original value.
Introduce a new set of variables KBUILD_{A,C,LD}FLAGS_MODULE
that is used by arch specific files and free up
{A,C,LD}FLAGS_MODULE so they can be assigned on
the command line.
All arch Makefiles that used the old variables has been updated.
Note: Previously we had a MODFLAGS variable for both
AS and CC. But in favour of consistency this was dropped.
So in some cases arch Makefile has one assignmnet replaced by
two assignmnets.
Note2: MODFLAGS was not documented and is dropped
without any notice. I do not expect much/any breakage
from this.
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
Cc: Denys Vlasenko <vda.linux@googlemail.com>
Cc: Haavard Skinnemoen <hskinnemoen@atmel.com>
Cc: Mike Frysinger <vapier@gentoo.org>
Cc: Tony Luck <tony.luck@intel.com>
Cc: Geert Uytterhoeven <geert@linux-m68k.org>
Cc: Ralf Baechle <ralf@linux-mips.org>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Martin Schwidefsky <schwidefsky@de.ibm.com>
Cc: Chen Liqin <liqin.chen@sunplusct.com>
Acked-by: Mike Frysinger <vapier@gentoo.org> [blackfin]
Acked-by: Haavard Skinnemoen <haavard.skinnemoen@atmel.com> [avr32]
Signed-off-by: Michal Marek <mmarek@suse.cz>
2010-07-28 15:33:09 +00:00
|
|
|
CFLAGS_MODULE
|
|
|
|
--------------------------------------------------
|
2011-03-31 01:57:33 +00:00
|
|
|
Additional module specific options to use for $(CC).
|
kbuild: allow assignment to {A,C,LD}FLAGS_MODULE on the command line
It is now possible to assign options to AS, CC and LD
on the command line - which is only used when building modules.
{A,C,LD}FLAGS_MODULE was all used both in the top-level Makefile
in the arch makefiles, thus users had no way to specify
additional options to AS, CC, LD when building modules
without overriding the original value.
Introduce a new set of variables KBUILD_{A,C,LD}FLAGS_MODULE
that is used by arch specific files and free up
{A,C,LD}FLAGS_MODULE so they can be assigned on
the command line.
All arch Makefiles that used the old variables has been updated.
Note: Previously we had a MODFLAGS variable for both
AS and CC. But in favour of consistency this was dropped.
So in some cases arch Makefile has one assignmnet replaced by
two assignmnets.
Note2: MODFLAGS was not documented and is dropped
without any notice. I do not expect much/any breakage
from this.
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
Cc: Denys Vlasenko <vda.linux@googlemail.com>
Cc: Haavard Skinnemoen <hskinnemoen@atmel.com>
Cc: Mike Frysinger <vapier@gentoo.org>
Cc: Tony Luck <tony.luck@intel.com>
Cc: Geert Uytterhoeven <geert@linux-m68k.org>
Cc: Ralf Baechle <ralf@linux-mips.org>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Martin Schwidefsky <schwidefsky@de.ibm.com>
Cc: Chen Liqin <liqin.chen@sunplusct.com>
Acked-by: Mike Frysinger <vapier@gentoo.org> [blackfin]
Acked-by: Haavard Skinnemoen <haavard.skinnemoen@atmel.com> [avr32]
Signed-off-by: Michal Marek <mmarek@suse.cz>
2010-07-28 15:33:09 +00:00
|
|
|
|
|
|
|
LDFLAGS_MODULE
|
|
|
|
--------------------------------------------------
|
|
|
|
Additional options used for $(LD) when linking modules.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
KBUILD_VERBOSE
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
Set the kbuild verbosity. Can be assigned same values as "V=...".
|
2008-12-29 12:45:52 +00:00
|
|
|
See make help for the full list.
|
|
|
|
Setting "V=..." takes precedence over KBUILD_VERBOSE.
|
|
|
|
|
|
|
|
KBUILD_EXTMOD
|
|
|
|
--------------------------------------------------
|
|
|
|
Set the directory to look for the kernel source when building external
|
|
|
|
modules.
|
|
|
|
The directory can be specified in several ways:
|
|
|
|
1) Use "M=..." on the command line
|
2010-08-05 18:23:11 +00:00
|
|
|
2) Environment variable KBUILD_EXTMOD
|
|
|
|
3) Environment variable SUBDIRS
|
2008-12-29 12:45:52 +00:00
|
|
|
The possibilities are listed in the order they take precedence.
|
|
|
|
Using "M=..." will always override the others.
|
|
|
|
|
|
|
|
KBUILD_OUTPUT
|
|
|
|
--------------------------------------------------
|
|
|
|
Specify the output directory when building the kernel.
|
2010-08-05 18:23:11 +00:00
|
|
|
The output directory can also be specified using "O=...".
|
2009-01-08 18:59:34 +00:00
|
|
|
Setting "O=..." takes precedence over KBUILD_OUTPUT.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
2010-12-12 17:39:40 +00:00
|
|
|
KBUILD_DEBARCH
|
|
|
|
--------------------------------------------------
|
|
|
|
For the deb-pkg target, allows overriding the normal heuristics deployed by
|
|
|
|
deb-pkg. Normally deb-pkg attempts to guess the right architecture based on
|
|
|
|
the UTS_MACHINE variable, and on some architectures also the kernel config.
|
|
|
|
The value of KBUILD_DEBARCH is assumed (not checked) to be a valid Debian
|
|
|
|
architecture.
|
|
|
|
|
2008-12-29 12:45:52 +00:00
|
|
|
ARCH
|
|
|
|
--------------------------------------------------
|
|
|
|
Set ARCH to the architecture to be built.
|
|
|
|
In most cases the name of the architecture is the same as the
|
|
|
|
directory name found in the arch/ directory.
|
2009-01-08 18:59:34 +00:00
|
|
|
But some architectures such as x86 and sparc have aliases.
|
2008-12-29 12:45:52 +00:00
|
|
|
x86: i386 for 32 bit, x86_64 for 64 bit
|
|
|
|
sparc: sparc for 32 bit, sparc64 for 64 bit
|
|
|
|
|
|
|
|
CROSS_COMPILE
|
|
|
|
--------------------------------------------------
|
|
|
|
Specify an optional fixed part of the binutils filename.
|
|
|
|
CROSS_COMPILE can be a part of the filename or the full path.
|
|
|
|
|
2010-02-17 08:45:33 +00:00
|
|
|
CROSS_COMPILE is also used for ccache in some setups.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
CF
|
|
|
|
--------------------------------------------------
|
|
|
|
Additional options for sparse.
|
|
|
|
CF is often used on the command-line like this:
|
|
|
|
|
|
|
|
make CF=-Wbitwise C=2
|
|
|
|
|
|
|
|
INSTALL_PATH
|
|
|
|
--------------------------------------------------
|
|
|
|
INSTALL_PATH specifies where to place the updated kernel and system map
|
2009-01-08 18:59:34 +00:00
|
|
|
images. Default is /boot, but you can set it to other values.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
2009-07-20 19:37:11 +00:00
|
|
|
INSTALLKERNEL
|
|
|
|
--------------------------------------------------
|
|
|
|
Install script called when using "make install".
|
|
|
|
The default name is "installkernel".
|
|
|
|
|
|
|
|
The script will be called with the following arguments:
|
|
|
|
$1 - kernel version
|
|
|
|
$2 - kernel image file
|
|
|
|
$3 - kernel map file
|
|
|
|
$4 - default install path (use root directory if blank)
|
|
|
|
|
2010-08-05 18:23:11 +00:00
|
|
|
The implementation of "make install" is architecture specific
|
2009-07-20 19:37:11 +00:00
|
|
|
and it may differ from the above.
|
|
|
|
|
|
|
|
INSTALLKERNEL is provided to enable the possibility to
|
|
|
|
specify a custom installer when cross compiling a kernel.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
MODLIB
|
|
|
|
--------------------------------------------------
|
|
|
|
Specify where to install modules.
|
|
|
|
The default value is:
|
|
|
|
|
|
|
|
$(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
|
|
|
|
|
|
|
|
The value can be overridden in which case the default value is ignored.
|
|
|
|
|
|
|
|
INSTALL_MOD_PATH
|
|
|
|
--------------------------------------------------
|
|
|
|
INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
|
|
|
|
relocations required by build roots. This is not defined in the
|
|
|
|
makefile but the argument can be passed to make if needed.
|
|
|
|
|
|
|
|
INSTALL_MOD_STRIP
|
|
|
|
--------------------------------------------------
|
|
|
|
INSTALL_MOD_STRIP, if defined, will cause modules to be
|
|
|
|
stripped after they are installed. If INSTALL_MOD_STRIP is '1', then
|
|
|
|
the default option --strip-debug will be used. Otherwise,
|
2011-01-09 07:59:49 +00:00
|
|
|
INSTALL_MOD_STRIP value will be used as the options to the strip command.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
INSTALL_FW_PATH
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
INSTALL_FW_PATH specifies where to install the firmware blobs.
|
2008-12-29 12:45:52 +00:00
|
|
|
The default value is:
|
|
|
|
|
|
|
|
$(INSTALL_MOD_PATH)/lib/firmware
|
|
|
|
|
|
|
|
The value can be overridden in which case the default value is ignored.
|
|
|
|
|
|
|
|
INSTALL_HDR_PATH
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
INSTALL_HDR_PATH specifies where to install user space headers when
|
2008-12-29 12:45:52 +00:00
|
|
|
executing "make headers_*".
|
|
|
|
The default value is:
|
|
|
|
|
|
|
|
$(objtree)/usr
|
|
|
|
|
|
|
|
$(objtree) is the directory where output files are saved.
|
|
|
|
The output directory is often set using "O=..." on the commandline.
|
|
|
|
|
|
|
|
The value can be overridden in which case the default value is ignored.
|
|
|
|
|
|
|
|
KBUILD_MODPOST_WARN
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
KBUILD_MODPOST_WARN can be set to avoid errors in case of undefined
|
|
|
|
symbols in the final module linking stage. It changes such errors
|
|
|
|
into warnings.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
2009-01-08 18:59:34 +00:00
|
|
|
KBUILD_MODPOST_NOFINAL
|
2008-12-29 12:45:52 +00:00
|
|
|
--------------------------------------------------
|
|
|
|
KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules.
|
2009-01-08 18:59:34 +00:00
|
|
|
This is solely useful to speed up test compiles.
|
2008-12-29 12:45:52 +00:00
|
|
|
|
|
|
|
KBUILD_EXTRA_SYMBOLS
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
For modules that use symbols from other modules.
|
2008-12-29 12:45:52 +00:00
|
|
|
See more details in modules.txt.
|
2009-01-05 06:57:03 +00:00
|
|
|
|
|
|
|
ALLSOURCE_ARCHS
|
|
|
|
--------------------------------------------------
|
2009-01-08 18:59:34 +00:00
|
|
|
For tags/TAGS/cscope targets, you can specify more than one arch
|
|
|
|
to be included in the databases, separated by blank space. E.g.:
|
2009-01-05 06:57:03 +00:00
|
|
|
|
|
|
|
$ make ALLSOURCE_ARCHS="x86 mips arm" tags
|
2010-03-02 15:57:52 +00:00
|
|
|
|
|
|
|
To get all available archs you can also specify all. E.g.:
|
|
|
|
|
|
|
|
$ make ALLSOURCE_ARCHS=all tags
|
2011-03-01 08:35:29 +00:00
|
|
|
|
|
|
|
KBUILD_ENABLE_EXTRA_GCC_CHECKS
|
|
|
|
--------------------------------------------------
|
|
|
|
If enabled over the make command line with "W=1", it turns on additional
|
|
|
|
gcc -W... options for more extensive build-time checking.
|