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. */
445 set_or_check_view (r, r->next, NULL);
446 while (r->next && r->next->loc.view && !S_IS_DEFINED (r->next->loc.view)
449 /* Unreverse the list, so that we can go forward again. */
450 h2 = reverse_line_entry_list (p);
451 gas_assert (h2 == h);
453 /* Starting from the last view we just defined, attempt to
454 simplify the view expressions, until we do so to P. */
457 gas_assert (S_IS_DEFINED (r->loc.view));
458 resolve_expression (symbol_get_value_expression (r->loc.view));
460 while (r != p && (r = r->next));
462 /* Now that we've defined and computed all earlier views that might
463 be needed to compute E's, attempt to simplify it. */
464 resolve_expression (symbol_get_value_expression (e->loc.view));
468 /* Record an entry for LOC occurring at LABEL. */
471 dwarf2_gen_line_info_1 (symbolS *label, struct dwarf2_line_info *loc)
473 struct line_subseg *lss;
474 struct line_entry *e;
476 e = XNEW (struct line_entry);
481 lss = get_line_subseg (now_seg, now_subseg, TRUE);
484 set_or_check_view (e,
485 !lss->head ? NULL : (struct line_entry *)lss->ptail,
489 lss->ptail = &e->next;
492 /* Record an entry for LOC occurring at OFS within the current fragment. */
495 dwarf2_gen_line_info (addressT ofs, struct dwarf2_line_info *loc)
497 static unsigned int line = -1;
498 static unsigned int filenum = -1;
502 /* Early out for as-yet incomplete location information. */
503 if (loc->filenum == 0 || loc->line == 0)
506 /* Don't emit sequences of line symbols for the same line when the
507 symbols apply to assembler code. It is necessary to emit
508 duplicate line symbols when a compiler asks for them, because GDB
509 uses them to determine the end of the prologue. */
510 if (debug_type == DEBUG_DWARF2
511 && line == loc->line && filenum == loc->filenum)
515 filenum = loc->filenum;
521 /* Use a non-fake name for the line number location,
522 so that it can be referred to by relocations. */
523 sprintf (name, ".Loc.%u.%u", line, filenum);
524 sym = symbol_new (name, now_seg, ofs, frag_now);
527 sym = symbol_temp_new (now_seg, ofs, frag_now);
528 dwarf2_gen_line_info_1 (sym, loc);
531 /* Returns the current source information. If .file directives have
532 been encountered, the info for the corresponding source file is
533 returned. Otherwise, the info for the assembly source file is
537 dwarf2_where (struct dwarf2_line_info *line)
539 if (debug_type == DEBUG_DWARF2)
541 const char *filename;
543 memset (line, 0, sizeof (*line));
544 filename = as_where (&line->line);
545 line->filenum = get_filenum (filename, 0);
547 line->flags = DWARF2_FLAG_IS_STMT;
548 line->isa = current.isa;
549 line->discriminator = current.discriminator;
556 /* A hook to allow the target backend to inform the line number state
557 machine of isa changes when assembler debug info is enabled. */
560 dwarf2_set_isa (unsigned int isa)
565 /* Called for each machine instruction, or relatively atomic group of
566 machine instructions (ie built-in macro). The instruction or group
567 is SIZE bytes in length. If dwarf2 line number generation is called
568 for, emit a line statement appropriately. */
571 dwarf2_emit_insn (int size)
573 struct dwarf2_line_info loc;
575 if (debug_type != DEBUG_DWARF2
576 ? !dwarf2_loc_directive_seen
577 : !seen_at_least_1_file ())
582 dwarf2_gen_line_info ((frag_now_fix_octets () - size) / OCTETS_PER_BYTE, &loc);
583 dwarf2_consume_line_info ();
586 /* Move all previously-emitted line entries for the current position by
587 DELTA bytes. This function cannot be used to move the same entries
591 dwarf2_move_insn (int delta)
593 struct line_subseg *lss;
594 struct line_entry *e;
600 lss = get_line_subseg (now_seg, now_subseg, FALSE);
604 now = frag_now_fix ();
605 while ((e = *lss->pmove_tail))
607 if (S_GET_VALUE (e->label) == now)
608 S_SET_VALUE (e->label, now + delta);
609 lss->pmove_tail = &e->next;
613 /* Called after the current line information has been either used with
614 dwarf2_gen_line_info or saved with a machine instruction for later use.
615 This resets the state of the line number information to reflect that
619 dwarf2_consume_line_info (void)
621 /* Unless we generate DWARF2 debugging information for each
622 assembler line, we only emit one line symbol for one LOC. */
623 dwarf2_loc_directive_seen = FALSE;
625 current.flags &= ~(DWARF2_FLAG_BASIC_BLOCK
626 | DWARF2_FLAG_PROLOGUE_END
627 | DWARF2_FLAG_EPILOGUE_BEGIN);
628 current.discriminator = 0;
632 /* Called for each (preferably code) label. If dwarf2_loc_mark_labels
633 is enabled, emit a basic block marker. */
636 dwarf2_emit_label (symbolS *label)
638 struct dwarf2_line_info loc;
640 if (!dwarf2_loc_mark_labels)
642 if (S_GET_SEGMENT (label) != now_seg)
644 if (!(bfd_get_section_flags (stdoutput, now_seg) & SEC_CODE))
646 if (files_in_use == 0 && debug_type != DEBUG_DWARF2)
651 loc.flags |= DWARF2_FLAG_BASIC_BLOCK;
653 dwarf2_gen_line_info_1 (label, &loc);
654 dwarf2_consume_line_info ();
657 /* Get a .debug_line file number for FILENAME. If NUM is nonzero,
658 allocate it on that file table slot, otherwise return the first
662 get_filenum (const char *filename, unsigned int num)
664 static unsigned int last_used, last_used_dir_len;
669 if (num == 0 && last_used)
671 if (! files[last_used].dir
672 && filename_cmp (filename, files[last_used].filename) == 0)
674 if (files[last_used].dir
675 && filename_ncmp (filename, dirs[files[last_used].dir],
676 last_used_dir_len) == 0
677 && IS_DIR_SEPARATOR (filename [last_used_dir_len])
678 && filename_cmp (filename + last_used_dir_len + 1,
679 files[last_used].filename) == 0)
683 file = lbasename (filename);
684 /* Don't make empty string from / or A: from A:/ . */
685 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
686 if (file <= filename + 3)
689 if (file == filename + 1)
692 dir_len = file - filename;
697 #ifndef DWARF2_DIR_SHOULD_END_WITH_SEPARATOR
700 for (dir = 1; dir < dirs_in_use; ++dir)
701 if (filename_ncmp (filename, dirs[dir], dir_len) == 0
702 && dirs[dir][dir_len] == '\0')
705 if (dir >= dirs_in_use)
707 if (dir >= dirs_allocated)
709 dirs_allocated = dir + 32;
710 dirs = XRESIZEVEC (char *, dirs, dirs_allocated);
713 dirs[dir] = xmemdup0 (filename, dir_len);
714 dirs_in_use = dir + 1;
720 for (i = 1; i < files_in_use; ++i)
721 if (files[i].dir == dir
723 && filename_cmp (file, files[i].filename) == 0)
726 last_used_dir_len = dir_len;
733 if (i >= files_allocated)
735 unsigned int old = files_allocated;
737 files_allocated = i + 32;
738 files = XRESIZEVEC (struct file_entry, files, files_allocated);
740 memset (files + old, 0, (i + 32 - old) * sizeof (struct file_entry));
743 files[i].filename = num ? file : xstrdup (file);
745 if (files_in_use < i + 1)
746 files_in_use = i + 1;
748 last_used_dir_len = dir_len;
753 /* Handle two forms of .file directive:
754 - Pass .file "source.c" to s_app_file
755 - Handle .file 1 "source.c" by adding an entry to the DWARF-2 file table
757 If an entry is added to the file table, return a pointer to the filename. */
760 dwarf2_directive_filename (void)
766 /* Continue to accept a bare string and pass it off. */
768 if (*input_line_pointer == '"')
774 num = get_absolute_expression ();
775 filename = demand_copy_C_string (&filename_len);
776 if (filename == NULL)
778 demand_empty_rest_of_line ();
782 as_bad (_("file number less than one"));
786 /* A .file directive implies compiler generated debug information is
787 being supplied. Turn off gas generated debug info. */
788 debug_type = DEBUG_NONE;
790 if (num < (int) files_in_use && files[num].filename != 0)
792 as_bad (_("file number %ld already allocated"), (long) num);
796 get_filenum (filename, num);
801 /* Calls dwarf2_directive_filename, but discards its result.
802 Used in pseudo-op tables where the function result is ignored. */
805 dwarf2_directive_file (int dummy ATTRIBUTE_UNUSED)
807 (void) dwarf2_directive_filename ();
811 dwarf2_directive_loc (int dummy ATTRIBUTE_UNUSED)
813 offsetT filenum, line;
815 /* If we see two .loc directives in a row, force the first one to be
817 if (dwarf2_loc_directive_seen)
818 dwarf2_emit_insn (0);
820 filenum = get_absolute_expression ();
822 line = get_absolute_expression ();
826 as_bad (_("file number less than one"));
829 if (filenum >= (int) files_in_use || files[filenum].filename == 0)
831 as_bad (_("unassigned file number %ld"), (long) filenum);
835 current.filenum = filenum;
837 current.discriminator = 0;
842 if (files[filenum].dir)
844 size_t dir_len = strlen (dirs[files[filenum].dir]);
845 size_t file_len = strlen (files[filenum].filename);
846 char *cp = XNEWVEC (char, dir_len + 1 + file_len + 1);
848 memcpy (cp, dirs[files[filenum].dir], dir_len);
849 INSERT_DIR_SEPARATOR (cp, dir_len);
850 memcpy (cp + dir_len + 1, files[filenum].filename, file_len);
851 cp[dir_len + file_len + 1] = '\0';
852 listing_source_file (cp);
856 listing_source_file (files[filenum].filename);
857 listing_source_line (line);
862 if (ISDIGIT (*input_line_pointer))
864 current.column = get_absolute_expression ();
868 while (ISALPHA (*input_line_pointer))
873 c = get_symbol_name (& p);
875 if (strcmp (p, "basic_block") == 0)
877 current.flags |= DWARF2_FLAG_BASIC_BLOCK;
878 *input_line_pointer = c;
880 else if (strcmp (p, "prologue_end") == 0)
882 current.flags |= DWARF2_FLAG_PROLOGUE_END;
883 *input_line_pointer = c;
885 else if (strcmp (p, "epilogue_begin") == 0)
887 current.flags |= DWARF2_FLAG_EPILOGUE_BEGIN;
888 *input_line_pointer = c;
890 else if (strcmp (p, "is_stmt") == 0)
892 (void) restore_line_pointer (c);
893 value = get_absolute_expression ();
895 current.flags &= ~DWARF2_FLAG_IS_STMT;
897 current.flags |= DWARF2_FLAG_IS_STMT;
900 as_bad (_("is_stmt value not 0 or 1"));
904 else if (strcmp (p, "isa") == 0)
906 (void) restore_line_pointer (c);
907 value = get_absolute_expression ();
912 as_bad (_("isa number less than zero"));
916 else if (strcmp (p, "discriminator") == 0)
918 (void) restore_line_pointer (c);
919 value = get_absolute_expression ();
921 current.discriminator = value;
924 as_bad (_("discriminator less than zero"));
928 else if (strcmp (p, "view") == 0)
932 (void) restore_line_pointer (c);
935 if (ISDIGIT (*input_line_pointer)
936 || *input_line_pointer == '-')
938 bfd_boolean force_reset = *input_line_pointer == '-';
940 value = get_absolute_expression ();
943 as_bad (_("numeric view can only be asserted to zero"));
946 if (force_reset && force_reset_view)
947 sym = force_reset_view;
950 sym = symbol_temp_new (absolute_section, value,
953 force_reset_view = sym;
958 char *name = read_symbol_name ();
962 sym = symbol_find_or_make (name);
963 if (S_IS_DEFINED (sym) || symbol_equated_p (sym))
965 if (S_IS_VOLATILE (sym))
966 sym = symbol_clone (sym, 1);
967 else if (!S_CAN_BE_REDEFINED (sym))
969 as_bad (_("symbol `%s' is already defined"), name);
973 S_SET_SEGMENT (sym, undefined_section);
974 S_SET_VALUE (sym, 0);
975 symbol_set_frag (sym, &zero_address_frag);
981 as_bad (_("unknown .loc sub-directive `%s'"), p);
982 (void) restore_line_pointer (c);
986 SKIP_WHITESPACE_AFTER_NAME ();
989 demand_empty_rest_of_line ();
990 dwarf2_loc_directive_seen = TRUE;
991 debug_type = DEBUG_NONE;
993 /* If we were given a view id, emit the row right away. */
995 dwarf2_emit_insn (0);
999 dwarf2_directive_loc_mark_labels (int dummy ATTRIBUTE_UNUSED)
1001 offsetT value = get_absolute_expression ();
1003 if (value != 0 && value != 1)
1005 as_bad (_("expected 0 or 1"));
1006 ignore_rest_of_line ();
1010 dwarf2_loc_mark_labels = value != 0;
1011 demand_empty_rest_of_line ();
1015 static struct frag *
1016 first_frag_for_seg (segT seg)
1018 return seg_info (seg)->frchainP->frch_root;
1021 static struct frag *
1022 last_frag_for_seg (segT seg)
1024 frchainS *f = seg_info (seg)->frchainP;
1026 while (f->frch_next != NULL)
1029 return f->frch_last;
1032 /* Emit a single byte into the current segment. */
1037 FRAG_APPEND_1_CHAR (byte);
1040 /* Emit a statement program opcode into the current segment. */
1043 out_opcode (int opc)
1048 /* Emit a two-byte word into the current segment. */
1053 md_number_to_chars (frag_more (2), data, 2);
1056 /* Emit a four byte word into the current segment. */
1061 md_number_to_chars (frag_more (4), data, 4);
1064 /* Emit an unsigned "little-endian base 128" number. */
1067 out_uleb128 (addressT value)
1069 output_leb128 (frag_more (sizeof_leb128 (value, 0)), value, 0);
1072 /* Emit a signed "little-endian base 128" number. */
1075 out_leb128 (addressT value)
1077 output_leb128 (frag_more (sizeof_leb128 (value, 1)), value, 1);
1080 /* Emit a tuple for .debug_abbrev. */
1083 out_abbrev (int name, int form)
1089 /* Get the size of a fragment. */
1092 get_frag_fix (fragS *frag, segT seg)
1097 return frag->fr_fix;
1099 /* If a fragment is the last in the chain, special measures must be
1100 taken to find its size before relaxation, since it may be pending
1101 on some subsegment chain. */
1102 for (fr = seg_info (seg)->frchainP; fr; fr = fr->frch_next)
1103 if (fr->frch_last == frag)
1104 return (char *) obstack_next_free (&fr->frch_obstack) - frag->fr_literal;
1109 /* Set an absolute address (may result in a relocation entry). */
1112 out_inc_line_addr (int line_delta, addressT addr_delta);
1115 out_set_addr (symbolS *sym)
1118 addressT expr_addr, expr_addr_aligned;
1120 memset (&exp, 0, sizeof exp);
1122 /* The expression at the bottom must be aligned to OCTETS_PER_BYTE. The
1123 statements after the for loop will contribute 3 more octets. */
1124 expr_addr = frag_now_fix_octets () + 3;
1125 expr_addr_aligned = (expr_addr + OCTETS_PER_BYTE - 1) & -OCTETS_PER_BYTE;
1126 for ( ; expr_addr != expr_addr_aligned; expr_addr++)
1127 out_inc_line_addr (0, 0); /* NOP */
1129 out_opcode (DW_LNS_extended_op); /* 1 octet */
1130 out_uleb128 (sizeof_address + 1); /* 1 octet */
1132 out_opcode (DW_LNE_set_address); /* 1 octet */
1133 exp.X_op = O_symbol;
1134 exp.X_add_symbol = sym;
1135 exp.X_add_number = 0;
1136 emit_expr (&exp, sizeof_address);
1139 static void scale_addr_delta (addressT *);
1142 scale_addr_delta (addressT *addr_delta)
1144 static int printed_this = 0;
1145 if (DWARF2_LINE_MIN_INSN_LENGTH > 1)
1147 if (*addr_delta % DWARF2_LINE_MIN_INSN_LENGTH != 0 && !printed_this)
1149 as_bad("unaligned opcodes detected in executable segment");
1152 *addr_delta /= DWARF2_LINE_MIN_INSN_LENGTH;
1156 /* Encode a pair of line and address skips as efficiently as possible.
1157 Note that the line skip is signed, whereas the address skip is unsigned.
1159 The following two routines *must* be kept in sync. This is
1160 enforced by making emit_inc_line_addr abort if we do not emit
1161 exactly the expected number of bytes. */
1164 size_inc_line_addr (int line_delta, addressT addr_delta)
1166 unsigned int tmp, opcode;
1169 /* Scale the address delta by the minimum instruction length. */
1170 scale_addr_delta (&addr_delta);
1172 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1173 We cannot use special opcodes here, since we want the end_sequence
1174 to emit the matrix entry. */
1175 if (line_delta == INT_MAX)
1177 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1180 len = 1 + sizeof_leb128 (addr_delta, 0);
1184 /* Bias the line delta by the base. */
1185 tmp = line_delta - DWARF2_LINE_BASE;
1187 /* If the line increment is out of range of a special opcode, we
1188 must encode it with DW_LNS_advance_line. */
1189 if (tmp >= DWARF2_LINE_RANGE)
1191 len = 1 + sizeof_leb128 (line_delta, 1);
1193 tmp = 0 - DWARF2_LINE_BASE;
1196 /* Bias the opcode by the special opcode base. */
1197 tmp += DWARF2_LINE_OPCODE_BASE;
1199 /* Avoid overflow when addr_delta is large. */
1200 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1202 /* Try using a special opcode. */
1203 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1207 /* Try using DW_LNS_const_add_pc followed by special op. */
1208 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1213 /* Otherwise use DW_LNS_advance_pc. */
1214 len += 1 + sizeof_leb128 (addr_delta, 0);
1216 /* DW_LNS_copy or special opcode. */
1223 emit_inc_line_addr (int line_delta, addressT addr_delta, char *p, int len)
1225 unsigned int tmp, opcode;
1227 char *end = p + len;
1229 /* Line number sequences cannot go backward in addresses. This means
1230 we've incorrectly ordered the statements in the sequence. */
1231 gas_assert ((offsetT) addr_delta >= 0);
1233 /* Scale the address delta by the minimum instruction length. */
1234 scale_addr_delta (&addr_delta);
1236 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence.
1237 We cannot use special opcodes here, since we want the end_sequence
1238 to emit the matrix entry. */
1239 if (line_delta == INT_MAX)
1241 if (addr_delta == MAX_SPECIAL_ADDR_DELTA)
1242 *p++ = DW_LNS_const_add_pc;
1245 *p++ = DW_LNS_advance_pc;
1246 p += output_leb128 (p, addr_delta, 0);
1249 *p++ = DW_LNS_extended_op;
1251 *p++ = DW_LNE_end_sequence;
1255 /* Bias the line delta by the base. */
1256 tmp = line_delta - DWARF2_LINE_BASE;
1258 /* If the line increment is out of range of a special opcode, we
1259 must encode it with DW_LNS_advance_line. */
1260 if (tmp >= DWARF2_LINE_RANGE)
1262 *p++ = DW_LNS_advance_line;
1263 p += output_leb128 (p, line_delta, 1);
1266 tmp = 0 - DWARF2_LINE_BASE;
1270 /* Prettier, I think, to use DW_LNS_copy instead of a "line +0, addr +0"
1272 if (line_delta == 0 && addr_delta == 0)
1278 /* Bias the opcode by the special opcode base. */
1279 tmp += DWARF2_LINE_OPCODE_BASE;
1281 /* Avoid overflow when addr_delta is large. */
1282 if (addr_delta < 256 + MAX_SPECIAL_ADDR_DELTA)
1284 /* Try using a special opcode. */
1285 opcode = tmp + addr_delta * DWARF2_LINE_RANGE;
1292 /* Try using DW_LNS_const_add_pc followed by special op. */
1293 opcode = tmp + (addr_delta - MAX_SPECIAL_ADDR_DELTA) * DWARF2_LINE_RANGE;
1296 *p++ = DW_LNS_const_add_pc;
1302 /* Otherwise use DW_LNS_advance_pc. */
1303 *p++ = DW_LNS_advance_pc;
1304 p += output_leb128 (p, addr_delta, 0);
1312 gas_assert (p == end);
1315 /* Handy routine to combine calls to the above two routines. */
1318 out_inc_line_addr (int line_delta, addressT addr_delta)
1320 int len = size_inc_line_addr (line_delta, addr_delta);
1321 emit_inc_line_addr (line_delta, addr_delta, frag_more (len), len);
1324 /* Write out an alternative form of line and address skips using
1325 DW_LNS_fixed_advance_pc opcodes. This uses more space than the default
1326 line and address information, but it is required if linker relaxation
1327 could change the code offsets. The following two routines *must* be
1329 #define ADDR_DELTA_LIMIT 50000
1332 size_fixed_inc_line_addr (int line_delta, addressT addr_delta)
1336 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1337 if (line_delta != INT_MAX)
1338 len = 1 + sizeof_leb128 (line_delta, 1);
1340 if (addr_delta > ADDR_DELTA_LIMIT)
1342 /* DW_LNS_extended_op */
1343 len += 1 + sizeof_leb128 (sizeof_address + 1, 0);
1344 /* DW_LNE_set_address */
1345 len += 1 + sizeof_address;
1348 /* DW_LNS_fixed_advance_pc */
1351 if (line_delta == INT_MAX)
1352 /* DW_LNS_extended_op + DW_LNE_end_sequence */
1362 emit_fixed_inc_line_addr (int line_delta, addressT addr_delta, fragS *frag,
1366 char *end = p + len;
1368 /* Line number sequences cannot go backward in addresses. This means
1369 we've incorrectly ordered the statements in the sequence. */
1370 gas_assert ((offsetT) addr_delta >= 0);
1372 /* Verify that we have kept in sync with size_fixed_inc_line_addr. */
1373 gas_assert (len == size_fixed_inc_line_addr (line_delta, addr_delta));
1375 /* INT_MAX is a signal that this is actually a DW_LNE_end_sequence. */
1376 if (line_delta != INT_MAX)
1378 *p++ = DW_LNS_advance_line;
1379 p += output_leb128 (p, line_delta, 1);
1382 pexp = symbol_get_value_expression (frag->fr_symbol);
1384 /* The DW_LNS_fixed_advance_pc opcode has a 2-byte operand so it can
1385 advance the address by at most 64K. Linker relaxation (without
1386 which this function would not be used) could change the operand by
1387 an unknown amount. If the address increment is getting close to
1388 the limit, just reset the address. */
1389 if (addr_delta > ADDR_DELTA_LIMIT)
1394 memset (&exp, 0, sizeof exp);
1395 gas_assert (pexp->X_op == O_subtract);
1396 to_sym = pexp->X_add_symbol;
1398 *p++ = DW_LNS_extended_op;
1399 p += output_leb128 (p, sizeof_address + 1, 0);
1400 *p++ = DW_LNE_set_address;
1401 exp.X_op = O_symbol;
1402 exp.X_add_symbol = to_sym;
1403 exp.X_add_number = 0;
1404 emit_expr_fix (&exp, sizeof_address, frag, p, TC_PARSE_CONS_RETURN_NONE);
1405 p += sizeof_address;
1409 *p++ = DW_LNS_fixed_advance_pc;
1410 emit_expr_fix (pexp, 2, frag, p, TC_PARSE_CONS_RETURN_NONE);
1414 if (line_delta == INT_MAX)
1416 *p++ = DW_LNS_extended_op;
1418 *p++ = DW_LNE_end_sequence;
1423 gas_assert (p == end);
1426 /* Generate a variant frag that we can use to relax address/line
1427 increments between fragments of the target segment. */
1430 relax_inc_line_addr (int line_delta, symbolS *to_sym, symbolS *from_sym)
1435 memset (&exp, 0, sizeof exp);
1436 exp.X_op = O_subtract;
1437 exp.X_add_symbol = to_sym;
1438 exp.X_op_symbol = from_sym;
1439 exp.X_add_number = 0;
1441 /* The maximum size of the frag is the line delta with a maximum
1442 sized address delta. */
1443 if (DWARF2_USE_FIXED_ADVANCE_PC)
1444 max_chars = size_fixed_inc_line_addr (line_delta,
1445 -DWARF2_LINE_MIN_INSN_LENGTH);
1447 max_chars = size_inc_line_addr (line_delta, -DWARF2_LINE_MIN_INSN_LENGTH);
1449 frag_var (rs_dwarf2dbg, max_chars, max_chars, 1,
1450 make_expr_symbol (&exp), line_delta, NULL);
1453 /* The function estimates the size of a rs_dwarf2dbg variant frag
1454 based on the current values of the symbols. It is called before
1455 the relaxation loop. We set fr_subtype to the expected length. */
1458 dwarf2dbg_estimate_size_before_relax (fragS *frag)
1463 addr_delta = resolve_symbol_value (frag->fr_symbol);
1464 if (DWARF2_USE_FIXED_ADVANCE_PC)
1465 size = size_fixed_inc_line_addr (frag->fr_offset, addr_delta);
1467 size = size_inc_line_addr (frag->fr_offset, addr_delta);
1469 frag->fr_subtype = size;
1474 /* This function relaxes a rs_dwarf2dbg variant frag based on the
1475 current values of the symbols. fr_subtype is the current length
1476 of the frag. This returns the change in frag length. */
1479 dwarf2dbg_relax_frag (fragS *frag)
1481 int old_size, new_size;
1483 old_size = frag->fr_subtype;
1484 new_size = dwarf2dbg_estimate_size_before_relax (frag);
1486 return new_size - old_size;
1489 /* This function converts a rs_dwarf2dbg variant frag into a normal
1490 fill frag. This is called after all relaxation has been done.
1491 fr_subtype will be the desired length of the frag. */
1494 dwarf2dbg_convert_frag (fragS *frag)
1498 if (DWARF2_USE_FIXED_ADVANCE_PC)
1500 /* If linker relaxation is enabled then the distance between the two
1501 symbols in the frag->fr_symbol expression might change. Hence we
1502 cannot rely upon the value computed by resolve_symbol_value.
1503 Instead we leave the expression unfinalized and allow
1504 emit_fixed_inc_line_addr to create a fixup (which later becomes a
1505 relocation) that will allow the linker to correctly compute the
1506 actual address difference. We have to use a fixed line advance for
1507 this as we cannot (easily) relocate leb128 encoded values. */
1508 int saved_finalize_syms = finalize_syms;
1511 addr_diff = resolve_symbol_value (frag->fr_symbol);
1512 finalize_syms = saved_finalize_syms;
1515 addr_diff = resolve_symbol_value (frag->fr_symbol);
1517 /* fr_var carries the max_chars that we created the fragment with.
1518 fr_subtype carries the current expected length. We must, of
1519 course, have allocated enough memory earlier. */
1520 gas_assert (frag->fr_var >= (int) frag->fr_subtype);
1522 if (DWARF2_USE_FIXED_ADVANCE_PC)
1523 emit_fixed_inc_line_addr (frag->fr_offset, addr_diff, frag,
1524 frag->fr_literal + frag->fr_fix,
1527 emit_inc_line_addr (frag->fr_offset, addr_diff,
1528 frag->fr_literal + frag->fr_fix, frag->fr_subtype);
1530 frag->fr_fix += frag->fr_subtype;
1531 frag->fr_type = rs_fill;
1533 frag->fr_offset = 0;
1536 /* Generate .debug_line content for the chain of line number entries
1537 beginning at E, for segment SEG. */
1540 process_entries (segT seg, struct line_entry *e)
1542 unsigned filenum = 1;
1544 unsigned column = 0;
1546 unsigned flags = DWARF2_LINE_DEFAULT_IS_STMT ? DWARF2_FLAG_IS_STMT : 0;
1547 fragS *last_frag = NULL, *frag;
1548 addressT last_frag_ofs = 0, frag_ofs;
1549 symbolS *last_lab = NULL, *lab;
1550 struct line_entry *next;
1552 if (flag_dwarf_sections)
1555 const char * sec_name;
1557 /* Switch to the relevant sub-section before we start to emit
1558 the line number table.
1560 FIXME: These sub-sections do not have a normal Line Number
1561 Program Header, thus strictly speaking they are not valid
1562 DWARF sections. Unfortunately the DWARF standard assumes
1563 a one-to-one relationship between compilation units and
1564 line number tables. Thus we have to have a .debug_line
1565 section, as well as our sub-sections, and we have to ensure
1566 that all of the sub-sections are merged into a proper
1567 .debug_line section before a debugger sees them. */
1569 sec_name = bfd_get_section_name (stdoutput, seg);
1570 if (strcmp (sec_name, ".text") != 0)
1572 name = concat (".debug_line", sec_name, (char *) NULL);
1573 subseg_set (subseg_get (name, FALSE), 0);
1576 /* Don't create a .debug_line.text section -
1577 that is redundant. Instead just switch back to the
1578 normal .debug_line section. */
1579 subseg_set (subseg_get (".debug_line", FALSE), 0);
1586 if (filenum != e->loc.filenum)
1588 filenum = e->loc.filenum;
1589 out_opcode (DW_LNS_set_file);
1590 out_uleb128 (filenum);
1593 if (column != e->loc.column)
1595 column = e->loc.column;
1596 out_opcode (DW_LNS_set_column);
1597 out_uleb128 (column);
1600 if (e->loc.discriminator != 0)
1602 out_opcode (DW_LNS_extended_op);
1603 out_leb128 (1 + sizeof_leb128 (e->loc.discriminator, 0));
1604 out_opcode (DW_LNE_set_discriminator);
1605 out_uleb128 (e->loc.discriminator);
1608 if (isa != e->loc.isa)
1611 out_opcode (DW_LNS_set_isa);
1615 if ((e->loc.flags ^ flags) & DWARF2_FLAG_IS_STMT)
1617 flags = e->loc.flags;
1618 out_opcode (DW_LNS_negate_stmt);
1621 if (e->loc.flags & DWARF2_FLAG_BASIC_BLOCK)
1622 out_opcode (DW_LNS_set_basic_block);
1624 if (e->loc.flags & DWARF2_FLAG_PROLOGUE_END)
1625 out_opcode (DW_LNS_set_prologue_end);
1627 if (e->loc.flags & DWARF2_FLAG_EPILOGUE_BEGIN)
1628 out_opcode (DW_LNS_set_epilogue_begin);
1630 /* Don't try to optimize away redundant entries; gdb wants two
1631 entries for a function where the code starts on the same line as
1632 the {, and there's no way to identify that case here. Trust gcc
1633 to optimize appropriately. */
1634 line_delta = e->loc.line - line;
1636 frag = symbol_get_frag (lab);
1637 frag_ofs = S_GET_VALUE (lab);
1639 if (last_frag == NULL
1640 || (e->loc.view == force_reset_view && force_reset_view
1641 /* If we're going to reset the view, but we know we're
1642 advancing the PC, we don't have to force with
1643 set_address. We know we do when we're at the same
1644 address of the same frag, and we know we might when
1645 we're in the beginning of a frag, and we were at the
1646 end of the previous frag. */
1647 && (frag == last_frag
1648 ? (last_frag_ofs == frag_ofs)
1650 && ((offsetT)last_frag_ofs
1651 >= get_frag_fix (last_frag, seg))))))
1654 out_inc_line_addr (line_delta, 0);
1656 else if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1657 out_inc_line_addr (line_delta, frag_ofs - last_frag_ofs);
1659 relax_inc_line_addr (line_delta, lab, last_lab);
1664 last_frag_ofs = frag_ofs;
1672 /* Emit a DW_LNE_end_sequence for the end of the section. */
1673 frag = last_frag_for_seg (seg);
1674 frag_ofs = get_frag_fix (frag, seg);
1675 if (frag == last_frag && ! DWARF2_USE_FIXED_ADVANCE_PC)
1676 out_inc_line_addr (INT_MAX, frag_ofs - last_frag_ofs);
1679 lab = symbol_temp_new (seg, frag_ofs, frag);
1680 relax_inc_line_addr (INT_MAX, lab, last_lab);
1684 /* Emit the directory and file tables for .debug_line. */
1687 out_file_list (void)
1694 /* Emit directory list. */
1695 for (i = 1; i < dirs_in_use; ++i)
1697 dir = remap_debug_filename (dirs[i]);
1698 size = strlen (dir) + 1;
1699 cp = frag_more (size);
1700 memcpy (cp, dir, size);
1705 for (i = 1; i < files_in_use; ++i)
1707 const char *fullfilename;
1709 if (files[i].filename == NULL)
1711 as_bad (_("unassigned file number %ld"), (long) i);
1712 /* Prevent a crash later, particularly for file 1. */
1713 files[i].filename = "";
1717 fullfilename = DWARF2_FILE_NAME (files[i].filename,
1718 files[i].dir ? dirs [files [i].dir] : "");
1719 size = strlen (fullfilename) + 1;
1720 cp = frag_more (size);
1721 memcpy (cp, fullfilename, size);
1723 out_uleb128 (files[i].dir); /* directory number */
1724 /* Output the last modification timestamp. */
1725 out_uleb128 (DWARF2_FILE_TIME_NAME (files[i].filename,
1726 files[i].dir ? dirs [files [i].dir] : ""));
1727 /* Output the filesize. */
1728 out_uleb128 (DWARF2_FILE_SIZE_NAME (files[i].filename,
1729 files[i].dir ? dirs [files [i].dir] : ""));
1732 /* Terminate filename list. */
1736 /* Switch to SEC and output a header length field. Return the size of
1737 offsets used in SEC. The caller must set EXPR->X_add_symbol value
1738 to the end of the section. EXPR->X_add_number will be set to the
1739 negative size of the header. */
1742 out_header (asection *sec, expressionS *exp)
1747 subseg_set (sec, 0);
1749 if (flag_dwarf_sections)
1751 /* If we are going to put the start and end symbols in different
1752 sections, then we need real symbols, not just fake, local ones. */
1754 start_sym = symbol_make (".Ldebug_line_start");
1755 end_sym = symbol_make (".Ldebug_line_end");
1756 symbol_set_value_now (start_sym);
1760 start_sym = symbol_temp_new_now_octets ();
1761 end_sym = symbol_temp_make ();
1764 /* Total length of the information. */
1765 exp->X_op = O_subtract;
1766 exp->X_add_symbol = end_sym;
1767 exp->X_op_symbol = start_sym;
1769 switch (DWARF2_FORMAT (sec))
1771 case dwarf2_format_32bit:
1772 exp->X_add_number = -4;
1776 case dwarf2_format_64bit:
1777 exp->X_add_number = -12;
1782 case dwarf2_format_64bit_irix:
1783 exp->X_add_number = -8;
1788 as_fatal (_("internal error: unknown dwarf2 format"));
1792 /* Emit the collected .debug_line data. */
1795 out_debug_line (segT line_seg)
1798 symbolS *prologue_start, *prologue_end;
1802 addressT section_end, section_end_aligned;
1804 memset (&exp, 0, sizeof exp);
1805 sizeof_offset = out_header (line_seg, &exp);
1806 line_end = exp.X_add_symbol;
1809 out_two (DWARF2_LINE_VERSION);
1811 /* Length of the prologue following this length. */
1812 prologue_start = symbol_temp_make ();
1813 prologue_end = symbol_temp_make ();
1814 exp.X_op = O_subtract;
1815 exp.X_add_symbol = prologue_end;
1816 exp.X_op_symbol = prologue_start;
1817 exp.X_add_number = 0;
1818 emit_expr (&exp, sizeof_offset);
1819 symbol_set_value_now_octets (prologue_start);
1821 /* Parameters of the state machine. */
1822 out_byte (DWARF2_LINE_MIN_INSN_LENGTH);
1823 out_byte (DWARF2_LINE_DEFAULT_IS_STMT);
1824 out_byte (DWARF2_LINE_BASE);
1825 out_byte (DWARF2_LINE_RANGE);
1826 out_byte (DWARF2_LINE_OPCODE_BASE);
1828 /* Standard opcode lengths. */
1829 out_byte (0); /* DW_LNS_copy */
1830 out_byte (1); /* DW_LNS_advance_pc */
1831 out_byte (1); /* DW_LNS_advance_line */
1832 out_byte (1); /* DW_LNS_set_file */
1833 out_byte (1); /* DW_LNS_set_column */
1834 out_byte (0); /* DW_LNS_negate_stmt */
1835 out_byte (0); /* DW_LNS_set_basic_block */
1836 out_byte (0); /* DW_LNS_const_add_pc */
1837 out_byte (1); /* DW_LNS_fixed_advance_pc */
1838 out_byte (0); /* DW_LNS_set_prologue_end */
1839 out_byte (0); /* DW_LNS_set_epilogue_begin */
1840 out_byte (1); /* DW_LNS_set_isa */
1844 symbol_set_value_now_octets (prologue_end);
1846 /* For each section, emit a statement program. */
1847 for (s = all_segs; s; s = s->next)
1848 if (SEG_NORMAL (s->seg))
1849 process_entries (s->seg, s->head->head);
1851 as_warn ("dwarf line number information for %s ignored",
1852 segment_name (s->seg));
1854 if (flag_dwarf_sections)
1855 /* We have to switch to the special .debug_line_end section
1856 before emitting the end-of-debug_line symbol. The linker
1857 script arranges for this section to be placed after all the
1858 (potentially garbage collected) .debug_line.<foo> sections.
1859 This section contains the line_end symbol which is used to
1860 compute the size of the linked .debug_line section, as seen
1861 in the DWARF Line Number header. */
1862 subseg_set (subseg_get (".debug_line_end", FALSE), 0);
1864 /* Pad size of .debug_line section to a multiple of OCTETS_PER_BYTE.
1865 Simply sizing the section in md_section_align() is not sufficient,
1866 also the size field in the .debug_line header must be a multiple
1867 of OCTETS_PER_BYTE. Not doing so will introduce gaps within the
1868 .debug_line sections after linking. */
1869 section_end = frag_now_fix_octets ();
1870 section_end_aligned = (section_end + OCTETS_PER_BYTE - 1) & -OCTETS_PER_BYTE;
1871 for ( ; section_end != section_end_aligned; section_end++)
1872 out_inc_line_addr (0, 0); /* NOP */
1874 symbol_set_value_now_octets (line_end);
1878 out_debug_ranges (segT ranges_seg)
1880 unsigned int addr_size = sizeof_address;
1885 memset (&exp, 0, sizeof exp);
1886 subseg_set (ranges_seg, 0);
1888 /* Base Address Entry. */
1889 for (i = 0; i < addr_size; i++)
1891 for (i = 0; i < addr_size; i++)
1894 /* Range List Entry. */
1895 for (s = all_segs; s; s = s->next)
1900 frag = first_frag_for_seg (s->seg);
1901 beg = symbol_temp_new (s->seg, 0, frag);
1902 s->text_start = beg;
1904 frag = last_frag_for_seg (s->seg);
1905 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1908 exp.X_op = O_symbol;
1909 exp.X_add_symbol = beg;
1910 exp.X_add_number = 0;
1911 emit_expr (&exp, addr_size);
1913 exp.X_op = O_symbol;
1914 exp.X_add_symbol = end;
1915 exp.X_add_number = 0;
1916 emit_expr (&exp, addr_size);
1919 /* End of Range Entry. */
1920 for (i = 0; i < addr_size; i++)
1922 for (i = 0; i < addr_size; i++)
1926 /* Emit data for .debug_aranges. */
1929 out_debug_aranges (segT aranges_seg, segT info_seg)
1931 unsigned int addr_size = sizeof_address;
1935 symbolS *aranges_end;
1939 memset (&exp, 0, sizeof exp);
1940 sizeof_offset = out_header (aranges_seg, &exp);
1941 aranges_end = exp.X_add_symbol;
1942 size = -exp.X_add_number;
1945 out_two (DWARF2_ARANGES_VERSION);
1948 /* Offset to .debug_info. */
1949 TC_DWARF2_EMIT_OFFSET (section_symbol (info_seg), sizeof_offset);
1950 size += sizeof_offset;
1952 /* Size of an address (offset portion). */
1953 out_byte (addr_size);
1956 /* Size of a segment descriptor. */
1960 /* Align the header. */
1961 while ((size++ % (2 * addr_size)) > 0)
1964 for (s = all_segs; s; s = s->next)
1969 frag = first_frag_for_seg (s->seg);
1970 beg = symbol_temp_new (s->seg, 0, frag);
1971 s->text_start = beg;
1973 frag = last_frag_for_seg (s->seg);
1974 end = symbol_temp_new (s->seg, get_frag_fix (frag, s->seg), frag);
1977 exp.X_op = O_symbol;
1978 exp.X_add_symbol = beg;
1979 exp.X_add_number = 0;
1980 emit_expr (&exp, addr_size);
1982 exp.X_op = O_subtract;
1983 exp.X_add_symbol = end;
1984 exp.X_op_symbol = beg;
1985 exp.X_add_number = 0;
1986 emit_expr (&exp, addr_size);
1989 p = frag_more (2 * addr_size);
1990 md_number_to_chars (p, 0, addr_size);
1991 md_number_to_chars (p + addr_size, 0, addr_size);
1993 symbol_set_value_now_octets (aranges_end);
1996 /* Emit data for .debug_abbrev. Note that this must be kept in
1997 sync with out_debug_info below. */
2000 out_debug_abbrev (segT abbrev_seg,
2001 segT info_seg ATTRIBUTE_UNUSED,
2002 segT line_seg ATTRIBUTE_UNUSED)
2004 subseg_set (abbrev_seg, 0);
2007 out_uleb128 (DW_TAG_compile_unit);
2008 out_byte (DW_CHILDREN_no);
2009 if (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit)
2010 out_abbrev (DW_AT_stmt_list, DW_FORM_data4);
2012 out_abbrev (DW_AT_stmt_list, DW_FORM_data8);
2013 if (all_segs->next == NULL)
2015 out_abbrev (DW_AT_low_pc, DW_FORM_addr);
2016 if (DWARF2_VERSION < 4)
2017 out_abbrev (DW_AT_high_pc, DW_FORM_addr);
2019 out_abbrev (DW_AT_high_pc, (sizeof_address == 4
2020 ? DW_FORM_data4 : DW_FORM_data8));
2024 if (DWARF2_FORMAT (info_seg) == dwarf2_format_32bit)
2025 out_abbrev (DW_AT_ranges, DW_FORM_data4);
2027 out_abbrev (DW_AT_ranges, DW_FORM_data8);
2029 out_abbrev (DW_AT_name, DW_FORM_strp);
2030 out_abbrev (DW_AT_comp_dir, DW_FORM_strp);
2031 out_abbrev (DW_AT_producer, DW_FORM_strp);
2032 out_abbrev (DW_AT_language, DW_FORM_data2);
2035 /* Terminate the abbreviations for this compilation unit. */
2039 /* Emit a description of this compilation unit for .debug_info. */
2042 out_debug_info (segT info_seg, segT abbrev_seg, segT line_seg, segT ranges_seg,
2043 symbolS *name_sym, symbolS *comp_dir_sym, symbolS *producer_sym)
2049 memset (&exp, 0, sizeof exp);
2050 sizeof_offset = out_header (info_seg, &exp);
2051 info_end = exp.X_add_symbol;
2053 /* DWARF version. */
2054 out_two (DWARF2_VERSION);
2056 /* .debug_abbrev offset */
2057 TC_DWARF2_EMIT_OFFSET (section_symbol (abbrev_seg), sizeof_offset);
2059 /* Target address size. */
2060 out_byte (sizeof_address);
2062 /* DW_TAG_compile_unit DIE abbrev */
2065 /* DW_AT_stmt_list */
2066 TC_DWARF2_EMIT_OFFSET (section_symbol (line_seg),
2067 (DWARF2_FORMAT (line_seg) == dwarf2_format_32bit
2070 /* These two attributes are emitted if all of the code is contiguous. */
2071 if (all_segs->next == NULL)
2074 exp.X_op = O_symbol;
2075 exp.X_add_symbol = all_segs->text_start;
2076 exp.X_add_number = 0;
2077 emit_expr (&exp, sizeof_address);
2080 if (DWARF2_VERSION < 4)
2081 exp.X_op = O_symbol;
2084 exp.X_op = O_subtract;
2085 exp.X_op_symbol = all_segs->text_start;
2087 exp.X_add_symbol = all_segs->text_end;
2088 exp.X_add_number = 0;
2089 emit_expr (&exp, sizeof_address);
2093 /* This attribute is emitted if the code is disjoint. */
2095 TC_DWARF2_EMIT_OFFSET (section_symbol (ranges_seg), sizeof_offset);
2098 /* DW_AT_name, DW_AT_comp_dir and DW_AT_producer. Symbols in .debug_str
2099 setup in out_debug_str below. */
2100 TC_DWARF2_EMIT_OFFSET (name_sym, sizeof_offset);
2101 TC_DWARF2_EMIT_OFFSET (comp_dir_sym, sizeof_offset);
2102 TC_DWARF2_EMIT_OFFSET (producer_sym, sizeof_offset);
2104 /* DW_AT_language. Yes, this is probably not really MIPS, but the
2105 dwarf2 draft has no standard code for assembler. */
2106 out_two (DW_LANG_Mips_Assembler);
2108 symbol_set_value_now_octets (info_end);
2111 /* Emit the three debug strings needed in .debug_str and setup symbols
2112 to them for use in out_debug_info. */
2114 out_debug_str (segT str_seg, symbolS **name_sym, symbolS **comp_dir_sym,
2115 symbolS **producer_sym)
2118 const char *comp_dir;
2119 const char *dirname;
2123 subseg_set (str_seg, 0);
2125 /* DW_AT_name. We don't have the actual file name that was present
2126 on the command line, so assume files[1] is the main input file.
2127 We're not supposed to get called unless at least one line number
2128 entry was emitted, so this should always be defined. */
2129 *name_sym = symbol_temp_new_now_octets ();
2130 if (files_in_use == 0)
2134 dirname = remap_debug_filename (dirs[files[1].dir]);
2135 len = strlen (dirname);
2137 /* Already has trailing slash. */
2138 p = frag_more (len);
2139 memcpy (p, dirname, len);
2141 p = frag_more (len + 1);
2142 memcpy (p, dirname, len);
2143 INSERT_DIR_SEPARATOR (p, len);
2146 len = strlen (files[1].filename) + 1;
2147 p = frag_more (len);
2148 memcpy (p, files[1].filename, len);
2150 /* DW_AT_comp_dir */
2151 *comp_dir_sym = symbol_temp_new_now_octets ();
2152 comp_dir = remap_debug_filename (getpwd ());
2153 len = strlen (comp_dir) + 1;
2154 p = frag_more (len);
2155 memcpy (p, comp_dir, len);
2157 /* DW_AT_producer */
2158 *producer_sym = symbol_temp_new_now_octets ();
2159 sprintf (producer, "GNU AS %s", VERSION);
2160 len = strlen (producer) + 1;
2161 p = frag_more (len);
2162 memcpy (p, producer, len);
2168 last_seg_ptr = &all_segs;
2172 /* Finish the dwarf2 debug sections. We emit .debug.line if there
2173 were any .file/.loc directives, or --gdwarf2 was given, or if the
2174 file has a non-empty .debug_info section and an empty .debug_line
2175 section. If we emit .debug_line, and the .debug_info section is
2176 empty, we also emit .debug_info, .debug_aranges and .debug_abbrev.
2177 ALL_SEGS will be non-null if there were any .file/.loc directives,
2178 or --gdwarf2 was given and there were any located instructions
2182 dwarf2_finish (void)
2187 int emit_other_sections = 0;
2188 int empty_debug_line = 0;
2190 info_seg = bfd_get_section_by_name (stdoutput, ".debug_info");
2191 emit_other_sections = info_seg == NULL || !seg_not_empty_p (info_seg);
2193 line_seg = bfd_get_section_by_name (stdoutput, ".debug_line");
2194 empty_debug_line = line_seg == NULL || !seg_not_empty_p (line_seg);
2196 /* We can't construct a new debug_line section if we already have one.
2198 if (all_segs && !empty_debug_line)
2199 as_fatal ("duplicate .debug_line sections");
2201 if ((!all_segs && emit_other_sections)
2202 || (!emit_other_sections && !empty_debug_line))
2203 /* If there is no line information and no non-empty .debug_info
2204 section, or if there is both a non-empty .debug_info and a non-empty
2205 .debug_line, then we do nothing. */
2208 /* Calculate the size of an address for the target machine. */
2209 sizeof_address = DWARF2_ADDR_SIZE (stdoutput);
2211 /* Create and switch to the line number section. */
2212 line_seg = subseg_new (".debug_line", 0);
2213 bfd_set_section_flags (stdoutput, line_seg, SEC_READONLY | SEC_DEBUGGING);
2215 /* For each subsection, chain the debug entries together. */
2216 for (s = all_segs; s; s = s->next)
2218 struct line_subseg *lss = s->head;
2219 struct line_entry **ptail = lss->ptail;
2221 while ((lss = lss->next) != NULL)
2228 out_debug_line (line_seg);
2230 /* If this is assembler generated line info, and there is no
2231 debug_info already, we need .debug_info, .debug_abbrev and
2232 .debug_str sections as well. */
2233 if (emit_other_sections)
2239 symbolS *name_sym, *comp_dir_sym, *producer_sym;
2241 gas_assert (all_segs);
2243 info_seg = subseg_new (".debug_info", 0);
2244 abbrev_seg = subseg_new (".debug_abbrev", 0);
2245 aranges_seg = subseg_new (".debug_aranges", 0);
2246 str_seg = subseg_new (".debug_str", 0);
2248 bfd_set_section_flags (stdoutput, info_seg,
2249 SEC_READONLY | SEC_DEBUGGING);
2250 bfd_set_section_flags (stdoutput, abbrev_seg,
2251 SEC_READONLY | SEC_DEBUGGING);
2252 bfd_set_section_flags (stdoutput, aranges_seg,
2253 SEC_READONLY | SEC_DEBUGGING);
2254 bfd_set_section_flags (stdoutput, str_seg,
2255 (SEC_READONLY | SEC_DEBUGGING
2256 | SEC_MERGE | SEC_STRINGS));
2257 str_seg->entsize = 1;
2259 record_alignment (aranges_seg, ffs (2 * sizeof_address) - 1);
2261 if (all_segs->next == NULL)
2265 ranges_seg = subseg_new (".debug_ranges", 0);
2266 bfd_set_section_flags (stdoutput, ranges_seg,
2267 SEC_READONLY | SEC_DEBUGGING);
2268 record_alignment (ranges_seg, ffs (2 * sizeof_address) - 1);
2269 out_debug_ranges (ranges_seg);
2272 out_debug_aranges (aranges_seg, info_seg);
2273 out_debug_abbrev (abbrev_seg, info_seg, line_seg);
2274 out_debug_str (str_seg, &name_sym, &comp_dir_sym, &producer_sym);
2275 out_debug_info (info_seg, abbrev_seg, line_seg, ranges_seg,
2276 name_sym, comp_dir_sym, producer_sym);
2280 /* Perform any deferred checks pertaining to debug information. */
2283 dwarf2dbg_final_check (void)
2285 /* Perform reset-view checks. Don't evaluate view_assert_failed
2286 recursively: it could be very deep. It's a chain of adds, with
2287 each chain element pointing to the next in X_add_symbol, and
2288 holding the check value in X_op_symbol. */
2289 while (view_assert_failed)
2295 gas_assert (!symbol_resolved_p (view_assert_failed));
2297 exp = symbol_get_value_expression (view_assert_failed);
2298 sym = view_assert_failed;
2300 /* If view_assert_failed looks like a compound check in the
2301 chain, break it up. */
2302 if (exp->X_op == O_add && exp->X_add_number == 0 && exp->X_unsigned)
2304 view_assert_failed = exp->X_add_symbol;
2305 sym = exp->X_op_symbol;
2308 view_assert_failed = NULL;
2310 failed = resolve_symbol_value (sym);
2311 if (!symbol_resolved_p (sym) || failed)
2313 as_bad (_("view number mismatch"));