xref: /illumos-gate/usr/src/cmd/sgs/elfedit/modules/common/dyn.msg (revision 89a7715a55deca73d03076f5c24463717f0aaa91)
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# ident	"%Z%%M%	%I%	%E% SMI"
27
28
29@ _START_
30
31# Message file for elfedit 'dyn' module
32
33@ MSG_ID_ELFEDIT_DYN
34
35
36# Strings
37@ MSG_STR_DEPRECATED	"(deprecated value)"
38
39# Debug messages
40
41@ MSG_DEBUG_S_OK	"[%d: %s][%d]: value unchanged: %s\n"
42@ MSG_DEBUG_S_CHG	"[%d: %s][%d]: change from %s to %s\n"
43@ MSG_DEBUG_X_OK	"[%d: %s][%d]: value unchanged: %#llx\n"
44@ MSG_DEBUG_X_CHG	"[%d: %s][%d]: change from %#llx to %#llx\n"
45@ MSG_DEBUG_PREVRPATH	"[%d: %s][%d]: Reusing existing %s entry: %s\n"
46@ MSG_DEBUG_OLDRPATHOK	"[%d: %s][%d]: Existing %s already has desired \
47			 value\n"
48@ MSG_DEBUG_CONVNULL	"[%d: %s][%d]: No existing %s to modify. Converting \
49			 extra DT_NULL\n"
50@ MSG_DEBUG_DT2NDX	"[%d: %s][%d]: Dynamic entry for tag: %s\n"
51@ MSG_DEBUG_NULCLIP	"[%d: %s][%d]: ELF warning: null element will cause \
52			 the runtime linker to ignore the non-null \
53			 elements that follow: %s\n"
54@ MSG_DEBUG_NULHIDE	"[%d: %s][%d]: ELF warning: this non-null element \
55			 follows the first DT_NULL element, and will be \
56			 ignored by the runtime linker: %s\n"
57@ MSG_DEBUG_NULLTERM	"[%d: %s][%d]: ELF warning: dynamic section is \
58			 must be terminated by a DT_NULL. The runtime linker \
59			 will be unable to use this object: %s\n"
60@ MSG_DEBUG_DTNULLVALUE	"[%d: %s][%d]: ELF warning: DT_NULL element value \
61			 is expected to be 0: %#llx\n"
62
63
64# Errors
65
66@ MSG_ERR_NODTELT	"[%d: %s]: Dynamic section does not contain tag: %s\n"
67@ MSG_ERR_NOEXTRANULL	"[%d: %s]: Dynamic section does not have room to add \
68			 a new element\n"
69@ MSG_ERR_NORUNPATH	"[%d: %s]: no runpath (DT_RPATH or DT_RUNPATH) found\n"
70@ MSG_ERR_NODYNELT	"[%d: %s]: no elements of type %s found\n"
71@ MSG_ERR_STRPADSTRVAL	"[%d: %s]: -s option cannot be used with \
72			 DT_SUNW_STRPAD dynamic element\n"
73
74
75# Module description
76
77@ MSG_MOD_DESC		"Dynamic Section"
78
79
80
81# 1-line description strings
82
83@ MSG_DESC_DUMP		"Dump Dynamic Section"
84@ MSG_DESC_TAG		"Change element tag"
85@ MSG_DESC_VALUE	"Change element value"
86@ MSG_DESC_DELETE	"Delete elements"
87@ MSG_DESC_MOVE		"Move elements"
88@ MSG_DESC_RUNPATH	"Set runpath"
89@ MSG_DESC_POSFLAG1	"DT_POSFLAG_1 bit values"
90@ MSG_DESC_FLAGS	"DT_FLAGS bit values"
91@ MSG_DESC_FLAGS1	"DT_FLAGS_1 bit values"
92@ MSG_DESC_FEATURE1	"DT_FEATURE_1 bit values"
93@ MSG_DESC_CHECKSUM	"Recompute DT_CHECKSUM"
94
95
96# Commmand option description strings
97
98@ MSG_OPTDESC_ADD	"\
99   By default, dyn:value modifies the first element of the\n\
100   dynamic section that has the specified tag type, creating\n\
101   a new element only if no element of the specified type\n\
102   exists, and if room exists in the file. If -add is specified,\n\
103   dyn:value will always create a new element for the new value,\n\
104   leaving any existing elements with the same tag untouched.\n"
105
106@ MSG_OPTDESC_S		"\
107   Interpret the value argument as a string rather than an\n\
108   integer. If the specified string already exists in the dynamic\n\
109   string table, the offset of that string is stored in the\n\
110   dynamic entry. If the string does not exist in the string table,\n\
111   but there is room to add it, the new string is added and then\n\
112   the offset is placed in the dynamic entry.\n"
113
114@ MSG_OPTDESC_DYNNDX		"\
115   Interpret the elt argument as a direct index into the dynamic\n\
116   section, rather than as a DT_ tag value.\n"
117
118
119# Command argument description strings
120
121@ MSG_A1_TAG_ELT	"\
122   Dynamic element to be examined or changed. By default, this\n\
123   is a DT_ tag value. The index of the first element in the\n\
124   dynamic section that has the specified tag value will be used.\n\
125   The value specified can be one of the well known DT_ constants,\n\
126   or any integer.\n\
127   \n\
128   If the -dynndx option is specified, elt is instead interpreted\n\
129   as a simple integer index into the dynamic section.\n"
130
131@ MSG_A2_TAG_VALUE	"\
132   Value to be set for d_tag field of specified dynamic\n\
133   element. Tag values can be specified using the well known\n\
134   DT_ symbolic constants from /usr/include/sys/link.h, or\n\
135   as integers.\n"
136
137@ MSG_ARGDESC_ELT	"\
138   Element within dynamic section. By default, this is a tag\n\
139   value. In this case, the index of the first dynamic element\n\
140   with the specified tag value will be used. Tag values can\n\
141   be specified using the well known DT_ symbolic constants from\n\
142   /usr/include/sys/link.h, or as integers. If the -dynndx\n\
143   option is specified, then elt is instead interpreted as a\n\
144   direct numeric index into the dynamic section.\n"
145
146@ MSG_A2_VALUE_VALUE	"\
147   Value to set for specified dynamic section element. By\n\
148   default, this is a numeric value which is used directly.\n\
149   If the -s option is used, this is a string value, and the\n\
150   dynamic element will receive the numeric offset of the\n\
151   specified string from within the associated dynamic string\n\
152   table.\n"
153
154@ MSG_A2_DELETE_COUNT	"\
155   Number of dynamic elements to delete, starting at the\n\
156   specified position. This value cannot exceed the number\n\
157   of slots remaining in the table below the specified position.\n\
158   If count is not supplied, a single element is deleted.\n"
159
160@ MSG_A2_MOVE_DST_INDEX	"\
161   Numeric index within dynamic section to which the element(s)\n\
162   should be moved.\n"
163
164@ MSG_A3_MOVE_COUNT	"\
165   Number of dynamic elements to move. This value cannot\n\
166   exceed the number of slots remaining in the table below\n\
167   the specified position. If count is not supplied, a\n\
168   single element is moved.\n"
169
170@ MSG_A1_RUNPATH_NEWPATH	"\
171   New runpath string for the ELF object.\n"
172
173@ MSG_A1_POSFLAG1_VALUE "\
174   Position dependent state flags which are applied to the\n\
175   element immediately following. This can be an integer\n\
176   value, or any of the DF_P1_ symbolic constants defined\n\
177   in /usr/include/sys/link.h\n"
178
179@ MSG_A1_FLAGS_VALUE	"\
180   Flag values. This can be an integer value, or any of the\n\
181   DF_ symbolic constants defined in /usr/include/sys/link.h\n"
182
183@ MSG_A1_FLAGS1_VALUE	"\
184   Flag values. This can be an integer value, or any of the\n\
185   DF_1_ symbolic constants defined in /usr/include/sys/link.h\n"
186
187@ MSG_A1_FEATURE1_VALUE	"\
188   Feature values. This can be an integer value, or any of\n\
189   the DTF_1_ symbolic constants defined in\n\
190   /usr/include/sys/link.h\n"
191
192
193# Help strings
194
195@ MSG_HELP_DUMP	"   \
196   The dyn:dump command is used to display the contents of the\n\
197   dynamic section using the same style used by the elfdump program.\n"
198
199@ MSG_HELP_TAG	"   \
200   The dyn:tag command is used to display or alter the\n\
201   type of an element in the dynamic section. This information\n\
202   is found in the d_tag field of a dynamic element.\n\
203   \n\
204   If dyn:tag is called without arguments, the value of d_tag\n\
205   for every element in the dynamic section is shown. If called\n\
206   with the elt argument, the specified elements are displayed.\n\
207   If both arguments are present, the d_tag field of the specified\n\
208   dynamic element is set to the given value.\n"
209
210@ MSG_HELP_VALUE	"   \
211   The dyn:value command is used to display or alter the\n\
212   value of an element in the dynamic section, or to add\n\
213   a new element of a desired type. The value of a dynamic\n\
214   element is found in the d_un union of the element.\n\
215   \n\
216   If dyn:value is called without arguments, the value of every\n\
217   element in the dynamic section is shown. If called with the\n\
218   elt argument, the value of the specified elements are displayed.\n\
219   If both arguments are present, the value of the specified\n\
220   dynamic element is set to the given value.\n"
221
222@ MSG_HELP_DELETE	"   \
223   The dyn:delete command is used to delete one or more elements\n\
224   in the dynamic section. The elements following the deleted\n\
225   items move up, and new DT_NULL elements are inserted at the\n\
226   end of the dynamic section to fill the vacated space.\n\
227   \n\
228   Other parts of the ELF object may have dependencies on the\n\
229   position and values of existing dynamic elements. Moving or\n\
230   deleting dynamic elements can therefore break the object,\n\
231   and should be done with caution. Among the potential issues:\n\
232   \n\
233   o\tDT_POSFLAG_1 has a positional dependency on the item that\n\
234   \tfollows it. If that item is removed, the DT_POSFLAG_1 will\n\
235   \tapply to the new item that moves below it.\n\
236   \n\
237   o\tSyminfo sections reference DT_NEEDED elements in the dynamic\n\
238   \tsection by index. Moving or deleting such elements will break\n\
239   \tthis dependency.\n"
240
241@ MSG_HELP_MOVE	"   \
242   The dyn:move command is used to move the position of one\n\
243   or more elements in the dynamic section. The specified\n\
244   number of elements are moved from elt to dst_index.\n\
245   \n\
246   Other parts of the ELF object may have dependencies on the\n\
247   position and values of existing dynamic elements. Moving or\n\
248   deleting dynamic elements can therefore break the object,\n\
249   and should be done with caution. Among the potential issues:\n\
250   \n\
251   o\tDT_POSFLAG_1 has a positional dependency on the item that\n\
252   \tfollows it. If that item is removed, the DT_POSFLAG_1 will\n\
253   \tapply to the new item that moves below it.\n\
254   \n\
255   o\tSyminfo sections reference DT_NEEDED elements in the dynamic\n\
256   \tsection by index. Moving or deleting such elements will break\n\
257   \tthis dependency.\n"
258
259@ MSG_HELP_RUNPATH	"   \
260   The dyn:runpath command is used to display or alter the\n\
261   runpath of the ELF object.\n\
262   \n\
263   If dyn:runpath is called without arguments, the existing runpath\n\
264   is shown. If called with the newpath argument, the runpath is set\n\
265   to the given string, if possible.\n\
266   \n\
267   Not all files can be modified to have a new runpath:\n\
268   \n\
269   o\tThe desired string must already exist in the dynamic string\n\
270   \ttable, or there must be enough room in the reserved section\n\
271   \tsection at the end (DT_SUNW_STRPAD) for the new string to be\n\
272   \tadded.\n\
273   \n\
274   o\tThe dynamic section must already have a DT_RPATH or DT_RUNPATH\n\
275   \telement, or there must be an extra DT_NULL slot at the end\n\
276   \twhere a DT_RUNPATH can be inserted.\n\
277   \n\
278   If the file has both DT_RPATH and DT_RUNPATH elements in\n\
279   the dynamic section, both are set to the new value. If no\n\
280   runpath entry exists, a new DT_RUNPATH is inserted if the room\n\
281   for it exists.\n"
282
283@ MSG_HELP_POSFLAG1	"   \
284   The dyn:posflag1 command is used to display or alter the\n\
285   DT_POSFLAG_1 flags values.\n\
286   \n\
287   If dyn:posflag1 is called without arguments, the current\n\
288   value is shown. If one or more value arguments are present,\n\
289   the following steps are taken:\n\
290   \n   \
291   o\tAll the value arguments are OR'd together.\n\
292   \n   \
293   o\tIf the -cmp option has been specified, the new value\n\
294   \tis complemented.\n\
295   \n   \
296   o\tThe DT_POSFLAG_1 element of the dynamic section is updated\n\
297   \twith the new value. If -and is specified, the new value is\n\
298   \tAND'd against the existing value. If -or is specified,\n\
299   \tthe new value is OR'd against the existing value. If\n\
300   \tneither -and or -or are specified, the new value replaces\n\
301   \tthe existing value.\n\
302   \n\
303   If the current dynamic section does not have a current\n\
304   DT_POSFLAG_1 element, and room for it exists at the end\n\
305   of the section, a new one is inserted.\n"
306
307@ MSG_HELP_FLAGS	"   \
308   The dyn:flags command is used to display or alter the\n\
309   value of the DT_FLAGS dynamic element.\n\
310   \n\
311   If dyn:flags is called without arguments, the current\n\
312   value is shown. If one or more value arguments are present,\n\
313   the following steps are taken:\n\
314   \n   \
315   o\tAll the value arguments are OR'd together.\n\
316   \n   \
317   o\tIf the -cmp option has been specified, the new value\n\
318   \tis complemented.\n\
319   \n   \
320   o\tThe DT_FLAGS element of the dynamic section is updated\n\
321   \twith the new value. If -and is specified, the new value is\n\
322   \tAND'd against the existing value. If -or is specified,\n\
323   \tthe new value is OR'd against the existing value. If\n\
324   \tneither -and or -or are specified, the new value replaces\n\
325   \tthe existing value.\n\
326   \n\
327   If the current dynamic section does not have a current\n\
328   DT_FLAGS element, and room for it exists at the end\n\
329   of the section, a new one is inserted.\n"
330
331@ MSG_HELP_FLAGS1	"   \
332   The dyn:flags1 command is used to display or alter the\n\
333   value of the DT_FLAGS_1 dynamic element.\n\
334   \n\
335   If dyn:flags1 is called without arguments, the current\n\
336   value is shown. If one or more value arguments are present,\n\
337   the following steps are taken:\n\
338   \n   \
339   o\tAll the value arguments are OR'd together.\n\
340   \n   \
341   o\tIf the -cmp option has been specified, the new value\n\
342   \tis complemented.\n\
343   \n   \
344   o\tThe DT_FLAGS_1 element of the dynamic section is updated\n\
345   \twith the new value. If -and is specified, the new value is\n\
346   \tAND'd against the existing value. If -or is specified,\n\
347   \tthe new value is OR'd against the existing value. If\n\
348   \tneither -and or -or are specified, the new value replaces\n\
349   \tthe existing value.\n\
350   \n\
351   If the current dynamic section does not have a current\n\
352   DT_FLAGS_1 element, and room for it exists at the end\n\
353   of the section, a new one is inserted.\n"
354
355@ MSG_HELP_FEATURE1	"   \
356   The dyn:feature1 command is used to display or alter the\n\
357   value of the DT_FEATURE_1 dynamic element.\n\
358   \n\
359   If dyn:feature1 is called without arguments, the current\n\
360   value is shown. If one or more value arguments are present,\n\
361   the following steps are taken:\n\
362   \n   \
363   o\tAll the value arguments are OR'd together.\n\
364   \n   \
365   o\tIf the -cmp option has been specified, the new value\n\
366   \tis complemented.\n\
367   \n   \
368   o\tThe DT_FEATURE_1 element of the dynamic section is updated\n\
369   \twith the new value. If -and is specified, the new value is\n\
370   \tAND'd against the existing value. If -or is specified,\n\
371   \tthe new value is OR'd against the existing value. If\n\
372   \tneither -and or -or are specified, the new value replaces\n\
373   \tthe existing value.\n\
374   \n\
375   If the current dynamic section does not have a current\n\
376   DT_FEATURE_1 element, and room for it exists at the end\n\
377   of the section, a new one is inserted.\n"
378
379@ MSG_HELP_CHECKSUM	"   \
380   The dyn:checksum command recomputes the value of the DT_CHECKSUM\n\
381   dynamic element. It calls the elf32_checksum() for 32-bit objects,\n\
382   or elf64_checksum() for 64-bit objects, and then sets the value of\n\
383   the DT_CHECKSUM element to the resulting value.\n\
384   \n\
385   If the current dynamic section does not have a current\n\
386   DT_CHECKSUM element, and room for it exists at the end\n\
387   of the section, a new one is inserted.\n"
388
389@ _END_
390
391
392# The following strings represent reserved words, files, pathnames and symbols.
393# Reference to this strings is via the MSG_ORIG() macro, and thus no message
394# translation is required.
395
396
397# Strings
398@ MSG_STR_EMPTY		""
399@ MSG_STR_COUNT		"count"
400@ MSG_STR_ELT		"elt"
401@ MSG_STR_DST_INDEX	"dst_index"
402@ MSG_STR_MINUS_ADD	"-add"
403@ MSG_STR_MINUS_DYNNDX	"-dynndx"
404@ MSG_STR_MINUS_S	"-s"
405@ MSG_STR_NEWPATH	"newpath"
406@ MSG_STR_VALUE		"value"
407
408# Format strings
409@ MSG_FMT_STRNL		"%s\n"
410@ MSG_FMT_HEXXWORDNL	"%#llx\n"
411
412
413# Module name
414
415@ MSG_MOD_NAME		"dyn"
416
417
418# Command names
419
420@ MSG_CMD_DUMP		"dump"
421@ MSG_CMD_TAG		"tag"
422@ MSG_CMD_VALUE		"value"
423@ MSG_CMD_DELETE	"delete"
424@ MSG_CMD_MOVE		"move"
425@ MSG_CMD_RUNPATH	"runpath"
426@ MSG_CMD_RUNPATH_A1	"rpath"
427@ MSG_CMD_POSFLAG1	"posflag1"
428@ MSG_CMD_FLAGS		"flags"
429@ MSG_CMD_FLAGS1	"flags1"
430@ MSG_CMD_FEATURE1	"feature1"
431@ MSG_CMD_CHECKSUM	"checksum"
432