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