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{} \\*
214 &\DWATrnglistsbase{} \\*
217 &\DWATstroffsetsbase{} \\*
218 &\DWATuseUTFeight{} \\
222 &\livelink{chap:DECL}{DECL} \\*
227 &\livelink{chap:DECL}{DECL} \\*
228 &\DWATalignment{} \\*
234 &\livelink{chap:DECL}{DECL} \\*
235 &\DWATaccessibility{} \\*
236 &\DWATconstvalue{} \\*
237 &\DWATdeclaration{} \\*
238 %\DWATdescription{} \\*
239 &\DWATendianity{} \\*
241 &\DWATlinkagename{} \\*
243 &\DWATstartscope{} \\*
245 &\DWATvisibility{} \\
253 &\livelink{chap:DECL}{DECL} \\*
254 &\DWATalignment{} \\*
257 &\DWATdatalocation \\*
258 %\DWATdescription \\*
264 &\livelink{chap:DECL}{DECL} \\*
265 &\DWATaddressclass{} \\*
266 %\DWATdescription{} \\*
267 &\DWATframebase{} \\*
268 &\DWATlinkagename{} \\*
271 &\DWATreturnaddr{} \\*
273 &\DWATstaticlink{} \\*
277 \DWTAGenumerationtype
278 &\livelink{chap:DECL}{DECL} \\*
279 &\DWATaccessibility{} \\*
280 &\DWATalignment{} \\*
281 &\DWATallocated{} \\*
282 &\DWATassociated{} \\*
284 &\DWATbitstride{} \\*
286 &\DWATbytestride{} \\*
287 &\DWATdatalocation{} \\*
288 &\DWATdeclaration{} \\*
289 %\DWATdescription{} \\*
290 &\DWATenumclass{} \\*
292 &\DWATsignature{} \\*
293 &\DWATspecification{} \\*
294 &\DWATstartscope{} \\*
296 &\DWATvisibility{} \\
300 &\livelink{chap:DECL}{DECL} \\*
301 &\DWATconstvalue{} \\*
302 %\DWATdescription{} \\*
307 &\livelink{chap:DECL}{DECL} \\*
308 &\DWATalignment{} \\*
309 &\DWATallocated{} \\*
310 &\DWATassociated{} \\*
313 &\DWATdatalocation{} \\*
314 %\DWATdescription{} \\*
316 &\DWATstartscope{} \\*
318 &\DWATvisibility{} \\*
321 \DWTAGformalparameter
322 &\livelink{chap:DECL}{DECL} \\*
323 &\DWATartificial{} \\*
324 &\DWATconstvalue{} \\*
325 &\DWATdefaultvalue{} \\*
326 %\DWATdescription{} \\*
327 &\DWATendianity{} \\*
328 &\DWATisoptional{} \\*
333 &\DWATvariableparameter{} \\
337 &\livelink{chap:DECL}{DECL} \\*
341 % Please keep in synch with DW_TAG_subrange_type.
342 \DWTAGgenericsubrange
343 &\livelink{chap:DECL}{DECL} \\*
344 &\DWATaccessibility{} \\*
345 &\DWATalignment{} \\*
346 &\DWATallocated{} \\*
347 &\DWATassociated{} \\*
349 &\DWATbitstride{} \\*
351 &\DWATbytestride{} \\*
353 &\DWATdatalocation{} \\*
354 &\DWATdeclaration{} \\*
355 %\DWATdescription{} \\*
356 &\DWATlowerbound{} \\*
358 &\DWATthreadsscaled{} \\*
360 &\DWATupperbound{} \\*
361 &\DWATvisibility{} \\
365 &\livelink{chap:DECL}{DECL} \\*
370 \DWTAGimporteddeclaration
371 &\livelink{chap:DECL}{DECL} \\*
372 &\DWATaccessibility{} \\*
373 %\DWATdescription{} \\*
376 &\DWATstartscope{} \\
380 &\livelink{chap:DECL}{DECL} \\*
382 &\DWATstartscope{} \\
390 &\livelink{chap:DECL}{DECL} \\*
391 &\DWATaccessibility{} \\*
392 &\DWATdatamemberlocation{} \\*
394 &\DWATvirtuality{} \\
397 \DWTAGinlinedsubroutine
398 &\DWATcallcolumn{} \\*
401 &\DWATconstexpr{} \\*
406 &\DWATreturnaddr{} \\*
408 &\DWATstartscope{} \\*
409 &\DWATtrampoline{} \\
413 &\livelink{chap:DECL}{DECL} \\*
414 &\DWATaccessibility{} \\*
415 &\DWATalignment{} \\*
416 %\DWATdescription{} \\*
419 &\DWATstartscope{} \\*
423 &\livelink{chap:DECL}{DECL} \\*
424 %\DWATdescription{} \\*
428 &\DWATstartscope{} \\*
432 &\livelink{chap:DECL}{DECL} \\*
433 %\DWATdescription{} \\*
443 &\livelink{chap:DECL}{DECL} \\*
444 &\DWATaccessibility{} \\*
445 &\DWATartificial{} \\*
446 %&\DWATbitoffset{} \\*
449 &\DWATdatabitoffset{} \\*
450 &\DWATdatamemberlocation{} \\*
451 &\DWATdeclaration{} \\*
452 %\DWATdescription{} \\*
456 &\DWATvisibility{} \\*
460 &\livelink{chap:DECL}{DECL} \\*
461 &\DWATaccessibility{} \\*
462 &\DWATdeclaration{} \\*
463 %\DWATdescription{} \\*
471 &\DWATspecification{} \\*
472 &\DWATvisibility{} \\
476 &\livelink{chap:DECL}{DECL} \\*
477 &\DWATaccessibility{} \\*
478 &\DWATdeclaration{} \\*
480 &\DWATvisibility{} \\
484 &\livelink{chap:DECL}{DECL} \\*
485 &\DWATnamelistitem{} \\
489 &\livelink{chap:DECL}{DECL} \\*
490 %\DWATdescription{} \\*
491 &\DWATexportsymbols{} \\*
492 &\DWATextension{} \\*
494 &\DWATstartscope{} \\
498 &\livelink{chap:DECL}{DECL} \\*
499 &\DWATalignment{} \\*
506 &\DWATbasetypes{} \\*
508 %\DWATdescription{} \\*
512 &\DWATidentifiercase{} \\*
517 &\DWATmainsubprogram{} \\*
521 &\DWATrnglistsbase{} \\*
524 &\DWATstroffsetsbase{} \\*
525 &\DWATuseUTFeight{} \\
529 &\livelink{chap:DECL}{DECL} \\*
530 &\DWATaddressclass{} \\*
531 &\DWATalignment{} \\*
538 \DWTAGptrtomembertype
539 &\livelink{chap:DECL}{DECL} \\*
540 &\DWATaddressclass{} \\*
541 &\DWATalignment{} \\*
542 &\DWATallocated{} \\*
543 &\DWATassociated{} \\*
544 &\DWATcontainingtype{} \\*
545 &\DWATdatalocation{} \\*
546 &\DWATdeclaration{} \\*
547 %\DWATdescription{} \\*
550 &\DWATuselocation{} \\*
551 &\DWATvisibility{} \\
555 &\livelink{chap:DECL}{DECL} \\*
556 &\DWATaddressclass{} \\*
557 &\DWATalignment{} \\*
565 &\livelink{chap:DECL}{DECL} \\*
566 &\DWATalignment{} \\*
571 \DWTAGrvaluereferencetype
572 &\livelink{chap:DECL}{DECL} \\*
573 &\DWATaddressclass{} \\*
574 &\DWATalignment{} \\*
582 &\livelink{chap:DECL}{DECL} \\*
583 &\DWATaccessibility{} \\*
584 &\DWATalignment{} \\*
585 &\DWATallocated{} \\*
586 &\DWATassociated{} \\*
589 &\DWATdatalocation{} \\*
590 &\DWATdeclaration{} \\*
591 %\DWATdescription{} \\*
593 &\DWATstartscope{} \\*
595 &\DWATvisibility{} \\
599 &\livelink{chap:DECL}{DECL} \\*
601 &\DWATalignment{} \\*
613 &\DWATrnglistsbase{} \\*
615 &\DWATstroffsetsbase{} \\*
621 &\livelink{chap:DECL}{DECL} \\*
622 &\DWATalignment{} \\*
623 &\DWATaccessibility{} \\*
624 &\DWATallocated{} \\*
625 &\DWATassociated{} \\*
628 &\DWATdatalocation{} \\*
629 &\DWATdeclaration{} \\*
630 %\DWATdescription{} \\*
632 &\DWATstartscope{} \\*
633 &\DWATstringlength{} \\*
634 &\DWATstringlengthbitsize{} \\*
635 &\DWATstringlengthbytesize{} \\*
636 &\DWATvisibility{} \\
640 &\livelink{chap:DECL}{DECL} \\*
641 &\DWATaccessibility{} \\*
642 &\DWATalignment{} \\*
643 &\DWATallocated{} \\*
644 &\DWATassociated{} \\*
647 &\DWATcallingconvention{} \\*
648 &\DWATdatalocation{} \\*
649 &\DWATdeclaration{} \\*
650 %\DWATdescription{} \\*
651 &\DWATexportsymbols{} \\*
653 &\DWATsignature{} \\*
654 &\DWATspecification{} \\*
655 &\DWATstartscope{} \\*
656 &\DWATvisibility{} \\
660 &\livelink{chap:DECL}{DECL} \\*
661 &\DWATaccessibility{} \\*
662 &\DWATaddressclass{} \\*
663 &\DWATalignment{} \\*
664 &\DWATartificial{} \\*
665 &\DWATcallingconvention{} \\*
666 &\DWATdeclaration{} \\*
667 &\DWATdefaulted{} \\*
669 %\DWATdescription{} \\*
670 &\DWATelemental{} \\*
674 &\DWATframebase{} \\*
677 &\DWATlinkagename{} \\*
679 &\DWATmainsubprogram{} \\*
682 &\DWATobjectpointer{} \\*
683 &\DWATprototyped{} \\*
686 &\DWATrecursive{} \\*
687 &\DWATreference{} \\*
688 &\DWATreturnaddr{} \\*
689 &\DWATrvaluereference{} \\*
691 &\DWATspecification{} \\*
692 &\textit{Additional attributes continue on next page} \\
693 \DWTAGsubprogram{} (cont.)
694 &\DWATstartscope{} \\*
695 &\DWATstaticlink{} \\*
696 &\DWATtrampoline{} \\*
698 &\DWATvisibility{} \\*
699 &\DWATvirtuality{} \\*
700 &\DWATvtableelemlocation{} \\
704 &\livelink{chap:DECL}{DECL} \\*
705 &\DWATaccessibility{} \\*
706 &\DWATalignment{} \\*
707 &\DWATallocated{} \\*
708 &\DWATassociated{} \\*
710 &\DWATbitstride{} \\*
712 &\DWATbytestride{} \\*
714 &\DWATdatalocation{} \\*
715 &\DWATdeclaration{} \\*
716 %\DWATdescription{} \\*
717 &\DWATlowerbound{} \\*
719 &\DWATthreadsscaled{} \\*
721 &\DWATupperbound{} \\*
722 &\DWATvisibility{} \\
726 &\livelink{chap:DECL}{DECL} \\*
727 &\DWATaccessibility{} \\*
728 &\DWATaddressclass{} \\*
729 &\DWATalignment{} \\*
730 &\DWATallocated{} \\*
731 &\DWATassociated{} \\*
732 &\DWATdatalocation{} \\*
733 &\DWATdeclaration{} \\*
734 %\DWATdescription{} \\*
736 &\DWATprototyped{} \\*
737 &\DWATreference{} \\*
738 &\DWATrvaluereference{} \\*
739 &\DWATstartscope{} \\*
741 &\DWATvisibility{} \\
745 &\livelink{chap:DECL}{DECL} \\*
746 &\DWATaccessibility{} \\*
747 &\DWATallocated{} \\*
748 &\DWATassociated{} \\*
749 &\DWATdatalocation{} \\*
750 &\DWATdeclaration{} \\*
751 %\DWATdescription{} \\*
753 &\DWATsignature{} \\*
754 &\DWATstartscope{} \\*
756 &\DWATvisibility{} \\
759 \DWTAGtemplatetypeparameter
760 &\livelink{chap:DECL}{DECL} \\*
761 &\DWATdefaultvalue{} \\*
762 %\DWATdescription{} \\*
767 \DWTAGtemplatevalueparameter{}
768 &\livelink{chap:DECL}{DECL} \\*
769 &\DWATconstvalue{} \\*
770 &\DWATdefaultvalue{} \\*
771 %\DWATdescription{} \\*
777 &\livelink{chap:DECL}{DECL} \\*
778 &\DWATalignment{} \\*
779 &\DWATallocated{} \\*
780 &\DWATassociated{} \\*
781 &\DWATdatalocation{} \\*
787 &\livelink{chap:DECL}{DECL} \\*
796 &\livelink{chap:DECL}{DECL} \\*
797 &\DWATaccessibility{} \\*
798 &\DWATalignment{} \\*
799 &\DWATallocated{} \\*
800 &\DWATassociated{} \\*
801 &\DWATdatalocation{} \\*
802 &\DWATdeclaration{} \\*
803 %\DWATdescription{} \\*
805 &\DWATstartscope{} \\*
807 &\DWATvisibility{} \\
813 &\DWATstroffsetsbase{} \\*
814 &\DWATuseUTFeight{} \\
818 &\livelink{chap:DECL}{DECL} \\*
819 &\DWATaccessibility{} \\*
820 &\DWATalignment{} \\*
821 &\DWATallocated{} \\*
822 &\DWATassociated{} \\*
825 &\DWATcallingconvention{} \\*
826 &\DWATdatalocation{} \\*
827 &\DWATdeclaration{} \\*
828 %\DWATdescription{} \\*
829 &\DWATexportsymbols{} \\*
831 &\DWATsignature{} \\*
832 &\DWATspecification{} \\*
833 &\DWATstartscope{} \\*
834 &\DWATvisibility{} \\
837 \DWTAGunspecifiedparameters
838 &\livelink{chap:DECL}{DECL} \\*
839 &\DWATartificial{} \\
842 \DWTAGunspecifiedtype
843 &\livelink{chap:DECL}{DECL} \\*
844 %\DWATdescription{} \\*
849 &\livelink{chap:DECL}{DECL} \\*
850 &\DWATaccessibility{} \\*
851 &\DWATalignment{} \\*
852 &\DWATartificial{} \\*
853 &\DWATconstexpr{} \\*
854 &\DWATconstvalue{} \\*
855 &\DWATdeclaration{} \\*
856 %\DWATdescription{} \\*
857 &\DWATendianity{} \\*
859 &\DWATlinkagename{} \\*
863 &\DWATspecification{} \\*
864 &\DWATstartscope{} \\*
866 &\DWATvisibility{} \\
870 &\livelink{chap:DECL}{DECL} \\*
871 &\DWATaccessibility{} \\*
872 &\DWATdeclaration{} \\*
873 &\DWATdiscrlist{} \\*
874 &\DWATdiscrvalue{} \\
878 &\livelink{chap:DECL}{DECL} \\*
879 &\DWATaccessibility{} \\*
880 &\DWATdeclaration{} \\*
886 &\livelink{chap:DECL}{DECL} \\*
892 &\livelink{chap:DECL}{DECL} \\*
893 &\DWATaccessibility{} \\*
894 &\DWATaddressclass{} \\*
895 &\DWATdeclaration{} \\*
903 &\DWATvisibility{} \\