xref: /illumos-gate/usr/src/cmd/sgs/elfedit/modules/common/cap.msg (revision 3d393ee6c37fa10ac512ed6d36109ad616dc7c1a)
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@ _START_
29
30# Message file for elfedit 'cap' module
31
32@ MSG_ID_ELFEDIT_CAP
33
34
35# Debug messages
36
37@ MSG_DEBUG_S_OK	"[%d: %s][%d]: value unchanged: %s\n"
38@ MSG_DEBUG_S_CHG	"[%d: %s][%d]: change from %s to %s\n"
39@ MSG_DEBUG_BSB_OK	"[%d: %s][%d]: value unchanged: [%s]\n"
40@ MSG_DEBUG_BSB_CHG	"[%d: %s][%d]: change from [%s] to [%s]\n"
41@ MSG_DEBUG_X_OK	"[%d: %s][%d]: value unchanged: %#llx\n"
42@ MSG_DEBUG_X_CHG	"[%d: %s][%d]: change from %#llx to %#llx\n"
43@ MSG_DEBUG_CA2NDX	"[%d: %s][%d]: Capability entry for tag: %s\n"
44
45
46# Errors
47
48@ MSG_ERR_NOCAELT	"[%d: %s]: Capabilities section does not contain \
49			 tag: %s\n"
50
51
52# Module description
53
54@ MSG_MOD_DESC		"Capabilities Section"
55
56
57
58# 1-line description strings
59
60@ MSG_DESC_DUMP		"Dump Capabilities Section"
61@ MSG_DESC_TAG		"Change element tag"
62@ MSG_DESC_VALUE	"Change element value"
63@ MSG_DESC_DELETE	"Delete elements"
64@ MSG_DESC_MOVE		"Move elements"
65@ MSG_DESC_HW1		"Hardware capabilities bit values"
66@ MSG_DESC_SF1		"Software capabilities bit values"
67
68
69# Commmand option description strings
70
71@ MSG_OPTDESC_CAPNDX		"\
72   Interpret the elt argument as a direct index into the\n\
73   capabilities section, rather than as a CA_ tag value.\n"
74
75
76# Command argument description strings
77
78@ MSG_A1_TAG_ELT	"\
79   Capabilities element to be examined or changed. By default,\n\
80   this is a CA_ tag value. The index of the first element\n\
81   in the capabilities section that has the specified tag value\n\
82   will be used. The value specified can be one of the well known\n\
83   CA_ constants, or any integer.\n\
84   \n\
85   If the -capndx option is specified, elt is instead interpreted\n\
86   as a simple integer index into the capabilities section.\n"
87
88@ MSG_A2_TAG_VALUE	"\
89   Value to be set for c_tag field of specified capabilities\n\
90   element. Tag values can be specified using the well known\n\
91   CA_ symbolic constants from /usr/include/sys/elf.h, or\n\
92   as integers.\n"
93
94@ MSG_ARGDESC_ELT	"\
95   Element within capabilities section. By default, this is a\n\
96   tag value. In this case, the index of the first capabilities\n\
97   element with the specified tag value will be used. Tag values\n\
98   can be specified using the well known CA_ symbolic constants\n\
99   from /usr/include/sys/elf.h, or as integers. If the -capndx\n\
100   option is specified, then elt is instead interpreted as a\n\
101   direct numeric index into the capabilities section.\n"
102
103@ MSG_A2_VALUE_VALUE	"\
104   Value to set for specified capabilities section element.\n\
105   This is a numeric value which is used directly.\n"
106
107@ MSG_A2_DELETE_COUNT	"\
108   Number of capabilities elements to delete, starting at the\n\
109   specified position. This value cannot exceed the number\n\
110   of slots remaining in the table below the specified position.\n\
111   If count is not supplied, a single element is deleted.\n"
112
113@ MSG_A2_MOVE_DST_INDEX	"\
114   Numeric index within capabilities section to which the element(s)\n\
115   should be moved.\n"
116
117@ MSG_A3_MOVE_COUNT	"\
118   Number of capabilities elements to move. This value cannot\n\
119   exceed the number of slots remaining in the table below\n\
120   the specified position. If count is not supplied, a\n\
121   single element is moved.\n"
122
123@ MSG_A1_HW1_VALUE	"\
124   Hardware capability values. This can be an integer value,\n\
125   any of the AV_386_ symbolic constants defined in\n\
126   /usr/include/sys/auxv_386.h, or the AV_SPARC symbolic\n\
127   constants defined in /usr/include/sys/auxv_SPARC.h\n"
128
129@ MSG_A1_SF1_VALUE	"\
130   Software capability values. This can be an integer value,\n\
131   any of the SF1_SUNW_ symbolic constants defined in\n\
132   /usr/include/sys/elf.h\n"
133
134
135
136# Help strings
137
138@ MSG_HELP_DUMP	"   \
139   The cap:dump command is used to display the contents of the\n\
140   capabilities section using the same style used by the elfdump\n\
141   program.\n"
142
143@ MSG_HELP_TAG	"   \
144   The cap:tag command is used to display or alter the\n\
145   type of an element in the capabilities section. This information\n\
146   is found in the c_tag field of a capabilities element.\n\
147   \n\
148   If cap:tag is called without arguments, the value of c_tag\n\
149   for every element in the capabilities section is shown. If called\n\
150   with the elt argument, the specified elements are displayed.\n\
151   If both arguments are present, the c_tag field of the specified\n\
152   capabilities element is set to the given value.\n"
153
154@ MSG_HELP_VALUE	"   \
155   The cap:value command is used to display or alter the\n\
156   value of an element in the capabilities section. The value\n\
157   of a capabilities element is found in the c_un union of the\n\
158   element.\n\
159   \n\
160   If cap:value is called without arguments, the value of every\n\
161   element in the capabilities section is shown. If called with the\n\
162   elt argument, the value of the specified elements are displayed.\n\
163   If both arguments are present, the value of the specified\n\
164   capabilities element is set to the given value.\n"
165
166@ MSG_HELP_DELETE	"   \
167   The cap:delete command is used to delete one or more elements\n\
168   in the capabilities section. The elements following the deleted\n\
169   items move up, and new CA_NULL elements are inserted at the\n\
170   end of the capabilities section to fill the vacated space.\n"
171
172@ MSG_HELP_MOVE	"   \
173   The cap:move command is used to move the position of one\n\
174   or more elements in the capabilities section. The specified\n\
175   number of elements are moved from elt to dst_index.\n"
176
177@ MSG_HELP_HW1	"   \
178   The cap:hw1 command is used to display or alter the\n\
179   value of the hardware capabilities element (CA_SUNW_HW_1).\n\
180   \n\
181   If cap:hw1 is called without arguments, the current\n\
182   value is shown. If one or more value arguments are present,\n\
183   the following steps are taken:\n\
184   \n   \
185   o\tAll the value arguments are OR'd together.\n\
186   \n   \
187   o\tIf the -cmp option has been specified, the new value\n\
188   \tis complemented.\n\
189   \n   \
190   o\tThe CA_SUNW_HW_1 element of the capabilities section is\n\
191   \tupdated with the new value. If -and is specified, the new\n\
192   \tvalue is AND'd against the existing value. If -or is\n\
193   \tspecified, the new value is OR'd against the existing\n\
194   \tvalue. If neither -and or -or are specified, the new value\n\
195   \treplaces the existing value.\n"
196
197@ MSG_HELP_SF1	"   \
198   The cap:sf1 command is used to display or alter the\n\
199   value of the software capabilities element (CA_SUNW_SF_1).\n\
200   \n\
201   If cap:sf1 is called without arguments, the current\n\
202   value is shown. If one or more value arguments are present,\n\
203   the following steps are taken:\n\
204   \n   \
205   o\tAll the value arguments are OR'd together.\n\
206   \n   \
207   o\tIf the -cmp option has been specified, the new value\n\
208   \tis complemented.\n\
209   \n   \
210   o\tThe CA_SUNW_SF_1 element of the capabilities section is\n\
211   \tupdated with the new value. If -and is specified, the new\n\
212   \tvalue is AND'd against the existing value. If -or is\n\
213   \tspecified, the new value is OR'd against the existing\n\
214   \tvalue. If neither -and or -or are specified, the new value\n\
215   replaces the existing value.\n"
216
217@ _END_
218
219
220# The following strings represent reserved words, files, pathnames and symbols.
221# Reference to this strings is via the MSG_ORIG() macro, and thus no message
222# translation is required.
223
224
225# Strings
226@ MSG_STR_EMPTY		""
227@ MSG_STR_COUNT		"count"
228@ MSG_STR_ELT		"elt"
229@ MSG_STR_DST_INDEX	"dst_index"
230@ MSG_STR_MINUS_CAPNDX	"-capndx"
231@ MSG_STR_VALUE		"value"
232
233# Format strings
234@ MSG_FMT_STRNL		"%s\n"
235@ MSG_FMT_HEXXWORDNL	"%#llx\n"
236
237
238# Module name
239
240@ MSG_MOD_NAME		"cap"
241
242
243# Command names
244
245@ MSG_CMD_DUMP		"dump"
246@ MSG_CMD_TAG		"tag"
247@ MSG_CMD_VALUE		"value"
248@ MSG_CMD_DELETE	"delete"
249@ MSG_CMD_MOVE		"move"
250@ MSG_CMD_HW1		"hw1"
251@ MSG_CMD_SF1		"sf1"
252