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