1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22 /*
23 * Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
24 */
25
26 /*
27 * Dump an elf file.
28 */
29 #include <sys/param.h>
30 #include <fcntl.h>
31 #include <stdio.h>
32 #include <stdlib.h>
33 #include <ctype.h>
34 #include <_libelf.h>
35 #include <link.h>
36 #include <stdarg.h>
37 #include <unistd.h>
38 #include <libgen.h>
39 #include <libintl.h>
40 #include <locale.h>
41 #include <errno.h>
42 #include <strings.h>
43 #include <debug.h>
44 #include <conv.h>
45 #include <msg.h>
46 #include <_elfdump.h>
47 #include <sys/elf_SPARC.h>
48 #include <sys/elf_amd64.h>
49
50
51 const Cache cache_init = {NULL, NULL, NULL, NULL, 0};
52
53
54
55 /*
56 * The -I, -N, and -T options are called "match options", because
57 * they allow selecting the items to be displayed based on matching
58 * their index, name, or type.
59 *
60 * The ELF information to which -I, -N, or -T are applied in
61 * the current invocation is called the "match item".
62 */
63 typedef enum {
64 MATCH_ITEM_PT, /* Program header (PT_) */
65 MATCH_ITEM_SHT /* Section header (SHT_) */
66 } match_item_t;
67
68 /* match_opt_t is used to note which match option was used */
69 typedef enum {
70 MATCH_OPT_NAME, /* Record contains a name */
71 MATCH_OPT_NDX, /* Record contains a single index */
72 MATCH_OPT_RANGE, /* Record contains an index range */
73 MATCH_OPT_TYPE, /* Record contains a type (shdr or phdr) */
74 } match_opt_t;
75
76 typedef struct _match {
77 struct _match *next; /* Pointer to next item in list */
78 match_opt_t opt_type;
79 union {
80 const char *name; /* MATCH_OPT_NAME */
81 struct { /* MATCH_OPT_NDX and MATCH_OPT_RANGE */
82 int start;
83 int end; /* Only for MATCH_OPT_RANGE */
84 } ndx;
85 uint32_t type; /* MATCH_OPT_TYPE */
86 } value;
87 } match_rec_t;
88
89 static struct {
90 match_item_t item_type; /* Type of item being matched */
91 match_rec_t *list; /* Records for (-I, -N, -T) options */
92 } match_state;
93
94
95
96 const char *
97 _elfdump_msg(Msg mid)
98 {
99 return (gettext(MSG_ORIG(mid)));
100 }
101
102 /*
103 * Determine whether a symbol name should be demangled.
104 */
105 const char *
106 demangle(const char *name, uint_t flags)
107 {
108 if (flags & FLG_CTL_DEMANGLE)
109 return (Elf_demangle_name(name));
110 else
111 return ((char *)name);
112 }
113
114 /*
115 * Define our own standard error routine.
116 */
117 void
118 failure(const char *file, const char *func)
119 {
120 (void) fprintf(stderr, MSG_INTL(MSG_ERR_FAILURE),
121 file, func, elf_errmsg(elf_errno()));
122 }
123
124 /*
125 * The full usage message
126 */
127 static void
128 detail_usage()
129 {
130 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL1));
131 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL2));
132 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL3));
133 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL4));
134 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL5));
135 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL6));
136 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL7));
137 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL8));
138 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL9));
139 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL10));
140 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL11));
141 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL12));
142 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL13));
143 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL14));
144 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL15));
145 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL16));
146 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL17));
147 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL18));
148 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL19));
149 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL20));
150 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL21));
151 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL22));
152 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL23));
153 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL24));
154 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL25));
155 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_DETAIL26));
156 }
157
158 /*
159 * Output a block of raw data as hex bytes. Each row is given
160 * the index of the first byte in the row.
161 *
162 * entry:
163 * data - Pointer to first byte of data to be displayed
164 * n - # of bytes of data
165 * prefix - String to be output before each line. Useful
166 * for indenting output.
167 * bytes_per_col - # of space separated bytes to output
168 * in each column.
169 * col_per_row - # of columns to output per row
170 *
171 * exit:
172 * The formatted data has been sent to stdout. Each row of output
173 * shows (bytes_per_col * col_per_row) bytes of data.
174 */
175 void
176 dump_hex_bytes(const void *data, size_t n, int indent,
177 int bytes_per_col, int col_per_row)
178 {
179 const uchar_t *ldata = data;
180 int bytes_per_row = bytes_per_col * col_per_row;
181 int ndx, byte, word;
182 char string[128], *str = string;
183 char index[MAXNDXSIZE];
184 int index_width;
185 int sp_prefix = 0;
186
187
188 /*
189 * Determine the width to use for the index string. We follow
190 * 8-byte tab rules, but don't use an actual \t character so
191 * that the output can be arbitrarily shifted without odd
192 * tab effects, and so that all the columns line up no matter
193 * how many lines of output are produced.
194 */
195 ndx = n / bytes_per_row;
196 (void) snprintf(index, sizeof (index),
197 MSG_ORIG(MSG_FMT_INDEX2), EC_WORD(ndx));
198 index_width = strlen(index);
199 index_width = S_ROUND(index_width, 8);
200
201 for (ndx = byte = word = 0; n > 0; n--, ldata++) {
202 while (sp_prefix-- > 0)
203 *str++ = ' ';
204
205 (void) snprintf(str, sizeof (string),
206 MSG_ORIG(MSG_HEXDUMP_TOK), (int)*ldata);
207 str += 2;
208 sp_prefix = 1;
209
210 if (++byte == bytes_per_col) {
211 sp_prefix += 2;
212 word++;
213 byte = 0;
214 }
215 if (word == col_per_row) {
216 *str = '\0';
217 (void) snprintf(index, sizeof (index),
218 MSG_ORIG(MSG_FMT_INDEX2), EC_WORD(ndx));
219 dbg_print(0, MSG_ORIG(MSG_HEXDUMP_ROW),
220 indent, MSG_ORIG(MSG_STR_EMPTY),
221 index_width, index, string);
222 sp_prefix = 0;
223 word = 0;
224 ndx += bytes_per_row;
225 str = string;
226 }
227 }
228 if (byte || word) {
229 *str = '\0'; /* */
230 (void) snprintf(index, sizeof (index),
231 MSG_ORIG(MSG_FMT_INDEX2), EC_WORD(ndx));
232 dbg_print(0, MSG_ORIG(MSG_HEXDUMP_ROW), indent,
233 MSG_ORIG(MSG_STR_EMPTY), index_width, index, string);
234 }
235 }
236
237 /*
238 * Convert the ASCII representation of an index, or index range, into
239 * binary form, and store it in rec:
240 *
241 * index: An positive or 0 valued integer
242 * range: Two indexes, separated by a ':' character, denoting
243 * a range of allowed values. If the second value is omitted,
244 * any values equal to or greater than the first will match.
245 *
246 * exit:
247 * On success, *rec is filled in with a MATCH_OPT_NDX or MATCH_OPT_RANGE
248 * value, and this function returns (1). On failure, the contents
249 * of *rec are undefined, and (0) is returned.
250 */
251 int
252 process_index_opt(const char *str, match_rec_t *rec)
253 {
254 #define SKIP_BLANK for (; *str && isspace(*str); str++)
255
256 char *endptr;
257
258 rec->value.ndx.start = strtol(str, &endptr, 10);
259 /* Value must use some of the input, and be 0 or positive */
260 if ((str == endptr) || (rec->value.ndx.start < 0))
261 return (0);
262 str = endptr;
263
264 SKIP_BLANK;
265 if (*str != ':') {
266 rec->opt_type = MATCH_OPT_NDX;
267 } else {
268 str++; /* Skip the ':' */
269 rec->opt_type = MATCH_OPT_RANGE;
270 SKIP_BLANK;
271 if (*str == '\0') {
272 rec->value.ndx.end = -1; /* Indicates "to end" */
273 } else {
274 rec->value.ndx.end = strtol(str, &endptr, 10);
275 if ((str == endptr) || (rec->value.ndx.end < 0))
276 return (0);
277 str = endptr;
278 SKIP_BLANK;
279 }
280 }
281
282 /* Syntax error if anything is left over */
283 if (*str != '\0')
284 return (0);
285
286 return (1);
287
288 #undef SKIP_BLANK
289 }
290
291 /*
292 * Convert a string containing a specific type of ELF constant, or an ASCII
293 * representation of a number, to an integer. Strings starting with '0'
294 * are taken to be octal, those staring with '0x' are hex, and all
295 * others are decimal.
296 *
297 * entry:
298 * str - String to be converted
299 * ctype - Constant type
300 * v - Address of variable to receive resulting value.
301 *
302 * exit:
303 * On success, returns True (1) and *v is set to the value.
304 * On failure, returns False (0) and *v is undefined.
305 */
306 typedef enum {
307 ATOUI_PT,
308 ATOUI_SHT,
309 ATOUI_OSABI
310 } atoui_type_t;
311
312 static int
313 atoui(const char *str, atoui_type_t type, uint32_t *v)
314 {
315 conv_strtol_uvalue_t uvalue;
316 char *endptr;
317
318 if (conv_iter_strtol_init(str, &uvalue) != 0) {
319 switch (type) {
320 case ATOUI_PT:
321 if (conv_iter_phdr_type(CONV_OSABI_ALL, CONV_FMT_ALT_CF,
322 conv_iter_strtol, &uvalue) == CONV_ITER_DONE)
323 break;
324 (void) conv_iter_phdr_type(CONV_OSABI_ALL,
325 CONV_FMT_ALT_NF, conv_iter_strtol, &uvalue);
326 break;
327 case ATOUI_SHT:
328 if (conv_iter_sec_type(CONV_OSABI_ALL, CONV_MACH_ALL,
329 CONV_FMT_ALT_CF, conv_iter_strtol, &uvalue) ==
330 CONV_ITER_DONE)
331 break;
332 (void) conv_iter_sec_type(CONV_OSABI_ALL, CONV_MACH_ALL,
333 CONV_FMT_ALT_NF, conv_iter_strtol, &uvalue);
334 break;
335 case ATOUI_OSABI:
336 if (conv_iter_ehdr_osabi(CONV_FMT_ALT_CF,
337 conv_iter_strtol, &uvalue) == CONV_ITER_DONE)
338 break;
339 (void) conv_iter_ehdr_osabi(CONV_FMT_ALT_NF,
340 conv_iter_strtol, &uvalue);
341 break;
342 }
343 if (uvalue.csl_found) {
344 *v = uvalue.csl_value;
345 return (1);
346 }
347 }
348
349 *v = strtoull(str, &endptr, 0);
350
351 /* If the left over part contains anything but whitespace, fail */
352 for (; *endptr; endptr++)
353 if (!isspace(*endptr))
354 return (0);
355 return (1);
356 }
357
358 /*
359 * Called after getopt() processing is finished if there is a non-empty
360 * match list. Prepares the matching code for use.
361 *
362 * exit:
363 * Returns True (1) if no errors are encountered. Writes an
364 * error string to stderr and returns False (0) otherwise.
365 */
366 static int
367 match_prepare(char *argv0, uint_t flags)
368 {
369 match_rec_t *list;
370 const char *str;
371 int minus_p = (flags & FLG_SHOW_PHDR) != 0;
372 atoui_type_t atoui_type;
373
374 /*
375 * Flag ambiguous attempt to use match option with both -p and
376 * and one or more section SHOW options. In this case, we
377 * can't tell what type of item we're supposed to match against.
378 */
379 if (minus_p && (flags & FLG_MASK_SHOW_SHDR)) {
380 (void) fprintf(stderr, MSG_INTL(MSG_ERR_AMBIG_MATCH),
381 basename(argv0));
382 return (0);
383 }
384
385 /* Set the match type, based on the presence of the -p option */
386 if (minus_p) {
387 match_state.item_type = MATCH_ITEM_PT;
388 atoui_type = ATOUI_PT;
389 } else {
390 match_state.item_type = MATCH_ITEM_SHT;
391 atoui_type = ATOUI_SHT;
392 }
393
394 /*
395 * Scan match list and perform any necessary fixups:
396 *
397 * MATCH_OPT_NAME: If -p is specified, convert MATCH_OPT_NAME (-N)
398 * requests into MATCH_OPT_TYPE (-T).
399 *
400 * MATCH_OPT_TYPE: Now that we know item type we are matching
401 * against, we can convert the string saved in the name
402 * field during getopt() processing into an integer and
403 * write it into the type field.
404 */
405 for (list = match_state.list; list; list = list->next) {
406 if ((list->opt_type == MATCH_OPT_NAME) && minus_p)
407 list->opt_type = MATCH_OPT_TYPE;
408
409 if (list->opt_type != MATCH_OPT_TYPE)
410 continue;
411
412 str = list->value.name;
413 if (atoui(str, atoui_type, &list->value.type) == 0) {
414 const char *fmt = minus_p ?
415 MSG_INTL(MSG_ERR_BAD_T_PT) :
416 MSG_INTL(MSG_ERR_BAD_T_SHT);
417
418 (void) fprintf(stderr, fmt, basename(argv0), str);
419 return (0);
420 }
421 }
422
423 return (1);
424 }
425
426
427 /*
428 * Returns True (1) if the item with the given name or index should
429 * be displayed, and False (0) if it should not be.
430 *
431 * entry:
432 * match_flags - Bitmask specifying matching options, as described
433 * in _elfdump.h.
434 * name - If MATCH_F_NAME flag is set, name of item under
435 * consideration. Otherwise ignored.
436 * should not be considered.
437 * ndx - If MATCH_F_NDX flag is set, index of item under consideration.
438 * type - If MATCH_F_TYPE is set, type of item under consideration.
439 * If MATCH_F_PHDR is set, this would be a program
440 * header type (PT_). Otherwise, a section header type (SHT_).
441 *
442 * exit:
443 * True will be returned if the given name/index matches those given
444 * by one of the (-I, -N -T) command line options, or if no such option
445 * was used in the command invocation and MATCH_F_STRICT is not
446 * set.
447 */
448 int
449 match(match_flags_t match_flags, const char *name, uint_t ndx, uint_t type)
450 {
451 match_item_t item_type = (match_flags & MATCH_F_PHDR) ?
452 MATCH_ITEM_PT : MATCH_ITEM_SHT;
453 match_rec_t *list;
454
455 /*
456 * If there is no match list, then we use the MATCH_F_STRICT
457 * flag to decide what to return. In the strict case, we return
458 * False (0), in the normal case, True (1).
459 */
460 if (match_state.list == NULL)
461 return ((match_flags & MATCH_F_STRICT) == 0);
462
463 /*
464 * If item being checked is not the current match type,
465 * then allow it.
466 */
467 if (item_type != match_state.item_type)
468 return (1);
469
470 /* Run through the match records and check for a hit */
471 for (list = match_state.list; list; list = list->next) {
472 switch (list->opt_type) {
473 case MATCH_OPT_NAME:
474 if (((match_flags & MATCH_F_NAME) == 0) ||
475 (name == NULL))
476 break;
477 if (strcmp(list->value.name, name) == 0)
478 return (1);
479 break;
480 case MATCH_OPT_NDX:
481 if ((match_flags & MATCH_F_NDX) &&
482 (ndx == list->value.ndx.start))
483 return (1);
484 break;
485 case MATCH_OPT_RANGE:
486 /*
487 * A range end value less than 0 means that any value
488 * above the start is acceptible.
489 */
490 if ((match_flags & MATCH_F_NDX) &&
491 (ndx >= list->value.ndx.start) &&
492 ((list->value.ndx.end < 0) ||
493 (ndx <= list->value.ndx.end)))
494 return (1);
495 break;
496
497 case MATCH_OPT_TYPE:
498 if ((match_flags & MATCH_F_TYPE) &&
499 (type == list->value.type))
500 return (1);
501 break;
502 }
503 }
504
505 /* Nothing matched */
506 return (0);
507 }
508
509 /*
510 * Add an entry to match_state.list for use by match(). This routine is for
511 * use during getopt() processing. It should not be called once
512 * match_prepare() has been called.
513 *
514 * Return True (1) for success. On failure, an error is written
515 * to stderr, and False (0) is returned.
516 */
517 static int
518 add_match_record(char *argv0, match_rec_t *data)
519 {
520 match_rec_t *rec;
521 match_rec_t *list;
522
523 if ((rec = malloc(sizeof (*rec))) == NULL) {
524 int err = errno;
525 (void) fprintf(stderr, MSG_INTL(MSG_ERR_MALLOC),
526 basename(argv0), strerror(err));
527 return (0);
528 }
529
530 *rec = *data;
531
532 /* Insert at end of match_state.list */
533 if (match_state.list == NULL) {
534 match_state.list = rec;
535 } else {
536 for (list = match_state.list; list->next != NULL;
537 list = list->next)
538 ;
539 list->next = rec;
540 }
541
542 rec->next = NULL;
543 return (1);
544 }
545
546 static int
547 decide(const char *file, int fd, Elf *elf, uint_t flags,
548 const char *wname, int wfd, uchar_t osabi)
549 {
550 int r;
551
552 if (gelf_getclass(elf) == ELFCLASS64)
553 r = regular64(file, fd, elf, flags, wname, wfd, osabi);
554 else
555 r = regular32(file, fd, elf, flags, wname, wfd, osabi);
556
557 return (r);
558 }
559
560 static int
561 archive(const char *file, int fd, Elf *elf, uint_t flags,
562 const char *wname, int wfd, uchar_t osabi)
563 {
564 Elf_Cmd cmd = ELF_C_READ;
565 Elf_Arhdr *arhdr;
566 Elf *_elf = NULL;
567 size_t ptr;
568 Elf_Arsym *arsym = NULL;
569
570 /*
571 * Determine if the archive symbol table itself is required.
572 */
573 if ((flags & FLG_SHOW_SYMBOLS) &&
574 match(MATCH_F_NAME, MSG_ORIG(MSG_ELF_ARSYM), 0, 0)) {
575 /*
576 * Get the archive symbol table.
577 */
578 if (((arsym = elf_getarsym(elf, &ptr)) == 0) && elf_errno()) {
579 /*
580 * The arsym could be 0 even though there was no error.
581 * Print the error message only when there was
582 * real error from elf_getarsym().
583 */
584 failure(file, MSG_ORIG(MSG_ELF_GETARSYM));
585 return (0);
586 }
587 }
588
589 /*
590 * Print the archive symbol table only when the archive symbol
591 * table exists and it was requested to print.
592 */
593 if (arsym) {
594 size_t cnt;
595 char index[MAXNDXSIZE];
596 size_t offset = 0, _offset = 0;
597 const char *fmt_arsym1, *fmt_arsym2;
598
599 /*
600 * Print out all the symbol entries. The format width used
601 * corresponds to whether the archive symbol table is 32
602 * or 64-bit. We see them via Elf_Arhdr as size_t values
603 * in either case with no information loss (see the comments
604 * in libelf/getarsym.c) so this is done simply to improve
605 * the user presentation.
606 */
607 if (_elf_getarsymwordsize(elf) == 8) {
608 dbg_print(0, MSG_INTL(MSG_ARCHIVE_SYMTAB_64));
609 dbg_print(0, MSG_INTL(MSG_ARCHIVE_FIELDS_64));
610
611 fmt_arsym1 = MSG_ORIG(MSG_FMT_ARSYM1_64);
612 fmt_arsym2 = MSG_ORIG(MSG_FMT_ARSYM2_64);
613 } else {
614 dbg_print(0, MSG_INTL(MSG_ARCHIVE_SYMTAB_32));
615 dbg_print(0, MSG_INTL(MSG_ARCHIVE_FIELDS_32));
616
617 fmt_arsym1 = MSG_ORIG(MSG_FMT_ARSYM1_32);
618 fmt_arsym2 = MSG_ORIG(MSG_FMT_ARSYM2_32);
619 }
620
621 for (cnt = 0; cnt < ptr; cnt++, arsym++) {
622 /*
623 * For each object obtain an elf descriptor so that we
624 * can establish the members name. Note, we have had
625 * archives where the archive header has not been
626 * obtainable so be lenient with errors.
627 */
628 if ((offset == 0) || ((arsym->as_off != 0) &&
629 (arsym->as_off != _offset))) {
630
631 if (_elf)
632 (void) elf_end(_elf);
633
634 if (elf_rand(elf, arsym->as_off) !=
635 arsym->as_off) {
636 failure(file, MSG_ORIG(MSG_ELF_RAND));
637 arhdr = NULL;
638 } else if ((_elf = elf_begin(fd,
639 ELF_C_READ, elf)) == 0) {
640 failure(file, MSG_ORIG(MSG_ELF_BEGIN));
641 arhdr = NULL;
642 } else if ((arhdr = elf_getarhdr(_elf)) == 0) {
643 failure(file,
644 MSG_ORIG(MSG_ELF_GETARHDR));
645 arhdr = NULL;
646 }
647
648 _offset = arsym->as_off;
649 if (offset == 0)
650 offset = _offset;
651 }
652
653 (void) snprintf(index, MAXNDXSIZE,
654 MSG_ORIG(MSG_FMT_INDEX), EC_XWORD(cnt));
655 if (arsym->as_off)
656 dbg_print(0, fmt_arsym1, index,
657 EC_XWORD(arsym->as_off),
658 arhdr ? arhdr->ar_name :
659 MSG_INTL(MSG_STR_UNKNOWN), (arsym->as_name ?
660 demangle(arsym->as_name, flags) :
661 MSG_INTL(MSG_STR_NULL)));
662 else
663 dbg_print(0, fmt_arsym2, index,
664 EC_XWORD(arsym->as_off));
665 }
666
667 if (_elf)
668 (void) elf_end(_elf);
669
670 /*
671 * If we only need the archive symbol table return.
672 */
673 if ((flags & FLG_SHOW_SYMBOLS) &&
674 match(MATCH_F_STRICT | MATCH_F_NAME,
675 MSG_ORIG(MSG_ELF_ARSYM), -1, -1))
676 return (0);
677
678 /*
679 * Reset elf descriptor in preparation for processing each
680 * member.
681 */
682 if (offset)
683 (void) elf_rand(elf, offset);
684 }
685
686 /*
687 * Process each object within the archive.
688 */
689 while ((_elf = elf_begin(fd, cmd, elf)) != NULL) {
690 char name[MAXPATHLEN];
691
692 if ((arhdr = elf_getarhdr(_elf)) == NULL) {
693 failure(file, MSG_ORIG(MSG_ELF_GETARHDR));
694 return (0);
695 }
696 if (*arhdr->ar_name != '/') {
697 (void) snprintf(name, MAXPATHLEN,
698 MSG_ORIG(MSG_FMT_ARNAME), file, arhdr->ar_name);
699 dbg_print(0, MSG_ORIG(MSG_FMT_NLSTR), name);
700
701 switch (elf_kind(_elf)) {
702 case ELF_K_AR:
703 if (archive(name, fd, _elf, flags,
704 wname, wfd, osabi) == 1)
705 return (1);
706 break;
707 case ELF_K_ELF:
708 if (decide(name, fd, _elf, flags,
709 wname, wfd, osabi) == 1)
710 return (1);
711 break;
712 default:
713 (void) fprintf(stderr,
714 MSG_INTL(MSG_ERR_BADFILE), name);
715 break;
716 }
717 }
718
719 cmd = elf_next(_elf);
720 (void) elf_end(_elf);
721 }
722
723 return (0);
724 }
725
726 int
727 main(int argc, char **argv, char **envp)
728 {
729 Elf *elf;
730 int var, fd, wfd = 0;
731 char *wname = NULL;
732 uint_t flags = 0;
733 match_rec_t match_data;
734 int ret;
735 uchar_t osabi;
736
737 /*
738 * If we're on a 64-bit kernel, try to exec a full 64-bit version of
739 * the binary. If successful, conv_check_native() won't return.
740 */
741 (void) conv_check_native(argv, envp);
742
743 /*
744 * Establish locale.
745 */
746 (void) setlocale(LC_MESSAGES, MSG_ORIG(MSG_STR_EMPTY));
747 (void) textdomain(MSG_ORIG(MSG_SUNW_OST_SGS));
748
749 (void) setvbuf(stdout, NULL, _IOLBF, 0);
750 (void) setvbuf(stderr, NULL, _IOLBF, 0);
751
752 opterr = 0;
753 while ((var = getopt(argc, argv, MSG_ORIG(MSG_STR_OPTIONS))) != EOF) {
754 switch (var) {
755 case 'C':
756 flags |= FLG_CTL_DEMANGLE;
757 break;
758 case 'c':
759 flags |= FLG_SHOW_SHDR;
760 break;
761 case 'd':
762 flags |= FLG_SHOW_DYNAMIC;
763 break;
764 case 'e':
765 flags |= FLG_SHOW_EHDR;
766 break;
767 case 'G':
768 flags |= FLG_SHOW_GOT;
769 break;
770 case 'g':
771 flags |= FLG_SHOW_GROUP;
772 break;
773 case 'H':
774 flags |= FLG_SHOW_CAP;
775 break;
776 case 'h':
777 flags |= FLG_SHOW_HASH;
778 break;
779 case 'I':
780 if (!process_index_opt(optarg, &match_data))
781 goto usage_brief;
782 if (!add_match_record(argv[0], &match_data))
783 return (1);
784 flags |= FLG_CTL_MATCH;
785 break;
786 case 'i':
787 flags |= FLG_SHOW_INTERP;
788 break;
789 case 'k':
790 flags |= FLG_CALC_CHECKSUM;
791 break;
792 case 'l':
793 flags |= FLG_CTL_LONGNAME;
794 break;
795 case 'm':
796 flags |= FLG_SHOW_MOVE;
797 break;
798 case 'N':
799 match_data.opt_type = MATCH_OPT_NAME;
800 match_data.value.name = optarg;
801 if (!add_match_record(argv[0], &match_data))
802 return (1);
803 flags |= FLG_CTL_MATCH;
804 break;
805 case 'n':
806 flags |= FLG_SHOW_NOTE;
807 break;
808 case 'O':
809 {
810 uint32_t val;
811
812 /*
813 * osabi is a uchar_t in the ELF header.
814 * Don't accept any value that exceeds
815 * that range.
816 */
817 if ((atoui(optarg, ATOUI_OSABI, &val) == 0) ||
818 (val > 255)) {
819 (void) fprintf(stderr,
820 MSG_INTL(MSG_ERR_BAD_T_OSABI),
821 basename(argv[0]), optarg);
822 return (1);
823 }
824 osabi = val;
825 }
826 flags |= FLG_CTL_OSABI;
827 break;
828 case 'P':
829 flags |= FLG_CTL_FAKESHDR;
830 break;
831 case 'p':
832 flags |= FLG_SHOW_PHDR;
833 break;
834 case 'r':
835 flags |= FLG_SHOW_RELOC;
836 break;
837 case 'S':
838 flags |= FLG_SHOW_SORT;
839 break;
840 case 's':
841 flags |= FLG_SHOW_SYMBOLS;
842 break;
843 case 'T':
844 /*
845 * We can't evaluate the value yet, because
846 * we need to know if -p is used or not in
847 * order to tell if we're seeing section header
848 * or program header types. So, we save the
849 * string in the name field, and then convert
850 * it to a type integer in a following pass.
851 */
852 match_data.opt_type = MATCH_OPT_TYPE;
853 match_data.value.name = optarg;
854 if (!add_match_record(argv[0], &match_data))
855 return (1);
856 flags |= FLG_CTL_MATCH;
857 break;
858 case 'u':
859 flags |= FLG_SHOW_UNWIND;
860 break;
861 case 'v':
862 flags |= FLG_SHOW_VERSIONS;
863 break;
864 case 'w':
865 wname = optarg;
866 break;
867 case 'y':
868 flags |= FLG_SHOW_SYMINFO;
869 break;
870 case '?':
871 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_BRIEF),
872 basename(argv[0]));
873 detail_usage();
874 return (1);
875 default:
876 break;
877 }
878 }
879
880 /* -p and -w are mutually exclusive. -w only works with sections */
881 if (((flags & FLG_SHOW_PHDR) != 0) && (wname != NULL))
882 goto usage_brief;
883
884 /* If a match argument is present, prepare the match state */
885 if ((match_state.list != NULL) && (match_prepare(argv[0], flags) == 0))
886 return (1);
887
888 /*
889 * Decide what to do if no options specifying something to
890 * show or do are present.
891 *
892 * If there is no -w and no match options, then we will set all
893 * the show flags, causing a full display of everything in the
894 * file that we know how to handle.
895 *
896 * Otherwise, if there is no match list, we generate a usage
897 * error and quit.
898 *
899 * In the case where there is a match list, we go ahead and call
900 * regular() anyway, leaving it to decide what to do. If -w is
901 * present, regular() will use the match list to handle it.
902 * In addition, in the absence of explicit show/calc flags, regular()
903 * will compare the section headers to the match list and use
904 * that to generate the FLG_ bits that will display the information
905 * specified by the match list.
906 */
907 if ((flags & ~FLG_MASK_CTL) == 0) {
908 if (!wname && (match_state.list == NULL))
909 flags |= FLG_MASK_SHOW;
910 else if (match_state.list == NULL)
911 goto usage_brief;
912 }
913
914 /* There needs to be at least 1 filename left following the options */
915 if ((var = argc - optind) == 0)
916 goto usage_brief;
917
918 /*
919 * If the -l/-C option is specified, set up the liblddbg.so.
920 */
921 if (flags & FLG_CTL_LONGNAME)
922 dbg_desc->d_extra |= DBG_E_LONG;
923 if (flags & FLG_CTL_DEMANGLE)
924 dbg_desc->d_extra |= DBG_E_DEMANGLE;
925
926 /*
927 * If the -w option has indicated an output file open it. It's
928 * arguable whether this option has much use when multiple files are
929 * being processed.
930 *
931 * If wname is non-NULL, we know that -p was not specified, due
932 * to the test above.
933 */
934 if (wname) {
935 if ((wfd = open(wname, (O_RDWR | O_CREAT | O_TRUNC),
936 0666)) < 0) {
937 int err = errno;
938 (void) fprintf(stderr, MSG_INTL(MSG_ERR_OPEN),
939 wname, strerror(err));
940 return (1);
941 }
942 }
943
944 /*
945 * Open the input file, initialize the elf interface, and
946 * process it.
947 */
948 ret = 0;
949 for (; (optind < argc) && (ret == 0); optind++) {
950 const char *file = argv[optind];
951
952 if ((fd = open(argv[optind], O_RDONLY)) == -1) {
953 int err = errno;
954 (void) fprintf(stderr, MSG_INTL(MSG_ERR_OPEN),
955 file, strerror(err));
956 continue;
957 }
958 (void) elf_version(EV_CURRENT);
959 if ((elf = elf_begin(fd, ELF_C_READ, NULL)) == NULL) {
960 failure(file, MSG_ORIG(MSG_ELF_BEGIN));
961 (void) close(fd);
962 continue;
963 }
964
965 if (var > 1)
966 dbg_print(0, MSG_ORIG(MSG_FMT_NLSTRNL), file);
967
968 switch (elf_kind(elf)) {
969 case ELF_K_AR:
970 ret = archive(file, fd, elf, flags, wname, wfd, osabi);
971 break;
972 case ELF_K_ELF:
973 ret = decide(file, fd, elf, flags, wname, wfd, osabi);
974 break;
975 default:
976 (void) fprintf(stderr, MSG_INTL(MSG_ERR_BADFILE), file);
977 break;
978 }
979
980 (void) close(fd);
981 (void) elf_end(elf);
982 }
983
984 if (wfd)
985 (void) close(wfd);
986 return (ret);
987
988 usage_brief:
989 /* Control comes here for a simple usage message and exit */
990 (void) fprintf(stderr, MSG_INTL(MSG_USAGE_BRIEF),
991 basename(argv[0]));
992 return (1);
993
994 }