16.4 xc-dsc-ranlib Utility

The xc-dsc-ranlib utility generates an index to the contents of an archive and stores it in the archive. The index lists each symbol defined by a member of an archive that is a relocatable object file. You may use xc-dsc-nm -s or xc-dsc --print-armap to list this index. An archive with such an index speeds up linking to the library and allows routines in the library to call each other without regard to their placement in the archive.

Running xc-dsc-ranlib is completely equivalent to executing xc-dsc-ar -s (i.e., the MPLAB XC-DSC archiver/librarian with the -s option).