Lines Matching refs:the
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.
8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 # See the License for the specific language governing permissions
11 # and limitations under the License.
14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 # If applicable, add the following below this CDDL HEADER, with the
52 the runtime linker to ignore the non-null \
55 follows the first DT_NULL element, and will be \
56 ignored by the runtime linker: %s\n"
102 By default, dyn:value modifies the first element of the\n\
103 dynamic section that has the specified tag type, creating\n\
104 a new element only if no element of the specified type\n\
105 exists, and if room exists in the file. If -add is specified,\n\
106 dyn:value will always create a new element for the new value,\n\
107 leaving any existing elements with the same tag untouched.\n"
110 Interpret the value argument as a string rather than an\n\
111 integer. If the specified string already exists in the dynamic\n\
112 string table, the offset of that string is stored in the\n\
113 dynamic entry. If the string does not exist in the string table,\n\
114 but there is room to add it, the new string is added and then\n\
115 the offset is placed in the dynamic entry.\n"
118 Interpret the elt argument as a direct index into the dynamic\n\
122 Use the dynamic element with the specified index.\n"
125 Select the first DT_POSFLAG_1 dynamic element that corresponds\n\
126 to the DT_NEEDED element with a value that starts with the\n\
127 string given by prefix. If present, the DT_POSFLAG_1 element\n\
128 will be in the dynamic element directly in front of the\n\
136 is a DT_ tag value. The index of the first element in the\n\
137 dynamic section that has the specified tag value will be used.\n\
138 The value specified can be one of the well known DT_ constants,\n\
141 If the -dynndx option is specified, elt is instead interpreted\n\
142 as a simple integer index into the dynamic section.\n"
146 element. Tag values can be specified using the well known\n\
152 value. In this case, the index of the first dynamic element\n\
153 with the specified tag value will be used. Tag values can\n\
154 be specified using the well known DT_ symbolic constants from\n\
155 /usr/include/sys/link.h, or as integers. If the -dynndx\n\
157 direct numeric index into the dynamic section.\n"
162 If the -s option is used, this is a string value, and the\n\
163 dynamic element will receive the numeric offset of the\n\
164 specified string from within the associated dynamic string\n\
168 Number of dynamic elements to delete, starting at the\n\
169 specified position. This value cannot exceed the number\n\
170 of slots remaining in the table below the specified position.\n\
174 Numeric index within dynamic section to which the element(s)\n\
179 exceed the number of slots remaining in the table below\n\
180 the specified position. If count is not supplied, a\n\
184 New runpath string for the ELF object.\n"
187 Position dependent state flags which are applied to the\n\
189 value, or any of the DF_P1_ symbolic constants defined\n\
193 Flag values. This can be an integer value, or any of the\n\
197 Flag values. This can be an integer value, or any of the\n\
202 the DTF_1_ symbolic constants defined in\n\
206 Machine type of link-editor that built the object being edited.\n\
207 This can be an integer value, or any of the EM_ symbolic\n\
214 The dyn:dump command is used to display the contents of the\n\
215 dynamic section using the same style used by the elfdump program.\n"
218 The dyn:tag command is used to display or alter the\n\
219 type of an element in the dynamic section. This information\n\
220 is found in the d_tag field of a dynamic element.\n\
222 If dyn:tag is called without arguments, the value of d_tag\n\
223 for every element in the dynamic section is shown. If called\n\
224 with the elt argument, the specified elements are displayed.\n\
225 If both arguments are present, the d_tag field of the specified\n\
226 dynamic element is set to the given value.\n"
229 The dyn:value command is used to display or alter the\n\
230 value of an element in the dynamic section, or to add\n\
232 element is found in the d_un union of the element.\n\
234 If dyn:value is called without arguments, the value of every\n\
235 element in the dynamic section is shown. If called with the\n\
236 elt argument, the value of the specified elements are displayed.\n\
237 If both arguments are present, the value of the specified\n\
238 dynamic element is set to the given value.\n"
242 in the dynamic section. The elements following the deleted\n\
243 items move up, and new DT_NULL elements are inserted at the\n\
244 end of the dynamic section to fill the vacated space.\n\
246 Other parts of the ELF object may have dependencies on the\n\
248 deleting dynamic elements can therefore break the object,\n\
249 and should be done with caution. Among the potential issues:\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\
255 o\tSyminfo sections reference DT_NEEDED elements in the dynamic\n\
260 The dyn:move command is used to move the position of one\n\
261 or more elements in the dynamic section. The specified\n\
264 Other parts of the ELF object may have dependencies on the\n\
266 deleting dynamic elements can therefore break the object,\n\
267 and should be done with caution. Among the potential issues:\n\
269 o\tDT_POSFLAG_1 has a positional dependency on the item that\n\
270 \tfollows it. If that item is removed, the DT_POSFLAG_1 will\n\
271 \tapply to the new item that moves below it.\n\
273 o\tSyminfo sections reference DT_NEEDED elements in the dynamic\n\
278 The dyn:runpath command is used to display or alter the\n\
279 runpath of the ELF object.\n\
281 If dyn:runpath is called without arguments, the existing runpath\n\
282 is shown. If called with the newpath argument, the runpath is set\n\
283 to the given string, if possible.\n\
287 o\tThe desired string must already exist in the dynamic string\n\
288 \ttable, or there must be enough room in the reserved section\n\
289 \tsection at the end (DT_SUNW_STRPAD) for the new string to be\n\
293 \telement, or there must be an extra DT_NULL slot at the end\n\
296 If the file has both DT_RPATH and DT_RUNPATH elements in\n\
297 the dynamic section, both are set to the new value. If no\n\
298 runpath entry exists, a new DT_RUNPATH is inserted if the room\n\
304 dynamic element that affects the interpretation of the item\n\
306 using the default output style, dyn:posflag1 also displays the\n\
309 If dyn:posflag1 is called without arguments, the current\n\
311 to display the value of a single specific DT_POSFLAG_1 element\n\
312 by using the -dynndx or -needed option to specify it.\n\
314 If one or more value arguments are present, the default is to\n\
315 modify the first DT_POSFLAG_1 element. The -dynndx or -needed\n\
317 instead. The following steps are taken to compute the new value:\n\
319 o\tAll the value arguments are OR'd together.\n\
321 o\tIf the -cmp option has been specified, the new value\n\
324 o\tThe DT_POSFLAG_1 element is updated with the new value.\n\
325 \tIf -and is specified, the new value is AND'd against the\n\
326 \texisting value. If -or is specified, the new value is OR'd\n\
327 \tagainst the existing value. If neither -and or -or are\n\
328 \tspecified, the new value replaces the existing value.\n\
330 A new DT_POSFLAG_1 element is inserted in the dynamic section\n\
331 when all of the following are true:\n\
340 o\tThere is available space at the end of the dynamic section.\n"
343 The dyn:flags command is used to display or alter the\n\
344 value of the DT_FLAGS dynamic element.\n\
346 If dyn:flags is called without arguments, the current\n\
348 the following steps are taken:\n\
350 o\tAll the value arguments are OR'd together.\n\
352 o\tIf the -cmp option has been specified, the new value\n\
355 o\tThe DT_FLAGS element of the dynamic section is updated\n\
356 \twith the new value. If -and is specified, the new value is\n\
357 \tAND'd against the existing value. If -or is specified,\n\
358 \tthe new value is OR'd against the existing value. If\n\
359 \tneither -and or -or are specified, the new value replaces\n\
362 If the current dynamic section does not have a current\n\
363 DT_FLAGS element, and room for it exists at the end\n\
364 of the section, a new one is inserted.\n"
367 The dyn:flags1 command is used to display or alter the\n\
368 value of the DT_FLAGS_1 dynamic element.\n\
370 If dyn:flags1 is called without arguments, the current\n\
372 the following steps are taken:\n\
374 o\tAll the value arguments are OR'd together.\n\
376 o\tIf the -cmp option has been specified, the new value\n\
379 o\tThe DT_FLAGS_1 element of the dynamic section is updated\n\
380 \twith the new value. If -and is specified, the new value is\n\
381 \tAND'd against the existing value. If -or is specified,\n\
382 \tthe new value is OR'd against the existing value. If\n\
383 \tneither -and or -or are specified, the new value replaces\n\
386 If the current dynamic section does not have a current\n\
387 DT_FLAGS_1 element, and room for it exists at the end\n\
388 of the section, a new one is inserted.\n"
391 The dyn:feature1 command is used to display or alter the\n\
392 value of the DT_FEATURE_1 dynamic element.\n\
394 If dyn:feature1 is called without arguments, the current\n\
396 the following steps are taken:\n\
398 o\tAll the value arguments are OR'd together.\n\
400 o\tIf the -cmp option has been specified, the new value\n\
403 o\tThe DT_FEATURE_1 element of the dynamic section is updated\n\
404 \twith the new value. If -and is specified, the new value is\n\
405 \tAND'd against the existing value. If -or is specified,\n\
406 \tthe new value is OR'd against the existing value. If\n\
407 \tneither -and or -or are specified, the new value replaces\n\
410 If the current dynamic section does not have a current\n\
411 DT_FEATURE_1 element, and room for it exists at the end\n\
412 of the section, a new one is inserted.\n"
415 The dyn:checksum command recomputes the value of the DT_CHECKSUM\n\
416 dynamic element. It calls the elf32_checksum() for 32-bit objects,\n\
417 or elf64_checksum() for 64-bit objects, and then sets the value of\n\
418 the DT_CHECKSUM element to the resulting value.\n\
420 If the current dynamic section does not have a current\n\
421 DT_CHECKSUM element, and room for it exists at the end\n\
422 of the section, a new one is inserted.\n"
425 The dyn:sunw_ldmach command is used to display or alter the\n\
426 DT_SUNW_LDMACH dynamic element of the ELF object. This dynamic\n\
427 element records the ELF machine type of the link-editor that produced\n\
428 the object. This is of special interest if the object was built\n\
429 by a cross link-editor instead of being linked on a machine of the\n\
430 same type as the object.\n\
432 If dyn:sunw_ldmach is called without arguments, the current\n\
433 value is shown. If called with the value argument, the\n\
434 DT_SUNW_LDMACH dynamic element is set to the specified machine type.\n\
436 If the current dynamic section does not have a current\n\
437 DT_SUNW_LDMACH element, and room for it exists at the end\n\
438 of the section, a new one is inserted.\n"
444 # Reference to this strings is via the MSG_ORIG() macro, and thus no message