Link Archiver: Difference between revisions

From OSDev.wiki
Jump to navigation Jump to search
[unchecked revision][unchecked revision]
Content added Content deleted
No edit summary
 
(Fixed article up a bit.)
Line 1: Line 1:
{{Convert}}
{{Convert}}
==GNU ar==
GNU ar is a utility that archives a series of files. It is used to take a group of files, and combine them all into one. This allows one to then compress, send, or most importantly and commonly, link the files into a program.


The tool itself is about as simple as its purpose. To archive a series of object files:
You have many object files and your linking line for a program in your OS grows longer and longer? GNU AR helps.
ar -rcs archive.a obj_fil1.o obj_fil2.o obj_fil3.o obj_fil4.o ... obj_filN.o


Then, to link against them:
It creates archives of object files alongside with a table of the symbols, which each object file (==member) sports.
cc example.c archive.a -o example.bin


'''Important''': If you link other object files besides the library ''archive.a'', take care that the ''archive.a'' is right behind these object files (or have it be the very last file in the list of files to link) - so the linker can resolve the one or other occurrence of a symbol which is covered by some member of the ''archive.a'' library.
USAGE: =ar -rcs archive.a obj_fil1.o obj_fil2.o obj_fil3.o obj_fil4.o ... obj_filN.o=


==See Also==
You link your program's object file against =crt0.o= and the =archive.a= file.
*[http://www.gnu.org/software/binutils/manual/html_chapter/binutils_1.html GNU 'ar' online manual].

Important: If you link other object files besides the library =archive.a=, take care that the =archive.a= is right behind these object files (or have it be the very last file in the list of files to link) - so the linker can resolve the one or other occurrence of a symbol which is covered by some member of the =archive.a= library.

See also the [GNU 'ar' online manual | http://www.gnu.org/software/binutils/manual/html_chapter/binutils_1.html].

Revision as of 04:22, 7 July 2007

Template:Convert

GNU ar

GNU ar is a utility that archives a series of files. It is used to take a group of files, and combine them all into one. This allows one to then compress, send, or most importantly and commonly, link the files into a program.

The tool itself is about as simple as its purpose. To archive a series of object files:

ar -rcs archive.a obj_fil1.o obj_fil2.o obj_fil3.o obj_fil4.o ... obj_filN.o

Then, to link against them:

cc example.c archive.a -o example.bin

Important: If you link other object files besides the library archive.a, take care that the archive.a is right behind these object files (or have it be the very last file in the list of files to link) - so the linker can resolve the one or other occurrence of a symbol which is covered by some member of the archive.a library.

See Also