xref: /illumos-gate/usr/src/cmd/sgs/elfedit/modules/common/cap.msg (revision 27954b0d964ffcb749cf19296906e7fecdf3da1b)
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 2010 Sun Microsystems, Inc.  All rights reserved.
24# Use is subject to license terms.
25#
26
27@ _START_
28
29# Message file for elfedit 'cap' module
30
31@ MSG_ID_ELFEDIT_CAP
32
33
34# Debug messages
35
36@ MSG_DEBUG_S_OK	"[%d: %s][%d]: value unchanged: %s\n"
37@ MSG_DEBUG_S_CHG	"[%d: %s][%d]: change from %s to %s\n"
38@ MSG_DEBUG_BSB_OK	"[%d: %s][%d]: value unchanged: [%s]\n"
39@ MSG_DEBUG_BSB_CHG	"[%d: %s][%d]: change from [%s] to [%s]\n"
40@ MSG_DEBUG_X_OK	"[%d: %s][%d]: value unchanged: %#llx\n"
41@ MSG_DEBUG_X_CHG	"[%d: %s][%d]: change from %#llx to %#llx\n"
42@ MSG_DEBUG_CA2NDX	"[%d: %s][%d]: capability entry for tag: %s\n"
43@ MSG_DEBUG_CAPGRP	"[%d: %s][%u-%u: %s]: capability group\n"
44@ MSG_DEBUG_CONVNULL	"[%d: %s][%d]: no existing %s to modify, converting \
45			 extra CA_SUNW_NULL\n"
46
47# Errors
48
49@ MSG_ERR_NOCAELT	"[%d: %s][%u-%u: %s]: capabilities group does not \
50			 contain tag: %s\n"
51@ MSG_ERR_NOSTRTAB	"[%d: %s]: capabilities section does not have an \
52			 associated string table\n"
53@ MSG_ERR_BADCAPID	"[%d: %s]: capabilities section does not contain \
54			 specified id: %s\n"
55@ MSG_ERR_GRPARRBNDS	"%s[%u-%u: %s]: attempt to access elements outside \
56			 of capabilities group\n"
57
58# Module description
59
60@ MSG_MOD_DESC		"Capabilities Section"
61
62# Strings
63@ MSG_STR_OBJECT	"<object>"
64@ MSG_STR_NONAME	"<noname>"
65
66# Format strings
67@ MSG_FMT_CAPGRP	"   Group[%u-%u]: %s\n"
68
69# 1-line description strings
70
71@ MSG_DESC_DUMP		"Dump Capabilities Section"
72@ MSG_DESC_TAG		"Change element tag"
73@ MSG_DESC_VALUE	"Change element value"
74@ MSG_DESC_DELETE	"Delete elements"
75@ MSG_DESC_MOVE		"Move elements"
76@ MSG_DESC_HW1		"Hardware capabilities (CA_SUNW_HW_1) bit values"
77@ MSG_DESC_SF1		"Software capabilities (CA_SUNW_SF_1) bit values"
78@ MSG_DESC_HW2		"Hardware capabilities (CA_SUNW_HW_2) bit values"
79
80
81# Command option description strings
82
83@ MSG_OPTDESC_CAPNDX		"\
84   Interpret the elt argument as a direct index into the\n\
85   capabilities section, rather than as a CA_ tag value.\n"
86
87@ MSG_OPTDESC_CAPID		"\
88   Restrict the elt argument to the capability elements belonging\n\
89   to the capabilities group with a CA_SUNW_ID entry matching the\n\
90   specified id name.\n"
91
92@ MSG_OPTDESC_S		"\
93   Interpret the value argument as a string rather than an\n\
94   integer. If the specified string already exists in the\n\
95   string table, the offset of that string is stored in the\n\
96   capability entry. If the string does not exist in the string\n\
97   table, but there is room to add it, the new string is added\n\
98   and then the offset is placed in the capability entry.\n"
99
100
101# Command argument description strings
102
103@ MSG_A1_TAG_ELT	"\
104   Capabilities element to be examined or changed. By default,\n\
105   this is a CA_ tag value. The index of the first element\n\
106   in the capabilities section that has the specified tag value\n\
107   will be used. The value specified can be one of the well known\n\
108   CA_ constants, or any integer.\n\
109   \n\
110   If the -capndx option is specified, elt is instead interpreted\n\
111   as a simple integer index into the capabilities section.\n"
112
113@ MSG_A2_TAG_VALUE	"\
114   Value to be set for c_tag field of specified capabilities\n\
115   element. Tag values can be specified using the well known\n\
116   CA_ symbolic constants from /usr/include/sys/elf.h, or\n\
117   as integers.\n"
118
119@ MSG_ARGDESC_ELT	"\
120   Element within capabilities section. By default, this is a\n\
121   tag value. In this case, the index of the first capabilities\n\
122   element with the specified tag value will be used. Tag values\n\
123   can be specified using the well known CA_ symbolic constants\n\
124   from /usr/include/sys/elf.h, or as integers. If the -capndx\n\
125   option is specified, then elt is instead interpreted as a\n\
126   direct numeric index into the capabilities section. If the\n\
127   -capid option is specified, the search is limited to elements\n\
128   within the named capabilities group.\n"
129
130@ MSG_A2_VALUE_VALUE	"\
131   Value to set for specified capabilities section element.\n\
132   This is a numeric value which is used directly.\n"
133
134@ MSG_A2_DELETE_COUNT	"\
135   Number of capabilities elements to delete, starting at the\n\
136   specified position. This value cannot exceed the number\n\
137   of slots remaining in the capabilities group below the specified\n\
138   position. If count is not supplied, a single element is deleted.\n"
139
140@ MSG_A2_MOVE_DST_INDEX	"\
141   Numeric index within capabilities section to which the element(s)\n\
142   should be moved. The destination index must lie within the same\n\
143   capabilities group as elt.\n"
144
145@ MSG_A3_MOVE_COUNT	"\
146   Number of capabilities elements to move. This value cannot\n\
147   exceed the number of slots remaining in the capabilities group\n\
148   below the specified position. If count is not supplied, a\n\
149   single element is moved.\n"
150
151@ MSG_A1_HW1_VALUE	"\
152   Hardware capability (CA_SUNW_HW_1) values. This can be an integer\n\
153   value, any of the AV_386_ symbolic constants defined in\n\
154   /usr/include/sys/auxv_386.h, or the AV_SPARC symbolic\n\
155   constants defined in /usr/include/sys/auxv_SPARC.h.\n"
156
157@ MSG_A1_SF1_VALUE	"\
158   Software capability (CA_SUNW_SF_1) values. This can be an integer\n\
159   value, any of the SF1_SUNW_ symbolic constants defined in\n\
160   /usr/include/sys/elf.h.\n"
161
162@ MSG_A1_HW2_VALUE	"\
163   Hardware capability (CA_SUNW_HW_2) values. This is available for\n\
164   future expansion.\n"
165
166
167# Help strings
168
169@ MSG_HELP_DUMP	"   \
170   The cap:dump command is used to display the contents of the\n\
171   capabilities section using the same style used by the elfdump\n\
172   program.\n"
173
174@ MSG_HELP_TAG	"   \
175   The cap:tag command is used to display or alter the\n\
176   type of an element in the capabilities section. This information\n\
177   is found in the c_tag field of a capabilities element.\n\
178   \n\
179   If cap:tag is called without arguments, the value of c_tag\n\
180   for every element in the capabilities section is shown. If called\n\
181   with the elt argument, the specified elements are displayed.\n\
182   If both arguments are present, the c_tag field of the specified\n\
183   capabilities element is set to the given value.\n"
184
185@ MSG_HELP_VALUE	"   \
186   The cap:value command is used to display or alter the\n\
187   value of an element in the capabilities section. The value\n\
188   of a capabilities element is found in the c_un union of the\n\
189   element.\n\
190   \n\
191   If cap:value is called without arguments, the value of every\n\
192   element in the capabilities section is shown. If called with the\n\
193   elt argument, the value of the specified elements are displayed.\n\
194   If both arguments are present, the value of the specified\n\
195   capabilities element is set to the given value.\n"
196
197@ MSG_HELP_DELETE	"   \
198   The cap:delete command is used to delete one or more elements\n\
199   from a capabilities group within the capabilities section. The\n\
200   elements following the deleted items move up, and new CA_NULL\n\
201   elements are inserted at the end of the capabilities group to\n\
202   fill the vacated space.\n"
203
204@ MSG_HELP_MOVE	"   \
205   The cap:move command is used to move the position of one\n\
206   or more elements in a capabilities group within in the\n\
207   capabilities section. The specified number of elements are\n\
208   moved from elt to dst_index.\n"
209
210@ MSG_HELP_HW1	"   \
211   The cap:hw1 command is used to display or alter the\n\
212   value of the hardware capabilities element (CA_SUNW_HW_1).\n\
213   \n\
214   If cap:hw1 is called without arguments, the current\n\
215   value is shown. If one or more value arguments are present,\n\
216   the following steps are taken:\n\
217   \n   \
218   o\tAll the value arguments are OR'd together.\n\
219   \n   \
220   o\tIf the -cmp option has been specified, the new value\n\
221   \tis complemented.\n\
222   \n   \
223   o\tThe CA_SUNW_HW_1 element of the capabilities section is\n\
224   \tupdated with the new value. If -and is specified, the new\n\
225   \tvalue is AND'd against the existing value. If -or is\n\
226   \tspecified, the new value is OR'd against the existing\n\
227   \tvalue. If neither -and or -or are specified, the new value\n\
228   \treplaces the existing value.\n"
229
230@ MSG_HELP_SF1	"   \
231   The cap:sf1 command is used to display or alter the\n\
232   value of the software capabilities element (CA_SUNW_SF_1).\n\
233   \n\
234   If cap:sf1 is called without arguments, the current\n\
235   value is shown. If one or more value arguments are present,\n\
236   the following steps are taken:\n\
237   \n   \
238   o\tAll the value arguments are OR'd together.\n\
239   \n   \
240   o\tIf the -cmp option has been specified, the new value\n\
241   \tis complemented.\n\
242   \n   \
243   o\tThe CA_SUNW_SF_1 element of the capabilities section is\n\
244   \tupdated with the new value. If -and is specified, the new\n\
245   \tvalue is AND'd against the existing value. If -or is\n\
246   \tspecified, the new value is OR'd against the existing\n\
247   \tvalue. If neither -and or -or are specified, the new value\n\
248   replaces the existing value.\n"
249
250@ MSG_HELP_HW2	"   \
251   The cap:hw2 command is used to display or alter the\n\
252   value of the hardware capabilities element (CA_SUNW_HW_2).\n\
253   \n\
254   If cap:hw2 is called without arguments, the current\n\
255   value is shown. If one or more value arguments are present,\n\
256   the following steps are taken:\n\
257   \n   \
258   o\tAll the value arguments are OR'd together.\n\
259   \n   \
260   o\tIf the -cmp option has been specified, the new value\n\
261   \tis complemented.\n\
262   \n   \
263   o\tThe CA_SUNW_HW_2 element of the capabilities section is\n\
264   \tupdated with the new value. If -and is specified, the new\n\
265   \tvalue is AND'd against the existing value. If -or is\n\
266   \tspecified, the new value is OR'd against the existing\n\
267   \tvalue. If neither -and or -or are specified, the new value\n\
268   \treplaces the existing value.\n"
269@ _END_
270
271
272# The following strings represent reserved words, files, pathnames and symbols.
273# Reference to this strings is via the MSG_ORIG() macro, and thus no message
274# translation is required.
275
276
277# Strings
278@ MSG_STR_EMPTY		""
279@ MSG_STR_COUNT		"count"
280@ MSG_STR_ELT		"elt"
281@ MSG_STR_DST_INDEX	"dst_index"
282@ MSG_STR_MINUS_CAPID	"-capid"
283@ MSG_STR_MINUS_CAPNDX	"-capndx"
284@ MSG_STR_MINUS_S	"-s"
285@ MSG_STR_VALUE		"value"
286@ MSG_STR_IDNAME	"id_name"
287
288# Format strings
289@ MSG_FMT_STRNL		"%s\n"
290@ MSG_FMT_HEXXWORDNL	"%#llx\n"
291@ MSG_FMT_WORDVALNL	"%u\n"
292
293
294# Module name
295
296@ MSG_MOD_NAME		"cap"
297
298
299# Command names
300
301@ MSG_CMD_DUMP		"dump"
302@ MSG_CMD_TAG		"tag"
303@ MSG_CMD_VALUE		"value"
304@ MSG_CMD_DELETE	"delete"
305@ MSG_CMD_MOVE		"move"
306@ MSG_CMD_HW1		"hw1"
307@ MSG_CMD_SF1		"sf1"
308@ MSG_CMD_HW2		"hw2"
309