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