1 \chapter[Attributes by Tag (Informative)]{Attributes by Tag Value (Informative)}
2 \label{chap:attributesbytagvalueinformative}
4 The table below enumerates the attributes that are
5 most applicable to each type of debugging information
6 entry. DWARF does not in general require that a given
7 debugging information entry contain a particular attribute
8 or set of attributes. Instead, a DWARF producer is free to
9 generate any, all, or none of the attributes described in the
10 text as being applicable to a given entry. Other attributes
11 (both those defined within this document but not explicitly
12 associated with the entry in question, and new, vendor-defined
13 ones) may also appear in a given debugging information
14 entry. Therefore, the table may be taken as instructive, but
15 cannot be considered definitive.
17 In the following table, the following special conventions apply:
18 \begin{enumerate}[1. ]
22 \livetarg{chap:DECL}{}
23 pseudo-attribute stands for all three of the
24 \addtoindex{declaration coordinates}
29 \item The \DWATdescription{} attribute can be used on any
30 debugging information entry that may have a \DWATname{} attribute.
31 For simplicity, this attribute is not explicitly shown.
33 \item The \DWATsibling{} attribute can be used on any
34 debugging information entry.
35 For simplicity, this attribute is not explicitly shown.
37 \item The \DWATabstractorigin{} attribute can be used with
38 almost any debugging information entry;
39 the exceptions are mostly the compilation
41 For simplicity, this attribute is not explicitly shown.
48 \label{tab:attributesbytag}
49 \setlength{\extrarowheight}{0.1cm}
50 \begin{longtable}{l|l}
51 \caption{Attributes by tag value} \\
52 \hline \bfseries TAG name&\bfseries Applicable attributes\\ \hline
54 \bfseries TAG name&\bfseries Applicable attributes \\ \hline
56 \hline \emph{Continued on next page}
61 \DWTAGaccessdeclaration{}
62 &\livelink{chap:DECL}{DECL} \\*
63 &\DWATaccessibility{} \\*
64 %\DWATdescription{} \\*
69 &\livelink{chap:DECL}{DECL} \\*
70 &\DWATaccessibility{} \\*
73 &\DWATassociated{} \\*
77 &\DWATdatalocation{} \\*
78 &\DWATdeclaration{} \\*
79 %\DWATdescription{} \\*
83 &\DWATspecification{} \\*
84 &\DWATstartscope{} \\*
90 &\livelink{chap:DECL}{DECL} \\*
97 &\livelink{chap:DECL}{DECL} \\*
100 &\DWATassociated{} \\*
101 &\DWATbinaryscale{} \\*
102 %&\DWATbitoffset{} \\*
105 &\DWATdatabitoffset{} \\*
106 &\DWATdatalocation{} \\*
107 &\DWATdecimalscale{} \\*
108 &\DWATdecimalsign{} \\*
109 %\DWATdescription{} \\*
110 &\DWATdigitcount{} \\*
112 &\DWATendianity{} \\*
114 &\DWATpicturestring{} \\*
124 &\DWATcallreturnpc \\*
125 &\DWATcalltailcall \\*
127 &\DWATcalltargetclobbered \\*
131 \DWTAGcallsiteparameter
132 &\DWATcalldatalocation \\*
133 &\DWATcalldatavalue \\*
134 &\DWATcallparameter \\*
142 &\livelink{chap:DECL}{DECL} \\*
151 &\livelink{chap:DECL}{DECL} \\*
152 &\DWATaccessibility{} \\*
153 &\DWATalignment{} \\*
154 &\DWATallocated{} \\*
155 &\DWATassociated{} \\*
158 &\DWATcallingconvention{} \\*
159 &\DWATdatalocation{} \\*
160 &\DWATdeclaration{} \\*
161 %\DWATdescription{} \\*
162 &\DWATexportsymbols{} \\*
164 &\DWATsignature{} \\*
165 &\DWATspecification{} \\*
166 &\DWATstartscope{} \\*
167 &\DWATvisibility{} \\
171 &\livelink{chap:DECL}{DECL} \\*
172 &\DWATalignment{} \\*
176 %\DWATdescription{} \\*
181 &\livelink{chap:DECL}{DECL} \\*
182 &\DWATdeclaration{} \\*
183 %\DWATdescription{} \\*
184 &\DWATlinkagename{} \\*
188 &\DWATvisibility{} \\
191 \DWTAGcommoninclusion
192 &\livelink{chap:DECL}{DECL} \\*
193 &\DWATcommonreference{} \\*
194 &\DWATdeclaration{} \\*
195 &\DWATvisibility{} \\
200 &\DWATbasetypes{} \\*
205 &\DWATidentifiercase{} \\*
210 &\DWATmainsubprogram{} \\*
219 &\DWATstroffsetsbase{} \\*
220 &\DWATuseUTFeight{} \\
224 &\livelink{chap:DECL}{DECL} \\*
229 &\livelink{chap:DECL}{DECL} \\*
230 &\DWATalignment{} \\*
236 &\livelink{chap:DECL}{DECL} \\*
237 &\DWATaccessibility{} \\*
238 &\DWATconstvalue{} \\*
239 &\DWATdeclaration{} \\*
240 %\DWATdescription{} \\*
241 &\DWATendianity{} \\*
243 &\DWATlinkagename{} \\*
245 &\DWATstartscope{} \\*
247 &\DWATvisibility{} \\
255 &\livelink{chap:DECL}{DECL} \\*
256 &\DWATalignment{} \\*
259 &\DWATdatalocation \\*
260 %\DWATdescription \\*
266 &\livelink{chap:DECL}{DECL} \\*
267 &\DWATaddressclass{} \\*
268 %\DWATdescription{} \\*
269 &\DWATframebase{} \\*
270 &\DWATlinkagename{} \\*
273 &\DWATreturnaddr{} \\*
275 &\DWATstaticlink{} \\*
279 \DWTAGenumerationtype
280 &\livelink{chap:DECL}{DECL} \\*
281 &\DWATaccessibility{} \\*
282 &\DWATalignment{} \\*
283 &\DWATallocated{} \\*
284 &\DWATassociated{} \\*
286 &\DWATbitstride{} \\*
288 &\DWATbytestride{} \\*
289 &\DWATdatalocation{} \\*
290 &\DWATdeclaration{} \\*
291 %\DWATdescription{} \\*
292 &\DWATenumclass{} \\*
294 &\DWATsignature{} \\*
295 &\DWATspecification{} \\*
296 &\DWATstartscope{} \\*
298 &\DWATvisibility{} \\
302 &\livelink{chap:DECL}{DECL} \\*
303 &\DWATconstvalue{} \\*
304 %\DWATdescription{} \\*
309 &\livelink{chap:DECL}{DECL} \\*
310 &\DWATalignment{} \\*
311 &\DWATallocated{} \\*
312 &\DWATassociated{} \\*
315 &\DWATdatalocation{} \\*
316 %\DWATdescription{} \\*
318 &\DWATstartscope{} \\*
320 &\DWATvisibility{} \\*
323 \DWTAGformalparameter
324 &\livelink{chap:DECL}{DECL} \\*
325 &\DWATartificial{} \\*
326 &\DWATconstvalue{} \\*
327 &\DWATdefaultvalue{} \\*
328 %\DWATdescription{} \\*
329 &\DWATendianity{} \\*
330 &\DWATisoptional{} \\*
335 &\DWATvariableparameter{} \\
339 &\livelink{chap:DECL}{DECL} \\*
343 % Please keep in synch with DW_TAG_subrange_type.
344 \DWTAGgenericsubrange
345 &\livelink{chap:DECL}{DECL} \\*
346 &\DWATaccessibility{} \\*
347 &\DWATalignment{} \\*
348 &\DWATallocated{} \\*
349 &\DWATassociated{} \\*
351 &\DWATbitstride{} \\*
353 &\DWATbytestride{} \\*
355 &\DWATdatalocation{} \\*
356 &\DWATdeclaration{} \\*
357 %\DWATdescription{} \\*
358 &\DWATlowerbound{} \\*
360 &\DWATthreadsscaled{} \\*
362 &\DWATupperbound{} \\*
363 &\DWATvisibility{} \\
367 \bbeb&\livelink{chap:DECL}{DECL} \\*
372 \DWTAGimporteddeclaration
373 &\livelink{chap:DECL}{DECL} \\*
374 &\DWATaccessibility{} \\*
375 %\DWATdescription{} \\*
378 &\DWATstartscope{} \\
382 &\livelink{chap:DECL}{DECL} \\*
384 &\DWATstartscope{} \\
392 &\livelink{chap:DECL}{DECL} \\*
393 &\DWATaccessibility{} \\*
394 &\DWATdatamemberlocation{} \\*
396 &\DWATvirtuality{} \\
399 \DWTAGinlinedsubroutine
400 &\DWATcallcolumn{} \\*
403 &\DWATconstexpr{} \\*
408 &\DWATreturnaddr{} \\*
410 &\DWATstartscope{} \\*
411 &\DWATtrampoline{} \\
415 &\livelink{chap:DECL}{DECL} \\*
416 &\DWATaccessibility{} \\*
417 &\DWATalignment{} \\*
418 %\DWATdescription{} \\*
421 &\DWATstartscope{} \\*
425 &\livelink{chap:DECL}{DECL} \\*
426 %\DWATdescription{} \\*
430 &\DWATstartscope{} \\*
434 &\livelink{chap:DECL}{DECL} \\*
435 %\DWATdescription{} \\*
445 &\livelink{chap:DECL}{DECL} \\*
446 &\DWATaccessibility{} \\*
447 &\DWATartificial{} \\*
448 %&\DWATbitoffset{} \\*
451 &\DWATdatabitoffset{} \\*
452 &\DWATdatamemberlocation{} \\*
453 &\DWATdeclaration{} \\*
454 %\DWATdescription{} \\*
458 &\DWATvisibility{} \\*
462 &\livelink{chap:DECL}{DECL} \\*
463 &\DWATaccessibility{} \\*
464 &\DWATdeclaration{} \\*
465 %\DWATdescription{} \\*
473 &\DWATspecification{} \\*
474 &\DWATvisibility{} \\
478 &\livelink{chap:DECL}{DECL} \\*
479 &\DWATaccessibility{} \\*
480 &\DWATdeclaration{} \\*
482 &\DWATvisibility{} \\
486 &\livelink{chap:DECL}{DECL} \\*
487 &\DWATnamelistitem{} \\
491 &\livelink{chap:DECL}{DECL} \\*
492 %\DWATdescription{} \\*
493 &\DWATexportsymbols{} \\*
494 &\DWATextension{} \\*
496 &\DWATstartscope{} \\
500 &\livelink{chap:DECL}{DECL} \\*
501 &\DWATalignment{} \\*
508 &\DWATbasetypes{} \\*
510 %\DWATdescription{} \\*
514 &\DWATidentifiercase{} \\*
519 &\DWATmainsubprogram{} \\*
528 &\DWATstroffsetsbase{} \\*
529 &\DWATuseUTFeight{} \\
533 &\livelink{chap:DECL}{DECL} \\*
534 &\DWATaddressclass{} \\*
535 &\DWATalignment{} \\*
542 \DWTAGptrtomembertype
543 &\livelink{chap:DECL}{DECL} \\*
544 &\DWATaddressclass{} \\*
545 &\DWATalignment{} \\*
546 &\DWATallocated{} \\*
547 &\DWATassociated{} \\*
548 &\DWATcontainingtype{} \\*
549 &\DWATdatalocation{} \\*
550 &\DWATdeclaration{} \\*
551 %\DWATdescription{} \\*
554 &\DWATuselocation{} \\*
555 &\DWATvisibility{} \\
559 &\livelink{chap:DECL}{DECL} \\*
560 &\DWATaddressclass{} \\*
561 &\DWATalignment{} \\*
569 &\livelink{chap:DECL}{DECL} \\*
570 &\DWATalignment{} \\*
575 \DWTAGrvaluereferencetype
576 &\livelink{chap:DECL}{DECL} \\*
577 &\DWATaddressclass{} \\*
578 &\DWATalignment{} \\*
586 &\livelink{chap:DECL}{DECL} \\*
587 &\DWATaccessibility{} \\*
588 &\DWATalignment{} \\*
589 &\DWATallocated{} \\*
590 &\DWATassociated{} \\*
593 &\DWATdatalocation{} \\*
594 &\DWATdeclaration{} \\*
595 %\DWATdescription{} \\*
597 &\DWATstartscope{} \\*
599 &\DWATvisibility{} \\
603 &\livelink{chap:DECL}{DECL} \\*
605 &\DWATalignment{} \\*
621 &\DWATstroffsetsbase{} \\*
627 &\livelink{chap:DECL}{DECL} \\*
628 &\DWATalignment{} \\*
629 &\DWATaccessibility{} \\*
630 &\DWATallocated{} \\*
631 &\DWATassociated{} \\*
634 &\DWATdatalocation{} \\*
635 &\DWATdeclaration{} \\*
636 %\DWATdescription{} \\*
638 &\DWATstartscope{} \\*
639 &\DWATstringlength{} \\*
640 &\DWATstringlengthbitsize{} \\*
641 &\DWATstringlengthbytesize{} \\*
642 &\DWATvisibility{} \\
646 &\livelink{chap:DECL}{DECL} \\*
647 &\DWATaccessibility{} \\*
648 &\DWATalignment{} \\*
649 &\DWATallocated{} \\*
650 &\DWATassociated{} \\*
653 &\DWATcallingconvention{} \\*
654 &\DWATdatalocation{} \\*
655 &\DWATdeclaration{} \\*
656 %\DWATdescription{} \\*
657 &\DWATexportsymbols{} \\*
659 &\DWATsignature{} \\*
660 &\DWATspecification{} \\*
661 &\DWATstartscope{} \\*
662 &\DWATvisibility{} \\
666 &\livelink{chap:DECL}{DECL} \\*
667 &\DWATaccessibility{} \\*
668 &\DWATaddressclass{} \\*
669 &\DWATalignment{} \\*
670 &\DWATartificial{} \\*
671 &\DWATcallingconvention{} \\*
672 &\DWATdeclaration{} \\*
673 &\DWATdefaulted{} \\*
675 %\DWATdescription{} \\*
676 &\DWATelemental{} \\*
680 &\DWATframebase{} \\*
683 &\DWATlinkagename{} \\*
685 &\DWATmainsubprogram{} \\*
688 &\DWATobjectpointer{} \\*
689 &\DWATprototyped{} \\*
692 &\DWATrecursive{} \\*
693 &\DWATreference{} \\*
694 &\DWATreturnaddr{} \\*
695 &\DWATrvaluereference{} \\*
697 &\DWATspecification{} \\*
698 &\textit{Additional attributes continue on next page} \\
699 \DWTAGsubprogram{} (cont.)
700 &\DWATstartscope{} \\*
701 &\DWATstaticlink{} \\*
702 &\DWATtrampoline{} \\*
704 &\DWATvisibility{} \\*
705 &\DWATvirtuality{} \\*
706 &\DWATvtableelemlocation{} \\
710 &\livelink{chap:DECL}{DECL} \\*
711 &\DWATaccessibility{} \\*
712 &\DWATalignment{} \\*
713 &\DWATallocated{} \\*
714 &\DWATassociated{} \\*
716 &\DWATbitstride{} \\*
718 &\DWATbytestride{} \\*
720 &\DWATdatalocation{} \\*
721 &\DWATdeclaration{} \\*
722 %\DWATdescription{} \\*
723 &\DWATlowerbound{} \\*
725 &\DWATthreadsscaled{} \\*
727 &\DWATupperbound{} \\*
728 &\DWATvisibility{} \\
732 &\livelink{chap:DECL}{DECL} \\*
733 &\DWATaccessibility{} \\*
734 &\DWATaddressclass{} \\*
735 &\DWATalignment{} \\*
736 &\DWATallocated{} \\*
737 &\DWATassociated{} \\*
738 &\DWATdatalocation{} \\*
739 &\DWATdeclaration{} \\*
740 %\DWATdescription{} \\*
742 &\DWATprototyped{} \\*
743 &\DWATreference{} \\*
744 &\DWATrvaluereference{} \\*
745 &\DWATstartscope{} \\*
747 &\DWATvisibility{} \\
751 &\livelink{chap:DECL}{DECL} \\*
752 &\DWATaccessibility{} \\*
753 &\DWATallocated{} \\*
754 &\DWATassociated{} \\*
755 &\DWATdatalocation{} \\*
756 &\DWATdeclaration{} \\*
757 %\DWATdescription{} \\*
759 &\DWATsignature{} \\*
760 &\DWATstartscope{} \\*
762 &\DWATvisibility{} \\
765 \DWTAGtemplatetypeparameter
766 &\livelink{chap:DECL}{DECL} \\*
767 &\DWATdefaultvalue{} \\*
768 %\DWATdescription{} \\*
773 \DWTAGtemplatevalueparameter{}
774 &\livelink{chap:DECL}{DECL} \\*
775 &\DWATconstvalue{} \\*
776 &\DWATdefaultvalue{} \\*
777 %\DWATdescription{} \\*
783 &\livelink{chap:DECL}{DECL} \\*
784 &\DWATalignment{} \\*
785 &\DWATallocated{} \\*
786 &\DWATassociated{} \\*
787 &\DWATdatalocation{} \\*
793 &\livelink{chap:DECL}{DECL} \\*
802 &\livelink{chap:DECL}{DECL} \\*
803 &\DWATaccessibility{} \\*
804 &\DWATalignment{} \\*
805 &\DWATallocated{} \\*
806 &\DWATassociated{} \\*
807 &\DWATdatalocation{} \\*
808 &\DWATdeclaration{} \\*
809 %\DWATdescription{} \\*
811 &\DWATstartscope{} \\*
813 &\DWATvisibility{} \\
819 &\DWATstroffsetsbase{} \\*
820 &\DWATuseUTFeight{} \\
824 &\livelink{chap:DECL}{DECL} \\*
825 &\DWATaccessibility{} \\*
826 &\DWATalignment{} \\*
827 &\DWATallocated{} \\*
828 &\DWATassociated{} \\*
831 &\DWATcallingconvention{} \\*
832 &\DWATdatalocation{} \\*
833 &\DWATdeclaration{} \\*
834 %\DWATdescription{} \\*
835 &\DWATexportsymbols{} \\*
837 &\DWATsignature{} \\*
838 &\DWATspecification{} \\*
839 &\DWATstartscope{} \\*
840 &\DWATvisibility{} \\
843 \DWTAGunspecifiedparameters
844 &\livelink{chap:DECL}{DECL} \\*
845 &\DWATartificial{} \\
848 \DWTAGunspecifiedtype
849 &\livelink{chap:DECL}{DECL} \\*
850 %\DWATdescription{} \\*
855 &\livelink{chap:DECL}{DECL} \\*
856 &\DWATaccessibility{} \\*
857 &\DWATalignment{} \\*
858 &\DWATartificial{} \\*
859 &\DWATconstexpr{} \\*
860 &\DWATconstvalue{} \\*
861 &\DWATdeclaration{} \\*
862 %\DWATdescription{} \\*
863 &\DWATendianity{} \\*
865 &\DWATlinkagename{} \\*
869 &\DWATspecification{} \\*
870 &\DWATstartscope{} \\*
872 &\DWATvisibility{} \\
876 &\livelink{chap:DECL}{DECL} \\*
877 &\DWATaccessibility{} \\*
878 &\DWATdeclaration{} \\*
879 &\DWATdiscrlist{} \\*
880 &\DWATdiscrvalue{} \\
884 &\livelink{chap:DECL}{DECL} \\*
885 &\DWATaccessibility{} \\*
886 &\DWATdeclaration{} \\*
892 &\livelink{chap:DECL}{DECL} \\*
898 &\livelink{chap:DECL}{DECL} \\*
899 &\DWATaccessibility{} \\*
900 &\DWATaddressclass{} \\*
901 &\DWATdeclaration{} \\*
909 &\DWATvisibility{} \\