10.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:

    ar7x -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:

    ar7x -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:

    ar7x -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 sine.obj that contains the members push.asm, pop.asm, and swap.asm.

ar7x -x function sine.obj

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

ar7x -r function sine.obj

If you want to use a command file, specify the command filename after the -@ command. For example:

ar7x -@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.