7.4 Archiver Examples

The following are examples of typical archiver operations:

• If you want to create a library called function.lib that contains the files sine.obj, cos.obj, and flt.obj, enter:
ar430 -a function sine.obj cos.obj flt.obj

The archiver responds as follows:

==> new archive 'function.lib' ==> building new archive 'function.lib'
• You can print a table of contents of function.lib with the -t command, enter:
ar430 -t function

The archiver responds as follows:

SIZE DATE FILE NAME -------- ------------------------ ----------------- 4260 Thu Mar 28 15:38:18 2019 sine.obj 4260 Thu Mar 28 15:38:18 2019 cos.obj 4260 Thu Mar 28 15:38:18 2019 flt.obj
• If you want to add new members to the library, enter:
ar430 -as function atan.obj

The archiver responds as follows:

==> symbol defined: '_sin' ==> symbol defined: '_cos' ==> symbol defined: '_tan' ==> symbol defined: '_atan ==> building archive 'function.lib'

Because this example does not specify an extension for the libname, the archiver adds the files to the library called function.lib. If function.lib does not exist, the archiver creates it. (The -s option tells the archiver to list the global symbols that are defined in the library.)

• If you want to modify a library member, you can extract it, edit it, and replace it. In this example, assume there is a library named macros.lib that contains the members push.asm, pop.asm, and swap.asm.
ar430 -x macros push.asm

The archiver makes a copy of push.asm and places it in the current directory; it does not remove push.asm from the library. Now you can edit the extracted file. To replace the copy of push.asm in the library with the edited copy, enter:

ar430 -r macros push.asm
• If you want to use a command file, specify the command filename after the -@ command. For example:
ar430 -@modules.cmd

The archiver responds as follows:

==> building archive 'modules.lib'

Example 1 is the modules.cmd command file. The r command specifies that the filenames given in the command file replace files of the same name in the modules.lib library. The -u option specifies that these files are replaced only when the current file has a more recent revision date than the file that is in the library.