1 /* dwarf2dbg.c - DWARF2 debug support
2 Copyright (C) 1999-2018 Free Software Foundation, Inc.
3 Contributed by David Mosberger-Tang <davidm@hpl.hp.com>
5 This file is part of GAS, the GNU Assembler.
7 GAS is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
12 GAS is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GAS; see the file COPYING. If not, write to the Free
19 Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
22 /* Logical line numbers can be controlled by the compiler via the
26 .loc FILENO LINENO [COLUMN] [basic_block] [prologue_end] \
27 [epilogue_begin] [is_stmt VALUE] [isa VALUE] \
32 #include "safe-ctype.h"
37 #ifdef HAVE_SYS_PARAM_H
38 #include <sys/param.h>
41 #define INT_MAX (int) (((unsigned) (-1)) >> 1)
45 #include "dwarf2dbg.h"
46 #include <filenames.h>
48 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
49 /* We need to decide which character to use as a directory separator.
50 Just because HAVE_DOS_BASED_FILE_SYSTEM is defined, it does not
51 necessarily mean that the backslash character is the one to use.
52 Some environments, eg Cygwin, can support both naming conventions.
53 So we use the heuristic that we only need to use the backslash if
54 the path is an absolute path starting with a DOS style drive
55 selector. eg C: or D: */
56 # define INSERT_DIR_SEPARATOR(string, offset) \
61 && string[1] == ':') \
62 string [offset] = '\\'; \
64 string [offset] = '/'; \
68 # define INSERT_DIR_SEPARATOR(string, offset) string[offset] = '/'
72 # define DWARF2_FORMAT(SEC) dwarf2_format_32bit
75 #ifndef DWARF2_ADDR_SIZE
76 # define DWARF2_ADDR_SIZE(bfd) (bfd_arch_bits_per_address (bfd) / 8)
79 #ifndef DWARF2_FILE_NAME
80 #define DWARF2_FILE_NAME(FILENAME, DIRNAME) FILENAME
83 #ifndef DWARF2_FILE_TIME_NAME
84 #define DWARF2_FILE_TIME_NAME(FILENAME,DIRNAME) 0
87 #ifndef DWARF2_FILE_SIZE_NAME
88 #define DWARF2_FILE_SIZE_NAME(FILENAME,DIRNAME) 0
91 #ifndef DWARF2_VERSION
92 #define DWARF2_VERSION 2
95 /* The .debug_aranges version has been 2 in DWARF version 2, 3 and 4. */
96 #ifndef DWARF2_ARANGES_VERSION
97 #define DWARF2_ARANGES_VERSION 2
100 /* This implementation output version 2 .debug_line information. */
101 #ifndef DWARF2_LINE_VERSION
102 #define DWARF2_LINE_VERSION 2
109 /* Since we can't generate the prolog until the body is complete, we
110 use three different subsegments for .debug_line: one holding the
111 prolog, one for the directory and filename info, and one for the
112 body ("statement program"). */
117 /* If linker relaxation might change offsets in the code, the DWARF special
118 opcodes and variable-length operands cannot be used. If this macro is
119 nonzero, use the DW_LNS_fixed_advance_pc opcode instead. */
120 #ifndef DWARF2_USE_FIXED_ADVANCE_PC
121 # define DWARF2_USE_FIXED_ADVANCE_PC linkrelax
124 /* First special line opcode - leave room for the standard opcodes.
125 Note: If you want to change this, you'll have to update the
126 "standard_opcode_lengths" table that is emitted below in
128 #define DWARF2_LINE_OPCODE_BASE 13
130 #ifndef DWARF2_LINE_BASE
131 /* Minimum line offset in a special line info. opcode. This value
132 was chosen to give a reasonable range of values. */
133 # define DWARF2_LINE_BASE -5
136 /* Range of line offsets in a special line info. opcode. */
137 #ifndef DWARF2_LINE_RANGE
138 # define DWARF2_LINE_RANGE 14
141 #ifndef DWARF2_LINE_MIN_INSN_LENGTH
142 /* Define the architecture-dependent minimum instruction length (in
143 bytes). This value should be rather too small than too big. */
144 # define DWARF2_LINE_MIN_INSN_LENGTH 1
147 /* Flag that indicates the initial value of the is_stmt_start flag. */
148 #define DWARF2_LINE_DEFAULT_IS_STMT 1
150 /* Given a special op, return the line skip amount. */
151 #define SPECIAL_LINE(op) \
152 (((op) - DWARF2_LINE_OPCODE_BASE)%DWARF2_LINE_RANGE + DWARF2_LINE_BASE)
154 /* Given a special op, return the address skip amount (in units of
155 DWARF2_LINE_MIN_INSN_LENGTH. */
156 #define SPECIAL_ADDR(op) (((op) - DWARF2_LINE_OPCODE_BASE)/DWARF2_LINE_RANGE)
158 /* The maximum address skip amount that can be encoded with a special op. */
159 #define MAX_SPECIAL_ADDR_DELTA SPECIAL_ADDR(255)
161 #ifndef TC_PARSE_CONS_RETURN_NONE
162 #define TC_PARSE_CONS_RETURN_NONE BFD_RELOC_NONE
167 struct line_entry *next;
169 struct dwarf2_line_info loc;
172 /* Don't change the offset of next in line_entry. set_or_check_view
173 calls in dwarf2_gen_line_info_1 depend on it. */
174 static char unused[offsetof(struct line_entry, next) ? -1 : 1]
179 struct line_subseg *next;
181 struct line_entry *head;
182 struct line_entry **ptail;
183 struct line_entry **pmove_tail;
188 struct line_seg *next;
190 struct line_subseg *head;
195 /* Collects data for all line table entries during assembly. */
196 static struct line_seg *all_segs;
197 static struct line_seg **last_seg_ptr;
201 const char *filename;
205 /* Table of files used by .debug_line. */
206 static struct file_entry *files;
207 static unsigned int files_in_use;
208 static unsigned int files_allocated;
210 /* Table of directories used by .debug_line. */
212 static unsigned int dirs_in_use;
213 static unsigned int dirs_allocated;
215 /* TRUE when we've seen a .loc directive recently. Used to avoid
216 doing work when there's nothing to do. */
217 bfd_boolean dwarf2_loc_directive_seen;
219 /* TRUE when we're supposed to set the basic block mark whenever a
221 bfd_boolean dwarf2_loc_mark_labels;
223 /* Current location as indicated by the most recent .loc directive. */
224 static struct dwarf2_line_info current =
227 DWARF2_LINE_DEFAULT_IS_STMT ? DWARF2_FLAG_IS_STMT : 0,
231 /* This symbol is used to recognize view number forced resets in loc
233 static symbolS *force_reset_view;
235 /* This symbol evaluates to an expression that, if nonzero, indicates
236 some view assert check failed. */
237 static symbolS *view_assert_failed;
239 /* The size of an address on the target. */
240 static unsigned int sizeof_address;
242 static unsigned int get_filenum (const char *, unsigned int);
244 #ifndef TC_DWARF2_EMIT_OFFSET
245 #define TC_DWARF2_EMIT_OFFSET generic_dwarf2_emit_offset
247 /* Create an offset to .dwarf2_*. */
250 generic_dwarf2_emit_offset (symbolS *symbol, unsigned int size)
255 exp.X_add_symbol = symbol;
256 exp.X_add_number = 0;
257 emit_expr (&exp, size);
261 /* Find or create (if CREATE_P) an entry for SEG+SUBSEG in ALL_SEGS. */
263 static struct line_subseg *
264 get_line_subseg (segT seg, subsegT subseg, bfd_boolean create_p)
266 struct line_seg *s = seg_info (seg)->dwarf2_line_seg;
267 struct line_subseg **pss, *lss;
274 s = XNEW (struct line_seg);
279 last_seg_ptr = &s->next;
280 seg_info (seg)->dwarf2_line_seg = s;
282 gas_assert (seg == s->seg);
284 for (pss = &s->head; (lss = *pss) != NULL ; pss = &lss->next)
286 if (lss->subseg == subseg)
288 if (lss->subseg > subseg)
292 lss = XNEW (struct line_subseg);
294 lss->subseg = subseg;
296 lss->ptail = &lss->head;
297 lss->pmove_tail = &lss->head;
304 /* (Un)reverse the line_entry list starting from H. */
306 static struct line_entry *
307 reverse_line_entry_list (struct line_entry *h)
309 struct line_entry *p = NULL, *e, *n;
311 for (e = h; e; e = n)
320 /* Compute the view for E based on the previous entry P. If we
321 introduce an (undefined) view symbol for P, and H is given (P must
322 be the tail in this case), introduce view symbols for earlier list
323 entries as well, until one of them is constant. */
326 set_or_check_view (struct line_entry *e, struct line_entry *p,
327 struct line_entry *h)
331 memset (&viewx, 0, sizeof (viewx));
332 viewx.X_unsigned = 1;
334 /* First, compute !(E->label > P->label), to tell whether or not
335 we're to reset the view number. If we can't resolve it to a
336 constant, keep it symbolic. */
337 if (!p || (e->loc.view == force_reset_view && force_reset_view))
339 viewx.X_op = O_constant;
340 viewx.X_add_number = 0;
341 viewx.X_add_symbol = NULL;
342 viewx.X_op_symbol = NULL;
347 viewx.X_add_number = 0;
348 viewx.X_add_symbol = e->label;
349 viewx.X_op_symbol = p->label;
350 resolve_expression (&viewx);
351 if (viewx.X_op == O_constant)
352 viewx.X_add_number = !viewx.X_add_number;
355 viewx.X_add_symbol = make_expr_symbol (&viewx);
356 viewx.X_add_number = 0;
357 viewx.X_op_symbol = NULL;
358 viewx.X_op = O_logical_not;
362 if (S_IS_DEFINED (e->loc.view) && symbol_constant_p (e->loc.view))
364 expressionS *value = symbol_get_value_expression (e->loc.view);
365 /* We can't compare the view numbers at this point, because in
366 VIEWX we've only determined whether we're to reset it so
368 if (viewx.X_op == O_constant)
370 if (!value->X_add_number != !viewx.X_add_number)
371 as_bad (_("view number mismatch"));
373 /* Record the expression to check it later. It is the result of
374 a logical not, thus 0 or 1. We just add up all such deferred
375 expressions, and resolve it at the end. */
376 else if (!value->X_add_number)
378 symbolS *deferred = make_expr_symbol (&viewx);
379 if (view_assert_failed)
382 memset (&chk, 0, sizeof (chk));
385 chk.X_add_number = 0;
386 chk.X_add_symbol = view_assert_failed;
387 chk.X_op_symbol = deferred;
388 deferred = make_expr_symbol (&chk);
390 view_assert_failed = deferred;
394 if (viewx.X_op != O_constant || viewx.X_add_number)
400 p->loc.view = symbol_temp_make ();
401 gas_assert (!S_IS_DEFINED (p->loc.view));
404 memset (&incv, 0, sizeof (incv));
406 incv.X_op = O_symbol;
407 incv.X_add_symbol = p->loc.view;
408 incv.X_add_number = 1;
410 if (viewx.X_op == O_constant)
412 gas_assert (viewx.X_add_number == 1);
417 viewx.X_add_symbol = make_expr_symbol (&viewx);
418 viewx.X_add_number = 0;
419 viewx.X_op_symbol = make_expr_symbol (&incv);
420 viewx.X_op = O_multiply;
424 if (!S_IS_DEFINED (e->loc.view))
426 symbol_set_value_expression (e->loc.view, &viewx);
427 S_SET_SEGMENT (e->loc.view, absolute_section);
428 symbol_set_frag (e->loc.view, &zero_address_frag);
431 /* Define and attempt to simplify any earlier views needed to
433 if (h && p && p->loc.view && !S_IS_DEFINED (p->loc.view))
435 struct line_entry *h2;
436 /* Reverse the list to avoid quadratic behavior going backwards
437 in a single-linked list. */
438 struct line_entry *r = reverse_line_entry_list (h);
441 /* Set or check views until we find a defined or absent view. */
443 set_or_check_view (r, r->next, NULL);
444 while (r->next && r->next->loc.view && !S_IS_DEFINED (r->next->loc.view)
447 /* Unreverse the list, so that we can go forward again. */
448 h2 = reverse_line_entry_list (p);
449 gas_assert (h2 == h);
451 /* Starting from the last view we just defined, attempt to
452 simplify the view expressions, until we do so to P. */
455 gas_assert (S_IS_DEFINED (r->loc.view));
456 resolve_expression (symbol_get_value_expression (r->loc.view));
458 while (r != p && (r = r->next));
460 /* Now that we've defined and computed all earlier views that might
461 be needed to compute E's, attempt to simplify it. */
462 resolve_expression (symbol_get_value_expression (e->loc.view));
466 /* Record an entry for LOC occurring at LABEL. */
469 dwarf2_gen_line_info_1 (symbolS *label, struct dwarf2_line_info *loc)
471 struct line_subseg *lss;
472 struct line_entry *e;
474 e = XNEW (struct line_entry);
479 lss = get_line_subseg (now_seg, now_subseg, TRUE);
482 set_or_check_view (e,
483 !lss->head ? NULL : (struct line_entry *)lss->ptail,
487 lss->ptail = &e->next;
490 /* Record an entry for LOC occurring at OFS within the current fragment. */
493 dwarf2_gen_line_info (addressT ofs, struct dwarf2_line_info *loc)
495 static unsigned int line = -1;
496 static unsigned int filenum = -1;
500 /* Early out for as-yet incomplete location information. */
501 if (loc->filenum == 0 || loc->line == 0)
504 /* Don't emit sequences of line symbols for the same line when the
505 symbols apply to assembler code. It is necessary to emit
506 duplicate line symbols when a compiler asks for them, because GDB
507 uses them to determine the end of the prologue. */
508 if (debug_type == DEBUG_DWARF2
509 && line == loc->line && filenum == loc->filenum)
513 filenum = loc->filenum;
519 /* Use a non-fake name for the line number location,
520 so that it can be referred to by relocations. */
521 sprintf (name, ".Loc.%u.%u", line, filenum);
522 sym = symbol_new (name, now_seg, ofs, frag_now);
525 sym = symbol_temp_new (now_seg, ofs, frag_now);
526 dwarf2_gen_line_info_1 (sym, loc);
529 /* Returns the current source information. If .file directives have
530 been encountered, the info for the corresponding source file is
531 returned. Otherwise, the info for the assembly source file is
535 dwarf2_where (struct dwarf2_line_info *line)
537 if (debug_type == DEBUG_DWARF2)
539 const char *filename;
541 memset (line, 0, sizeof (*line));
542 filename = as_where (&line->line);
543 line->filenum = get_filenum (filename, 0);
545 line->flags = DWARF2_FLAG_IS_STMT;
546 line->isa = current.isa;
547 line->discriminator = current.discriminator;
554 /* A hook to allow the target backend to inform the line number state
555 machine of isa changes when assembler debug info is enabled. */
558 dwarf2_set_isa (unsigned int isa)
563 /* Called for each machine instruction, or relatively atomic group of
564 machine instructions (ie built-in macro). The instruction or group
565 is SIZE bytes in length. If dwarf2 line number generation is called
566 for, emit a line statement appropriately. */
569 dwarf2_emit_insn (int size)
571 struct dwarf2_line_info loc;
573 if (debug_type != DEBUG_DWARF2
574 ? !dwarf2_loc_directive_seen
575 : !seen_at_least_1_file ())
580 dwarf2_gen_line_info (frag_now_fix () - size, &loc);
581 dwarf2_consume_line_info ();
584 /* Move all previously-emitted line entries for the current position by
585 DELTA bytes. This function cannot be used to move the same entries
589 dwarf2_move_insn (int delta)
591 struct line_subseg *lss;
592 struct line_entry *e;
598 lss = get_line_subseg (now_seg, now_subseg, FALSE);
602 now = frag_now_fix ();
603 while ((e = *lss->pmove_tail))
605 if (S_GET_VALUE (e->label) == now)
606 S_SET_VALUE (e->label, now + delta);
607 lss->pmove_tail = &e->next;
611 /* Called after the current line information has been either used with
612 dwarf2_gen_line_info or saved with a machine instruction for later use.
613 This resets the state of the line number information to reflect that
617 dwarf2_consume_line_info (void)
619 /* Unless we generate DWARF2 debugging information for each
620 assembler line, we only emit one line symbol for one LOC. */
621 dwarf2_loc_directive_seen = FALSE;
623 current.flags &= ~(DWARF2_FLAG_BASIC_BLOCK
624 | DWARF2_FLAG_PROLOGUE_END
625 | DWARF2_FLAG_EPILOGUE_BEGIN);
626 current.discriminator = 0;
630 /* Called for each (preferably code) label. If dwarf2_loc_mark_labels
631 is enabled, emit a basic block marker. */
634 dwarf2_emit_label (symbolS *label)
636 struct dwarf2_line_info loc;
638 if (!dwarf2_loc_mark_labels)
640 if (S_GET_SEGMENT (label) != now_seg)
642 if (!(bfd_get_section_flags (stdoutput, now_seg) & SEC_CODE))
644 if (files_in_use == 0 && debug_type != DEBUG_DWARF2)
649 loc.flags |= DWARF2_FLAG_BASIC_BLOCK;
651 dwarf2_gen_line_info_1 (label, &loc);
652 dwarf2_consume_line_info ();
655 /* Get a .debug_line file number for FILENAME. If NUM is nonzero,
656 allocate it on that file table slot, otherwise return the first
660 get_filenum (const char *filename, unsigned int num)
662 static unsigned int last_used, last_used_dir_len;
667 if (num == 0 && last_used)
669 if (! files[last_used].dir
670 && filename_cmp (filename, files[last_used].filename) == 0)
672 if (files[last_used].dir
673 && filename_ncmp (filename, dirs[files[last_used].dir],
674 last_used_dir_len) == 0
675 && IS_DIR_SEPARATOR (filename [last_used_dir_len])
676 && filename_cmp (filename + last_used_dir_len + 1,
677 files[last_used].filename) == 0)
681 file = lbasename (filename);
682 /* Don't make empty string from / or A: from A:/ . */
683 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
684 if (file <= filename + 3)
687 if (file == filename + 1)
690 dir_len = file - filename;
695 #ifndef DWARF2_DIR_SHOULD_END_WITH_SEPARATOR
698 for (dir = 1; dir < dirs_in_use; ++dir)
699 if (filename_ncmp (filename, dirs[dir], dir_len) == 0
700 && dirs[dir][dir_len] == '\0')
703 if (dir >= dirs_in_use)
705 if (dir >= dirs_allocated)
707 dirs_allocated = dir + 32;
708 dirs = XRESIZEVEC (char *, dirs, dirs_allocated);
711 dirs[dir] = xmemdup0 (filename, dir_len);
712 dirs_in_use = dir + 1;
718 for (i = 1; i < files_in_use; ++i)
719 if (files[i].dir == dir
721 && filename_cmp (file, files[i].filename) == 0)
724 last_used_dir_len = dir_len;
731 if (i >= files_allocated)
733 unsigned int old = files_allocated;
735 files_allocated = i + 32;
736 files = XRESIZEVEC (struct file_entry, files, files_allocated);
738 memset (files + old, 0, (i + 32 - old) * sizeof (struct file_entry));
741 files[i].filename = num ? file : xstrdup (file);
743 if (files_in_use < i + 1)
744 files_in_use = i + 1;
746 last_used_dir_len = dir_len;
751 /* Handle two forms of .file directive:
752 - Pass .file "source.c" to s_app_file
753 - Handle .file 1 "source.c" by adding an entry to the DWARF-2 file table
755 If an entry is added to the file table, return a pointer to the filename. */
758 dwarf2_directive_filename (void)
764 /* Continue to accept a bare string and pass it off. */
766 if (*input_line_pointer == '"')
772 num = get_absolute_expression ();
773 filename = demand_copy_C_string (&filename_len);
774 if (filename == NULL)
776 demand_empty_rest_of_line ();
780 as_bad (_("file number less than one"));
784 /* A .file directive implies compiler generated debug information is
785 being supplied. Turn off gas generated debug info. */
786 debug_type = DEBUG_NONE;
788 if (num < (int) files_in_use && files[num].filename != 0)
790 as_bad (_("file number %ld already allocated"), (long) num);
794 get_filenum (filename, num);
799 /* Calls dwarf2_directive_filename, but discards its result.
800 Used in pseudo-op tables where the function result is ignored. */
803 dwarf2_directive_file (int dummy ATTRIBUTE_UNUSED)
805 (void) dwarf2_directive_filename ();
809 dwarf2_directive_loc (int dummy ATTRIBUTE_UNUSED)
811 offsetT filenum, line;
813 /* If we see two .loc directives in a row, force the first one to be
815 if (dwarf2_loc_directive_seen)
816 dwarf2_emit_insn (0);
818 filenum = get_absolute_expression ();
820 line = get_absolute_expression ();
824 as_bad (_("file number less than one"));
827 if (filenum >= (int) files_in_use || files[filenum].filename == 0)
829 as_bad (_("unassigned file number %ld"), (long) filenum);
833 current.filenum = filenum;
835 current.discriminator = 0;
840 if (files[filenum].dir)
842 size_t dir_len = strlen (dirs[files[filenum].dir]);
843 size_t file_len = strlen (files[filenum].filename);
844 char *cp = XNEWVEC (char, dir_len + 1 + file_len + 1);
846 memcpy (cp, dirs[files[filenum].dir], dir_len);
847 INSERT_DIR_SEPARATOR (cp, dir_len);
848 memcpy (cp + dir_len + 1, files[filenum].filename, file_len);
849 cp[dir_len + file_len + 1] = '\0';
850 listing_source_file (cp);
854 listing_source_file (files[filenum].filename);
855 listing_source_line (line);
860 if (ISDIGIT (*input_line_pointer))
862 current.column = get_absolute_expression ();
866 while (ISALPHA (*input_line_pointer))
871 c = get_symbol_name (& p);
873 if (strcmp (p, "basic_block") == 0)
875 current.flags |= DWARF2_FLAG_BASIC_BLOCK;
876 *input_line_pointer = c;
878 else if (strcmp (p, "prologue_end") == 0)
880 current.flags |= DWARF2_FLAG_PROLOGUE_END;
881 *input_line_pointer = c;
883 else if (strcmp (p, "epilogue_begin") == 0)
885 current.flags |= DWARF2_FLAG_EPILOGUE_BEGIN;
886 *input_line_pointer = c;
888 else if (strcmp (p, "is_stmt") == 0)
890 (void) restore_line_pointer (c);
891 value = get_absolute_expression ();
893 current.flags &= ~DWARF2_FLAG_IS_STMT;
895 current.flags |= DWARF2_FLAG_IS_STMT;
898 as_bad (_("is_stmt value not 0 or 1"));
902 else if (strcmp (p, "isa") == 0)
904 (void) restore_line_pointer (c);
905 value = get_absolute_expression ();
910 as_bad (_("isa number less than zero"));
914 else if (strcmp (p, "discriminator") == 0)
916 (void) restore_line_pointer (c);
917 value = get_absolute_expression ();
919 current.discriminator = value;
922 as_bad (_("discriminator less than zero"));
926 else if (strcmp (p, "view") == 0)
930 (void) restore_line_pointer (c);
933 if (ISDIGIT (*input_line_pointer)
934 || *input_line_pointer == '-')
936 bfd_boolean force_reset = *input_line_pointer == '-';
938 value = get_absolute_expression ();
941 as_bad (_("numeric view can only be asserted to zero"));
944 if (force_reset && force_reset_view)
945 sym = force_reset_view;
948 sym = symbol_temp_new (absolute_section, value,
951 force_reset_view = sym;
956 char *name = read_symbol_name ();
960 sym = symbol_find_or_make (name);
961 if (S_IS_DEFINED (sym))
963 if (!S_CAN_BE_REDEFINED (sym))
964 as_bad (_("symbol `%s' is already defined"), name);
966 sym = symbol_clone (sym, 1);
967 S_SET_SEGMENT (sym, undefined_section);
968 S_SET_VALUE (sym, 0);
969 symbol_set_frag (sym, &zero_address_frag);
976 as_bad (_("unknown .loc sub-directive `%s'"), p);
977 (void) restore_line_pointer (c);
981 SKIP_WHITESPACE_AFTER_NAME ();
984 demand_empty_rest_of_line ();
985 dwarf2_loc_directive_seen = TRUE;
986 debug_type = DEBUG_NONE;
988 /* If we were given a view id, emit the row right away. */
990 dwarf2_emit_insn (0);
994 dwarf2_directive_loc_mark_labels (int dummy ATTRIBUTE_UNUSED)
996 offsetT value = get_absolute_expression ();
998 if (value != 0 && value != 1)
1000 as_bad (_("expected 0 or 1"));
1001 ignore_rest_of_line ();
1005 dwarf2_loc_mark_labels = value != 0;
1006 demand_empty_rest_of_line ();
1010 static struct frag *
1011 first_frag_for_seg (segT seg)
1013 return seg_info (seg)->frchainP->frch_root;
1016 static struct frag *
1017 last_frag_for_seg (segT seg)
1019 frchainS *f = seg_info (seg)->frchainP;
1021 while (f->frch_next != NULL)
1024 return f->frch_last;
1027 /* Emit a single byte into the current segment. */
1032 FRAG_APPEND_1_CHAR (byte);
1035 /* Emit a statement program opcode into the current segment. */
1038 out_opcode (int opc)
1043 /* Emit a two-byte word into the current segment. */
1048 md_number_to_chars (frag_more (2), data, 2);
1051 /* Emit a four byte word into the current segment. */
1056 md_number_to_chars (frag_more (4), data, 4);
1059 /* Emit an unsigned "little-endian base 128" number. */
1062 out_uleb128 (addressT value)
1064 output_leb128 (frag_more (sizeof_leb128 (value, 0)), value, 0);
1067 /* Emit a signed "little-endian base 128" number. */
1070 out_leb128 (addressT value)
1072 output_leb128 (frag_more (sizeof_leb128 (value, 1)), value, 1);
1075 /* Emit a tuple for .debug_abbrev. */
1078 out_abbrev (int name, int form)
1084 /* Get the size of a fragment. */
1087 get_frag_fix (fragS *frag, segT seg)
1092 return frag->fr_fix;
1094 /* If a fragment is the last in the chain, special measures must be
1095 taken to find its size before relaxation, since it may be pending
1096 on some subsegment chain. */
1097 for (fr = seg_info (seg)->frchainP; fr; fr = fr->frch_next)
1098 if (fr->frch_last == frag)
1099 return (char *) obstack_next_free (&fr->frch_obstack) - frag->fr_literal;
1104 /* Set an absolute address (may result in a relocation entry). */
1107 out_set_addr (symbolS *sym)
1111 out_opcode (DW_LNS_extended_op);
1112 out_uleb128 (sizeof_address + 1);
1114 out_opcode (DW_LNE_set_address);
1115 exp.X_op = O_symbol;
1116 exp.X_add_symbol = sym;
1117 exp.X_add_number = 0;
1118 emit_expr (&exp, sizeof_address);
1121 static void scale_addr_delta (addressT *);
1124 scale_addr_delta (addressT *addr_delta)
1126 static int printed_this = 0;
1127 if (DWARF2_LINE_MIN_INSN_LENGTH > 1)
1129 if (*addr_delta % DWARF2_LINE_MIN_INSN_LENGTH != 0 && !printed_this)
1131 as_bad("unaligned opcodes detected in executable segment");
1134 *addr_delta /= DWARF2_LINE_MIN_INSN_LENGTH;
1138 /* Encode a pair of line and address skips as efficiently as possible.
1139 Note that the line skip is signed, whereas the address skip is unsigned.
1141 The following two routines *must* be kept in sync. This is
1142 enforced by making emit_inc_line_addr abort if we do not emit
1143 exactly the expected number of bytes. */
1146 size_inc_line_addr (int line_delta, addressT addr_delta)
1148 unsigned int tmp, opcode;
1151 /* Scale the address delta by the minimum instruction length. */
1152 scale_addr_delta (&addr_delta);
1154 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1155 We cannot use special opcodes here, since we want the end_sequence
1156 to emit the matrix entry. */
1157 if (line_delta == INT_MAX)
1159 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1162 len = 1 + sizeof_leb128 (addr_delta, 0);
1166 /* Bias the line delta by the base. */
1167 tmp = line_delta - DWARF2_LINE_BASE;
1169 /* If the line increment is out of range of a special opcode, we
1170 must encode it with DW_LNS_advance_line. */
1171 if (tmp >= DWARF2_LINE_RANGE)
1173 len = 1 + sizeof_leb128 (line_delta, 1);
1175 tmp = 0 - DWARF2_LINE_BASE;
1178 /* Bias the opcode by the special opcode base. */
1179 tmp += DWARF2_LINE_OPCODE_BASE;
1181 /* Avoid overflow when addr_delta is large. */
1182 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1184 /* Try using a special opcode. */
1185 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1189 /* Try using DW_LNS_const_add_pc followed by special op. */
1190 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1195 /* Otherwise use DW_LNS_advance_pc. */
1196 len += 1 + sizeof_leb128 (addr_delta, 0);
1198 /* DW_LNS_copy or special opcode. */
1205 emit_inc_line_addr (int line_delta, addressT addr_delta, char *p, int len)
1207 unsigned int tmp, opcode;
1209 char *end = p + len;
1211 /* Line number sequences cannot go backward in addresses. This means
1212 we've incorrectly ordered the statements in the sequence. */
1213 gas_assert ((offsetT) addr_delta >= 0);
1215 /* Scale the address delta by the minimum instruction length. */
1216 scale_addr_delta (&addr_delta);
1218 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1219 We cannot use special opcodes here, since we want the end_sequence
1220 to emit the matrix entry. */
1221 if (line_delta == INT_MAX)
1223 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1224 *p++ = DW_LNS_const_add_pc;
1227 *p++ = DW_LNS_advance_pc;
1228 p += output_leb128 (p, addr_delta, 0);
1231 *p++ = DW_LNS_extended_op;
1233 *p++ = DW_LNE_end_sequence;
1237 /* Bias the line delta by the base. */
1238 tmp = line_delta - DWARF2_LINE_BASE;
1240 /* If the line increment is out of range of a special opcode, we
1241 must encode it with DW_LNS_advance_line. */
1242 if (tmp >= DWARF2_LINE_RANGE)
1244 *p++ = DW_LNS_advance_line;
1245 p += output_leb128 (p, line_delta, 1);
1248 tmp = 0 - DWARF2_LINE_BASE;
1252 /* Prettier, I think, to use DW_LNS_copy instead of a "line +0, addr +0"
1254 if (line_delta == 0 && addr_delta == 0)
1260 /* Bias the opcode by the special opcode base. */
1261 tmp += DWARF2_LINE_OPCODE_BASE;
1263 /* Avoid overflow when addr_delta is large. */
1264 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1266 /* Try using a special opcode. */
1267 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1274 /* Try using DW_LNS_const_add_pc followed by special op. */
1275 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1278 *p++ = DW_LNS_const_add_pc;
1284 /* Otherwise use DW_LNS_advance_pc. */
1285 *p++ = DW_LNS_advance_pc;
1286 p += output_leb128 (p, addr_delta, 0);
1294 gas_assert (p == end);
1297 /* Handy routine to combine calls to the above two routines. */
1300 out_inc_line_addr (int line_delta, addressT addr_delta)
1302 int len = size_inc_line_addr (line_delta, addr_delta);
1303 emit_inc_line_addr (line_delta, addr_delta, frag_more (len), len);
1306 /* Write out an alternative form of line and address skips using
1307 DW_LNS_fixed_advance_pc opcodes. This uses more space than the default
1308 line and address information, but it is required if linker relaxation
1309 could change the code offsets. The following two routines *must* be
1311 #define ADDR_DELTA_LIMIT 50000
1314 size_fixed_inc_line_addr (int line_delta, addressT addr_delta)
1318 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1319 if (line_delta != INT_MAX)
1320 len = 1 + sizeof_leb128 (line_delta, 1);
1322 if (addr_delta > ADDR_DELTA_LIMIT)
1324 /* DW_LNS_extended_op */
1325 len += 1 + sizeof_leb128 (sizeof_address + 1, 0);
1326 /* DW_LNE_set_address */
1327 len += 1 + sizeof_address;
1330 /* DW_LNS_fixed_advance_pc */
1333 if (line_delta == INT_MAX)
1334 /* DW_LNS_extended_op + DW_LNE_end_sequence */
1344 emit_fixed_inc_line_addr (int line_delta, addressT addr_delta, fragS *frag,
1348 char *end = p + len;
1350 /* Line number sequences cannot go backward in addresses. This means
1351 we've incorrectly ordered the statements in the sequence. */
1352 gas_assert ((offsetT) addr_delta >= 0);
1354 /* Verify that we have kept in sync with size_fixed_inc_line_addr. */
1355 gas_assert (len == size_fixed_inc_line_addr (line_delta, addr_delta));
1357 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1358 if (line_delta != INT_MAX)
1360 *p++ = DW_LNS_advance_line;
1361 p += output_leb128 (p, line_delta, 1);
1364 pexp = symbol_get_value_expression (frag->fr_symbol);
1366 /* The DW_LNS_fixed_advance_pc opcode has a 2-byte operand so it can
1367 advance the address by at most 64K. Linker relaxation (without
1368 which this function would not be used) could change the operand by
1369 an unknown amount. If the address increment is getting close to
1370 the limit, just reset the address. */
1371 if (addr_delta > ADDR_DELTA_LIMIT)
1376 gas_assert (pexp->X_op == O_subtract);
1377 to_sym = pexp->X_add_symbol;
1379 *p++ = DW_LNS_extended_op;
1380 p += output_leb128 (p, sizeof_address + 1, 0);
1381 *p++ = DW_LNE_set_address;
1382 exp.X_op = O_symbol;
1383 exp.X_add_symbol = to_sym;
1384 exp.X_add_number = 0;
1385 emit_expr_fix (&exp, sizeof_address, frag, p, TC_PARSE_CONS_RETURN_NONE);
1386 p += sizeof_address;
1390 *p++ = DW_LNS_fixed_advance_pc;
1391 emit_expr_fix (pexp, 2, frag, p, TC_PARSE_CONS_RETURN_NONE);
1395 if (line_delta == INT_MAX)
1397 *p++ = DW_LNS_extended_op;
1399 *p++ = DW_LNE_end_sequence;
1404 gas_assert (p == end);
1407 /* Generate a variant frag that we can use to relax address/line
1408 increments between fragments of the target segment. */
1411 relax_inc_line_addr (int line_delta, symbolS *to_sym, symbolS *from_sym)
1416 exp.X_op = O_subtract;
1417 exp.X_add_symbol = to_sym;
1418 exp.X_op_symbol = from_sym;
1419 exp.X_add_number = 0;
1421 /* The maximum size of the frag is the line delta with a maximum
1422 sized address delta. */
1423 if (DWARF2_USE_FIXED_ADVANCE_PC)
1424 max_chars = size_fixed_inc_line_addr (line_delta,
1425 -DWARF2_LINE_MIN_INSN_LENGTH);
1427 max_chars = size_inc_line_addr (line_delta, -DWARF2_LINE_MIN_INSN_LENGTH);
1429 frag_var (rs_dwarf2dbg, max_chars, max_chars, 1,
1430 make_expr_symbol (&exp), line_delta, NULL);
1433 /* The function estimates the size of a rs_dwarf2dbg variant frag
1434 based on the current values of the symbols. It is called before
1435 the relaxation loop. We set fr_subtype to the expected length. */
1438 dwarf2dbg_estimate_size_before_relax (fragS *frag)
1443 addr_delta = resolve_symbol_value (frag->fr_symbol);
1444 if (DWARF2_USE_FIXED_ADVANCE_PC)
1445 size = size_fixed_inc_line_addr (frag->fr_offset, addr_delta);
1447 size = size_inc_line_addr (frag->fr_offset, addr_delta);
1449 frag->fr_subtype = size;
1454 /* This function relaxes a rs_dwarf2dbg variant frag based on the
1455 current values of the symbols. fr_subtype is the current length
1456 of the frag. This returns the change in frag length. */
1459 dwarf2dbg_relax_frag (fragS *frag)
1461 int old_size, new_size;
1463 old_size = frag->fr_subtype;
1464 new_size = dwarf2dbg_estimate_size_before_relax (frag);
1466 return new_size - old_size;
1469 /* This function converts a rs_dwarf2dbg variant frag into a normal
1470 fill frag. This is called after all relaxation has been done.
1471 fr_subtype will be the desired length of the frag. */
1474 dwarf2dbg_convert_frag (fragS *frag)
1478 if (DWARF2_USE_FIXED_ADVANCE_PC)
1480 /* If linker relaxation is enabled then the distance between the two
1481 symbols in the frag->fr_symbol expression might change. Hence we
1482 cannot rely upon the value computed by resolve_symbol_value.
1483 Instead we leave the expression unfinalized and allow
1484 emit_fixed_inc_line_addr to create a fixup (which later becomes a
1485 relocation) that will allow the linker to correctly compute the
1486 actual address difference. We have to use a fixed line advance for
1487 this as we cannot (easily) relocate leb128 encoded values. */
1488 int saved_finalize_syms = finalize_syms;
1491 addr_diff = resolve_symbol_value (frag->fr_symbol);
1492 finalize_syms = saved_finalize_syms;
1495 addr_diff = resolve_symbol_value (frag->fr_symbol);
1497 /* fr_var carries the max_chars that we created the fragment with.
1498 fr_subtype carries the current expected length. We must, of
1499 course, have allocated enough memory earlier. */
1500 gas_assert (frag->fr_var >= (int) frag->fr_subtype);
1502 if (DWARF2_USE_FIXED_ADVANCE_PC)
1503 emit_fixed_inc_line_addr (frag->fr_offset, addr_diff, frag,
1504 frag->fr_literal + frag->fr_fix,
1507 emit_inc_line_addr (frag->fr_offset, addr_diff,
1508 frag->fr_literal + frag->fr_fix, frag->fr_subtype);
1510 frag->fr_fix += frag->fr_subtype;
1511 frag->fr_type = rs_fill;
1513 frag->fr_offset = 0;
1516 /* Generate .debug_line content for the chain of line number entries
1517 beginning at E, for segment SEG. */
1520 process_entries (segT seg, struct line_entry *e)
1522 unsigned filenum = 1;
1524 unsigned column = 0;
1526 unsigned flags = DWARF2_LINE_DEFAULT_IS_STMT ? DWARF2_FLAG_IS_STMT : 0;
1527 fragS *last_frag = NULL, *frag;
1528 addressT last_frag_ofs = 0, frag_ofs;
1529 symbolS *last_lab = NULL, *lab;
1530 struct line_entry *next;
1532 if (flag_dwarf_sections)
1535 const char * sec_name;
1537 /* Switch to the relevant sub-section before we start to emit
1538 the line number table.
1540 FIXME: These sub-sections do not have a normal Line Number
1541 Program Header, thus strictly speaking they are not valid
1542 DWARF sections. Unfortunately the DWARF standard assumes
1543 a one-to-one relationship between compilation units and
1544 line number tables. Thus we have to have a .debug_line
1545 section, as well as our sub-sections, and we have to ensure
1546 that all of the sub-sections are merged into a proper
1547 .debug_line section before a debugger sees them. */
1549 sec_name = bfd_get_section_name (stdoutput, seg);
1550 if (strcmp (sec_name, ".text") != 0)
1552 name = concat (".debug_line", sec_name, (char *) NULL);
1553 subseg_set (subseg_get (name, FALSE), 0);
1556 /* Don't create a .debug_line.text section -
1557 that is redundant. Instead just switch back to the
1558 normal .debug_line section. */
1559 subseg_set (subseg_get (".debug_line", FALSE), 0);
1566 if (filenum != e->loc.filenum)
1568 filenum = e->loc.filenum;
1569 out_opcode (DW_LNS_set_file);
1570 out_uleb128 (filenum);
1573 if (column != e->loc.column)
1575 column = e->loc.column;
1576 out_opcode (DW_LNS_set_column);
1577 out_uleb128 (column);
1580 if (e->loc.discriminator != 0)
1582 out_opcode (DW_LNS_extended_op);
1583 out_leb128 (1 + sizeof_leb128 (e->loc.discriminator, 0));
1584 out_opcode (DW_LNE_set_discriminator);
1585 out_uleb128 (e->loc.discriminator);
1588 if (isa != e->loc.isa)
1591 out_opcode (DW_LNS_set_isa);
1595 if ((e->loc.flags ^ flags) & DWARF2_FLAG_IS_STMT)
1597 flags = e->loc.flags;
1598 out_opcode (DW_LNS_negate_stmt);
1601 if (e->loc.flags & DWARF2_FLAG_BASIC_BLOCK)
1602 out_opcode (DW_LNS_set_basic_block);
1604 if (e->loc.flags & DWARF2_FLAG_PROLOGUE_END)
1605 out_opcode (DW_LNS_set_prologue_end);
1607 if (e->loc.flags & DWARF2_FLAG_EPILOGUE_BEGIN)
1608 out_opcode (DW_LNS_set_epilogue_begin);
1610 /* Don't try to optimize away redundant entries; gdb wants two
1611 entries for a function where the code starts on the same line as
1612 the {, and there's no way to identify that case here. Trust gcc
1613 to optimize appropriately. */
1614 line_delta = e->loc.line - line;
1616 frag = symbol_get_frag (lab);
1617 frag_ofs = S_GET_VALUE (lab);
1619 if (last_frag == NULL
1620 || (e->loc.view == force_reset_view && force_reset_view
1621 /* If we're going to reset the view, but we know we're
1622 advancing the PC, we don't have to force with
1623 set_address. We know we do when we're at the same
1624 address of the same frag, and we know we might when
1625 we're in the beginning of a frag, and we were at the
1626 end of the previous frag. */
1627 && (frag == last_frag
1628 ? (last_frag_ofs == frag_ofs)
1630 && ((offsetT)last_frag_ofs
1631 >= get_frag_fix (last_frag, seg))))))
1634 out_inc_line_addr (line_delta, 0);
1636 else if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1637 out_inc_line_addr (line_delta, frag_ofs - last_frag_ofs);
1639 relax_inc_line_addr (line_delta, lab, last_lab);
1644 last_frag_ofs = frag_ofs;
1652 /* Emit a DW_LNE_end_sequence for the end of the section. */
1653 frag = last_frag_for_seg (seg);
1654 frag_ofs = get_frag_fix (frag, seg);
1655 if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1656 out_inc_line_addr (INT_MAX, frag_ofs - last_frag_ofs);
1659 lab = symbol_temp_new (seg, frag_ofs, frag);
1660 relax_inc_line_addr (INT_MAX, lab, last_lab);
1664 /* Emit the directory and file tables for .debug_line. */
1667 out_file_list (void)
1674 /* Emit directory list. */
1675 for (i = 1; i < dirs_in_use; ++i)
1677 dir = remap_debug_filename (dirs[i]);
1678 size = strlen (dir) + 1;
1679 cp = frag_more (size);
1680 memcpy (cp, dir, size);
1685 for (i = 1; i < files_in_use; ++i)
1687 const char *fullfilename;
1689 if (files[i].filename == NULL)
1691 as_bad (_("unassigned file number %ld"), (long) i);
1692 /* Prevent a crash later, particularly for file 1. */
1693 files[i].filename = "";
1697 fullfilename = DWARF2_FILE_NAME (files[i].filename,
1698 files[i].dir ? dirs [files [i].dir] : "");
1699 size = strlen (fullfilename) + 1;
1700 cp = frag_more (size);
1701 memcpy (cp, fullfilename, size);
1703 out_uleb128 (files[i].dir); /* directory number */
1704 /* Output the last modification timestamp. */
1705 out_uleb128 (DWARF2_FILE_TIME_NAME (files[i].filename,
1706 files[i].dir ? dirs [files [i].dir] : ""));
1707 /* Output the filesize. */
1708 out_uleb128 (DWARF2_FILE_SIZE_NAME (files[i].filename,
1709 files[i].dir ? dirs [files [i].dir] : ""));
1712 /* Terminate filename list. */
1716 /* Switch to SEC and output a header length field. Return the size of
1717 offsets used in SEC. The caller must set EXPR->X_add_symbol value
1718 to the end of the section. EXPR->X_add_number will be set to the
1719 negative size of the header. */
1722 out_header (asection *sec, expressionS *exp)
1727 subseg_set (sec, 0);
1729 if (flag_dwarf_sections)
1731 /* If we are going to put the start and end symbols in different
1732 sections, then we need real symbols, not just fake, local ones. */
1734 start_sym = symbol_make (".Ldebug_line_start");
1735 end_sym = symbol_make (".Ldebug_line_end");
1736 symbol_set_value_now (start_sym);
1740 start_sym = symbol_temp_new_now ();
1741 end_sym = symbol_temp_make ();
1744 /* Total length of the information. */
1745 exp->X_op = O_subtract;
1746 exp->X_add_symbol = end_sym;
1747 exp->X_op_symbol = start_sym;
1749 switch (DWARF2_FORMAT (sec))
1751 case dwarf2_format_32bit:
1752 exp->X_add_number = -4;
1756 case dwarf2_format_64bit:
1757 exp->X_add_number = -12;
1762 case dwarf2_format_64bit_irix:
1763 exp->X_add_number = -8;
1768 as_fatal (_("internal error: unknown dwarf2 format"));
1772 /* Emit the collected .debug_line data. */
1775 out_debug_line (segT line_seg)
1778 symbolS *prologue_start, *prologue_end;
1783 sizeof_offset = out_header (line_seg, &exp);
1784 line_end = exp.X_add_symbol;
1787 out_two (DWARF2_LINE_VERSION);
1789 /* Length of the prologue following this length. */
1790 prologue_start = symbol_temp_make ();
1791 prologue_end = symbol_temp_make ();
1792 exp.X_op = O_subtract;
1793 exp.X_add_symbol = prologue_end;
1794 exp.X_op_symbol = prologue_start;
1795 exp.X_add_number = 0;
1796 emit_expr (&exp, sizeof_offset);
1797 symbol_set_value_now (prologue_start);
1799 /* Parameters of the state machine. */
1800 out_byte (DWARF2_LINE_MIN_INSN_LENGTH);
1801 out_byte (DWARF2_LINE_DEFAULT_IS_STMT);
1802 out_byte (DWARF2_LINE_BASE);
1803 out_byte (DWARF2_LINE_RANGE);
1804 out_byte (DWARF2_LINE_OPCODE_BASE);
1806 /* Standard opcode lengths. */
1807 out_byte (0); /* DW_LNS_copy */
1808 out_byte (1); /* DW_LNS_advance_pc */
1809 out_byte (1); /* DW_LNS_advance_line */
1810 out_byte (1); /* DW_LNS_set_file */
1811 out_byte (1); /* DW_LNS_set_column */
1812 out_byte (0); /* DW_LNS_negate_stmt */
1813 out_byte (0); /* DW_LNS_set_basic_block */
1814 out_byte (0); /* DW_LNS_const_add_pc */
1815 out_byte (1); /* DW_LNS_fixed_advance_pc */
1816 out_byte (0); /* DW_LNS_set_prologue_end */
1817 out_byte (0); /* DW_LNS_set_epilogue_begin */
1818 out_byte (1); /* DW_LNS_set_isa */
1822 symbol_set_value_now (prologue_end);
1824 /* For each section, emit a statement program. */
1825 for (s = all_segs; s; s = s->next)
1826 if (SEG_NORMAL (s->seg))
1827 process_entries (s->seg, s->head->head);
1829 as_warn ("dwarf line number information for %s ignored",
1830 segment_name (s->seg));
1832 if (flag_dwarf_sections)
1833 /* We have to switch to the special .debug_line_end section
1834 before emitting the end-of-debug_line symbol. The linker
1835 script arranges for this section to be placed after all the
1836 (potentially garbage collected) .debug_line.<foo> sections.
1837 This section contains the line_end symbol which is used to
1838 compute the size of the linked .debug_line section, as seen
1839 in the DWARF Line Number header. */
1840 subseg_set (subseg_get (".debug_line_end", FALSE), 0);
1842 symbol_set_value_now (line_end);
1846 out_debug_ranges (segT ranges_seg)
1848 unsigned int addr_size = sizeof_address;
1853 subseg_set (ranges_seg, 0);
1855 /* Base Address Entry. */
1856 for (i = 0; i < addr_size; i++)
1858 for (i = 0; i < addr_size; i++)
1861 /* Range List Entry. */
1862 for (s = all_segs; s; s = s->next)
1867 frag = first_frag_for_seg (s->seg);
1868 beg = symbol_temp_new (s->seg, 0, frag);
1869 s->text_start = beg;
1871 frag = last_frag_for_seg (s->seg);
1872 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1875 exp.X_op = O_symbol;
1876 exp.X_add_symbol = beg;
1877 exp.X_add_number = 0;
1878 emit_expr (&exp, addr_size);
1880 exp.X_op = O_symbol;
1881 exp.X_add_symbol = end;
1882 exp.X_add_number = 0;
1883 emit_expr (&exp, addr_size);
1886 /* End of Range Entry. */
1887 for (i = 0; i < addr_size; i++)
1889 for (i = 0; i < addr_size; i++)
1893 /* Emit data for .debug_aranges. */
1896 out_debug_aranges (segT aranges_seg, segT info_seg)
1898 unsigned int addr_size = sizeof_address;
1902 symbolS *aranges_end;
1906 sizeof_offset = out_header (aranges_seg, &exp);
1907 aranges_end = exp.X_add_symbol;
1908 size = -exp.X_add_number;
1911 out_two (DWARF2_ARANGES_VERSION);
1914 /* Offset to .debug_info. */
1915 TC_DWARF2_EMIT_OFFSET (section_symbol (info_seg), sizeof_offset);
1916 size += sizeof_offset;
1918 /* Size of an address (offset portion). */
1919 out_byte (addr_size);
1922 /* Size of a segment descriptor. */
1926 /* Align the header. */
1927 while ((size++ % (2 * addr_size)) > 0)
1930 for (s = all_segs; s; s = s->next)
1935 frag = first_frag_for_seg (s->seg);
1936 beg = symbol_temp_new (s->seg, 0, frag);
1937 s->text_start = beg;
1939 frag = last_frag_for_seg (s->seg);
1940 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1943 exp.X_op = O_symbol;
1944 exp.X_add_symbol = beg;
1945 exp.X_add_number = 0;
1946 emit_expr (&exp, addr_size);
1948 exp.X_op = O_subtract;
1949 exp.X_add_symbol = end;
1950 exp.X_op_symbol = beg;
1951 exp.X_add_number = 0;
1952 emit_expr (&exp, addr_size);
1955 p = frag_more (2 * addr_size);
1956 md_number_to_chars (p, 0, addr_size);
1957 md_number_to_chars (p + addr_size, 0, addr_size);
1959 symbol_set_value_now (aranges_end);
1962 /* Emit data for .debug_abbrev. Note that this must be kept in
1963 sync with out_debug_info below. */
1966 out_debug_abbrev (segT abbrev_seg,
1967 segT info_seg ATTRIBUTE_UNUSED,
1968 segT line_seg ATTRIBUTE_UNUSED)
1970 subseg_set (abbrev_seg, 0);
1973 out_uleb128 (DW_TAG_compile_unit);
1974 out_byte (DW_CHILDREN_no);
1975 if (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit)
1976 out_abbrev (DW_AT_stmt_list, DW_FORM_data4);
1978 out_abbrev (DW_AT_stmt_list, DW_FORM_data8);
1979 if (all_segs->next == NULL)
1981 out_abbrev (DW_AT_low_pc, DW_FORM_addr);
1982 if (DWARF2_VERSION < 4)
1983 out_abbrev (DW_AT_high_pc, DW_FORM_addr);
1985 out_abbrev (DW_AT_high_pc, (sizeof_address == 4
1986 ? DW_FORM_data4 : DW_FORM_data8));
1990 if (DWARF2_FORMAT (info_seg) == dwarf2_format_32bit)
1991 out_abbrev (DW_AT_ranges, DW_FORM_data4);
1993 out_abbrev (DW_AT_ranges, DW_FORM_data8);
1995 out_abbrev (DW_AT_name, DW_FORM_strp);
1996 out_abbrev (DW_AT_comp_dir, DW_FORM_strp);
1997 out_abbrev (DW_AT_producer, DW_FORM_strp);
1998 out_abbrev (DW_AT_language, DW_FORM_data2);
2001 /* Terminate the abbreviations for this compilation unit. */
2005 /* Emit a description of this compilation unit for .debug_info. */
2008 out_debug_info (segT info_seg, segT abbrev_seg, segT line_seg, segT ranges_seg,
2009 symbolS *name_sym, symbolS *comp_dir_sym, symbolS *producer_sym)
2015 sizeof_offset = out_header (info_seg, &exp);
2016 info_end = exp.X_add_symbol;
2018 /* DWARF version. */
2019 out_two (DWARF2_VERSION);
2021 /* .debug_abbrev offset */
2022 TC_DWARF2_EMIT_OFFSET (section_symbol (abbrev_seg), sizeof_offset);
2024 /* Target address size. */
2025 out_byte (sizeof_address);
2027 /* DW_TAG_compile_unit DIE abbrev */
2030 /* DW_AT_stmt_list */
2031 TC_DWARF2_EMIT_OFFSET (section_symbol (line_seg),
2032 (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit
2035 /* These two attributes are emitted if all of the code is contiguous. */
2036 if (all_segs->next == NULL)
2039 exp.X_op = O_symbol;
2040 exp.X_add_symbol = all_segs->text_start;
2041 exp.X_add_number = 0;
2042 emit_expr (&exp, sizeof_address);
2045 if (DWARF2_VERSION < 4)
2046 exp.X_op = O_symbol;
2049 exp.X_op = O_subtract;
2050 exp.X_op_symbol = all_segs->text_start;
2052 exp.X_add_symbol = all_segs->text_end;
2053 exp.X_add_number = 0;
2054 emit_expr (&exp, sizeof_address);
2058 /* This attribute is emitted if the code is disjoint. */
2060 TC_DWARF2_EMIT_OFFSET (section_symbol (ranges_seg), sizeof_offset);
2063 /* DW_AT_name, DW_AT_comp_dir and DW_AT_producer. Symbols in .debug_str
2064 setup in out_debug_str below. */
2065 TC_DWARF2_EMIT_OFFSET (name_sym, sizeof_offset);
2066 TC_DWARF2_EMIT_OFFSET (comp_dir_sym, sizeof_offset);
2067 TC_DWARF2_EMIT_OFFSET (producer_sym, sizeof_offset);
2069 /* DW_AT_language. Yes, this is probably not really MIPS, but the
2070 dwarf2 draft has no standard code for assembler. */
2071 out_two (DW_LANG_Mips_Assembler);
2073 symbol_set_value_now (info_end);
2076 /* Emit the three debug strings needed in .debug_str and setup symbols
2077 to them for use in out_debug_info. */
2079 out_debug_str (segT str_seg, symbolS **name_sym, symbolS **comp_dir_sym,
2080 symbolS **producer_sym)
2083 const char *comp_dir;
2084 const char *dirname;
2088 subseg_set (str_seg, 0);
2090 /* DW_AT_name. We don't have the actual file name that was present
2091 on the command line, so assume files[1] is the main input file.
2092 We're not supposed to get called unless at least one line number
2093 entry was emitted, so this should always be defined. */
2094 *name_sym = symbol_temp_new_now ();
2095 if (files_in_use == 0)
2099 dirname = remap_debug_filename (dirs[files[1].dir]);
2100 len = strlen (dirname);
2102 /* Already has trailing slash. */
2103 p = frag_more (len);
2104 memcpy (p, dirname, len);
2106 p = frag_more (len + 1);
2107 memcpy (p, dirname, len);
2108 INSERT_DIR_SEPARATOR (p, len);
2111 len = strlen (files[1].filename) + 1;
2112 p = frag_more (len);
2113 memcpy (p, files[1].filename, len);
2115 /* DW_AT_comp_dir */
2116 *comp_dir_sym = symbol_temp_new_now ();
2117 comp_dir = remap_debug_filename (getpwd ());
2118 len = strlen (comp_dir) + 1;
2119 p = frag_more (len);
2120 memcpy (p, comp_dir, len);
2122 /* DW_AT_producer */
2123 *producer_sym = symbol_temp_new_now ();
2124 sprintf (producer, "GNU AS %s", VERSION);
2125 len = strlen (producer) + 1;
2126 p = frag_more (len);
2127 memcpy (p, producer, len);
2133 last_seg_ptr = &all_segs;
2137 /* Finish the dwarf2 debug sections. We emit .debug.line if there
2138 were any .file/.loc directives, or --gdwarf2 was given, or if the
2139 file has a non-empty .debug_info section and an empty .debug_line
2140 section. If we emit .debug_line, and the .debug_info section is
2141 empty, we also emit .debug_info, .debug_aranges and .debug_abbrev.
2142 ALL_SEGS will be non-null if there were any .file/.loc directives,
2143 or --gdwarf2 was given and there were any located instructions
2147 dwarf2_finish (void)
2152 int emit_other_sections = 0;
2153 int empty_debug_line = 0;
2155 info_seg = bfd_get_section_by_name (stdoutput, ".debug_info");
2156 emit_other_sections = info_seg == NULL || !seg_not_empty_p (info_seg);
2158 line_seg = bfd_get_section_by_name (stdoutput, ".debug_line");
2159 empty_debug_line = line_seg == NULL || !seg_not_empty_p (line_seg);
2161 /* We can't construct a new debug_line section if we already have one.
2163 if (all_segs && !empty_debug_line)
2164 as_fatal ("duplicate .debug_line sections");
2166 if ((!all_segs && emit_other_sections)
2167 || (!emit_other_sections && !empty_debug_line))
2168 /* If there is no line information and no non-empty .debug_info
2169 section, or if there is both a non-empty .debug_info and a non-empty
2170 .debug_line, then we do nothing. */
2173 /* Calculate the size of an address for the target machine. */
2174 sizeof_address = DWARF2_ADDR_SIZE (stdoutput);
2176 /* Create and switch to the line number section. */
2177 line_seg = subseg_new (".debug_line", 0);
2178 bfd_set_section_flags (stdoutput, line_seg, SEC_READONLY | SEC_DEBUGGING);
2180 /* For each subsection, chain the debug entries together. */
2181 for (s = all_segs; s; s = s->next)
2183 struct line_subseg *lss = s->head;
2184 struct line_entry **ptail = lss->ptail;
2186 while ((lss = lss->next) != NULL)
2193 out_debug_line (line_seg);
2195 /* If this is assembler generated line info, and there is no
2196 debug_info already, we need .debug_info, .debug_abbrev and
2197 .debug_str sections as well. */
2198 if (emit_other_sections)
2204 symbolS *name_sym, *comp_dir_sym, *producer_sym;
2206 gas_assert (all_segs);
2208 info_seg = subseg_new (".debug_info", 0);
2209 abbrev_seg = subseg_new (".debug_abbrev", 0);
2210 aranges_seg = subseg_new (".debug_aranges", 0);
2211 str_seg = subseg_new (".debug_str", 0);
2213 bfd_set_section_flags (stdoutput, info_seg,
2214 SEC_READONLY | SEC_DEBUGGING);
2215 bfd_set_section_flags (stdoutput, abbrev_seg,
2216 SEC_READONLY | SEC_DEBUGGING);
2217 bfd_set_section_flags (stdoutput, aranges_seg,
2218 SEC_READONLY | SEC_DEBUGGING);
2219 bfd_set_section_flags (stdoutput, str_seg,
2220 (SEC_READONLY | SEC_DEBUGGING
2221 | SEC_MERGE | SEC_STRINGS));
2222 str_seg->entsize = 1;
2224 record_alignment (aranges_seg, ffs (2 * sizeof_address) - 1);
2226 if (all_segs->next == NULL)
2230 ranges_seg = subseg_new (".debug_ranges", 0);
2231 bfd_set_section_flags (stdoutput, ranges_seg,
2232 SEC_READONLY | SEC_DEBUGGING);
2233 record_alignment (ranges_seg, ffs (2 * sizeof_address) - 1);
2234 out_debug_ranges (ranges_seg);
2237 out_debug_aranges (aranges_seg, info_seg);
2238 out_debug_abbrev (abbrev_seg, info_seg, line_seg);
2239 out_debug_str (str_seg, &name_sym, &comp_dir_sym, &producer_sym);
2240 out_debug_info (info_seg, abbrev_seg, line_seg, ranges_seg,
2241 name_sym, comp_dir_sym, producer_sym);
2245 /* Perform any deferred checks pertaining to debug information. */
2248 dwarf2dbg_final_check (void)
2250 /* Perform reset-view checks. Don't evaluate view_assert_failed
2251 recursively: it could be very deep. It's a chain of adds, with
2252 each chain element pointing to the next in X_add_symbol, and
2253 holding the check value in X_op_symbol. */
2254 while (view_assert_failed)
2260 gas_assert (!symbol_resolved_p (view_assert_failed));
2262 exp = symbol_get_value_expression (view_assert_failed);
2263 sym = view_assert_failed;
2265 /* If view_assert_failed looks like a compound check in the
2266 chain, break it up. */
2267 if (exp->X_op == O_add && exp->X_add_number == 0 && exp->X_unsigned)
2269 view_assert_failed = exp->X_add_symbol;
2270 sym = exp->X_op_symbol;
2273 view_assert_failed = NULL;
2275 failed = resolve_symbol_value (sym);
2276 if (!symbol_resolved_p (sym) || failed)
2278 as_bad (_("view number mismatch"));