be3
Updating Archive Symbol Directories
Contents|Index|Previous|Next
Updating Archive Symbol Directories
An archive file that is used as a library usually contains a special member
named __.SYMDEF which contains a directory of the external symbol names defined by all the
other members.
After you update any other members, you need to update
__.SYMDEF so that it will summarize the other members properly. This is done by
running the ranlib program: ranlib archivefile.
Normally you would put this command in the rule for the archive file, and make
all the members of the archive file dependencies of that rule. Use the
following example, for instance.
libfoo.a: libfoo.a(x.o) libfoo.a(y.o) ...
ranlib libfoo.a
The effect of this is to update archive members x.o, y.o, etc., and then update the symbol directory member, __.SYMDEF, by running ranlib. The rules for updating the members are not shown here; most likely you can
omit them and use the implicit rule which copies files into the archive, as
described in the preceding section (see Implicit Rule for Archive Member Targets for more information).
This is not necessary when using the GNU
ar program which automatically updates the __.SYMDEF member. See ar in The GNU Binary Utilities in GNUPro Utilities.
0