1 /* SPDX-License-Identifier: GPL-2.0 */
7  * Examples for kABI stability features with --stable.
18  * $ gcc -g -c examples/kabi_ex.c -o examples/kabi_ex.o
21  * 	./gendwarfksyms --stable --dump-dies \
23  * 	FileCheck examples/kabi_ex.h --check-prefix=STABLE
26  * 	./gendwarfksyms --stable --dump-versions \
29  * 	FileCheck examples/kabi_ex.h --check-prefix=VERSIONS
42 	int a;  member
49  * STABLE-NEXT: }
53 	A,  enumerator
65  * STABLE-NEXT:   enumerator A = 0 ,
66  * STABLE-NEXT:   enumerator D = 123456789
67  * STABLE-NEXT: } byte_size(4)
74 	int a;  member
81  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
82 …* STABLE-NEXT:   member base_type [[ULONG:long unsigned int|unsigned long]] byte_size(8) encoding(…
83  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) data_member_location(16)
84  * STABLE-NEXT: } byte_size(24)
88 	int a;  member
95  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
96  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) data_member_location(8) ,
97  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) data_member_location(16)
98  * STABLE-NEXT: } byte_size(24)
102 	int a;  member
109  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
110  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) data_member_location(8) ,
111  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) data_member_location(16)
112  * STABLE-NEXT: } byte_size(24)
116  * Example: A reserved array
120 	unsigned int a;  member
126  * STABLE-NEXT:   member base_type unsigned int byte_size(4) encoding(7) a data_member_location(0) ,
127  * STABLE-NEXT:   member array_type[64] {
128  * STABLE-NEXT:     base_type unsigned char byte_size(1) encoding(8)
129  * STABLE-NEXT:   } data_member_location(8)
130  * STABLE-NEXT: } byte_size(72)
134 	unsigned int a;  member
144  * STABLE-NEXT:   member base_type unsigned int byte_size(4) encoding(7) a data_member_location(0) ,
145  * STABLE-NEXT:   member array_type[64] {
146  * STABLE-NEXT:     base_type unsigned char byte_size(1) encoding(8)
147  * STABLE-NEXT:   } data_member_location(8)
148  * STABLE-NEXT: } byte_size(72)
152 	unsigned int a;  member
153 	KABI_USE_ARRAY(0, 64, void *p[8]);
158  * STABLE-NEXT:   member base_type unsigned int byte_size(4) encoding(7) a data_member_location(0) ,
159  * STABLE-NEXT:   member array_type[64] {
160  * STABLE-NEXT:     base_type unsigned char byte_size(1) encoding(8)
161  * STABLE-NEXT:   } data_member_location(8)
162  * STABLE-NEXT: } byte_size(72)
170 	int a;  member
178  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
179  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) b data_member_location(8)
180  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) c data_member_location(16) ,
181  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) d data_member_location(24)
182  * STABLE-NEXT: } byte_size(32)
186 	int a;  member
197  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
198  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) b data_member_location(8)
199  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) c data_member_location(16) ,
200  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) d data_member_location(24)
201  * STABLE-NEXT: } byte_size(32)
205 	int a;  member
217  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) a data_member_location(0) ,
218  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) b data_member_location(8)
219  * STABLE-NEXT:   member base_type int byte_size(4) encoding(5) c data_member_location(16) ,
220  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) d data_member_location(24)
221  * STABLE-NEXT: } byte_size(32)
226  * Example: A replaced field
230 	unsigned long a;  member
236  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) a data_member_location(0)
237  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) unused data_member_location(8)
238  * STABLE-NEXT: } byte_size(16)
242 	unsigned long a;  member
250  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) a data_member_location(0)
251  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) unused data_member_location(8)
252  * STABLE-NEXT: } byte_size(16)
256 	unsigned long a;  member
264  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) a data_member_location(0)
265  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) unused data_member_location(8)
266  * STABLE-NEXT: } byte_size(16)
270  * Example: An ignored field added to an end of a partially opaque struct,
275 	unsigned long a;  member
283 KABI_BYTE_SIZE(ex4a, 8);
287  * STABLE-NEXT:   member base_type [[ULONG]] byte_size(8) encoding(7) a data_member_location(0)
288  * STABLE-NEXT: } byte_size(8)
292  * Example: A type string override.
296 	unsigned long a;  member
305 …e_type ex5a { member pointer_type { s#ex4a } byte_size(8) p data_member_location(0) } byte_size(8)…
311  * VERSIONS-SAME:   member pointer_type {
312  * VERSIONS-SAME:     structure_type ex4a {
313 …* VERSIONS-SAME:       member base_type [[ULONG:long unsigned int|unsigned long]] byte_size(8) enc…
314  * VERSIONS-SAME:     } byte_size(8)
315  * VERSIONS-SAME:   } byte_size(8) p data_member_location(0)
316  * VERSIONS-SAME: } byte_size(8)
320  * Example: A type string definition for a non-existent type.
324 	unsigned long a;  member
330 …e_type ex5b { member pointer_type { s#ex5c } byte_size(8) p data_member_location(0) } byte_size(8)…
332 /* Define a type string for a non-existent struct ex5c */
335 …pe ex5c { member base_type int byte_size(4) encoding(5) n data_member_location(0) } byte_size(8)");
341  * VERSIONS-SAME:   member pointer_type {
342  * VERSIONS-SAME:     structure_type ex5c {
343  * VERSIONS-SAME:       member base_type int byte_size(4) encoding(5) n data_member_location(0)
344  * VERSIONS-SAME:     } byte_size(8)
345  * VERSIONS-SAME:   } byte_size(8) p data_member_location(0)
346  * VERSIONS-SAME: } byte_size(8)
350  * Example: A type string override for a symbol.
357  * VERSIONS-SAME:   member base_type int byte_size(4) encoding(5) n data_member_location(0)
358  * VERSIONS-SAME: } byte_size(8)