scc-objdump.1 (4284B)
1 .TH OBJDUMP 1 scc\-VERSION 2 .SH NAME 3 scc-objdump \- display information from object files 4 .SH SYNOPSIS 5 .B scc-objdump 6 .RB [ \-afhps ] 7 .RB [ \-t ] 8 .RB [ \-j 9 .IR section ] 10 .RI [ file ...] 11 .SH DESCRIPTION 12 .B scc-objdump 13 displays information about one or more object files. 14 The options control what information is displayed. 15 .PP 16 If no 17 .I file 18 arguments are given, 19 .B scc-objdump 20 reads from 21 .B a.out 22 by default. 23 .PP 24 At least one of the 25 .BR \-a , 26 .BR \-f , 27 .BR \-h , 28 .BR \-t , 29 or 30 .B \-s 31 options must be specified. 32 .PP 33 Archive libraries are also accepted, in which case 34 .B scc-objdump 35 processes each object file member within the archive. 36 .SH OPTIONS 37 .TP 38 .B \-a 39 If any of the 40 .I files 41 are archives, display the archive header information for each member 42 (file permissions, owner, group, size, and date) in a format similar to 43 .BR ls (1) 44 .BR \-l . 45 .TP 46 .B \-f 47 Display summary information from the file header of each 48 .IR file . 49 This includes the architecture name, the file flags in hexadecimal, 50 and the start address. 51 .PP 52 .RS 53 The file flags field is followed by a comma-separated list of the 54 flag names that are set, which may include: 55 .PP 56 .RS 57 .PD 0 58 .TP 59 .B HAS_RELOC 60 The file contains relocation entries. 61 .TP 62 .B EXEC_P 63 The file is an executable. 64 .TP 65 .B HAS_LINENO 66 The file contains line number information. 67 .TP 68 .B HAS_DEBUG 69 The file contains debugging information. 70 .TP 71 .B HAS_SYMS 72 The file contains a symbol table. 73 .TP 74 .B HAS_LOCALS 75 The file contains local symbols. 76 .TP 77 .B DYNAMIC 78 The file is a dynamically linked object. 79 .PD 80 .RE 81 .RE 82 .TP 83 .B \-h 84 Display summary information from the section headers of each 85 .IR file . 86 For each section, the output includes the section index, name, size, 87 virtual memory address (VMA), load memory address (LMA), file offset, 88 alignment (as a power of two), and a set of flags. 89 .PP 90 .RS 91 The section flags that may appear include: 92 .PP 93 .RS 94 .PD 0 95 .TP 96 .B CONTENTS 97 The section has contents stored in the file. 98 .TP 99 .B ALLOC 100 The section is allocated in memory at runtime. 101 .TP 102 .B LOAD 103 The section is loaded from the file into memory. 104 .TP 105 .B RELOC 106 The section has relocation entries. 107 .TP 108 .B READONLY 109 The section is not writable. 110 .TP 111 .B CODE 112 The section contains executable code. 113 .TP 114 .B DATA 115 The section contains initialised data. 116 .TP 117 .B DEBUGGING 118 The section contains debugging information. 119 .PD 120 .RE 121 .RE 122 .TP 123 .B \-p 124 When combined with 125 .BR \-h , 126 also display the full contents of each section using the 127 format-specific representation. 128 This option has no effect without 129 .BR \-h . 130 .TP 131 .B \-s 132 Display the full contents of all sections in hex and ASCII. 133 For each section that is allocated and non-empty, the output includes 134 the section name followed by rows of 16 bytes. 135 Each row shows the VMA-relative offset, the bytes in hexadecimal, 136 and a printable ASCII representation enclosed in 137 .B | 138 characters, with non-printable bytes shown as 139 .BR . . 140 .TP 141 .B \-t 142 Display the symbol table of each 143 .IR file . 144 The exact format depends on the object file format. 145 .TP 146 .BI \-j " section" 147 Display information only for the named 148 .IR section . 149 This option may be specified multiple times to select more than one section. 150 When no 151 .B \-j 152 option is given, all sections are processed. 153 .SH OPERANDS 154 .TP 155 .I file 156 A pathname of an object file or archive library to examine. 157 If no operands are given, 158 .B scc-objdump 159 reads from 160 .BR a.out . 161 .SH EXIT STATUS 162 .TP 163 .B 0 164 Successful completion. 165 .TP 166 .B >0 167 An error occurred. 168 .SH EXAMPLES 169 Display file header information for an object file: 170 .IP 171 .EX 172 scc-objdump \-f foo.o 173 .EE 174 .PP 175 Display section headers for an object file: 176 .IP 177 .EX 178 scc-objdump \-h foo.o 179 .EE 180 .PP 181 Display symbol table for an object file: 182 .IP 183 .EX 184 scc-objdump \-t foo.o 185 .EE 186 .PP 187 Display hex contents of all sections: 188 .IP 189 .EX 190 scc-objdump \-s foo.o 191 .EE 192 .PP 193 Display file header and section headers together: 194 .IP 195 .EX 196 scc-objdump \-fh foo.o 197 .EE 198 .PP 199 Display section headers and hex contents of a specific section: 200 .IP 201 .EX 202 scc-objdump \-hs \-j .text foo.o 203 .EE 204 .PP 205 Display archive member headers and symbol tables for all members: 206 .IP 207 .EX 208 scc-objdump \-at libfoo.a 209 .EE 210 .PP 211 Display all available information: 212 .IP 213 .EX 214 scc-objdump \-afhst foo.o 215 .EE 216 .SH LICENSE 217 See the LICENSE file for the terms of redistribution. 218 .SH SEE ALSO 219 .BR scc-nm (1), 220 .BR scc-size (1), 221 .BR scc-strip (1), 222 .BR scc-ar (1), 223 .BR scc-ranlib (1)