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 = ELFOSABI_NONE; 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 } 995