1 /* dwarf2dbg.c - DWARF2 debug support
2 Copyright (C) 1999-2019 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 outputs version 3 .debug_line information. */
101 #ifndef DWARF2_LINE_VERSION
102 #define DWARF2_LINE_VERSION 3
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)
254 memset (&exp, 0, sizeof exp);
256 exp.X_add_symbol = symbol;
257 exp.X_add_number = 0;
258 emit_expr (&exp, size);
262 /* Find or create (if CREATE_P) an entry for SEG+SUBSEG in ALL_SEGS. */
264 static struct line_subseg *
265 get_line_subseg (segT seg, subsegT subseg, bfd_boolean create_p)
267 struct line_seg *s = seg_info (seg)->dwarf2_line_seg;
268 struct line_subseg **pss, *lss;
275 s = XNEW (struct line_seg);
280 last_seg_ptr = &s->next;
281 seg_info (seg)->dwarf2_line_seg = s;
283 gas_assert (seg == s->seg);
285 for (pss = &s->head; (lss = *pss) != NULL ; pss = &lss->next)
287 if (lss->subseg == subseg)
289 if (lss->subseg > subseg)
293 lss = XNEW (struct line_subseg);
295 lss->subseg = subseg;
297 lss->ptail = &lss->head;
298 lss->pmove_tail = &lss->head;
305 /* (Un)reverse the line_entry list starting from H. */
307 static struct line_entry *
308 reverse_line_entry_list (struct line_entry *h)
310 struct line_entry *p = NULL, *e, *n;
312 for (e = h; e; e = n)
321 /* Compute the view for E based on the previous entry P. If we
322 introduce an (undefined) view symbol for P, and H is given (P must
323 be the tail in this case), introduce view symbols for earlier list
324 entries as well, until one of them is constant. */
327 set_or_check_view (struct line_entry *e, struct line_entry *p,
328 struct line_entry *h)
332 memset (&viewx, 0, sizeof (viewx));
333 viewx.X_unsigned = 1;
335 /* First, compute !(E->label > P->label), to tell whether or not
336 we're to reset the view number. If we can't resolve it to a
337 constant, keep it symbolic. */
338 if (!p || (e->loc.view == force_reset_view && force_reset_view))
340 viewx.X_op = O_constant;
341 viewx.X_add_number = 0;
342 viewx.X_add_symbol = NULL;
343 viewx.X_op_symbol = NULL;
348 viewx.X_add_number = 0;
349 viewx.X_add_symbol = e->label;
350 viewx.X_op_symbol = p->label;
351 resolve_expression (&viewx);
352 if (viewx.X_op == O_constant)
353 viewx.X_add_number = !viewx.X_add_number;
356 viewx.X_add_symbol = make_expr_symbol (&viewx);
357 viewx.X_add_number = 0;
358 viewx.X_op_symbol = NULL;
359 viewx.X_op = O_logical_not;
363 if (S_IS_DEFINED (e->loc.view) && symbol_constant_p (e->loc.view))
365 expressionS *value = symbol_get_value_expression (e->loc.view);
366 /* We can't compare the view numbers at this point, because in
367 VIEWX we've only determined whether we're to reset it so
369 if (viewx.X_op == O_constant)
371 if (!value->X_add_number != !viewx.X_add_number)
372 as_bad (_("view number mismatch"));
374 /* Record the expression to check it later. It is the result of
375 a logical not, thus 0 or 1. We just add up all such deferred
376 expressions, and resolve it at the end. */
377 else if (!value->X_add_number)
379 symbolS *deferred = make_expr_symbol (&viewx);
380 if (view_assert_failed)
384 memset (&chk, 0, sizeof (chk));
387 chk.X_add_number = 0;
388 chk.X_add_symbol = view_assert_failed;
389 chk.X_op_symbol = deferred;
390 deferred = make_expr_symbol (&chk);
392 view_assert_failed = deferred;
396 if (viewx.X_op != O_constant || viewx.X_add_number)
402 p->loc.view = symbol_temp_make ();
403 gas_assert (!S_IS_DEFINED (p->loc.view));
406 memset (&incv, 0, sizeof (incv));
408 incv.X_op = O_symbol;
409 incv.X_add_symbol = p->loc.view;
410 incv.X_add_number = 1;
412 if (viewx.X_op == O_constant)
414 gas_assert (viewx.X_add_number == 1);
419 viewx.X_add_symbol = make_expr_symbol (&viewx);
420 viewx.X_add_number = 0;
421 viewx.X_op_symbol = make_expr_symbol (&incv);
422 viewx.X_op = O_multiply;
426 if (!S_IS_DEFINED (e->loc.view))
428 symbol_set_value_expression (e->loc.view, &viewx);
429 S_SET_SEGMENT (e->loc.view, expr_section);
430 symbol_set_frag (e->loc.view, &zero_address_frag);
433 /* Define and attempt to simplify any earlier views needed to
435 if (h && p && p->loc.view && !S_IS_DEFINED (p->loc.view))
437 struct line_entry *h2;
438 /* Reverse the list to avoid quadratic behavior going backwards
439 in a single-linked list. */
440 struct line_entry *r = reverse_line_entry_list (h);
443 /* Set or check views until we find a defined or absent view. */
446 /* Do not define the head of a (sub?)segment view while
447 handling others. It would be defined too early, without
448 regard to the last view of other subsegments.
449 set_or_check_view will be called for every head segment
453 set_or_check_view (r, r->next, NULL);
455 while (r->next && r->next->loc.view && !S_IS_DEFINED (r->next->loc.view)
458 /* Unreverse the list, so that we can go forward again. */
459 h2 = reverse_line_entry_list (p);
460 gas_assert (h2 == h);
462 /* Starting from the last view we just defined, attempt to
463 simplify the view expressions, until we do so to P. */
466 /* The head view of a subsegment may remain undefined while
467 handling other elements, before it is linked to the last
468 view of the previous subsegment. */
471 gas_assert (S_IS_DEFINED (r->loc.view));
472 resolve_expression (symbol_get_value_expression (r->loc.view));
474 while (r != p && (r = r->next));
476 /* Now that we've defined and computed all earlier views that might
477 be needed to compute E's, attempt to simplify it. */
478 resolve_expression (symbol_get_value_expression (e->loc.view));
482 /* Record an entry for LOC occurring at LABEL. */
485 dwarf2_gen_line_info_1 (symbolS *label, struct dwarf2_line_info *loc)
487 struct line_subseg *lss;
488 struct line_entry *e;
490 e = XNEW (struct line_entry);
495 lss = get_line_subseg (now_seg, now_subseg, TRUE);
497 /* Subseg heads are chained to previous subsegs in
499 if (loc->view && lss->head)
500 set_or_check_view (e,
501 (struct line_entry *)lss->ptail,
505 lss->ptail = &e->next;
508 /* Record an entry for LOC occurring at OFS within the current fragment. */
511 dwarf2_gen_line_info (addressT ofs, struct dwarf2_line_info *loc)
513 static unsigned int line = -1;
514 static unsigned int filenum = -1;
518 /* Early out for as-yet incomplete location information. */
519 if (loc->filenum == 0 || loc->line == 0)
522 /* Don't emit sequences of line symbols for the same line when the
523 symbols apply to assembler code. It is necessary to emit
524 duplicate line symbols when a compiler asks for them, because GDB
525 uses them to determine the end of the prologue. */
526 if (debug_type == DEBUG_DWARF2
527 && line == loc->line && filenum == loc->filenum)
531 filenum = loc->filenum;
537 /* Use a non-fake name for the line number location,
538 so that it can be referred to by relocations. */
539 sprintf (name, ".Loc.%u.%u", line, filenum);
540 sym = symbol_new (name, now_seg, ofs, frag_now);
543 sym = symbol_temp_new (now_seg, ofs, frag_now);
544 dwarf2_gen_line_info_1 (sym, loc);
547 /* Returns the current source information. If .file directives have
548 been encountered, the info for the corresponding source file is
549 returned. Otherwise, the info for the assembly source file is
553 dwarf2_where (struct dwarf2_line_info *line)
555 if (debug_type == DEBUG_DWARF2)
557 const char *filename;
559 memset (line, 0, sizeof (*line));
560 filename = as_where (&line->line);
561 line->filenum = get_filenum (filename, 0);
563 line->flags = DWARF2_FLAG_IS_STMT;
564 line->isa = current.isa;
565 line->discriminator = current.discriminator;
572 /* A hook to allow the target backend to inform the line number state
573 machine of isa changes when assembler debug info is enabled. */
576 dwarf2_set_isa (unsigned int isa)
581 /* Called for each machine instruction, or relatively atomic group of
582 machine instructions (ie built-in macro). The instruction or group
583 is SIZE bytes in length. If dwarf2 line number generation is called
584 for, emit a line statement appropriately. */
587 dwarf2_emit_insn (int size)
589 struct dwarf2_line_info loc;
591 if (debug_type != DEBUG_DWARF2
592 ? !dwarf2_loc_directive_seen
593 : !seen_at_least_1_file ())
598 dwarf2_gen_line_info ((frag_now_fix_octets () - size) / OCTETS_PER_BYTE, &loc);
599 dwarf2_consume_line_info ();
602 /* Move all previously-emitted line entries for the current position by
603 DELTA bytes. This function cannot be used to move the same entries
607 dwarf2_move_insn (int delta)
609 struct line_subseg *lss;
610 struct line_entry *e;
616 lss = get_line_subseg (now_seg, now_subseg, FALSE);
620 now = frag_now_fix ();
621 while ((e = *lss->pmove_tail))
623 if (S_GET_VALUE (e->label) == now)
624 S_SET_VALUE (e->label, now + delta);
625 lss->pmove_tail = &e->next;
629 /* Called after the current line information has been either used with
630 dwarf2_gen_line_info or saved with a machine instruction for later use.
631 This resets the state of the line number information to reflect that
635 dwarf2_consume_line_info (void)
637 /* Unless we generate DWARF2 debugging information for each
638 assembler line, we only emit one line symbol for one LOC. */
639 dwarf2_loc_directive_seen = FALSE;
641 current.flags &= ~(DWARF2_FLAG_BASIC_BLOCK
642 | DWARF2_FLAG_PROLOGUE_END
643 | DWARF2_FLAG_EPILOGUE_BEGIN);
644 current.discriminator = 0;
648 /* Called for each (preferably code) label. If dwarf2_loc_mark_labels
649 is enabled, emit a basic block marker. */
652 dwarf2_emit_label (symbolS *label)
654 struct dwarf2_line_info loc;
656 if (!dwarf2_loc_mark_labels)
658 if (S_GET_SEGMENT (label) != now_seg)
660 if (!(bfd_get_section_flags (stdoutput, now_seg) & SEC_CODE))
662 if (files_in_use == 0 && debug_type != DEBUG_DWARF2)
667 loc.flags |= DWARF2_FLAG_BASIC_BLOCK;
669 dwarf2_gen_line_info_1 (label, &loc);
670 dwarf2_consume_line_info ();
673 /* Get a .debug_line file number for FILENAME. If NUM is nonzero,
674 allocate it on that file table slot, otherwise return the first
678 get_filenum (const char *filename, unsigned int num)
680 static unsigned int last_used, last_used_dir_len;
685 if (num == 0 && last_used)
687 if (! files[last_used].dir
688 && filename_cmp (filename, files[last_used].filename) == 0)
690 if (files[last_used].dir
691 && filename_ncmp (filename, dirs[files[last_used].dir],
692 last_used_dir_len) == 0
693 && IS_DIR_SEPARATOR (filename [last_used_dir_len])
694 && filename_cmp (filename + last_used_dir_len + 1,
695 files[last_used].filename) == 0)
699 file = lbasename (filename);
700 /* Don't make empty string from / or A: from A:/ . */
701 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
702 if (file <= filename + 3)
705 if (file == filename + 1)
708 dir_len = file - filename;
713 #ifndef DWARF2_DIR_SHOULD_END_WITH_SEPARATOR
716 for (dir = 1; dir < dirs_in_use; ++dir)
717 if (filename_ncmp (filename, dirs[dir], dir_len) == 0
718 && dirs[dir][dir_len] == '\0')
721 if (dir >= dirs_in_use)
723 if (dir >= dirs_allocated)
725 dirs_allocated = dir + 32;
726 dirs = XRESIZEVEC (char *, dirs, dirs_allocated);
729 dirs[dir] = xmemdup0 (filename, dir_len);
730 dirs_in_use = dir + 1;
736 for (i = 1; i < files_in_use; ++i)
737 if (files[i].dir == dir
739 && filename_cmp (file, files[i].filename) == 0)
742 last_used_dir_len = dir_len;
749 if (i >= files_allocated)
751 unsigned int old = files_allocated;
753 files_allocated = i + 32;
754 files = XRESIZEVEC (struct file_entry, files, files_allocated);
756 memset (files + old, 0, (i + 32 - old) * sizeof (struct file_entry));
759 files[i].filename = num ? file : xstrdup (file);
761 if (files_in_use < i + 1)
762 files_in_use = i + 1;
764 last_used_dir_len = dir_len;
769 /* Handle two forms of .file directive:
770 - Pass .file "source.c" to s_app_file
771 - Handle .file 1 "source.c" by adding an entry to the DWARF-2 file table
773 If an entry is added to the file table, return a pointer to the filename. */
776 dwarf2_directive_filename (void)
782 /* Continue to accept a bare string and pass it off. */
784 if (*input_line_pointer == '"')
790 num = get_absolute_expression ();
791 filename = demand_copy_C_string (&filename_len);
792 if (filename == NULL)
794 demand_empty_rest_of_line ();
798 as_bad (_("file number less than one"));
802 /* A .file directive implies compiler generated debug information is
803 being supplied. Turn off gas generated debug info. */
804 debug_type = DEBUG_NONE;
806 if (num < (int) files_in_use && files[num].filename != 0)
808 as_bad (_("file number %ld already allocated"), (long) num);
812 get_filenum (filename, num);
817 /* Calls dwarf2_directive_filename, but discards its result.
818 Used in pseudo-op tables where the function result is ignored. */
821 dwarf2_directive_file (int dummy ATTRIBUTE_UNUSED)
823 (void) dwarf2_directive_filename ();
827 dwarf2_directive_loc (int dummy ATTRIBUTE_UNUSED)
829 offsetT filenum, line;
831 /* If we see two .loc directives in a row, force the first one to be
833 if (dwarf2_loc_directive_seen)
834 dwarf2_emit_insn (0);
836 filenum = get_absolute_expression ();
838 line = get_absolute_expression ();
842 as_bad (_("file number less than one"));
845 if (filenum >= (int) files_in_use || files[filenum].filename == 0)
847 as_bad (_("unassigned file number %ld"), (long) filenum);
851 current.filenum = filenum;
853 current.discriminator = 0;
858 if (files[filenum].dir)
860 size_t dir_len = strlen (dirs[files[filenum].dir]);
861 size_t file_len = strlen (files[filenum].filename);
862 char *cp = XNEWVEC (char, dir_len + 1 + file_len + 1);
864 memcpy (cp, dirs[files[filenum].dir], dir_len);
865 INSERT_DIR_SEPARATOR (cp, dir_len);
866 memcpy (cp + dir_len + 1, files[filenum].filename, file_len);
867 cp[dir_len + file_len + 1] = '\0';
868 listing_source_file (cp);
872 listing_source_file (files[filenum].filename);
873 listing_source_line (line);
878 if (ISDIGIT (*input_line_pointer))
880 current.column = get_absolute_expression ();
884 while (ISALPHA (*input_line_pointer))
889 c = get_symbol_name (& p);
891 if (strcmp (p, "basic_block") == 0)
893 current.flags |= DWARF2_FLAG_BASIC_BLOCK;
894 *input_line_pointer = c;
896 else if (strcmp (p, "prologue_end") == 0)
898 current.flags |= DWARF2_FLAG_PROLOGUE_END;
899 *input_line_pointer = c;
901 else if (strcmp (p, "epilogue_begin") == 0)
903 current.flags |= DWARF2_FLAG_EPILOGUE_BEGIN;
904 *input_line_pointer = c;
906 else if (strcmp (p, "is_stmt") == 0)
908 (void) restore_line_pointer (c);
909 value = get_absolute_expression ();
911 current.flags &= ~DWARF2_FLAG_IS_STMT;
913 current.flags |= DWARF2_FLAG_IS_STMT;
916 as_bad (_("is_stmt value not 0 or 1"));
920 else if (strcmp (p, "isa") == 0)
922 (void) restore_line_pointer (c);
923 value = get_absolute_expression ();
928 as_bad (_("isa number less than zero"));
932 else if (strcmp (p, "discriminator") == 0)
934 (void) restore_line_pointer (c);
935 value = get_absolute_expression ();
937 current.discriminator = value;
940 as_bad (_("discriminator less than zero"));
944 else if (strcmp (p, "view") == 0)
948 (void) restore_line_pointer (c);
951 if (ISDIGIT (*input_line_pointer)
952 || *input_line_pointer == '-')
954 bfd_boolean force_reset = *input_line_pointer == '-';
956 value = get_absolute_expression ();
959 as_bad (_("numeric view can only be asserted to zero"));
962 if (force_reset && force_reset_view)
963 sym = force_reset_view;
966 sym = symbol_temp_new (absolute_section, value,
969 force_reset_view = sym;
974 char *name = read_symbol_name ();
978 sym = symbol_find_or_make (name);
979 if (S_IS_DEFINED (sym) || symbol_equated_p (sym))
981 if (S_IS_VOLATILE (sym))
982 sym = symbol_clone (sym, 1);
983 else if (!S_CAN_BE_REDEFINED (sym))
985 as_bad (_("symbol `%s' is already defined"), name);
989 S_SET_SEGMENT (sym, undefined_section);
990 S_SET_VALUE (sym, 0);
991 symbol_set_frag (sym, &zero_address_frag);
997 as_bad (_("unknown .loc sub-directive `%s'"), p);
998 (void) restore_line_pointer (c);
1002 SKIP_WHITESPACE_AFTER_NAME ();
1005 demand_empty_rest_of_line ();
1006 dwarf2_loc_directive_seen = TRUE;
1007 debug_type = DEBUG_NONE;
1009 /* If we were given a view id, emit the row right away. */
1011 dwarf2_emit_insn (0);
1015 dwarf2_directive_loc_mark_labels (int dummy ATTRIBUTE_UNUSED)
1017 offsetT value = get_absolute_expression ();
1019 if (value != 0 && value != 1)
1021 as_bad (_("expected 0 or 1"));
1022 ignore_rest_of_line ();
1026 dwarf2_loc_mark_labels = value != 0;
1027 demand_empty_rest_of_line ();
1031 static struct frag *
1032 first_frag_for_seg (segT seg)
1034 return seg_info (seg)->frchainP->frch_root;
1037 static struct frag *
1038 last_frag_for_seg (segT seg)
1040 frchainS *f = seg_info (seg)->frchainP;
1042 while (f->frch_next != NULL)
1045 return f->frch_last;
1048 /* Emit a single byte into the current segment. */
1053 FRAG_APPEND_1_CHAR (byte);
1056 /* Emit a statement program opcode into the current segment. */
1059 out_opcode (int opc)
1064 /* Emit a two-byte word into the current segment. */
1069 md_number_to_chars (frag_more (2), data, 2);
1072 /* Emit a four byte word into the current segment. */
1077 md_number_to_chars (frag_more (4), data, 4);
1080 /* Emit an unsigned "little-endian base 128" number. */
1083 out_uleb128 (addressT value)
1085 output_leb128 (frag_more (sizeof_leb128 (value, 0)), value, 0);
1088 /* Emit a signed "little-endian base 128" number. */
1091 out_leb128 (addressT value)
1093 output_leb128 (frag_more (sizeof_leb128 (value, 1)), value, 1);
1096 /* Emit a tuple for .debug_abbrev. */
1099 out_abbrev (int name, int form)
1105 /* Get the size of a fragment. */
1108 get_frag_fix (fragS *frag, segT seg)
1113 return frag->fr_fix;
1115 /* If a fragment is the last in the chain, special measures must be
1116 taken to find its size before relaxation, since it may be pending
1117 on some subsegment chain. */
1118 for (fr = seg_info (seg)->frchainP; fr; fr = fr->frch_next)
1119 if (fr->frch_last == frag)
1120 return (char *) obstack_next_free (&fr->frch_obstack) - frag->fr_literal;
1125 /* Set an absolute address (may result in a relocation entry). */
1128 out_inc_line_addr (int line_delta, addressT addr_delta);
1131 out_set_addr (symbolS *sym)
1134 addressT expr_addr, expr_addr_aligned;
1136 memset (&exp, 0, sizeof exp);
1138 /* The expression at the bottom must be aligned to OCTETS_PER_BYTE. The
1139 statements after the for loop will contribute 3 more octets. */
1140 expr_addr = frag_now_fix_octets () + 3;
1141 expr_addr_aligned = (expr_addr + OCTETS_PER_BYTE - 1) & -OCTETS_PER_BYTE;
1142 for ( ; expr_addr != expr_addr_aligned; expr_addr++)
1143 out_inc_line_addr (0, 0); /* NOP */
1145 out_opcode (DW_LNS_extended_op); /* 1 octet */
1146 out_uleb128 (sizeof_address + 1); /* 1 octet */
1148 out_opcode (DW_LNE_set_address); /* 1 octet */
1149 exp.X_op = O_symbol;
1150 exp.X_add_symbol = sym;
1151 exp.X_add_number = 0;
1152 emit_expr (&exp, sizeof_address);
1155 static void scale_addr_delta (addressT *);
1158 scale_addr_delta (addressT *addr_delta)
1160 static int printed_this = 0;
1161 if (DWARF2_LINE_MIN_INSN_LENGTH > 1)
1163 if (*addr_delta % DWARF2_LINE_MIN_INSN_LENGTH != 0 && !printed_this)
1165 as_bad("unaligned opcodes detected in executable segment");
1168 *addr_delta /= DWARF2_LINE_MIN_INSN_LENGTH;
1172 /* Encode a pair of line and address skips as efficiently as possible.
1173 Note that the line skip is signed, whereas the address skip is unsigned.
1175 The following two routines *must* be kept in sync. This is
1176 enforced by making emit_inc_line_addr abort if we do not emit
1177 exactly the expected number of bytes. */
1180 size_inc_line_addr (int line_delta, addressT addr_delta)
1182 unsigned int tmp, opcode;
1185 /* Scale the address delta by the minimum instruction length. */
1186 scale_addr_delta (&addr_delta);
1188 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1189 We cannot use special opcodes here, since we want the end_sequence
1190 to emit the matrix entry. */
1191 if (line_delta == INT_MAX)
1193 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1195 else if (addr_delta)
1196 len = 1 + sizeof_leb128 (addr_delta, 0);
1200 /* Bias the line delta by the base. */
1201 tmp = line_delta - DWARF2_LINE_BASE;
1203 /* If the line increment is out of range of a special opcode, we
1204 must encode it with DW_LNS_advance_line. */
1205 if (tmp >= DWARF2_LINE_RANGE)
1207 len = 1 + sizeof_leb128 (line_delta, 1);
1209 tmp = 0 - DWARF2_LINE_BASE;
1212 /* Bias the opcode by the special opcode base. */
1213 tmp += DWARF2_LINE_OPCODE_BASE;
1215 /* Avoid overflow when addr_delta is large. */
1216 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1218 /* Try using a special opcode. */
1219 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1223 /* Try using DW_LNS_const_add_pc followed by special op. */
1224 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1229 /* Otherwise use DW_LNS_advance_pc. */
1230 len += 1 + sizeof_leb128 (addr_delta, 0);
1232 /* DW_LNS_copy or special opcode. */
1239 emit_inc_line_addr (int line_delta, addressT addr_delta, char *p, int len)
1241 unsigned int tmp, opcode;
1243 char *end = p + len;
1245 /* Line number sequences cannot go backward in addresses. This means
1246 we've incorrectly ordered the statements in the sequence. */
1247 gas_assert ((offsetT) addr_delta >= 0);
1249 /* Scale the address delta by the minimum instruction length. */
1250 scale_addr_delta (&addr_delta);
1252 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1253 We cannot use special opcodes here, since we want the end_sequence
1254 to emit the matrix entry. */
1255 if (line_delta == INT_MAX)
1257 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1258 *p++ = DW_LNS_const_add_pc;
1259 else if (addr_delta)
1261 *p++ = DW_LNS_advance_pc;
1262 p += output_leb128 (p, addr_delta, 0);
1265 *p++ = DW_LNS_extended_op;
1267 *p++ = DW_LNE_end_sequence;
1271 /* Bias the line delta by the base. */
1272 tmp = line_delta - DWARF2_LINE_BASE;
1274 /* If the line increment is out of range of a special opcode, we
1275 must encode it with DW_LNS_advance_line. */
1276 if (tmp >= DWARF2_LINE_RANGE)
1278 *p++ = DW_LNS_advance_line;
1279 p += output_leb128 (p, line_delta, 1);
1282 tmp = 0 - DWARF2_LINE_BASE;
1286 /* Prettier, I think, to use DW_LNS_copy instead of a "line +0, addr +0"
1288 if (line_delta == 0 && addr_delta == 0)
1294 /* Bias the opcode by the special opcode base. */
1295 tmp += DWARF2_LINE_OPCODE_BASE;
1297 /* Avoid overflow when addr_delta is large. */
1298 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1300 /* Try using a special opcode. */
1301 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1308 /* Try using DW_LNS_const_add_pc followed by special op. */
1309 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1312 *p++ = DW_LNS_const_add_pc;
1318 /* Otherwise use DW_LNS_advance_pc. */
1319 *p++ = DW_LNS_advance_pc;
1320 p += output_leb128 (p, addr_delta, 0);
1328 gas_assert (p == end);
1331 /* Handy routine to combine calls to the above two routines. */
1334 out_inc_line_addr (int line_delta, addressT addr_delta)
1336 int len = size_inc_line_addr (line_delta, addr_delta);
1337 emit_inc_line_addr (line_delta, addr_delta, frag_more (len), len);
1340 /* Write out an alternative form of line and address skips using
1341 DW_LNS_fixed_advance_pc opcodes. This uses more space than the default
1342 line and address information, but it is required if linker relaxation
1343 could change the code offsets. The following two routines *must* be
1345 #define ADDR_DELTA_LIMIT 50000
1348 size_fixed_inc_line_addr (int line_delta, addressT addr_delta)
1352 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1353 if (line_delta != INT_MAX)
1354 len = 1 + sizeof_leb128 (line_delta, 1);
1356 if (addr_delta > ADDR_DELTA_LIMIT)
1358 /* DW_LNS_extended_op */
1359 len += 1 + sizeof_leb128 (sizeof_address + 1, 0);
1360 /* DW_LNE_set_address */
1361 len += 1 + sizeof_address;
1364 /* DW_LNS_fixed_advance_pc */
1367 if (line_delta == INT_MAX)
1368 /* DW_LNS_extended_op + DW_LNE_end_sequence */
1378 emit_fixed_inc_line_addr (int line_delta, addressT addr_delta, fragS *frag,
1382 char *end = p + len;
1384 /* Line number sequences cannot go backward in addresses. This means
1385 we've incorrectly ordered the statements in the sequence. */
1386 gas_assert ((offsetT) addr_delta >= 0);
1388 /* Verify that we have kept in sync with size_fixed_inc_line_addr. */
1389 gas_assert (len == size_fixed_inc_line_addr (line_delta, addr_delta));
1391 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1392 if (line_delta != INT_MAX)
1394 *p++ = DW_LNS_advance_line;
1395 p += output_leb128 (p, line_delta, 1);
1398 pexp = symbol_get_value_expression (frag->fr_symbol);
1400 /* The DW_LNS_fixed_advance_pc opcode has a 2-byte operand so it can
1401 advance the address by at most 64K. Linker relaxation (without
1402 which this function would not be used) could change the operand by
1403 an unknown amount. If the address increment is getting close to
1404 the limit, just reset the address. */
1405 if (addr_delta > ADDR_DELTA_LIMIT)
1410 memset (&exp, 0, sizeof exp);
1411 gas_assert (pexp->X_op == O_subtract);
1412 to_sym = pexp->X_add_symbol;
1414 *p++ = DW_LNS_extended_op;
1415 p += output_leb128 (p, sizeof_address + 1, 0);
1416 *p++ = DW_LNE_set_address;
1417 exp.X_op = O_symbol;
1418 exp.X_add_symbol = to_sym;
1419 exp.X_add_number = 0;
1420 emit_expr_fix (&exp, sizeof_address, frag, p, TC_PARSE_CONS_RETURN_NONE);
1421 p += sizeof_address;
1425 *p++ = DW_LNS_fixed_advance_pc;
1426 emit_expr_fix (pexp, 2, frag, p, TC_PARSE_CONS_RETURN_NONE);
1430 if (line_delta == INT_MAX)
1432 *p++ = DW_LNS_extended_op;
1434 *p++ = DW_LNE_end_sequence;
1439 gas_assert (p == end);
1442 /* Generate a variant frag that we can use to relax address/line
1443 increments between fragments of the target segment. */
1446 relax_inc_line_addr (int line_delta, symbolS *to_sym, symbolS *from_sym)
1451 memset (&exp, 0, sizeof exp);
1452 exp.X_op = O_subtract;
1453 exp.X_add_symbol = to_sym;
1454 exp.X_op_symbol = from_sym;
1455 exp.X_add_number = 0;
1457 /* The maximum size of the frag is the line delta with a maximum
1458 sized address delta. */
1459 if (DWARF2_USE_FIXED_ADVANCE_PC)
1460 max_chars = size_fixed_inc_line_addr (line_delta,
1461 -DWARF2_LINE_MIN_INSN_LENGTH);
1463 max_chars = size_inc_line_addr (line_delta, -DWARF2_LINE_MIN_INSN_LENGTH);
1465 frag_var (rs_dwarf2dbg, max_chars, max_chars, 1,
1466 make_expr_symbol (&exp), line_delta, NULL);
1469 /* The function estimates the size of a rs_dwarf2dbg variant frag
1470 based on the current values of the symbols. It is called before
1471 the relaxation loop. We set fr_subtype to the expected length. */
1474 dwarf2dbg_estimate_size_before_relax (fragS *frag)
1479 addr_delta = resolve_symbol_value (frag->fr_symbol);
1480 if (DWARF2_USE_FIXED_ADVANCE_PC)
1481 size = size_fixed_inc_line_addr (frag->fr_offset, addr_delta);
1483 size = size_inc_line_addr (frag->fr_offset, addr_delta);
1485 frag->fr_subtype = size;
1490 /* This function relaxes a rs_dwarf2dbg variant frag based on the
1491 current values of the symbols. fr_subtype is the current length
1492 of the frag. This returns the change in frag length. */
1495 dwarf2dbg_relax_frag (fragS *frag)
1497 int old_size, new_size;
1499 old_size = frag->fr_subtype;
1500 new_size = dwarf2dbg_estimate_size_before_relax (frag);
1502 return new_size - old_size;
1505 /* This function converts a rs_dwarf2dbg variant frag into a normal
1506 fill frag. This is called after all relaxation has been done.
1507 fr_subtype will be the desired length of the frag. */
1510 dwarf2dbg_convert_frag (fragS *frag)
1514 if (DWARF2_USE_FIXED_ADVANCE_PC)
1516 /* If linker relaxation is enabled then the distance between the two
1517 symbols in the frag->fr_symbol expression might change. Hence we
1518 cannot rely upon the value computed by resolve_symbol_value.
1519 Instead we leave the expression unfinalized and allow
1520 emit_fixed_inc_line_addr to create a fixup (which later becomes a
1521 relocation) that will allow the linker to correctly compute the
1522 actual address difference. We have to use a fixed line advance for
1523 this as we cannot (easily) relocate leb128 encoded values. */
1524 int saved_finalize_syms = finalize_syms;
1527 addr_diff = resolve_symbol_value (frag->fr_symbol);
1528 finalize_syms = saved_finalize_syms;
1531 addr_diff = resolve_symbol_value (frag->fr_symbol);
1533 /* fr_var carries the max_chars that we created the fragment with.
1534 fr_subtype carries the current expected length. We must, of
1535 course, have allocated enough memory earlier. */
1536 gas_assert (frag->fr_var >= (int) frag->fr_subtype);
1538 if (DWARF2_USE_FIXED_ADVANCE_PC)
1539 emit_fixed_inc_line_addr (frag->fr_offset, addr_diff, frag,
1540 frag->fr_literal + frag->fr_fix,
1543 emit_inc_line_addr (frag->fr_offset, addr_diff,
1544 frag->fr_literal + frag->fr_fix, frag->fr_subtype);
1546 frag->fr_fix += frag->fr_subtype;
1547 frag->fr_type = rs_fill;
1549 frag->fr_offset = 0;
1552 /* Generate .debug_line content for the chain of line number entries
1553 beginning at E, for segment SEG. */
1556 process_entries (segT seg, struct line_entry *e)
1558 unsigned filenum = 1;
1560 unsigned column = 0;
1562 unsigned flags = DWARF2_LINE_DEFAULT_IS_STMT ? DWARF2_FLAG_IS_STMT : 0;
1563 fragS *last_frag = NULL, *frag;
1564 addressT last_frag_ofs = 0, frag_ofs;
1565 symbolS *last_lab = NULL, *lab;
1566 struct line_entry *next;
1568 if (flag_dwarf_sections)
1571 const char * sec_name;
1573 /* Switch to the relevant sub-section before we start to emit
1574 the line number table.
1576 FIXME: These sub-sections do not have a normal Line Number
1577 Program Header, thus strictly speaking they are not valid
1578 DWARF sections. Unfortunately the DWARF standard assumes
1579 a one-to-one relationship between compilation units and
1580 line number tables. Thus we have to have a .debug_line
1581 section, as well as our sub-sections, and we have to ensure
1582 that all of the sub-sections are merged into a proper
1583 .debug_line section before a debugger sees them. */
1585 sec_name = bfd_get_section_name (stdoutput, seg);
1586 if (strcmp (sec_name, ".text") != 0)
1588 name = concat (".debug_line", sec_name, (char *) NULL);
1589 subseg_set (subseg_get (name, FALSE), 0);
1592 /* Don't create a .debug_line.text section -
1593 that is redundant. Instead just switch back to the
1594 normal .debug_line section. */
1595 subseg_set (subseg_get (".debug_line", FALSE), 0);
1602 if (filenum != e->loc.filenum)
1604 filenum = e->loc.filenum;
1605 out_opcode (DW_LNS_set_file);
1606 out_uleb128 (filenum);
1609 if (column != e->loc.column)
1611 column = e->loc.column;
1612 out_opcode (DW_LNS_set_column);
1613 out_uleb128 (column);
1616 if (e->loc.discriminator != 0)
1618 out_opcode (DW_LNS_extended_op);
1619 out_leb128 (1 + sizeof_leb128 (e->loc.discriminator, 0));
1620 out_opcode (DW_LNE_set_discriminator);
1621 out_uleb128 (e->loc.discriminator);
1624 if (isa != e->loc.isa)
1627 out_opcode (DW_LNS_set_isa);
1631 if ((e->loc.flags ^ flags) & DWARF2_FLAG_IS_STMT)
1633 flags = e->loc.flags;
1634 out_opcode (DW_LNS_negate_stmt);
1637 if (e->loc.flags & DWARF2_FLAG_BASIC_BLOCK)
1638 out_opcode (DW_LNS_set_basic_block);
1640 if (e->loc.flags & DWARF2_FLAG_PROLOGUE_END)
1641 out_opcode (DW_LNS_set_prologue_end);
1643 if (e->loc.flags & DWARF2_FLAG_EPILOGUE_BEGIN)
1644 out_opcode (DW_LNS_set_epilogue_begin);
1646 /* Don't try to optimize away redundant entries; gdb wants two
1647 entries for a function where the code starts on the same line as
1648 the {, and there's no way to identify that case here. Trust gcc
1649 to optimize appropriately. */
1650 line_delta = e->loc.line - line;
1652 frag = symbol_get_frag (lab);
1653 frag_ofs = S_GET_VALUE (lab);
1655 if (last_frag == NULL
1656 || (e->loc.view == force_reset_view && force_reset_view
1657 /* If we're going to reset the view, but we know we're
1658 advancing the PC, we don't have to force with
1659 set_address. We know we do when we're at the same
1660 address of the same frag, and we know we might when
1661 we're in the beginning of a frag, and we were at the
1662 end of the previous frag. */
1663 && (frag == last_frag
1664 ? (last_frag_ofs == frag_ofs)
1666 && ((offsetT)last_frag_ofs
1667 >= get_frag_fix (last_frag, seg))))))
1670 out_inc_line_addr (line_delta, 0);
1672 else if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1673 out_inc_line_addr (line_delta, frag_ofs - last_frag_ofs);
1675 relax_inc_line_addr (line_delta, lab, last_lab);
1680 last_frag_ofs = frag_ofs;
1688 /* Emit a DW_LNE_end_sequence for the end of the section. */
1689 frag = last_frag_for_seg (seg);
1690 frag_ofs = get_frag_fix (frag, seg);
1691 if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1692 out_inc_line_addr (INT_MAX, frag_ofs - last_frag_ofs);
1695 lab = symbol_temp_new (seg, frag_ofs, frag);
1696 relax_inc_line_addr (INT_MAX, lab, last_lab);
1700 /* Emit the directory and file tables for .debug_line. */
1703 out_file_list (void)
1710 /* Emit directory list. */
1711 for (i = 1; i < dirs_in_use; ++i)
1713 dir = remap_debug_filename (dirs[i]);
1714 size = strlen (dir) + 1;
1715 cp = frag_more (size);
1716 memcpy (cp, dir, size);
1721 for (i = 1; i < files_in_use; ++i)
1723 const char *fullfilename;
1725 if (files[i].filename == NULL)
1727 as_bad (_("unassigned file number %ld"), (long) i);
1728 /* Prevent a crash later, particularly for file 1. */
1729 files[i].filename = "";
1733 fullfilename = DWARF2_FILE_NAME (files[i].filename,
1734 files[i].dir ? dirs [files [i].dir] : "");
1735 size = strlen (fullfilename) + 1;
1736 cp = frag_more (size);
1737 memcpy (cp, fullfilename, size);
1739 out_uleb128 (files[i].dir); /* directory number */
1740 /* Output the last modification timestamp. */
1741 out_uleb128 (DWARF2_FILE_TIME_NAME (files[i].filename,
1742 files[i].dir ? dirs [files [i].dir] : ""));
1743 /* Output the filesize. */
1744 out_uleb128 (DWARF2_FILE_SIZE_NAME (files[i].filename,
1745 files[i].dir ? dirs [files [i].dir] : ""));
1748 /* Terminate filename list. */
1752 /* Switch to SEC and output a header length field. Return the size of
1753 offsets used in SEC. The caller must set EXPR->X_add_symbol value
1754 to the end of the section. EXPR->X_add_number will be set to the
1755 negative size of the header. */
1758 out_header (asection *sec, expressionS *exp)
1763 subseg_set (sec, 0);
1765 if (flag_dwarf_sections)
1767 /* If we are going to put the start and end symbols in different
1768 sections, then we need real symbols, not just fake, local ones. */
1770 start_sym = symbol_make (".Ldebug_line_start");
1771 end_sym = symbol_make (".Ldebug_line_end");
1772 symbol_set_value_now (start_sym);
1776 start_sym = symbol_temp_new_now_octets ();
1777 end_sym = symbol_temp_make ();
1780 /* Total length of the information. */
1781 exp->X_op = O_subtract;
1782 exp->X_add_symbol = end_sym;
1783 exp->X_op_symbol = start_sym;
1785 switch (DWARF2_FORMAT (sec))
1787 case dwarf2_format_32bit:
1788 exp->X_add_number = -4;
1792 case dwarf2_format_64bit:
1793 exp->X_add_number = -12;
1798 case dwarf2_format_64bit_irix:
1799 exp->X_add_number = -8;
1804 as_fatal (_("internal error: unknown dwarf2 format"));
1808 /* Emit the collected .debug_line data. */
1811 out_debug_line (segT line_seg)
1814 symbolS *prologue_start, *prologue_end;
1818 addressT section_end, section_end_aligned;
1820 memset (&exp, 0, sizeof exp);
1821 sizeof_offset = out_header (line_seg, &exp);
1822 line_end = exp.X_add_symbol;
1825 out_two (DWARF2_LINE_VERSION);
1827 /* Length of the prologue following this length. */
1828 prologue_start = symbol_temp_make ();
1829 prologue_end = symbol_temp_make ();
1830 exp.X_op = O_subtract;
1831 exp.X_add_symbol = prologue_end;
1832 exp.X_op_symbol = prologue_start;
1833 exp.X_add_number = 0;
1834 emit_expr (&exp, sizeof_offset);
1835 symbol_set_value_now_octets (prologue_start);
1837 /* Parameters of the state machine. */
1838 out_byte (DWARF2_LINE_MIN_INSN_LENGTH);
1839 out_byte (DWARF2_LINE_DEFAULT_IS_STMT);
1840 out_byte (DWARF2_LINE_BASE);
1841 out_byte (DWARF2_LINE_RANGE);
1842 out_byte (DWARF2_LINE_OPCODE_BASE);
1844 /* Standard opcode lengths. */
1845 out_byte (0); /* DW_LNS_copy */
1846 out_byte (1); /* DW_LNS_advance_pc */
1847 out_byte (1); /* DW_LNS_advance_line */
1848 out_byte (1); /* DW_LNS_set_file */
1849 out_byte (1); /* DW_LNS_set_column */
1850 out_byte (0); /* DW_LNS_negate_stmt */
1851 out_byte (0); /* DW_LNS_set_basic_block */
1852 out_byte (0); /* DW_LNS_const_add_pc */
1853 out_byte (1); /* DW_LNS_fixed_advance_pc */
1854 out_byte (0); /* DW_LNS_set_prologue_end */
1855 out_byte (0); /* DW_LNS_set_epilogue_begin */
1856 out_byte (1); /* DW_LNS_set_isa */
1860 symbol_set_value_now_octets (prologue_end);
1862 /* For each section, emit a statement program. */
1863 for (s = all_segs; s; s = s->next)
1864 if (SEG_NORMAL (s->seg))
1865 process_entries (s->seg, s->head->head);
1867 as_warn ("dwarf line number information for %s ignored",
1868 segment_name (s->seg));
1870 if (flag_dwarf_sections)
1871 /* We have to switch to the special .debug_line_end section
1872 before emitting the end-of-debug_line symbol. The linker
1873 script arranges for this section to be placed after all the
1874 (potentially garbage collected) .debug_line.<foo> sections.
1875 This section contains the line_end symbol which is used to
1876 compute the size of the linked .debug_line section, as seen
1877 in the DWARF Line Number header. */
1878 subseg_set (subseg_get (".debug_line_end", FALSE), 0);
1880 /* Pad size of .debug_line section to a multiple of OCTETS_PER_BYTE.
1881 Simply sizing the section in md_section_align() is not sufficient,
1882 also the size field in the .debug_line header must be a multiple
1883 of OCTETS_PER_BYTE. Not doing so will introduce gaps within the
1884 .debug_line sections after linking. */
1885 section_end = frag_now_fix_octets ();
1886 section_end_aligned = (section_end + OCTETS_PER_BYTE - 1) & -OCTETS_PER_BYTE;
1887 for ( ; section_end != section_end_aligned; section_end++)
1888 out_inc_line_addr (0, 0); /* NOP */
1890 symbol_set_value_now_octets (line_end);
1894 out_debug_ranges (segT ranges_seg)
1896 unsigned int addr_size = sizeof_address;
1901 memset (&exp, 0, sizeof exp);
1902 subseg_set (ranges_seg, 0);
1904 /* Base Address Entry. */
1905 for (i = 0; i < addr_size; i++)
1907 for (i = 0; i < addr_size; i++)
1910 /* Range List Entry. */
1911 for (s = all_segs; s; s = s->next)
1916 frag = first_frag_for_seg (s->seg);
1917 beg = symbol_temp_new (s->seg, 0, frag);
1918 s->text_start = beg;
1920 frag = last_frag_for_seg (s->seg);
1921 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1924 exp.X_op = O_symbol;
1925 exp.X_add_symbol = beg;
1926 exp.X_add_number = 0;
1927 emit_expr (&exp, addr_size);
1929 exp.X_op = O_symbol;
1930 exp.X_add_symbol = end;
1931 exp.X_add_number = 0;
1932 emit_expr (&exp, addr_size);
1935 /* End of Range Entry. */
1936 for (i = 0; i < addr_size; i++)
1938 for (i = 0; i < addr_size; i++)
1942 /* Emit data for .debug_aranges. */
1945 out_debug_aranges (segT aranges_seg, segT info_seg)
1947 unsigned int addr_size = sizeof_address;
1951 symbolS *aranges_end;
1955 memset (&exp, 0, sizeof exp);
1956 sizeof_offset = out_header (aranges_seg, &exp);
1957 aranges_end = exp.X_add_symbol;
1958 size = -exp.X_add_number;
1961 out_two (DWARF2_ARANGES_VERSION);
1964 /* Offset to .debug_info. */
1965 TC_DWARF2_EMIT_OFFSET (section_symbol (info_seg), sizeof_offset);
1966 size += sizeof_offset;
1968 /* Size of an address (offset portion). */
1969 out_byte (addr_size);
1972 /* Size of a segment descriptor. */
1976 /* Align the header. */
1977 while ((size++ % (2 * addr_size)) > 0)
1980 for (s = all_segs; s; s = s->next)
1985 frag = first_frag_for_seg (s->seg);
1986 beg = symbol_temp_new (s->seg, 0, frag);
1987 s->text_start = beg;
1989 frag = last_frag_for_seg (s->seg);
1990 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1993 exp.X_op = O_symbol;
1994 exp.X_add_symbol = beg;
1995 exp.X_add_number = 0;
1996 emit_expr (&exp, addr_size);
1998 exp.X_op = O_subtract;
1999 exp.X_add_symbol = end;
2000 exp.X_op_symbol = beg;
2001 exp.X_add_number = 0;
2002 emit_expr (&exp, addr_size);
2005 p = frag_more (2 * addr_size);
2006 md_number_to_chars (p, 0, addr_size);
2007 md_number_to_chars (p + addr_size, 0, addr_size);
2009 symbol_set_value_now_octets (aranges_end);
2012 /* Emit data for .debug_abbrev. Note that this must be kept in
2013 sync with out_debug_info below. */
2016 out_debug_abbrev (segT abbrev_seg,
2017 segT info_seg ATTRIBUTE_UNUSED,
2018 segT line_seg ATTRIBUTE_UNUSED)
2020 subseg_set (abbrev_seg, 0);
2023 out_uleb128 (DW_TAG_compile_unit);
2024 out_byte (DW_CHILDREN_no);
2025 if (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit)
2026 out_abbrev (DW_AT_stmt_list, DW_FORM_data4);
2028 out_abbrev (DW_AT_stmt_list, DW_FORM_data8);
2029 if (all_segs->next == NULL)
2031 out_abbrev (DW_AT_low_pc, DW_FORM_addr);
2032 if (DWARF2_VERSION < 4)
2033 out_abbrev (DW_AT_high_pc, DW_FORM_addr);
2035 out_abbrev (DW_AT_high_pc, (sizeof_address == 4
2036 ? DW_FORM_data4 : DW_FORM_data8));
2040 if (DWARF2_FORMAT (info_seg) == dwarf2_format_32bit)
2041 out_abbrev (DW_AT_ranges, DW_FORM_data4);
2043 out_abbrev (DW_AT_ranges, DW_FORM_data8);
2045 out_abbrev (DW_AT_name, DW_FORM_strp);
2046 out_abbrev (DW_AT_comp_dir, DW_FORM_strp);
2047 out_abbrev (DW_AT_producer, DW_FORM_strp);
2048 out_abbrev (DW_AT_language, DW_FORM_data2);
2051 /* Terminate the abbreviations for this compilation unit. */
2055 /* Emit a description of this compilation unit for .debug_info. */
2058 out_debug_info (segT info_seg, segT abbrev_seg, segT line_seg, segT ranges_seg,
2059 symbolS *name_sym, symbolS *comp_dir_sym, symbolS *producer_sym)
2065 memset (&exp, 0, sizeof exp);
2066 sizeof_offset = out_header (info_seg, &exp);
2067 info_end = exp.X_add_symbol;
2069 /* DWARF version. */
2070 out_two (DWARF2_VERSION);
2072 /* .debug_abbrev offset */
2073 TC_DWARF2_EMIT_OFFSET (section_symbol (abbrev_seg), sizeof_offset);
2075 /* Target address size. */
2076 out_byte (sizeof_address);
2078 /* DW_TAG_compile_unit DIE abbrev */
2081 /* DW_AT_stmt_list */
2082 TC_DWARF2_EMIT_OFFSET (section_symbol (line_seg),
2083 (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit
2086 /* These two attributes are emitted if all of the code is contiguous. */
2087 if (all_segs->next == NULL)
2090 exp.X_op = O_symbol;
2091 exp.X_add_symbol = all_segs->text_start;
2092 exp.X_add_number = 0;
2093 emit_expr (&exp, sizeof_address);
2096 if (DWARF2_VERSION < 4)
2097 exp.X_op = O_symbol;
2100 exp.X_op = O_subtract;
2101 exp.X_op_symbol = all_segs->text_start;
2103 exp.X_add_symbol = all_segs->text_end;
2104 exp.X_add_number = 0;
2105 emit_expr (&exp, sizeof_address);
2109 /* This attribute is emitted if the code is disjoint. */
2111 TC_DWARF2_EMIT_OFFSET (section_symbol (ranges_seg), sizeof_offset);
2114 /* DW_AT_name, DW_AT_comp_dir and DW_AT_producer. Symbols in .debug_str
2115 setup in out_debug_str below. */
2116 TC_DWARF2_EMIT_OFFSET (name_sym, sizeof_offset);
2117 TC_DWARF2_EMIT_OFFSET (comp_dir_sym, sizeof_offset);
2118 TC_DWARF2_EMIT_OFFSET (producer_sym, sizeof_offset);
2120 /* DW_AT_language. Yes, this is probably not really MIPS, but the
2121 dwarf2 draft has no standard code for assembler. */
2122 out_two (DW_LANG_Mips_Assembler);
2124 symbol_set_value_now_octets (info_end);
2127 /* Emit the three debug strings needed in .debug_str and setup symbols
2128 to them for use in out_debug_info. */
2130 out_debug_str (segT str_seg, symbolS **name_sym, symbolS **comp_dir_sym,
2131 symbolS **producer_sym)
2134 const char *comp_dir;
2135 const char *dirname;
2139 subseg_set (str_seg, 0);
2141 /* DW_AT_name. We don't have the actual file name that was present
2142 on the command line, so assume files[1] is the main input file.
2143 We're not supposed to get called unless at least one line number
2144 entry was emitted, so this should always be defined. */
2145 *name_sym = symbol_temp_new_now_octets ();
2146 if (files_in_use == 0)
2150 dirname = remap_debug_filename (dirs[files[1].dir]);
2151 len = strlen (dirname);
2153 /* Already has trailing slash. */
2154 p = frag_more (len);
2155 memcpy (p, dirname, len);
2157 p = frag_more (len + 1);
2158 memcpy (p, dirname, len);
2159 INSERT_DIR_SEPARATOR (p, len);
2162 len = strlen (files[1].filename) + 1;
2163 p = frag_more (len);
2164 memcpy (p, files[1].filename, len);
2166 /* DW_AT_comp_dir */
2167 *comp_dir_sym = symbol_temp_new_now_octets ();
2168 comp_dir = remap_debug_filename (getpwd ());
2169 len = strlen (comp_dir) + 1;
2170 p = frag_more (len);
2171 memcpy (p, comp_dir, len);
2173 /* DW_AT_producer */
2174 *producer_sym = symbol_temp_new_now_octets ();
2175 sprintf (producer, "GNU AS %s", VERSION);
2176 len = strlen (producer) + 1;
2177 p = frag_more (len);
2178 memcpy (p, producer, len);
2184 last_seg_ptr = &all_segs;
2188 /* Finish the dwarf2 debug sections. We emit .debug.line if there
2189 were any .file/.loc directives, or --gdwarf2 was given, or if the
2190 file has a non-empty .debug_info section and an empty .debug_line
2191 section. If we emit .debug_line, and the .debug_info section is
2192 empty, we also emit .debug_info, .debug_aranges and .debug_abbrev.
2193 ALL_SEGS will be non-null if there were any .file/.loc directives,
2194 or --gdwarf2 was given and there were any located instructions
2198 dwarf2_finish (void)
2203 int emit_other_sections = 0;
2204 int empty_debug_line = 0;
2206 info_seg = bfd_get_section_by_name (stdoutput, ".debug_info");
2207 emit_other_sections = info_seg == NULL || !seg_not_empty_p (info_seg);
2209 line_seg = bfd_get_section_by_name (stdoutput, ".debug_line");
2210 empty_debug_line = line_seg == NULL || !seg_not_empty_p (line_seg);
2212 /* We can't construct a new debug_line section if we already have one.
2214 if (all_segs && !empty_debug_line)
2215 as_fatal ("duplicate .debug_line sections");
2217 if ((!all_segs && emit_other_sections)
2218 || (!emit_other_sections && !empty_debug_line))
2219 /* If there is no line information and no non-empty .debug_info
2220 section, or if there is both a non-empty .debug_info and a non-empty
2221 .debug_line, then we do nothing. */
2224 /* Calculate the size of an address for the target machine. */
2225 sizeof_address = DWARF2_ADDR_SIZE (stdoutput);
2227 /* Create and switch to the line number section. */
2228 line_seg = subseg_new (".debug_line", 0);
2229 bfd_set_section_flags (stdoutput, line_seg, SEC_READONLY | SEC_DEBUGGING);
2231 /* For each subsection, chain the debug entries together. */
2232 for (s = all_segs; s; s = s->next)
2234 struct line_subseg *lss = s->head;
2235 struct line_entry **ptail = lss->ptail;
2237 /* Reset the initial view of the first subsection of the
2239 if (lss->head && lss->head->loc.view)
2240 set_or_check_view (lss->head, NULL, NULL);
2242 while ((lss = lss->next) != NULL)
2244 /* Link the first view of subsequent subsections to the
2246 if (lss->head && lss->head->loc.view)
2247 set_or_check_view (lss->head,
2248 !s->head ? NULL : (struct line_entry *)ptail,
2249 s->head ? s->head->head : NULL);
2255 out_debug_line (line_seg);
2257 /* If this is assembler generated line info, and there is no
2258 debug_info already, we need .debug_info, .debug_abbrev and
2259 .debug_str sections as well. */
2260 if (emit_other_sections)
2266 symbolS *name_sym, *comp_dir_sym, *producer_sym;
2268 gas_assert (all_segs);
2270 info_seg = subseg_new (".debug_info", 0);
2271 abbrev_seg = subseg_new (".debug_abbrev", 0);
2272 aranges_seg = subseg_new (".debug_aranges", 0);
2273 str_seg = subseg_new (".debug_str", 0);
2275 bfd_set_section_flags (stdoutput, info_seg,
2276 SEC_READONLY | SEC_DEBUGGING);
2277 bfd_set_section_flags (stdoutput, abbrev_seg,
2278 SEC_READONLY | SEC_DEBUGGING);
2279 bfd_set_section_flags (stdoutput, aranges_seg,
2280 SEC_READONLY | SEC_DEBUGGING);
2281 bfd_set_section_flags (stdoutput, str_seg,
2282 (SEC_READONLY | SEC_DEBUGGING
2283 | SEC_MERGE | SEC_STRINGS));
2284 str_seg->entsize = 1;
2286 record_alignment (aranges_seg, ffs (2 * sizeof_address) - 1);
2288 if (all_segs->next == NULL)
2292 ranges_seg = subseg_new (".debug_ranges", 0);
2293 bfd_set_section_flags (stdoutput, ranges_seg,
2294 SEC_READONLY | SEC_DEBUGGING);
2295 record_alignment (ranges_seg, ffs (2 * sizeof_address) - 1);
2296 out_debug_ranges (ranges_seg);
2299 out_debug_aranges (aranges_seg, info_seg);
2300 out_debug_abbrev (abbrev_seg, info_seg, line_seg);
2301 out_debug_str (str_seg, &name_sym, &comp_dir_sym, &producer_sym);
2302 out_debug_info (info_seg, abbrev_seg, line_seg, ranges_seg,
2303 name_sym, comp_dir_sym, producer_sym);
2307 /* Perform any deferred checks pertaining to debug information. */
2310 dwarf2dbg_final_check (void)
2312 /* Perform reset-view checks. Don't evaluate view_assert_failed
2313 recursively: it could be very deep. It's a chain of adds, with
2314 each chain element pointing to the next in X_add_symbol, and
2315 holding the check value in X_op_symbol. */
2316 while (view_assert_failed)
2322 gas_assert (!symbol_resolved_p (view_assert_failed));
2324 exp = symbol_get_value_expression (view_assert_failed);
2325 sym = view_assert_failed;
2327 /* If view_assert_failed looks like a compound check in the
2328 chain, break it up. */
2329 if (exp->X_op == O_add && exp->X_add_number == 0 && exp->X_unsigned)
2331 view_assert_failed = exp->X_add_symbol;
2332 sym = exp->X_op_symbol;
2335 view_assert_failed = NULL;
2337 failed = resolve_symbol_value (sym);
2338 if (!symbol_resolved_p (sym) || failed)
2340 as_bad (_("view number mismatch"));