scc

 1.TH SCC-RANLIB 1 scc\-VERSION
 2.SH NAME
 3scc-ranlib \- generate index to archive
 4.SH SYNOPSIS
 5.B scc-ranlib
 6.RB [ \-t ]
 7.I archive ...
 8.SH DESCRIPTION
 9.B scc-ranlib
10generates a symbol index for each
11.I archive
12and adds it as the first member of the archive.
13The index maps each exported symbol defined in an object file member
14to the offset of that member within the archive.
15This index allows the linker to quickly locate the object files needed
16to resolve external references without scanning the entire archive.
17.PP
18If an archive already contains a symbol index, it is replaced.
19The index member is named
20.B /
21for archives of ELF or COFF object files or
22.B __.SYMDEF
23for archives of other supported formats.
24.SH OPTIONS
25.TP
26.B \-t
27Accepted for compatibility with other implementations of
28.BR scc-ranlib (1)
29but has no effect.
30.SH OPERANDS
31.TP
32.I archive
33The pathname of an archive file to be indexed.
34One or more archive files must be specified.
35.SH EXAMPLES
36Generate a symbol index for a library archive:
37.IP
38.EX
39scc-ranlib libfoo.a
40.EE
41.PP
42Generate a symbol index for multiple archives at once:
43.IP
44.EX
45scc-ranlib libfoo.a libbar.a
46.EE
47.SH DIAGNOSTICS
48Error messages are written to standard error and have the format:
49.IP
50.EX
51scc-ranlib: archive: message
52.EE
53.PP
54If a member within the archive caused the error, the format is:
55.IP
56.EX
57scc-ranlib: archive: member: message
58.EE
59.SH SEE ALSO
60.BR scc-ar (1),
61.BR scc-ld (1),
62.BR scc-nm (1)