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]
23 # Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
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"
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"
62 @ MSG_FLG_ISMAIN "IS-MAIN"
63 @ MSG_FLG_IMGALLOC "IMAGE-ALLOCATED"
64 @ MSG_FLG_RELOCED "RELOCED"
65 @ MSG_FLG_SETGROUP "SET-GROUP"
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"
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"
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"
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 \
222 @ MSG_EHDR_LINE8 " e_shoff: %#18lx e_shentsize: %2d \
224 @ MSG_EHDR_LINE9 " e_phoff: %#18lx e_phentsize: %2d \
228 Decode an ELF Header (Elf_Ehdr) structure.\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\
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"
257 Decode an ELF Program Header (Elf_Phdr) structure.\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\
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"
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"
293 Decode an ELF dynamic section (Elf_Dyn) entry.\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\
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"
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 \
339 @ MSG_LMLIST_LINE4 " flags: 0x%08x\n"
340 @ MSG_LMLIST_LINE5 " tflags: 0x%08x\n"
341 @ MSG_LMLIST_LINE6 " [ %#b ]\n"
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 \
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 \
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\
357 The -v option walks all link-map control lists displaying each member.\n\
359 Example 1 - a single, verbose entry, starting from a specified address:\n\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\
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\
383 Example 2 - all link-map headers:\n\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"
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"
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\
424 The -v option expands each Rt_map in detail. See Rt_map.\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\
434 Example 2 - all Rt_map entries:\n\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"
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"
480 Display the contents of selected fields of an Rt_map structure.\n\
483 \t0xff3b0214::Rt_map\n\
484 \tRt_map located at: 0xff3b0214\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\
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"
507 Decode the binding descriptor specified by addr.\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\
514 The -v option expands each Rt_map.\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"
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\
540 The -v option walks the APlist descriptor displaying each dependency.\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"
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\
574 The -v option walks the APlist descriptor displaying each caller.\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"
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\
605 The -v option walks all APlists displaying each member of the handle.\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"
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"
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. \
647 The -v option walks the APlist descriptor displaying each member of the\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"
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\
696 The -v option expands each group descriptor.\n\
699 \t> 0xff3a0c58::GrpHdl\n\
700 \tGroup Handle located at: 0xff3a0c58\n\
701 \t----------------------------------------------\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\
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"
738 Set the associated environment variable. This can be useful to establish\n\
739 runtime linker environment variables without affecting the debugger itself.\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\
748 \t> ::Setenv LD_DEBUG=files\n"