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