scc-ranlib.1 (1660B)
1 .TH 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 EXIT STATUS 36 .TP 37 .B 0 38 Successful completion. 39 .TP 40 .B >0 41 An error occurred processing one or more archives. 42 .SH EXAMPLES 43 Generate a symbol index for a library archive: 44 .IP 45 .EX 46 scc-ranlib libfoo.a 47 .EE 48 .PP 49 Generate a symbol index for multiple archives at once: 50 .IP 51 .EX 52 scc-ranlib libfoo.a libbar.a 53 .EE 54 .SH DIAGNOSTICS 55 Error messages are written to standard error and have the format: 56 .IP 57 .EX 58 scc-ranlib: archive: message 59 .EE 60 .PP 61 If a member within the archive caused the error, the format is: 62 .IP 63 .EX 64 scc-ranlib: archive: member: message 65 .EE 66 .SH AUTHORS 67 See the LICENSE file for the authors. 68 .SH LICENSE 69 See the LICENSE file for the terms of redistribution. 70 .SH SEE ALSO 71 .BR scc-ar (1), 72 .BR scc-ld (1), 73 .BR scc-nm (1)