Hi Linus, documentation for the newly added lib-y.
Sam
===== Documentation/kbuild/makefiles.txt 1.8 vs edited =====
--- 1.8/Documentation/kbuild/makefiles.txt Sun Mar 16 06:52:28 2003
+++ edited/Documentation/kbuild/makefiles.txt Sun Jun 8 19:55:25 2003
@@ -11,7 +11,7 @@
--- 3.2 Built-in object goals - obj-y
--- 3.3 Loadable module goals - obj-m
--- 3.4 Objects which export symbols
- --- 3.5 Library file goals - L_TARGET
+ --- 3.5 Library file goals - lib-y
--- 3.6 Descending down in directories
--- 3.7 Compilation flags
--- 3.8 Command line dependency
@@ -214,20 +214,33 @@
modules exporting symbols.
See also Documentation/modules.txt.
---- 3.5 Library file goals - L_TARGET
+--- 3.5 Library file goals - lib-y
- Instead of building a built-in.o file, you may also
- build an archive which again contains objects listed in $(obj-y).
- This is normally not necessary and only used in lib/ and
- arch/$(ARCH)/lib directories.
- Only the name lib.a is allowed.
+ Objects listed with obj-* is used for modules or
+ are combined in a built-in.o for that specific directory.
+ There is also the possibility to list objects that will
+ be included in a library, lib.a.
+ All objects listed with lib-y are combined in a single
+ library for that directory.
+ Objects that are listed in obj-y and additional listed in
+ lib-y will not be included in the library, since they will anyway
+ be accessible.
+ For consistency objects listed in lib-m will be included in lib.a.
+
+ Note that the same kbuild makefile may list files to be built-in
+ and to be part of a library. Therefore the same directory
+ may contain both a built-in.o and a lib.a file.
Example:
#arch/i386/lib/Makefile
- L_TARGET := lib.a
- obj-y := checksum.o delay.o
+ lib-y := checksum.o delay.o
This will create a library lib.a based on checksum.o and delay.o.
+ For kbuild to actually recognize that there is a lib.a being build
+ the directory shall be listed in libs-y.
+ See also "6.3 List directories to visit when descending".
+
+ Usage of lib-y is normally restricted to lib/ and arch/*/lib.
--- 3.6 Descending down in directories
@@ -727,7 +740,7 @@
head-y, init-y, core-y, libs-y, drivers-y, net-y
$(head-y) list objects to be linked first in vmlinux.
- $(libs-y) list directories where a libs.a archive can be located.
+ $(libs-y) list directories where a lib.a archive can be located.
The rest list directories where a built-in.o object file can be located.
$(init-y) objects will be located after $(head-y).
Hi Sam.
> Hi Linus, documentation for the newly added lib-y.
Minor grammatical tweaks to the same...
> ===== Documentation/kbuild/makefiles.txt 1.8 vs edited =====
> --- 1.8/Documentation/kbuild/makefiles.txt Sun Mar 16 06:52:28 2003
> +++ edited/Documentation/kbuild/makefiles.txt Sun Jun 8
> @@ -214,20 +214,33 @@
> modules exporting symbols.
> See also Documentation/modules.txt.
>
> ---- 3.5 Library file goals - L_TARGET
> +--- 3.5 Library file goals - lib-y
>
> - Instead of building a built-in.o file, you may also
> - build an archive which again contains objects listed in $(obj-y).
> - This is normally not necessary and only used in lib/ and
> - arch/$(ARCH)/lib directories.
> - Only the name lib.a is allowed.
> + Objects listed with obj-* is used for modules or
^^
That should be "are" ?
> + are combined in a built-in.o for that specific directory.
^^^
That shouldn't be there.
Best wishes from Riley.
---
* Nothing as pretty as a smile, nothing as ugly as a frown.
---
Outgoing mail is certified Virus Free.
Checked by AVG anti-virus system (http://www.grisoft.com).
Version: 6.0.490 / Virus Database: 289 - Release Date: 16-Jun-2003
On Tue, Jun 17, 2003 at 11:16:15PM +0100, Riley Williams wrote:
> Hi Sam.
>
> > Hi Linus, documentation for the newly added lib-y.
>
> Minor grammatical tweaks to the same...
Thanks, done.
Sam