16.4 xc32-ranlib Utility

The xc32-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 xc32-nm -s or xc32 --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 xc32-ranlib is completely equivalent to executing xc32-ar -s (i.e., the MPLAB XC32 archiver/librarian with the -s option).