1 /* Low-level DWARF 2 reading code
3 Copyright (C) 1994-2020 Free Software Foundation, Inc.
5 Adapted by Gary Funck (gary@intrepid.com), Intrepid Technology,
6 Inc. with support from Florida State University (under contract
7 with the Ada Joint Program Office), and Silicon Graphics, Inc.
8 Initial contribution by Brent Benson, Harris Computer Systems, Inc.,
9 based on Fred Fish's (Cygnus Support) implementation of DWARF 1
12 This file is part of GDB.
14 This program is free software; you can redistribute it and/or modify
15 it under the terms of the GNU General Public License as published by
16 the Free Software Foundation; either version 3 of the License, or
17 (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 GNU General Public License for more details.
24 You should have received a copy of the GNU General Public License
25 along with this program. If not, see <http://www.gnu.org/licenses/>. */
27 #ifndef GDB_DWARF2_LEB_H
28 #define GDB_DWARF2_LEB_H
30 /* Read dwarf information from a buffer. */
32 static inline unsigned int
33 read_1_byte (bfd
*abfd
, const gdb_byte
*buf
)
35 return bfd_get_8 (abfd
, buf
);
39 read_1_signed_byte (bfd
*abfd
, const gdb_byte
*buf
)
41 return bfd_get_signed_8 (abfd
, buf
);
44 static inline unsigned int
45 read_2_bytes (bfd
*abfd
, const gdb_byte
*buf
)
47 return bfd_get_16 (abfd
, buf
);
51 read_2_signed_bytes (bfd
*abfd
, const gdb_byte
*buf
)
53 return bfd_get_signed_16 (abfd
, buf
);
56 /* Read the next three bytes (little-endian order) as an unsigned integer. */
57 static inline unsigned int
58 read_3_bytes (bfd
*abfd
, const gdb_byte
*buf
)
60 unsigned int result
= 0;
61 for (int i
= 0; i
< 3; ++i
)
63 unsigned char byte
= bfd_get_8 (abfd
, buf
);
65 result
|= ((unsigned int) byte
<< (i
* 8));
70 static inline unsigned int
71 read_4_bytes (bfd
*abfd
, const gdb_byte
*buf
)
73 return bfd_get_32 (abfd
, buf
);
77 read_4_signed_bytes (bfd
*abfd
, const gdb_byte
*buf
)
79 return bfd_get_signed_32 (abfd
, buf
);
82 static inline ULONGEST
83 read_8_bytes (bfd
*abfd
, const gdb_byte
*buf
)
85 return bfd_get_64 (abfd
, buf
);
88 extern LONGEST
read_signed_leb128 (bfd
*, const gdb_byte
*, unsigned int *);
90 extern ULONGEST
read_unsigned_leb128 (bfd
*, const gdb_byte
*, unsigned int *);
92 /* Read the initial length from a section. The (draft) DWARF 3
93 specification allows the initial length to take up either 4 bytes
94 or 12 bytes. If the first 4 bytes are 0xffffffff, then the next 8
95 bytes describe the length and all offsets will be 8 bytes in length
98 An older, non-standard 64-bit format is also handled by this
99 function. The older format in question stores the initial length
100 as an 8-byte quantity without an escape value. Lengths greater
101 than 2^32 aren't very common which means that the initial 4 bytes
102 is almost always zero. Since a length value of zero doesn't make
103 sense for the 32-bit format, this initial zero can be considered to
104 be an escape value which indicates the presence of the older 64-bit
105 format. As written, the code can't detect (old format) lengths
106 greater than 4GB. If it becomes necessary to handle lengths
107 somewhat larger than 4GB, we could allow other small values (such
108 as the non-sensical values of 1, 2, and 3) to also be used as
109 escape values indicating the presence of the old format.
111 The value returned via bytes_read should be used to increment the
112 relevant pointer after calling read_initial_length().
114 [ Note: read_initial_length() and read_offset() are based on the
115 document entitled "DWARF Debugging Information Format", revision
116 3, draft 8, dated November 19, 2001. This document was obtained
119 http://reality.sgiweb.org/davea/dwarf3-draft8-011125.pdf
121 This document is only a draft and is subject to change. (So beware.)
123 Details regarding the older, non-standard 64-bit format were
124 determined empirically by examining 64-bit ELF files produced by
125 the SGI toolchain on an IRIX 6.5 machine.
127 - Kevin, July 16, 2002
129 extern LONGEST
read_initial_length (bfd
*abfd
, const gdb_byte
*buf
,
130 unsigned int *bytes_read
,
131 bool handle_nonstd
= true);
133 /* Read an offset from the data stream. */
134 extern LONGEST
read_offset (bfd
*abfd
, const gdb_byte
*buf
,
135 unsigned int offset_size
);
137 static inline const gdb_byte
*
138 read_n_bytes (bfd
*abfd
, const gdb_byte
*buf
, unsigned int size
)
140 /* If the size of a host char is 8 bits, we can return a pointer
141 to the buffer, otherwise we have to copy the data to a buffer
142 allocated on the temporary obstack. */
143 gdb_assert (HOST_CHAR_BIT
== 8);
147 static inline const char *
148 read_direct_string (bfd
*abfd
, const gdb_byte
*buf
,
149 unsigned int *bytes_read_ptr
)
151 /* If the size of a host char is 8 bits, we can return a pointer
152 to the string, otherwise we have to copy the string to a buffer
153 allocated on the temporary obstack. */
154 gdb_assert (HOST_CHAR_BIT
== 8);
160 *bytes_read_ptr
= strlen ((const char *) buf
) + 1;
161 return (const char *) buf
;
164 #endif /* GDB_DWARF2_LEB_H */
This page took 0.032526 seconds and 4 git commands to generate.