dmake: do not set MAKEFLAGS=k
[unleashed/tickless.git] / usr / src / cmd / sgs / rtld / mdbmod / common / rtld.msg
blob3db84efa8eee95494b2b1a3da744ae2d8ac79077
2 # CDDL HEADER START
4 # The contents of this file are subject to the terms of the
5 # Common Development and Distribution License (the "License").
6 # You may not use this file except in compliance with the License.
8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 # or http://www.opensolaris.org/os/licensing.
10 # See the License for the specific language governing permissions
11 # and limitations under the License.
13 # When distributing Covered Code, include this CDDL HEADER in each
14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 # If applicable, add the following below this CDDL HEADER, with the
16 # fields enclosed by brackets "[]" replaced with your own identifying
17 # information: Portions Copyright [yyyy] [name of copyright owner]
19 # CDDL HEADER END
23 # Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
26 @ _START_
28 @ _END_
31 # Misc. Strings
33 @ MSG_STR_NAME          "NAME"
34 @ MSG_STR_PATHNAME      "PATHNAME"
35 @ MSG_STR_REFNAME       "REFNAME"
36 @ MSG_STR_RPATH         "RPATH"
37 @ MSG_STR_DASHES        "----------------------------------------------\n"
38 @ MSG_STR_LDSO1         "ld.so.1"
39 @ MSG_STR_DYNLMLIST     "dynlm_list"
40 @ MSG_STR_ALIST         "Alist"
41 @ MSG_STR_APLIST        "APlist"
42 @ MSG_STR_EMPTY         ""
43 @ MSG_STR_ORPHANED      "<orphaned>"
44 @ MSG_STR_SETENV        "setenv"
47 # mdb_dcmd_t.dc_usage's
49 @ MSG_USG_ADDREQ        ":"                     # Address required
50 @ MSG_USG_ADDREQ_V      ":[-v]"                 # Address required plus -v
51 @ MSG_USG_ADDOPT_V      "?[-v]"                 # Address optional plus -v
52 @ MSG_USG_SETENV        "name[=value]"          # Setenv argument
55 # mdb_walker.walk_descr's
57 @ MSG_WWD_RTMAP         "Walk a List of Rt_maps"
60 # Flag Strings
62 @ MSG_FLG_ISMAIN        "IS-MAIN"
63 @ MSG_FLG_IMGALLOC      "IMAGE-ALLOCATED"
64 @ MSG_FLG_RELOCED       "RELOCED"
65 @ MSG_FLG_SETGROUP      "SET-GROUP"
66 @ MSG_FLG_CAP           "CAP"
67 @ MSG_FLG_OBJECT        "OBJECT"
68 @ MSG_FLG_NEWLOAD       "NEWLOAD"
69 @ MSG_FLG_NODUMP        "NODUMP"
70 @ MSG_FLG_DELETE        "DELETE"
71 @ MSG_FLG_ANALYZED      "ANALYZED"
72 @ MSG_FLG_INITDONE      "INIT-DONE"
73 @ MSG_FLG_TRANS         "TRANS"
74 @ MSG_FLG_FIXED         "FIXED"
75 @ MSG_FLG_PRELOAD       "PRELOAD"
76 @ MSG_FLG_ALTER         "ALTERNATE"
77 @ MSG_FLG_LOADFLTR      "LOAD-FILTERS"
78 @ MSG_FLG_AUDIT         "AUDIT"
79 @ MSG_FLG_MODESET       "MODE-SET"
80 @ MSG_FLG_ANALZING      "ANALYZING"
81 @ MSG_FLG_INITFRST      "INIT-FIRST"
82 @ MSG_FLG_NOOPEN        "NO-OPEN"
83 @ MSG_FLG_FINICLCT      "FINI-COLLECTED"
84 @ MSG_FLG_INITCALL      "INIT-CALLED"
85 @ MSG_FLG_OBJINTPO      "OBJECT-INTERPOSE"
86 @ MSG_FLG_SYMINTPO      "SYMBOL-INTERPOSE"
87 @ MSG_FLG_MOVE          "MOVE"
88 @ MSG_FLG_RELOCING      "RELOCATING"
89 @ MSG_FLG_REGSYMS       "REGISTER-SYMS"
90 @ MSG_FLG_INITCLCT      "INIT-COLLECTED"
91 @ MSG_FLG_PUBHDL        "PUBLIC-HANDLE"
92 @ MSG_FLG_PRIHDL        "PRIVATE-HANDLE"
94 @ MSG_FL1_COPYTOOK      "COPYTOOK"
95 @ MSG_FL1_ALTCHECK      "ALT-CAP-CHECKED"
96 @ MSG_FL1_ALTCAP        "ALT-CAP-REQUIRED"
97 @ MSG_FL1_CONFSET       "CONFSET"
98 @ MSG_FL1_NODEFLIB      "NO-DEFAULT-LIBPATH"
99 @ MSG_FL1_ENDFILTE      "END-FILTEE"
100 @ MSG_FL1_DISPREL       "DISPLACEMENT-RELOCATED"
101 @ MSG_FL1_DTFLAGS       "DTFLAGS-AVAILABLE"
102 @ MSG_FL1_LDDSTUB       "LDDSTUB"
103 @ MSG_FL1_NOINIFIN      "NO-INITFINI"
104 @ MSG_FL1_USED          "USED"
105 @ MSG_FL1_SYMBOLIC      "SYMBOLIC"
106 @ MSG_FL1_OBJSFLTR      "OBJ-STD-FILTER"
107 @ MSG_FL1_OBJAFLTR      "OBJ-AUX-FILTER"
108 @ MSG_FL1_SYMSFLTR      "SYM-STD-FILTER"
109 @ MSG_FL1_SYMAFLTR      "SYM-AUX-FILTER"
110 @ MSG_FL1_TLSADD        "TLS-ADD"
111 @ MSG_FL1_TLSSTAT       "TLS-STAT"
112 @ MSG_FL1_DIRECT        "DIRECT"
113 @ MSG_FL1_GLOBAUD       "GLOBAL-AUDITING"
114 @ MSG_FL1_DEPAUD        "DT-DEPAUDIT"
116 @ MSG_MODE_LAZY         "LAZY"
117 @ MSG_MODE_NOW          "NOW"
118 @ MSG_MODE_NOLOAD       "NOLOAD"
119 @ MSG_MODE_GLOBAL       "GLOBAL"
120 @ MSG_MODE_PARENT       "PARENT"
121 @ MSG_MODE_GROUP        "GROUP"
122 @ MSG_MODE_WORLD        "WORLD"
123 @ MSG_MODE_NODELETE     "NODELETE"
124 @ MSG_MODE_FIRST        "FIRST"
125 @ MSG_MODE_CONFGEN      "CONFGEN"
127 @ MSG_BFL_NEEDED        "NEEDED"
128 @ MSG_BFL_REFER         "REFERENCED"
129 @ MSG_BFL_FILTER        "FILTER"
131 @ MSG_GPH_PUBLIC        "PUBLIC-HANDLE"
132 @ MSG_GPH_PRIVATE       "PRIVATE-HANDLE"
133 @ MSG_GPH_ZERO          "ZERO"
134 @ MSG_GPH_LDSO          "LD.SO.1"
135 @ MSG_GPH_FIRST         "FIRST-ONLY"
136 @ MSG_GPH_FILTEE        "FILTEE"
137 @ MSG_GPH_INITIAL       "INITIALIZED"
139 @ MSG_GPD_DLSYM         "AVAIL-TO-DLSYM"
140 @ MSG_GPD_RELOC         "AVAIL-FOR-RELOCATION"
141 @ MSG_GPD_ADDEPS        "ADD-DEPENDENCIES"
142 @ MSG_GPD_PARENT        "PARENT"
143 @ MSG_GPD_FILTER        "FILTER"
144 @ MSG_GPD_REMOVE        "REMOVAL-CANDIDATE"
146 @ MSG_LFL_BASELM                "BASELM"
147 @ MSG_LFL_RTLDLM                "RTLDLM"
148 @ MSG_LFL_PLTREL                "DEFERRED-PLT-RELOCATION"
149 @ MSG_LFL_HOLDLOCK              "HOLD-LOCK"
150 @ MSG_LFL_ENVIRON               "ENVIRON"
151 @ MSG_LFL_INTRPOSE              "INTERPOSE"
152 @ MSG_LFL_LOCAUDIT              "LOCAL-AUDIT"
153 @ MSG_LFL_LOADAVAIL             "LOAD-AVAILABLE"
154 @ MSG_LFL_IGNRELERR             "IGNORE-RELOCATION-ERROR"
155 @ MSG_LFL_STARTREL              "START-RELOCATION"
156 @ MSG_LFL_ATEXIT                "ATEXIT"
157 @ MSG_LFL_OBJADDED              "OBJECT-ADDED"
158 @ MSG_LFL_OBJDELETED            "OBJECT-DELETED"
159 @ MSG_LFL_OBJREEVAL             "OBJECT-REEVALUATE"
160 @ MSG_LFL_INTRPOSETSORT         "INTERPOSE-TSORTING-DONE"
161 @ MSG_LFL_AUDITNOTIFY           "AUDIT-CONSISTENT-REQUIRED"
162 @ MSG_LFL_GROUPSEXIST           "LOCAL-GROUPS-EXIST"
164 @ MSG_LFL_TRC_LDDSTUB           "LDDSTUB"
165 @ MSG_LFL_TRC_ENABLE            "TRACING-ENABLED"
166 @ MSG_LFL_TRC_WARN              "TRACE-WARNINGS"
167 @ MSG_LFL_TRC_VERBOSE           "TRACE-VERBOSE"
168 @ MSG_LFL_TRC_SEARCH            "TRACE-SEARCH"
169 @ MSG_LFL_TRC_UNREF             "TRACE-UNREFERENCED"
170 @ MSG_LFL_TRC_UNUSED            "TRACE-UNUSED"
171 @ MSG_LFL_TRC_INIT              "TRACE-INIT"
172 @ MSG_LFL_TRC_NOUNRESWEAK       "TRACE-NO-UNRESOLVED-WEAKS"
173 @ MSG_LFL_TRC_NOPAREXT          "TRACE-NO-PARENT-OR-EXTERN"
175 @ MSG_LTFL_NOLAZYLD             "NO-LAZY-LOADING"
176 @ MSG_LTFL_NODIRECT             "NO-DIRECT"
177 @ MSG_LTFL_NOAUDIT              "NO-AUDIT"
178 @ MSG_LTFL_LOADFLTR             "LOAD-FILTER"
180 @ MSG_LTFL_AUD_PREINIT          "AUD_PREINIT"
181 @ MSG_LTFL_AUD_OBJSEARCH        "AUD_OBJSEARCH"
182 @ MSG_LTFL_AUD_OBJOPEN          "AUD_OBJOPEN"
183 @ MSG_LTFL_AUD_OBJFILTER        "AUD_OBJFILTER"
184 @ MSG_LTFL_AUD_OBJCLOSE         "AUD_OBJCLOSE"
185 @ MSG_LTFL_AUD_SYMBIND          "AUD_SYMBIND"
186 @ MSG_LTFL_AUD_PLTENTER         "AUD_PLTENTER"
187 @ MSG_LTFL_AUD_PLTEXIT          "AUD_PLTEXIT"
188 @ MSG_LTFL_AUD_ACTIVITY         "AUD_ACTIVITY"
190 @ MSG_LMC_ANALYZING             "ANALYZING"
191 @ MSG_LMC_RELOCATING            "RELOCATING"
192 @ MSG_LMC_REANALYZE             "REANALYZE"
195 # Error messages
197 @ MSG_ERR_NAS           "%s:: no address specified\n"
198 @ MSG_ERR_READ          "%s:: failed to read from: 0x%p\n"      
199 @ MSG_ERR_SYMFAILED     "rtmaps:: lookup of %s`%s failed\n"
202 # Various generic format strings
204 @ MSG_FMT_RT            "[0x%x]\t0x%0?p 0x%0?p %s\n"
207 # Elf header messages.
209 @ MSG_EHDR_STR          "ElfEhdr"
211 @ MSG_EHDR_DCD          "Display Elf_Ehdr entry"
213 @ MSG_EHDR_TITLE        "Elf Header located at: 0x%p\n"
214 @ MSG_EHDR_LINE1        " ei_magic:    { 0x%x, %c, %c, %c }\n"
215 @ MSG_EHDR_LINE2        " ei_class:    %-18s  ei_data:     %s\n"
216 @ MSG_EHDR_LINE3        " e_machine:   %-18s  e_version:   %s\n"
217 @ MSG_EHDR_LINE4        " e_type:      %s\n"
218 @ MSG_EHDR_LINE5        " e_flags:     %s\n"
219 @ MSG_EHDR_LINE6        " e_flags:     %18s\n"
220 @ MSG_EHDR_LINE7        " e_entry:     %#18lx  e_ehsize:     %2d  \
221                           e_shstrndx:   %2d\n"
222 @ MSG_EHDR_LINE8        " e_shoff:     %#18lx  e_shentsize:  %2d  \
223                           e_shnum:      %2d\n"
224 @ MSG_EHDR_LINE9        " e_phoff:     %#18lx  e_phentsize:  %2d  \
225                           e_phnum:      %2d\n"
227 @ MSG_EHDR_HELP         "\
228    Decode an ELF Header (Elf_Ehdr) structure.\n\
229    \n\
230    Example:\n\n\
231    \t> 0x10000::ElfEhdr \n\
232    \tElf Header located at: 0x10000\n\
233    \t ei_magic:    { 0x7f, E, L, F }\n\
234    \t ei_class:    ELFCLASS32          ei_data:     ELFDATA2MSB\n\
235    \t e_machine:   EM_SPARC            e_version:   EV_CURRENT\n\
236    \t e_type:      ET_EXEC\n\
237    \t e_flags:                      0\n\
238    \t e_entry:                0x10640  e_ehsize:     52  e_shstrndx:   27\n\
239    \t e_shoff:                 0x1390  e_shentsize:  40  e_shnum:      29\n\
240    \t e_phoff:                   0x34  e_phentsize:  32  e_phnum:       5\n"
243 # Elf Program Header messages.
246 @ MSG_EPHDR_STR         "ElfPhdr"
248 @ MSG_EPHDR_DCD         "Display Elf_Phdr entry"
250 @ MSG_EPHDR_TITLE       "Program Header located at: 0x%p\n"
251 @ MSG_EPHDR_LINE1       "    p_vaddr:      %#-14lx  p_flags:    %s\n"
252 @ MSG_EPHDR_LINE2       "    p_paddr:      %#-14lx  p_type:     %s\n"
253 @ MSG_EPHDR_LINE3       "    p_filesz:     %#-14lx  p_memsz:    %#lx\n"
254 @ MSG_EPHDR_LINE4       "    p_offset:     %#-14lx  p_align:    %#lx\n"
256 @ MSG_EPHDR_HELP        "\
257    Decode an ELF Program Header (Elf_Phdr) structure.\n\
258    \n\
259    Example 1 - a single entry:\n\n\
260    \t> 0x10000+0x34::ElfPhdr\n\
261    \tProgram Header located at: 0x10034\n\
262    \t    p_vaddr:      0x10034         p_flags:    [ PF_X  PF_R ]\n\
263    \t    p_paddr:      0               p_type:     [ PT_PHDR ]\n\
264    \t    p_filesz:     0xa0            p_memsz:    0xa0\n\
265    \t    p_offset:     0x34            p_align:    0\n\
266    \n\
267    Example 2 - multiple entries:\n\n\
268    \t> 0x10034,2::ElfPhdr\n\
269    \tProgram Header located at: 0x10034\n\
270    \t    p_vaddr:      0x10034         p_flags:    [ PF_X  PF_R ]\n\
271    \t    p_paddr:      0               p_type:     [ PT_PHDR ]\n\
272    \t    p_filesz:     0xa0            p_memsz:    0xa0\n\
273    \t    p_offset:     0x34            p_align:    0\n\
274    \tProgram Header located at: 0x10054\n\
275    \t    p_vaddr:      0               p_flags:    [ PF_R ]\n\
276    \t    p_paddr:      0               p_type:     [ PT_INTERP ]\n\
277    \t    p_filesz:     0x11            p_memsz:    0\n\
278    \t    p_offset:     0xd4            p_align:    0\n"
282 # Elf_Dyn messages.
285 @ MSG_ELFDYN_STR        "ElfDyn"
287 @ MSG_ELFDYN_DCD        "Display Elf_Dyn entry"
289 @ MSG_ELFDYN_TITLE      "Elf_Dyn located at: 0x%p\n"
290 @ MSG_ELFDYN_LINE1      "    %a  %s\t  0x%0?p\n"
292 @ MSG_ELFDYN_HELP       "\
293    Decode an ELF dynamic section (Elf_Dyn) entry.\n\
294    \n\
295    Example 1 - a single entry:\n\n\
296    \t> 0xff33a478::ElfDyn\n\
297    \tElf_Dyn located at: 0xff33a478\n\
298    \t    0xff33a478  NEEDED  0x00004013\n\
299    \n\
300    Example 2 - multiple entries:\n\n\
301    \t> 0xff33a478,4::ElfDyn\n\
302    \tElf_Dyn located at: 0xff33a478\n\
303    \t    0xff33a478  NEEDED  0x00004013\n\
304    \tElf_Dyn located at: 0xff33a480\n\
305    \t    0xff33a480  INIT    0x0009b484\n\
306    \tElf_Dyn located at: 0xff33a488\n\
307    \t    0xff33a488  FINI    0x0009b4dc\n\
308    \tElf_Dyn located at: 0xff33a490\n\
309    \t    0xff33a490  SONAME  0x00004009\n"
313 # Lm_list messages.
316 @ MSG_LMLIST_STR        "Lm_list"
318 @ MSG_LMLIST_DCD        "Display Lm_list structure"
320 @ MSG_LMLIST_BASE       "(LM_ID_BASE)"
321 @ MSG_LMLIST_LDSO       "(LM_ID_LDSO)"
322 @ MSG_LMLIST_NEWLM      "(LM_ID_NEWLM)"
324 @ MSG_LMLIST_TITLE0     "Link-map lists (%s): 0x0\n";
325 @ MSG_LMLIST_TITLE1     "Link-map lists (%s): 0x%p Alist[used %u: total %u]\n";
326 @ MSG_LMLIST_TITLE2     "Lm_list: 0x%p  %s\n"
328 @ MSG_LMLIST_LINE0      "   lists: 0x%0?p Alist[used %u: total %u]\n"
330 @ MSG_LMC_LINE1         "Lm_cntl: 0x%p\n"
331 @ MSG_LMC_LINE2         "   head: 0x%0?p\t      tail: 0x%0?p\n"
332 @ MSG_LMC_LINE3         "  flags: 0x%08x\t       now: 0x%0?p\n"
333 @ MSG_LMC_LINE4         "         [ %#b ]\n"
335 @ MSG_LMLIST_LINE1      "    head: 0x%0?p\t      tail: 0x%0?p\n"
336 @ MSG_LMLIST_LINE2      "   audit: 0x%0?p\t  rtldinfo: 0x%0?p\n"
337 @ MSG_LMLIST_LINE3      "  handle: 0x%0?p\t       obj: %4d  init: %4d  \
338                          lazy: %4d\n"
339 @ MSG_LMLIST_LINE4      "   flags: 0x%08x\n"
340 @ MSG_LMLIST_LINE5      "  tflags: 0x%08x\n"
341 @ MSG_LMLIST_LINE6      "          [ %#b ]\n"
343 @ MSG_LMLIST_HELP       "\
344    Display a link-map list header.  If no address is specified, the \
345    dynlm_list\nmaster link-map list is searched and all link-map headers \
346    displayed.\n\
347    \n\
348    A link-map list header points to a family of link-map control lists, \
349    together\nwith other state information. The initial control list represents \
350    those\nobjects that have been completely analyzed and relocated, and are \
351    presently in\nuse.  \
352    Additional control lists may exist as families of objects are processed\nin \
353    preparation for joining the main control list.  These families are created\n\
354    from events such as dlopen(3c), lazy loading, and filtee processing, once\n\
355    the initial process that started the application has been relocated.\n\
356    \n\
357    The -v option walks all link-map control lists displaying each member.\n\
358    \n\
359    Example 1 - a single, verbose entry, starting from a specified address:\n\n\
360    \n\
361    \t> 0xff3ee0f0::Lm_list -v\n\
362    \tLm_list: 0xff3ee0f0  (LM_ID_BASE)\n\
363    \t----------------------------------------------\n\
364    \t   lists: 0xff3f0b00 Alist[used 1: total 4]\n\
365    \t  ----------------------------------------------\n\
366    \t    Lm_cntl: 0xff3f0b0c\n\
367    \t       head: 0xff3f0fdc      tail: 0xff3f13bc\n\
368    \t      flags: 0x00000000       now: 0x00000000\n\
369    \t             [ 0 ]\n\
370    \t    ----------------------------------------------\n\
371    \t    lmco        rtmap       ADDR()     NAME()\n\
372    \t    ----------------------------------------------\n\
373    \t    [0xc]       0xff3f0fdc 0x00010000 main\n\
374    \t    [0xc]       0xff3f13bc 0xff280000 /lib/libc.so.1\n\
375    \t    ----------------------------------------------\n\
376    \t    head: 0xff3f0f84        tail: 0xff3f1794\n\
377    \t   audit: 0x00000000     preexec: 0xff3f1794\n\
378    \t  handle: 0x00000000         obj:    3  init:    0  lazy:    0\n\
379    \t   flags: 0x00008041\n\
380    \t          [ BASELM,ENVIRON,STARTREL ]\n\
381    \t  tflags: 0x00000000\n\
382    \n\
383    Example 2 - all link-map headers:\n\n\
384    \t> ::Lm_list\n\
385    \tLink-map lists (dynlm_list): 0xffbfdbf8\n\
386    \t----------------------------------------------\n\
387    \t  Lm_list: 0xff3ee0f0  (LM_ID_BASE)\n\
388    \t  ----------------------------------------------\n\
389    \t     lists: 0xff3f0b68 Alist[used 1: total 4]\n\
390    \t    ----------------------------------------------\n\
391    \t      head: 0xff3f0f84        tail: 0xff3f1794\n\
392    \t     audit: 0x00000000     preexec: 0xff3f1794\n\
393    \t    handle: 0x00000000         obj:    3  init:    0  lazy:    0\n\
394    \t     flags: 0x00008041\n\
395    \t            [ BASELM,ENVIRON,STARTREL ]\n\
396    \t    tflags: 0x00000000\n\
397    \t  ----------------------------------------------\n\
398    \t  Lm_list: 0xff3ee134  (LM_ID_LDSO)\n\
399    \t  ----------------------------------------------\n\
400    \t     lists: 0xff3f0ba4 Alist[used 1: total 4]\n\
401    \t    ----------------------------------------------\n\
402    \t      head: 0xff3f0c20        tail: 0xff3f0c20\n\
403    \t     audit: 0x00000000     preexec: 0x00000000\n\
404    \t    handle: 0x00000000         obj:    0  init:    0  lazy:    0\n\
405    \t     flags: 0x00000006\n\
406    \t            [ RTLDLM,NOAUDIT ]\n\
407    \t    tflags: 0x00000000\n"
410 # Rt_maps messages.
413 @ MSG_RTMAPS_STR        "Rt_maps"
415 @ MSG_RTMAPS_DCD        "Display list of Rt_map structures"
417 @ MSG_RTMAPS_TITLE0     "lmco \trtmap       ADDR()     NAME()\n"
419 @ MSG_RTMAPS_HELP "\
420    Walk a list of Rt_map's starting with a specified Rt_map entry.  If no\n\
421    address is specified, the dynlm_list master Rt_map list is searched and\n\
422    all objects listed.\n\
423    \n\
424    The -v option expands each Rt_map in detail.  See Rt_map.\n\
425    \n\
426    Example 1 - a single entry, starting from a specified address:\n\n\
427    \t> 0xff3b0214::Rt_maps\n\
428    \tlmco    rtmap      ADDR()     NAME()\n\
429    \t---------------------------------------------\n\
430    \t[0xc]   0xff3b0214 0x00010000 prog\n\
431    \t[0xc]   0xff3b065c 0xff3a0000 /lib/libdl.so.1\n\
432    \t[0xc]   0xff3b0a04 0xff280000 /lib/libc.so.1\n\
433    \n\
434    Example 2 - all Rt_map entries:\n\n\
435    \t> ::Rt_maps\n\
436    \tLink-map lists (dynlm_list): 0xffbfe080\n\
437    \t---------------------------------------------\n\
438    \t  Lm_list: 0xff3f60c8  (LM_ID_BASE)\n\
439    \t  ---------------------------------------------\n\
440    \t    lmco    rtmap      ADDR()     NAME()\n\
441    \t    ---------------------------------------------\n\
442    \t    [0xc]   0xff3b0214 0x00010000 prog\n\
443    \t    [0xc]   0xff3b065c 0xff3a0000 /lib/libdl.so.1\n\
444    \t    [0xc]   0xff3b0a04 0xff280000 /lib/libc.so.1\n\
445    \t  ---------------------------------------------\n\
446    \t  Lm_list: 0xff3f60e8  (LM_ID_LDSO)\n\
447    \t  ---------------------------------------------\n\
448    \t    lmco    rtmap      ADDR()     NAME()\n\
449    \t    ---------------------------------------------\n\
450    \t    [0xc]   0xff3f7cc0 0xff3c0000 /lib/ld.so.1\n"
454 # Rt_map messages.
457 @ MSG_RTMAP_STR         "Rt_map"
459 @ MSG_RTMAP_DCD         "Display Rt_map structure"
461 @ MSG_RTMAP_TITLE       "Rt_map located at: 0x%0?p\n"
462 @ MSG_RTMAP_LINE1       "     NAME: %s\n"
463 @ MSG_RTMAP_LINE2       " PATHNAME: %s\n"
464 @ MSG_RTMAP_LINE3       "     ADDR: 0x%0?p\t      DYN: 0x%0?p\n"
465 @ MSG_RTMAP_LINE4       "     NEXT: 0x%0?p\t     PREV: 0x%0?p\n"
466 @ MSG_RTMAP_LINE5       "      FCT: 0x%0?p\t TLSMODID:   %?ld\n"
467 @ MSG_RTMAP_LINE6       "     INIT: 0x%0?p\t     FINI: 0x%0?p\n"
468 @ MSG_RTMAP_LINE7       "   GROUPS: 0x%0?p\t  HANDLES: 0x%0?p\n"
469 @ MSG_RTMAP_LINE8       "  DEPENDS: 0x%0?p\t  CALLERS: 0x%0?p\n"
470 @ MSG_RTMAP_LINE9       "  DYNINFO: 0x%0?p\t  REFNAME: %s\n"
471 @ MSG_RTMAP_LINE10      "    RLIST: 0x%0?p\t    RPATH: %s\n"
472 @ MSG_RTMAP_LINE11      "     LIST: 0x%0?p [%a]\n"
473 @ MSG_RTMAP_LINE12      "    FLAGS: 0x%08x\n"
474 @ MSG_RTMAP_LINE13      "   FLAGS1: 0x%08x\n"
475 @ MSG_RTMAP_LINE14      "   AFLAGS: 0x%08x\n"
476 @ MSG_RTMAP_LINE15      "     MODE: 0x%08x\n"
477 @ MSG_RTMAP_LINE20      "           [ %#b ]\n"
479 @ MSG_RTMAP_HELP "\
480    Display the contents of selected fields of an Rt_map structure.\n\
481    \n\
482    Example:\n\n\
483    \t0xff3b0214::Rt_map\n\
484    \tRt_map located at: 0xff3b0214\n\
485    \t      NAME: prog\n\
486    \t  PATHNAME: /home/developer/bin/prog\n\
487    \t      ADDR: 0x00010000         DYN: 0x00020b1\n\
488    \t      NEXT: 0xff3b065c        PREV: 0x0000000\n\
489    \t       FCT: 0xff3f6080    TLSMODID:         0\n\
490    \t      INIT: 0x00010960        FINI: 0x000109b\n\
491    \t      .....\n"
494 # Bind messages.
497 @ MSG_BND_STR           "Bind"
499 @ MSG_BND_DCD           "Display a Binding Descriptor"
501 @ MSG_BND_TITLE         "Binding descriptor located at: 0x%0?p\n"
502 @ MSG_BND_LINE1         "   caller: 0x%0?p    %s\n"
503 @ MSG_BND_LINE2         "   depend: 0x%0?p    %s\n"
504 @ MSG_BND_LINE3         "    flags: 0x%08x    [ %#b ]\n"
506 @ MSG_BND_HELP          "\
507    Decode the binding descriptor specified by addr.\n\
508    \n\
509    Relationships between Rt_map objects are maintained by a binding dis-\n\
510    cripter.  The descriptor contains a pointer to the Rt_map of the caller,\n\
511    a pointer to the Rt_map of the dependency, and a flags field indicating\n\
512    the relationship between the two Rt_map objects.\n\
513    \n\
514    The -v option expands each Rt_map.\n\
515    \n\
516    Example:\n\n\
517    \t> 0xff3b0410::Bind\n\
518    \tBinding Descriptor located at: 0xff3b0410\n\
519    \t   caller: 0xff3b0030    main\n\
520    \t   depend: 0xff3b0460    /lib/libelf.so.1\n\
521    \t    flags: 0x00000001    [ NEEDED ]\n"
525 # Depends messages.
528 @ MSG_DEPENDS_STR       "Depends"
530 @ MSG_DEPENDS_DCD       "Display Rt_map DEPENDS binding descriptors"
532 @ MSG_DEPENDS_LINE1     "DEPENDS for %s\n"
533 @ MSG_DEPENDS_LINE2     "  Depends: 0x%0?p APlist[used %u: total %u]\n"
535 @ MSG_DEPENDS_HELP      "\
536    Display the binding descriptor list of DEPENDS() of the Rt_map\n\
537    specified by addr.  A DEPENDS() entry consists of an APlist\n\
538    defining each dependency.\n\
539    \n\
540    The -v option walks the APlist descriptor displaying each dependency.\n\
541    \n\
542    Example:\n\n\
543    \t> 0xff3b0554::Depends -v\n\
544    \tDEPENDS for /lib/libc.so.1\n\
545    \t----------------------------------------------\n\
546    \t  Depends: 0xff3b0bc4 APlist[used 2: total 4]\n\
547    \t    ----------------------------------------------\n\
548    \t    Binding descriptor located at: 0xff3b08f8\n\
549    \t       caller: 0xff3b0554    /lib/libc.so.1\n\
550    \t       depend: 0xff3b0938    /lib/libdl.so.1\n\
551    \t        flags: 0x00000003    [ NEEDED,REFERENCED ]\n\
552    \t    ----------------------------------------------\n\
553    \t    Binding descriptor located at: 0xff3b07a8\n\
554    \t       caller: 0xff3b0554    /lib/libc.so.1\n\
555    \t       depend: 0xff3f7cc0    /lib/ld.so.1\n\
556    \t        flags: 0x00000002    [ REFERENCED ]\n"
559 # Callers messages.
562 @ MSG_CALLERS_STR       "Callers"
564 @ MSG_CALLERS_DCD       "Display Rt_map CALLERS binding descriptors"
566 @ MSG_CALLERS_LINE1     "CALLERS for %s\n"
567 @ MSG_CALLERS_LINE2     "  Callers: 0x%0?p APlist[used %u: total %u]\n"
569 @ MSG_CALLERS_HELP      "\
570    Display the binding descriptor list of CALLERS() of the Rt_map\n\
571    specified by addr.  A CALLERS() entry consists of an APlist\n\
572    defining each caller.\n\
573    \n\
574    The -v option walks the APlist descriptor displaying each caller.\n\
575    \n\
576    Example:\n\n\
577    \t> 0xff3b0554::Callers -v\n\
578    \tCALLERS for /lib/libc.so.1\n\
579    \t----------------------------------------------\n\
580    \t  Callers: 0xff3b08cc APlist[used 1: total 4]\n\
581    \t    ----------------------------------------------\n\
582    \t    Binding descriptor located at: 0xff3b0514\n\
583    \t       caller: 0xff3b0214    a.out\n\
584    \t       depend: 0xff3b0554    /lib/libc.so.1\n\
585    \t        flags: 0x00000003    [ NEEDED,REFERENCED ]\n"
589 # Handle messages.
592 @ MSG_HANDLES_STR       "Handles"
594 @ MSG_HANDLES_DCD       "Display Rt_map HANDLES group descriptors"
596 @ MSG_HANDLES_LINE1     "HANDLES for %s\n"
597 @ MSG_HANDLES_LINE2     "  HANDLE: 0x%0?p APlist[used %u: total %u]\n"
599 @ MSG_HANDLES_HELP      "\
600    Display the list of HANDLES() that the Rt_map, specified by addr, is the\n\
601    owner of.  A HANDLES() entry consists of an APlist of Grp_hdl descriptors.\n\
602    See GrpHdl.  Each Grp_hdl() consists of an APlist of Grp_desc descriptors\n\
603    that define each caller.  See GrpDesc.\n\
604    \n\
605    The -v option walks all APlists displaying each member of the handle.\n\
606    \n\
607    Example:\n\n\
608    \t> 0xff3b0f6c::Handles -v\n\
609    \tHANDLES for ./sub.so\n\
610    \t----------------------------------------------\n\
611    \t  HANDLE: 0xff3b1310 APlist[used 1: total 1]\n\
612    \t    ----------------------------------------------\n\
613    \t    Group Handle located at: 0xff3b1270\n\
614    \t    ----------------------------------------------\n\
615    \t       owner:               ./sub.so\n\
616    \t       flags: 0x00000000    [ 0 ]\n\
617    \t      refcnt:          1    depends: 0xff3b12c8 Alist[used 3: total 4]\n\
618    \t       ----------------------------------------------\n\
619    \t       Group Descriptor located at: 0xff3b12d4\n\
620    \t          depend: 0xff3b0f6c    ./sub.so\n\
621    \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
622    \t       ----------------------------------------------\n\
623    \t       Group Descriptor located at: 0xff3b12dc\n\
624    \t          depend: 0xff3b0a04    /lib/libc.so.1\n\
625    \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
626    \t       ----------------------------------------------\n\
627    \t       Group Descriptor located at: 0xff3b12e4\n\
628    \t          depend: 0xff3b065c    /lib/libdl.so.1\n\
629    \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
632 # Group messages.
635 @ MSG_GROUPS_STR        "Groups"
637 @ MSG_GROUPS_DCD        "Display Rt_map GROUPS group handles"
639 @ MSG_GROUPS_LINE1      "GROUPS for %s\n"
640 @ MSG_GROUPS_LINE2      "  Groups: 0x%0?p APlist[used %u: total %u]\n"
642 @ MSG_GROUPS_HELP       "\
643    Display the list of GROUPS() that the Rt_map, specified by addr, is a \
644    member\nof.  A GROUPS() entry consists of an APlist of Grp_hdl entries.  \
645    See GrpHdl.\n\
646    \n\
647    The -v option walks the APlist descriptor displaying each member of the\n\
648    handle.\n\
649    \n\
650    Example:\n\n\
651    \t> 0xff3b0f6c::Groups -v\n\
652    \tGROUPS for ./sub.so\n\
653    \t----------------------------------------------\n\
654    \t  Groups: 0xff3b12a8 APlist[used 1: total 1]\n\
655    \t    ----------------------------------------------\n\
656    \t    Group Handle located at: 0xff3b1270\n\
657    \t    ----------------------------------------------\n\
658    \t        owner:               ./sub.so\n\
659    \t        flags: 0x00000000    [ 0 ]\n\
660    \t       refcnt:          1    depends: 0xff3b12c8 Alist[used 3: total 4]\n\
661    \t        ----------------------------------------------\n\
662    \t        Group Descriptor located at: 0xff3b12d4\n\
663    \t           depend: 0xff3b0f6c    ./sub.so\n\
664    \t            flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
665    \t        ----------------------------------------------\n\
666    \t        Group Descriptor located at: 0xff3b12dc\n\
667    \t           depend: 0xff3b0a04    /lib/libc.so.1\n\
668    \t            flags: 0x00000004    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
669    \t        ----------------------------------------------\n\
670    \t        Group Descriptor located at: 0xff3b12e4\n\
671    \t           depend: 0xff3b065c    /lib/libdl.so.1\n\
672    \t            flags: 0x00000004    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
676 # Group handle and group descriptor messages.
679 @ MSG_GRPHDL_STR        "GrpHdl"
681 @ MSG_GRPHDL_DCD        "Display a Group Handle"
683 @ MSG_GRPHDL_LINE1      "Group Handle located at: 0x%0?p\n"
684 @ MSG_GRPHDL_LINE2      "    owner:               %s\n"
685 @ MSG_GRPHDL_LINE3      "    flags: 0x%08x    [ %#b ]\n"
686 @ MSG_GRPHDL_LINE4      "   refcnt:   %8d    depends: 0\n"
687 @ MSG_GRPHDL_LINE5      "   refcnt:   %8d    depends: 0x%0?p \
688                          Alist[used %u: total %u]\n"
690 @ MSG_GRPHDL_HELP       "\
691    Decode a group handle.  A successful dlopen() of an object returns a\n\
692    handle applicable for subsequent dlsym() requests.  The handle maintains\n\
693    a reference count, flags and a table of group descriptors that define the\n\
694    dependencies associated with this group of objects.\n\
695    \n\
696    The -v option expands each group descriptor.\n\
697    \n\
698    Example:\n\n\
699    \t> 0xff3a0c58::GrpHdl\n\
700    \tGroup Handle located at: 0xff3a0c58\n\
701    \t----------------------------------------------\n\
702    \t   refcnt:          1    main\n\
703    \t    flags: 0x00000001    [ DLOPEN-ZERO ]\n\
704    \t  depends: 0xff3a0c89 Alist[next 1: cnt 2]\n"
708 @ MSG_GRPDESC_STR       "GrpDesc"
710 @ MSG_GRPDESC_DCD       "Display a Group Descriptor"
712 @ MSG_GRPDESC_LINE1     "Group Descriptor located at: 0x%0?p\n"
713 @ MSG_GRPDESC_LINE2     "   depend: 0x%0?p    %s\n"
714 @ MSG_GRPDESC_LINE3     "    flags: 0x%08x    [ %#b ]\n"
716 @ MSG_GRPDESC_HELP      "\
717    Decode a group descriptor.  A GrpHdl created by dlopen() maintains a\n\
718    list of group descriptors for each dependency.  See GrpHdl.\n\
719    \n\
720    Example\n\n\
721    \t> 0xff3b12d4::GrpDesc -v\n\
722    \tGroup Descriptor located at: 0xff3b12d4\n\
723    \t   depend: 0xff3b0f6c    ./sub.so\n\
724    \t    flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
727 @ MSG_BNDDESC_STR       "BndDesc"
730 # General purpose environment addition.
733 @ MSG_SETENV_STR        "Setenv"
735 @ MSG_SETENV_DCD        "Set an environment variable"
737 @ MSG_SETENV_HELP       "\
738    Set the associated environment variable.  This can be useful to establish\n\
739    runtime linker environment variables without affecting the debugger itself.\n\
740    \n\
741    Note, newer versions of mdb(1) provide setenv.  The mdb(1) implementation\n\
742    provides the ability to make environment changes at any point during\n\
743    application monitoring.  Where available, Setenv calls through to setenv.\n\
744    On older environments, Setenv only provides for changing the applications\n\
745    environment before it is invoked.\n\
746    \n\
747    Example\n\n\
748    \t> ::Setenv LD_DEBUG=files\n"