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