The ARM Librarian

armlib

SYNOPSIS

       armlib [options] [library] [file-list | member-list]

DESCRIPTION

       The  ARM  Librarian allows sets of related AOF files to be
       collected together, and for  these libraries to  be  main-
       tained.   Such a  library can then be passed to the linker
       instead of several AOF files.  However,  linking  with  an
       object  library file does not necessarily produce the same
       results as linking with all  the  object  files  collected
       into the object library file.  This is due to the way arm-
       link processes its input files:

       o   each object file in the input list appears in the out-
           put  unconditionally  (although   unused areas will be
           eliminated if the output is AIF or if the -NOUNUSEDar-
           eas option is specified);

       o   a  module  from  a libray file is only included in the
           output if an  object  file,  or  previously  processed
           library file refers to it.

       For  more  information  on how armlink processes its input
       files refer to "Area Placement and Sorting Rules"  of  the
       Reference  Manual.   The  full specification of ARM Object
       Library Format can  be  found  in  chapter  "  ARM  Object
       Library Format" of the Technical Specifications.

OPTIONS

       The  wildcards  '*'  and '?' may be used in  file-list and
       member-list.  options can be any of the following:

       -h or -help
              give on-line details of the armlib command;

       -c     create a new library containing files in file-list;

       -i     insert files in file-list into the library.  Exist-
              ing members of the library are replaced by mermbers
              of the same name;

       -d     delete members in member-list

       -e     extract  members  in  member-list, placing them  in
              files of the same name;

       -o     add an external symbol table to an object library;

       -l     list library.  This may be specified together  with
              any other option;
              with any other option;

       -v file
              Additional arguments are read in from a  via  file,
              in the same way as the armlink -via option.

SEE ALSO

       armlink(1)
       Reference Manual, Technical Specifications