xref: /illumos-gate/usr/src/cmd/sgs/rtld/mdbmod/common/rtld.msg (revision 6e375c8351497b82ffa4f33cbf61d712999b4605)
1#
2# CDDL HEADER START
3#
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.
7#
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.
12#
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]
18#
19# CDDL HEADER END
20#
21
22#
23# Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
24# Use is subject to license terms.
25#
26
27@ _START_
28
29@ _END_
30
31#
32# Misc. Strings
33#
34@ MSG_STR_NAME		"NAME"
35@ MSG_STR_PATHNAME	"PATHNAME"
36@ MSG_STR_REFNAME	"REFNAME"
37@ MSG_STR_RPATH		"RPATH"
38@ MSG_STR_DASHES	"----------------------------------------------\n"
39@ MSG_STR_LDSO1		"ld.so.1"
40@ MSG_STR_DYNLMLIST	"dynlm_list"
41@ MSG_STR_ALIST		"Alist"
42@ MSG_STR_APLIST	"APlist"
43@ MSG_STR_LISTNODE	"Listnode"
44@ MSG_STR_EMPTY		""
45@ MSG_STR_ORPHANED	"<orphaned>"
46@ MSG_STR_SETENV	"setenv"
47
48#
49# mdb_dcmd_t.dc_usage's
50#
51@ MSG_USG_ADDREQ	":"			# Address required
52@ MSG_USG_ADDREQ_V	":[-v]"			# Address required plus -v
53@ MSG_USG_ADDOPT_V	"?[-v]"			# Address optional plus -v
54@ MSG_USG_SETENV	"name[=value]"		# Setenv argument
55
56#
57# mdb_walker.walk_descr's
58#
59@ MSG_WWD_RTMAP		"Walk a List of Rt_maps"
60@ MSG_WWD_LIST		"Walk a List"
61
62#
63# Flag Strings
64#
65@ MSG_FLG_ISMAIN	"IS-MAIN"
66@ MSG_FLG_IMGALLOC	"IMAGE-ALLOCATED"
67@ MSG_FLG_RELOCED	"RELOCED"
68@ MSG_FLG_SETGROUP	"SET-GROUP"
69@ MSG_FLG_HWCAP		"HWCAP"
70@ MSG_FLG_OBJECT	"OBJECT"
71@ MSG_FLG_NODUMP	"NODUMP"
72@ MSG_FLG_DELETE	"DELETE"
73@ MSG_FLG_ANALYZED	"ANALYZED"
74@ MSG_FLG_INITDONE	"INIT-DONE"
75@ MSG_FLG_TRANS		"TRANS"
76@ MSG_FLG_FIXED		"FIXED"
77@ MSG_FLG_PRELOAD	"PRELOAD"
78@ MSG_FLG_ALTER		"ALTERNATE"
79@ MSG_FLG_LOADFLTR	"LOAD-FILTERS"
80@ MSG_FLG_AUDIT		"AUDIT"
81@ MSG_FLG_MODESET	"MODE-SET"
82@ MSG_FLG_ANALZING	"ANALYZING"
83@ MSG_FLG_INITFRST	"INIT-FIRST"
84@ MSG_FLG_NOOPEN	"NO-OPEN"
85@ MSG_FLG_FINICLCT	"FINI-COLLECTED"
86@ MSG_FLG_INITCALL	"INIT-CALLED"
87@ MSG_FLG_OBJINTPO	"OBJECT-INTERPOSE"
88@ MSG_FLG_SYMINTPO	"SYMBOL-INTERPOSE"
89@ MSG_FLG_MOVE		"MOVE"
90@ MSG_FLG_TMPLIST	"TEMPORARY-LIST"
91@ MSG_FLG_REGSYMS	"REGISTER-SYMS"
92@ MSG_FLG_INITCLCT	"INIT-COLLECTED"
93@ MSG_FLG_HANDLE	"HANDLE"
94@ MSG_FLG_RELOCING	"RELOCATING"
95
96@ MSG_FL1_COPYTOOK	"COPYTOOK"
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
115@ MSG_MODE_LAZY		"LAZY"
116@ MSG_MODE_NOW		"NOW"
117@ MSG_MODE_NOLOAD	"NOLOAD"
118@ MSG_MODE_GLOBAL	"GLOBAL"
119@ MSG_MODE_PARENT	"PARENT"
120@ MSG_MODE_GROUP	"GROUP"
121@ MSG_MODE_WORLD	"WORLD"
122@ MSG_MODE_NODELETE	"NODELETE"
123@ MSG_MODE_FIRST	"FIRST"
124@ MSG_MODE_CONFGEN	"CONFGEN"
125
126@ MSG_BFL_NEEDED	"NEEDED"
127@ MSG_BFL_REFER		"REFERENCED"
128@ MSG_BFL_FILTER	"FILTER"
129
130@ MSG_GPH_ZERO		"ZERO"
131@ MSG_GPH_LDSO		"LD.SO.1"
132@ MSG_GPH_FIRST		"FIRST-ONLY"
133@ MSG_GPH_FILTEE	"FILTEE"
134@ MSG_GPH_INITIAL	"INITIALIZED"
135@ MSG_GPH_NOPENDLAZY	"NO-PENDING-LAZY-DEPENDENCIES"
136
137@ MSG_GPD_DLSYM		"AVAIL-TO-DLSYM"
138@ MSG_GPD_RELOC		"AVAIL-FOR-RELOCATION"
139@ MSG_GPD_ADDEPS	"ADD-DEPENDENCIES"
140@ MSG_GPD_PARENT	"PARENT"
141@ MSG_GPD_FILTER	"FILTER"
142@ MSG_GPD_REMOVE	"REMOVAL-CANDIDATE"
143@ MSG_GPD_PROMOTE	"RTLD_NOW-PROMOTER"
144
145@ MSG_LFL_BASELM		"BASELM"
146@ MSG_LFL_RTLDLM		"RTLDLM"
147@ MSG_LFL_NOAUDIT		"NO-AUDIT"
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_DBNOTIF		"DBG-NOTIFY"
156@ MSG_LFL_STARTREL		"START-RELOCATION"
157@ MSG_LFL_ATEXIT		"ATEXIT"
158@ MSG_LFL_OBJADDED		"OBJECT-ADDED"
159@ MSG_LFL_OBJDELETED		"OBJECT-DELETED"
160@ MSG_LFL_OBJREEVAL		"OBJECT-REEVALUATE"
161@ MSG_LFL_NOPENDGLBLAZY		"NO-PENDING-GLOBAL-LAZY-DEPENDENCY"
162@ MSG_LFL_INTRPOSETSORT		"INTERPOSE-TSORTING-DONE"
163@ MSG_LFL_AUDITNOTIFY		"AUDIT-CONSISTANT-REQUIRED"
164@ MSG_LFL_GROUPSEXIST		"LOCAL-GROUPS-EXIST"
165
166@ MSG_LFL_TRC_LDDSTUB		"LDDSTUB"
167@ MSG_LFL_TRC_ENABLE		"TRACING-ENABLED"
168@ MSG_LFL_TRC_WARN		"TRACE-WARNINGS"
169@ MSG_LFL_TRC_VERBOSE		"TRACE-VERBOSE"
170@ MSG_LFL_TRC_SEARCH		"TRACE-SEARCH"
171@ MSG_LFL_TRC_UNREF		"TRACE-UNREFERENCED"
172@ MSG_LFL_TRC_UNUSED		"TRACE-UNUSED"
173@ MSG_LFL_TRC_INIT		"TRACE-INIT"
174@ MSG_LFL_TRC_NOUNRESWEAK	"TRACE-NO-UNRESOLVED-WEAKS"
175@ MSG_LFL_TRC_NOPAREXT		"TRACE-NO-PARENT-OR-EXTERN"
176
177@ MSG_LTFL_NOLAZYLD		"NO-LAZY-LOADING"
178@ MSG_LTFL_NODIRECT		"NO-DIRECT"
179@ MSG_LTFL_LOADFLTR		"LOAD-FILTER"
180
181@ MSG_LTFL_AUD_PREINIT		"AUD_PREINIT"
182@ MSG_LTFL_AUD_OBJSEARCH	"AUD_OBJSEARCH"
183@ MSG_LTFL_AUD_OBJOPEN		"AUD_OBJOPEN"
184@ MSG_LTFL_AUD_OBJFILTER	"AUD_OBJFILTER"
185@ MSG_LTFL_AUD_OBJCLOSE		"AUD_OBJCLOSE"
186@ MSG_LTFL_AUD_SYMBIND		"AUD_SYMBIND"
187@ MSG_LTFL_AUD_PLTENTER		"AUD_PLTENTER"
188@ MSG_LTFL_AUD_PLTEXIT		"AUD_PLTEXIT"
189@ MSG_LTFL_AUD_ACTIVITY		"AUD_ACTIVITY"
190
191@ MSG_LMC_ANALYZING		"ANALYZING"
192@ MSG_LMC_RELOCATING		"RELOCATING"
193@ MSG_LMC_REANALYZE		"REANALYZE"
194
195#
196# Error messages
197#
198@ MSG_ERR_NAS		"%s:: no address specified\n"
199@ MSG_ERR_READ		"%s:: failed to read from: 0x%p\n"
200@ MSG_ERR_SYMFAILED	"rtmaps:: lookup of %s`%s failed\n"
201
202#
203# Various generic format strings
204#
205@ MSG_FMT_RT		"[0x%x]\t0x%0?p 0x%0?p %s\n"
206@ MSG_FMT_LN		"0x%0?p 0x%0?p 0x%0?p\n"
207
208#
209# Elf header messages.
210#
211@ MSG_EHDR_STR		"ElfEhdr"
212
213@ MSG_EHDR_DCD		"Display Elf_Ehdr entry"
214
215@ MSG_EHDR_TITLE	"Elf Header located at: 0x%p\n"
216@ MSG_EHDR_LINE1	" ei_magic:    { 0x%x, %c, %c, %c }\n"
217@ MSG_EHDR_LINE2	" ei_class:    %-18s  ei_data:     %s\n"
218@ MSG_EHDR_LINE3	" e_machine:   %-18s  e_version:   %s\n"
219@ MSG_EHDR_LINE4	" e_type:      %s\n"
220@ MSG_EHDR_LINE5	" e_flags:     %s\n"
221@ MSG_EHDR_LINE6	" e_flags:     %18s\n"
222@ MSG_EHDR_LINE7	" e_entry:     %#18lx  e_ehsize:     %2d  \
223			  e_shstrndx:   %2d\n"
224@ MSG_EHDR_LINE8	" e_shoff:     %#18lx  e_shentsize:  %2d  \
225			  e_shnum:      %2d\n"
226@ MSG_EHDR_LINE9	" e_phoff:     %#18lx  e_phentsize:  %2d  \
227			  e_phnum:      %2d\n"
228
229@ MSG_EHDR_HELP		"\
230   Decode an ELF Header (Elf_Ehdr) structure.\n\
231   \n\
232   Example:\n\n\
233   \t> 0x10000::ElfEhdr \n\
234   \tElf Header located at: 0x10000\n\
235   \t ei_magic:    { 0x7f, E, L, F }\n\
236   \t ei_class:    ELFCLASS32          ei_data:     ELFDATA2MSB\n\
237   \t e_machine:   EM_SPARC            e_version:   EV_CURRENT\n\
238   \t e_type:      ET_EXEC\n\
239   \t e_flags:                      0\n\
240   \t e_entry:                0x10640  e_ehsize:     52  e_shstrndx:   27\n\
241   \t e_shoff:                 0x1390  e_shentsize:  40  e_shnum:      29\n\
242   \t e_phoff:                   0x34  e_phentsize:  32  e_phnum:       5\n"
243
244#
245# Elf Program Header messages.
246#
247
248@ MSG_EPHDR_STR		"ElfPhdr"
249
250@ MSG_EPHDR_DCD		"Display Elf_Phdr entry"
251
252@ MSG_EPHDR_TITLE	"Program Header located at: 0x%p\n"
253@ MSG_EPHDR_LINE1	"    p_vaddr:      %#-14lx  p_flags:    %s\n"
254@ MSG_EPHDR_LINE2	"    p_paddr:      %#-14lx  p_type:     %s\n"
255@ MSG_EPHDR_LINE3	"    p_filesz:     %#-14lx  p_memsz:    %#lx\n"
256@ MSG_EPHDR_LINE4	"    p_offset:     %#-14lx  p_align:    %#lx\n"
257
258@ MSG_EPHDR_HELP	"\
259   Decode an ELF Program Header (Elf_Phdr) structure.\n\
260   \n\
261   Example 1 - a single entry:\n\n\
262   \t> 0x10000+0x34::ElfPhdr\n\
263   \tProgram Header located at: 0x10034\n\
264   \t    p_vaddr:      0x10034         p_flags:    [ PF_X  PF_R ]\n\
265   \t    p_paddr:      0               p_type:     [ PT_PHDR ]\n\
266   \t    p_filesz:     0xa0            p_memsz:    0xa0\n\
267   \t    p_offset:     0x34            p_align:    0\n\
268   \n\
269   Example 2 - multiple entries:\n\n\
270   \t> 0x10034,2::ElfPhdr\n\
271   \tProgram Header located at: 0x10034\n\
272   \t    p_vaddr:      0x10034         p_flags:    [ PF_X  PF_R ]\n\
273   \t    p_paddr:      0               p_type:     [ PT_PHDR ]\n\
274   \t    p_filesz:     0xa0            p_memsz:    0xa0\n\
275   \t    p_offset:     0x34            p_align:    0\n\
276   \tProgram Header located at: 0x10054\n\
277   \t    p_vaddr:      0               p_flags:    [ PF_R ]\n\
278   \t    p_paddr:      0               p_type:     [ PT_INTERP ]\n\
279   \t    p_filesz:     0x11            p_memsz:    0\n\
280   \t    p_offset:     0xd4            p_align:    0\n"
281
282
283#
284# Elf_Dyn messages.
285#
286
287@ MSG_ELFDYN_STR	"ElfDyn"
288
289@ MSG_ELFDYN_DCD	"Display Elf_Dyn entry"
290
291@ MSG_ELFDYN_TITLE	"Elf_Dyn located at: 0x%p\n"
292@ MSG_ELFDYN_LINE1	"    %a  %s\t  0x%0?p\n"
293
294@ MSG_ELFDYN_HELP	"\
295   Decode an ELF dynamic section (Elf_Dyn) entry.\n\
296   \n\
297   Example 1 - a single entry:\n\n\
298   \t> 0xff33a478::ElfDyn\n\
299   \tElf_Dyn located at: 0xff33a478\n\
300   \t    0xff33a478  NEEDED  0x00004013\n\
301   \n\
302   Example 2 - multiple entries:\n\n\
303   \t> 0xff33a478,4::ElfDyn\n\
304   \tElf_Dyn located at: 0xff33a478\n\
305   \t    0xff33a478  NEEDED  0x00004013\n\
306   \tElf_Dyn located at: 0xff33a480\n\
307   \t    0xff33a480  INIT    0x0009b484\n\
308   \tElf_Dyn located at: 0xff33a488\n\
309   \t    0xff33a488  FINI    0x0009b4dc\n\
310   \tElf_Dyn located at: 0xff33a490\n\
311   \t    0xff33a490  SONAME  0x00004009\n"
312
313
314#
315# List messages.
316#
317
318@ MSG_LIST_STR		"List"
319
320@ MSG_LIST_DCD		"Display entries in a List"
321
322@ MSG_LIST_TITLE	"Listnode   data       next\n"
323
324@ MSG_LIST_HELP		"\
325   Walk a List structure.  A list consists of a chain of Listnodes.  The head\n\
326   of a List points to the initial node, the tail of the list points to the\n\
327   final node.  A Listnode contains a pointer to a data item and a pointer to\n\
328   the next Listnode.\n\
329   \n\
330   Example:\n\n\
331   \t> ld.so.1`dynlm_list::List\n\
332   \tListnode   data       next\n\
333   \t---------------------------------------------\n\
334   \t0xff3b05ac 0xff3f60c8 0xff3b05c4\n\
335   \t0xff3b05c4 0xff3f60e8 0x00000000\n"
336
337#
338# Lm_list messages.
339#
340
341@ MSG_LMLIST_STR	"Lm_list"
342
343@ MSG_LMLIST_DCD	"Display Lm_list structure"
344
345@ MSG_LMLIST_BASE	"(LM_ID_BASE)"
346@ MSG_LMLIST_LDSO	"(LM_ID_LDSO)"
347@ MSG_LMLIST_NEWLM	"(LM_ID_NEWLM)"
348
349@ MSG_LMLIST_TITLE1	"Link-map lists (%s): 0x%p\n";
350@ MSG_LMLIST_TITLE2	"Lm_list: 0x%p  %s\n"
351
352@ MSG_LMLIST_LINE0	"   lists: 0x%0?p Alist[used %u: total %u]\n"
353
354@ MSG_LMC_LINE1		"Lm_cntl: 0x%p\n"
355@ MSG_LMC_LINE2		"   head: 0x%0?p\t      tail: 0x%0?p\n"
356@ MSG_LMC_LINE3		"  flags: 0x%08x\t       now: 0x%0?p\n"
357@ MSG_LMC_LINE4		"         [ %#b ]\n"
358
359@ MSG_LMLIST_LINE1	"    head: 0x%0?p\t      tail: 0x%0?p\n"
360@ MSG_LMLIST_LINE2	"   audit: 0x%0?p\t  rtldinfo: 0x%0?p\n"
361@ MSG_LMLIST_LINE3	"  handle: 0x%0?p\t       obj: %4d  init: %4d  \
362			 lazy: %4d\n"
363@ MSG_LMLIST_LINE4	"   flags: 0x%08x\n"
364@ MSG_LMLIST_LINE5	"  tflags: 0x%08x\n"
365@ MSG_LMLIST_LINE6	"          [ %#b ]\n"
366
367@ MSG_LMLIST_HELP	"\
368   Display a link-map list header.  If no address is specified, the \
369   dynlm_list\nmaster link-map list is searched and all link-map headers \
370   displayed.\n\
371   \n\
372   A link-map list header points to a family of link-map control lists, \
373   together\nwith other state information. The initial control list represents \
374   those\nobjects that have been completely analyzed and relocated, and are \
375   presently in\nuse.  \
376   Additional control lists may exist as families of objects are processed\nin \
377   preparation for joining the main control list.  These families are created\n\
378   from events such as dlopen(3c), lazy loading, and filtee processing, once\n\
379   the initial process that started the application has been relocated.\n\
380   \n\
381   The -v option walks all link-map control lists displaying each member.\n\
382   \n\
383   Example 1 - a single, verbose entry, starting from a specified address:\n\n\
384   \n\
385   \t> 0xff3ee0f0::Lm_list -v\n\
386   \tLm_list: 0xff3ee0f0  (LM_ID_BASE)\n\
387   \t----------------------------------------------\n\
388   \t   lists: 0xff3f0b00 Alist[used 1: total 4]\n\
389   \t  ----------------------------------------------\n\
390   \t    Lm_cntl: 0xff3f0b0c\n\
391   \t       head: 0xff3f0fdc      tail: 0xff3f13bc\n\
392   \t      flags: 0x00000000       now: 0x00000000\n\
393   \t             [ 0 ]\n\
394   \t    ----------------------------------------------\n\
395   \t    lmco        rtmap       ADDR()     NAME()\n\
396   \t    ----------------------------------------------\n\
397   \t    [0xc]       0xff3f0fdc 0x00010000 main\n\
398   \t    [0xc]       0xff3f13bc 0xff280000 /lib/libc.so.1\n\
399   \t    ----------------------------------------------\n\
400   \t    head: 0xff3f0f84        tail: 0xff3f1794\n\
401   \t   audit: 0x00000000     preexec: 0xff3f1794\n\
402   \t  handle: 0x00000000         obj:    3  init:    0  lazy:    0\n\
403   \t   flags: 0x00008041\n\
404   \t          [ BASELM,ENVIRON,STARTREL ]\n\
405   \t  tflags: 0x00000000\n\
406   \n\
407   Example 2 - all link-map headers:\n\n\
408   \t> ::Lm_list\n\
409   \tLink-map lists (dynlm_list): 0xffbfdbf8\n\
410   \t----------------------------------------------\n\
411   \t  Lm_list: 0xff3ee0f0  (LM_ID_BASE)\n\
412   \t  ----------------------------------------------\n\
413   \t     lists: 0xff3f0b68 Alist[used 1: total 4]\n\
414   \t    ----------------------------------------------\n\
415   \t      head: 0xff3f0f84        tail: 0xff3f1794\n\
416   \t     audit: 0x00000000     preexec: 0xff3f1794\n\
417   \t    handle: 0x00000000         obj:    3  init:    0  lazy:    0\n\
418   \t     flags: 0x00008041\n\
419   \t            [ BASELM,ENVIRON,STARTREL ]\n\
420   \t    tflags: 0x00000000\n\
421   \t  ----------------------------------------------\n\
422   \t  Lm_list: 0xff3ee134  (LM_ID_LDSO)\n\
423   \t  ----------------------------------------------\n\
424   \t     lists: 0xff3f0ba4 Alist[used 1: total 4]\n\
425   \t    ----------------------------------------------\n\
426   \t      head: 0xff3f0c20        tail: 0xff3f0c20\n\
427   \t     audit: 0x00000000     preexec: 0x00000000\n\
428   \t    handle: 0x00000000         obj:    0  init:    0  lazy:    0\n\
429   \t     flags: 0x00000006\n\
430   \t            [ RTLDLM,NOAUDIT ]\n\
431   \t    tflags: 0x00000000\n"
432
433#
434# Rt_maps messages.
435#
436
437@ MSG_RTMAPS_STR	"Rt_maps"
438
439@ MSG_RTMAPS_DCD	"Display list of Rt_map structures"
440
441@ MSG_RTMAPS_TITLE0	"lmco \trtmap       ADDR()     NAME()\n"
442
443@ MSG_RTMAPS_HELP "\
444   Walk a list of Rt_map's starting with a specified Rt_map entry.  If no\n\
445   address is specified, the dynlm_list master Rt_map list is searched and\n\
446   all objects listed.\n\
447   \n\
448   The -v option expands each Rt_map in detail.  See Rt_map.\n\
449   \n\
450   Example 1 - a single entry, starting from a specified address:\n\n\
451   \t> 0xff3b0214::Rt_maps\n\
452   \tlmco    rtmap      ADDR()     NAME()\n\
453   \t---------------------------------------------\n\
454   \t[0xc]   0xff3b0214 0x00010000 prog\n\
455   \t[0xc]   0xff3b065c 0xff3a0000 /lib/libdl.so.1\n\
456   \t[0xc]   0xff3b0a04 0xff280000 /lib/libc.so.1\n\
457   \n\
458   Example 2 - all Rt_map entries:\n\n\
459   \t> ::Rt_maps\n\
460   \tLink-map lists (dynlm_list): 0xffbfe080\n\
461   \t---------------------------------------------\n\
462   \t  Lm_list: 0xff3f60c8  (LM_ID_BASE)\n\
463   \t  ---------------------------------------------\n\
464   \t    lmco    rtmap      ADDR()     NAME()\n\
465   \t    ---------------------------------------------\n\
466   \t    [0xc]   0xff3b0214 0x00010000 prog\n\
467   \t    [0xc]   0xff3b065c 0xff3a0000 /lib/libdl.so.1\n\
468   \t    [0xc]   0xff3b0a04 0xff280000 /lib/libc.so.1\n\
469   \t  ---------------------------------------------\n\
470   \t  Lm_list: 0xff3f60e8  (LM_ID_LDSO)\n\
471   \t  ---------------------------------------------\n\
472   \t    lmco    rtmap      ADDR()     NAME()\n\
473   \t    ---------------------------------------------\n\
474   \t    [0xc]   0xff3f7cc0 0xff3c0000 /lib/ld.so.1\n"
475
476
477#
478# Rt_map messages.
479#
480
481@ MSG_RTMAP_STR		"Rt_map"
482
483@ MSG_RTMAP_DCD		"Display Rt_map structure"
484
485@ MSG_RTMAP_TITLE	"Rt_map located at: 0x%0?p\n"
486@ MSG_RTMAP_LINE1	"     NAME: %s\n"
487@ MSG_RTMAP_LINE2	" PATHNAME: %s\n"
488@ MSG_RTMAP_LINE3	"     ADDR: 0x%0?p\t      DYN: 0x%0?p\n"
489@ MSG_RTMAP_LINE4	"     NEXT: 0x%0?p\t     PREV: 0x%0?p\n"
490@ MSG_RTMAP_LINE5	"      FCT: 0x%0?p\t TLSMODID:   %?ld\n"
491@ MSG_RTMAP_LINE6	"     INIT: 0x%0?p\t     FINI: 0x%0?p\n"
492@ MSG_RTMAP_LINE7	"   GROUPS: 0x%0?p\t  HANDLES: 0x%0?p\n"
493@ MSG_RTMAP_LINE8	"  DEPENDS: 0x%0?p\t  CALLERS: 0x%0?p\n"
494@ MSG_RTMAP_LINE9	"  DYNINFO: 0x%0?p\t  REFNAME: %s\n"
495@ MSG_RTMAP_LINE10	"    RLIST: 0x%0?p\t    RPATH: %s\n"
496@ MSG_RTMAP_LINE11	"     LIST: 0x%0?p [%a]\n"
497@ MSG_RTMAP_LINE12	"    FLAGS: 0x%08x\n"
498@ MSG_RTMAP_LINE13	"   FLAGS1: 0x%08x\n"
499@ MSG_RTMAP_LINE14	"   AFLAGS: 0x%08x\n"
500@ MSG_RTMAP_LINE15	"     MODE: 0x%08x\n"
501@ MSG_RTMAP_LINE20	"           [ %#b ]\n"
502
503@ MSG_RTMAP_HELP "\
504   Display the contents of selected fields of an Rt_map structure.\n\
505   \n\
506   Example:\n\n\
507   \t0xff3b0214::Rt_map\n\
508   \tRt_map located at: 0xff3b0214\n\
509   \t      NAME: prog\n\
510   \t  PATHNAME: /home/developer/bin/prog\n\
511   \t      ADDR: 0x00010000         DYN: 0x00020b1\n\
512   \t      NEXT: 0xff3b065c        PREV: 0x0000000\n\
513   \t       FCT: 0xff3f6080    TLSMODID:         0\n\
514   \t      INIT: 0x00010960        FINI: 0x000109b\n\
515   \t      .....\n"
516
517#
518# Bind messages.
519#
520
521@ MSG_BND_STR		"Bind"
522
523@ MSG_BND_DCD		"Display a Binding Descriptor"
524
525@ MSG_BND_TITLE		"Binding descriptor located at: 0x%0?p\n"
526@ MSG_BND_LINE1		"   caller: 0x%0?p    %s\n"
527@ MSG_BND_LINE2		"   depend: 0x%0?p    %s\n"
528@ MSG_BND_LINE3		"    flags: 0x%08x    [ %#b ]\n"
529
530@ MSG_BND_HELP		"\
531   Decode the binding descriptor specified by addr.\n\
532   \n\
533   Relationships between Rt_map objects are maintained by a binding dis-\n\
534   cripter.  The descriptor contains a pointer to the Rt_map of the caller,\n\
535   a pointer to the Rt_map of the dependency, and a flags field indicating\n\
536   the relationship between the two Rt_map objects.\n\
537   \n\
538   The -v option expands each Rt_map.\n\
539   \n\
540   Example:\n\n\
541   \t> 0xff3b0410::Bind\n\
542   \tBinding Descriptor located at: 0xff3b0410\n\
543   \t   caller: 0xff3b0030    main\n\
544   \t   depend: 0xff3b0460    /lib/libelf.so.1\n\
545   \t    flags: 0x00000001    [ NEEDED ]\n"
546
547
548#
549# Depends messages.
550#
551
552@ MSG_DEPENDS_STR	"Depends"
553
554@ MSG_DEPENDS_DCD	"Display Rt_map DEPENDS binding descriptors"
555
556@ MSG_DEPENDS_LINE1	"DEPENDS for %s\n"
557@ MSG_DEPENDS_LINE2	"  Depends: 0x%0?p APlist[used %u: total %u]\n"
558
559@ MSG_DEPENDS_HELP	"\
560   Display the binding descriptor list of DEPENDS() of the Rt_map\n\
561   specified by addr.  A DEPENDS() entry consists of an APlist\n\
562   defining each dependency.\n\
563   \n\
564   The -v option walks the APlist descriptor displaying each dependency.\n\
565   \n\
566   Example:\n\n\
567   \t> 0xff3b0554::Depends -v\n\
568   \tDEPENDS for /lib/libc.so.1\n\
569   \t----------------------------------------------\n\
570   \t  Depends: 0xff3b0bc4 APlist[used 2: total 4]\n\
571   \t    ----------------------------------------------\n\
572   \t    Binding descriptor located at: 0xff3b08f8\n\
573   \t       caller: 0xff3b0554    /lib/libc.so.1\n\
574   \t       depend: 0xff3b0938    /lib/libdl.so.1\n\
575   \t        flags: 0x00000003    [ NEEDED,REFERENCED ]\n\
576   \t    ----------------------------------------------\n\
577   \t    Binding descriptor located at: 0xff3b07a8\n\
578   \t       caller: 0xff3b0554    /lib/libc.so.1\n\
579   \t       depend: 0xff3f7cc0    /lib/ld.so.1\n\
580   \t        flags: 0x00000002    [ REFERENCED ]\n"
581
582#
583# Callers messages.
584#
585
586@ MSG_CALLERS_STR	"Callers"
587
588@ MSG_CALLERS_DCD	"Display Rt_map CALLERS binding descriptors"
589
590@ MSG_CALLERS_LINE1	"CALLERS for %s\n"
591@ MSG_CALLERS_LINE2	"  Callers: 0x%0?p APlist[used %u: total %u]\n"
592
593@ MSG_CALLERS_HELP	"\
594   Display the binding descriptor list of CALLERS() of the Rt_map\n\
595   specified by addr.  A CALLERS() entry consists of an APlist\n\
596   defining each caller.\n\
597   \n\
598   The -v option walks the APlist descriptor displaying each caller.\n\
599   \n\
600   Example:\n\n\
601   \t> 0xff3b0554::Callers -v\n\
602   \tCALLERS for /lib/libc.so.1\n\
603   \t----------------------------------------------\n\
604   \t  Callers: 0xff3b08cc APlist[used 1: total 4]\n\
605   \t    ----------------------------------------------\n\
606   \t    Binding descriptor located at: 0xff3b0514\n\
607   \t       caller: 0xff3b0214    a.out\n\
608   \t       depend: 0xff3b0554    /lib/libc.so.1\n\
609   \t        flags: 0x00000003    [ NEEDED,REFERENCED ]\n"
610
611
612#
613# Handle messages.
614#
615
616@ MSG_HANDLES_STR	"Handles"
617
618@ MSG_HANDLES_DCD	"Display Rt_map HANDLES group descriptors"
619
620@ MSG_HANDLES_LINE1	"HANDLES for %s\n"
621@ MSG_HANDLES_LINE2	"  HANDLE: 0x%0?p APlist[used %u: total %u]\n"
622
623@ MSG_HANDLES_HELP	"\
624   Display the list of HANDLES() that the Rt_map, specified by addr, is the\n\
625   owner of.  A HANDLES() entry consists of an APlist of Grp_hdl descriptors.\n\
626   See GrpHdl.  Each Grp_hdl() consists of an APlist of Grp_desc descriptors\n\
627   that define each caller.  See GrpDesc.\n\
628   \n\
629   The -v option walks all APlists displaying each member of the handle.\n\
630   \n\
631   Example:\n\n\
632   \t> 0xff3b0f6c::Handles -v\n\
633   \tHANDLES for ./sub.so\n\
634   \t----------------------------------------------\n\
635   \t  HANDLE: 0xff3b1310 APlist[used 1: total 1]\n\
636   \t    ----------------------------------------------\n\
637   \t    Group Handle located at: 0xff3b1270\n\
638   \t    ----------------------------------------------\n\
639   \t       owner:               ./sub.so\n\
640   \t       flags: 0x00000000    [ 0 ]\n\
641   \t      refcnt:          1    depends: 0xff3b12c8 Alist[used 3: total 4]\n\
642   \t       ----------------------------------------------\n\
643   \t       Group Descriptor located at: 0xff3b12d4\n\
644   \t          depend: 0xff3b0f6c    ./sub.so\n\
645   \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
646   \t       ----------------------------------------------\n\
647   \t       Group Descriptor located at: 0xff3b12dc\n\
648   \t          depend: 0xff3b0a04    /lib/libc.so.1\n\
649   \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
650   \t       ----------------------------------------------\n\
651   \t       Group Descriptor located at: 0xff3b12e4\n\
652   \t          depend: 0xff3b065c    /lib/libdl.so.1\n\
653   \t           flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
654
655#
656# Group messages.
657#
658
659@ MSG_GROUPS_STR	"Groups"
660
661@ MSG_GROUPS_DCD	"Display Rt_map GROUPS group handles"
662
663@ MSG_GROUPS_LINE1	"GROUPS for %s\n"
664@ MSG_GROUPS_LINE2	"  Groups: 0x%0?p APlist[used %u: total %u]\n"
665
666@ MSG_GROUPS_HELP	"\
667   Display the list of GROUPS() that the Rt_map, specified by addr, is a \
668   member\nof.  A GROUPS() entry consists of an APlist of Grp_hdl entries.  \
669   See GrpHdl.\n\
670   \n\
671   The -v option walks the APlist descriptor displaying each member of the\n\
672   handle.\n\
673   \n\
674   Example:\n\n\
675   \t> 0xff3b0f6c::Groups -v\n\
676   \tGROUPS for ./sub.so\n\
677   \t----------------------------------------------\n\
678   \t  Groups: 0xff3b12a8 APlist[used 1: total 1]\n\
679   \t    ----------------------------------------------\n\
680   \t    Group Handle located at: 0xff3b1270\n\
681   \t    ----------------------------------------------\n\
682   \t        owner:               ./sub.so\n\
683   \t        flags: 0x00000000    [ 0 ]\n\
684   \t       refcnt:          1    depends: 0xff3b12c8 Alist[used 3: total 4]\n\
685   \t        ----------------------------------------------\n\
686   \t        Group Descriptor located at: 0xff3b12d4\n\
687   \t           depend: 0xff3b0f6c    ./sub.so\n\
688   \t            flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
689   \t        ----------------------------------------------\n\
690   \t        Group Descriptor located at: 0xff3b12dc\n\
691   \t           depend: 0xff3b0a04    /lib/libc.so.1\n\
692   \t            flags: 0x00000004    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n\
693   \t        ----------------------------------------------\n\
694   \t        Group Descriptor located at: 0xff3b12e4\n\
695   \t           depend: 0xff3b065c    /lib/libdl.so.1\n\
696   \t            flags: 0x00000004    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
697
698
699#
700# Group handle and group descriptor messages.
701#
702
703@ MSG_GRPHDL_STR	"GrpHdl"
704
705@ MSG_GRPHDL_DCD	"Display a Group Handle"
706
707@ MSG_GRPHDL_LINE1	"Group Handle located at: 0x%0?p\n"
708@ MSG_GRPHDL_LINE2	"    owner:               %s\n"
709@ MSG_GRPHDL_LINE3	"    flags: 0x%08x    [ %#b ]\n"
710@ MSG_GRPHDL_LINE4	"   refcnt:   %8d    depends: 0\n"
711@ MSG_GRPHDL_LINE5	"   refcnt:   %8d    depends: 0x%0?p \
712			 Alist[used %u: total %u]\n"
713
714@ MSG_GRPHDL_HELP	"\
715   Decode a group handle.  A successful dlopen() of an object returns a\n\
716   handle applicable for subsequent dlsym() requests.  The handle maintains\n\
717   a reference count, flags and a table of group descriptors that define the\n\
718   dependencies associated with this group of objects.\n\
719   \n\
720   The -v option expands each group descriptor.\n\
721   \n\
722   Example:\n\n\
723   \t> 0xff3a0c58::GrpHdl\n\
724   \tGroup Handle located at: 0xff3a0c58\n\
725   \t----------------------------------------------\n\
726   \t   refcnt:          1    main\n\
727   \t    flags: 0x00000001    [ DLOPEN-ZERO ]\n\
728   \t  depends: 0xff3a0c89 Alist[next 1: cnt 2]\n"
729
730
731
732@ MSG_GRPDESC_STR	"GrpDesc"
733
734@ MSG_GRPDESC_DCD	"Display a Group Descriptor"
735
736@ MSG_GRPDESC_LINE1	"Group Descriptor located at: 0x%0?p\n"
737@ MSG_GRPDESC_LINE2	"   depend: 0x%0?p    %s\n"
738@ MSG_GRPDESC_LINE3	"    flags: 0x%08x    [ %#b ]\n"
739
740@ MSG_GRPDESC_HELP	"\
741   Decode a group descriptor.  A GrpHdl created by dlopen() maintains a\n\
742   list of group descriptors for each dependency.  See GrpHdl.\n\
743   \n\
744   Example\n\n\
745   \t> 0xff3b12d4::GrpDesc -v\n\
746   \tGroup Descriptor located at: 0xff3b12d4\n\
747   \t   depend: 0xff3b0f6c    ./sub.so\n\
748   \t    flags: 0x00000003    [ AVAIL-TO-DLSYM,ADD-DEPENDENCIES ]\n"
749
750
751@ MSG_BNDDESC_STR	"BndDesc"
752
753#
754# General purpose environment addition.
755#
756
757@ MSG_SETENV_STR	"Setenv"
758
759@ MSG_SETENV_DCD	"Set an environment variable"
760
761@ MSG_SETENV_HELP	"\
762   Set the associated environment variable.  This can be useful to establish\n\
763   runtime linker environment variables without affecting the debugger itself.\n\
764   \n\
765   Note, newer versions of mdb(1) provide setenv.  The mdb(1) implementation\n\
766   provides the ability to make environment changes at any point during\n\
767   application monitoring.  Where available, Setenv calls through to setenv.\n\
768   On older environments, Setenv only provides for changing the applications\n\
769   environment before it is invoked.\n\
770   \n\
771   Example\n\n\
772   \t> ::Setenv LD_DEBUG=files\n"
773