Changeset 94208 in vbox for trunk/doc/manual/en_US
- Timestamp:
- Mar 13, 2022 7:48:18 PM (3 years ago)
- Location:
- trunk/doc/manual/en_US
- Files:
-
- 2 edited
-
man_VBoxManage-guestproperty.xml (modified) (2 diffs)
-
user_VBoxManage.xml (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/manual/en_US/man_VBoxManage-guestproperty.xml
r82969 r94208 20 20 <refentry id="vboxmanage-guestproperty" lang="en"> 21 21 <refentryinfo> 22 <pubdate> September 2019</pubdate>22 <pubdate>$Date$</pubdate> 23 23 <title>VBoxManage guestproperty</title> 24 24 </refentryinfo> … … 32 32 <refname>VBoxManage-guestproperty</refname> 33 33 <refpurpose>manage virtual machine guest properties</refpurpose> 34 <refclass> Oracle VM VirtualBox</refclass>34 <refclass>&product-name;</refclass> 35 35 </refnamediv> 36 36 -
trunk/doc/manual/en_US/user_VBoxManage.xml
r94207 r94208 1111 1111 <xi:include href="user_man_VBoxManage-sharedfolder.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" /> 1112 1112 1113 <sect1 id="vboxmanage-guestproperty"> 1114 1115 <title>VBoxManage guestproperty</title> 1116 1117 <para> 1118 The <command>guestproperty</command> commands enable you to get or 1119 set properties of a running virtual machine. See 1120 <xref linkend="guestadd-guestprops" />. Guest properties are 1121 arbitrary keyword-value string pairs which can be written to and 1122 read from by either the guest or the host, so they can be used as 1123 a low-volume communication channel for strings, provided that a 1124 guest is running and has the Guest Additions installed. In 1125 addition, a number of values whose keywords begin with 1126 <computeroutput>/VirtualBox/</computeroutput>are automatically set 1127 and maintained by the Guest Additions. 1128 </para> 1129 1130 <para> 1131 The following subcommands are available, where 1132 <computeroutput><vm></computeroutput> can either be a VM 1133 name or a VM UUID, as with the other <command>VBoxManage</command> 1134 commands: 1135 </para> 1136 1137 <itemizedlist> 1138 1139 <listitem> 1140 <para> 1141 <computeroutput>enumerate <vm> [--patterns 1142 <pattern>]</computeroutput>: Lists all the guest 1143 properties that are available for the given VM, including the 1144 value. This list will be very limited if the guest's service 1145 process cannot be contacted, for example because the VM is not 1146 running or the Guest Additions are not installed. 1147 </para> 1148 1149 <para> 1150 If <computeroutput>--patterns <pattern></computeroutput> 1151 is specified, it acts as a filter to only list properties that 1152 match the given pattern. The pattern can contain the following 1153 wildcard characters: 1154 </para> 1155 1156 <itemizedlist> 1157 1158 <listitem> 1159 <para> 1160 <computeroutput>*</computeroutput> (asterisk): Represents 1161 any number of characters. For example, 1162 "<computeroutput>/VirtualBox*</computeroutput>" would 1163 match all properties beginning with "/VirtualBox". 1164 </para> 1165 </listitem> 1166 1167 <listitem> 1168 <para> 1169 <computeroutput>?</computeroutput> (question mark): 1170 Represents a single arbitrary character. For example, 1171 "<computeroutput>fo?</computeroutput>" would match both 1172 "foo" and "for". 1173 </para> 1174 </listitem> 1175 1176 <listitem> 1177 <para> 1178 <computeroutput>|</computeroutput> (pipe symbol): Can be 1179 used to specify multiple alternative patterns. For 1180 example, "<computeroutput>s*|t*</computeroutput>" would 1181 match anything starting with either "s" or "t". 1182 </para> 1183 </listitem> 1184 1185 </itemizedlist> 1186 </listitem> 1187 1188 <listitem> 1189 <para> 1190 <computeroutput>get <vm> 1191 <property></computeroutput>: Retrieves the value of a 1192 single property only. If the property cannot be found, for 1193 example because the guest is not running, the following 1194 message is shown: 1195 </para> 1196 1197 <screen>No value set!</screen> 1198 </listitem> 1199 1200 <listitem> 1201 <para> 1202 <computeroutput>set <vm> <property> [<value> 1203 [--flags <flags>]]</computeroutput>: Enables you to set 1204 a guest property by specifying the keyword and value. If 1205 <computeroutput><value></computeroutput> is omitted, the 1206 property is deleted. With 1207 <computeroutput>--flags</computeroutput>, you can specify 1208 additional behavior. You can combine several flags by 1209 separating them with commas. 1210 </para> 1211 1212 <itemizedlist> 1213 1214 <listitem> 1215 <para> 1216 <computeroutput>TRANSIENT</computeroutput>: The value will 1217 not be stored with the VM data when the VM exits. 1218 </para> 1219 </listitem> 1220 1221 <listitem> 1222 <para> 1223 <computeroutput>TRANSRESET</computeroutput>: The value 1224 will be deleted as soon as the VM restarts or exits. 1225 </para> 1226 </listitem> 1227 1228 <listitem> 1229 <para> 1230 <computeroutput>RDONLYGUEST</computeroutput>: The value 1231 can only be changed by the host, but the guest can only 1232 read it. 1233 </para> 1234 </listitem> 1235 1236 <listitem> 1237 <para> 1238 <computeroutput>RDONLYHOST</computeroutput>: The value can 1239 only be changed by the guest, but the host can only read 1240 it. 1241 </para> 1242 </listitem> 1243 1244 <listitem> 1245 <para> 1246 <computeroutput>READONLY</computeroutput>: The value 1247 cannot be changed at all. 1248 </para> 1249 </listitem> 1250 1251 </itemizedlist> 1252 </listitem> 1253 1254 <listitem> 1255 <para> 1256 <computeroutput>wait <vm> <pattern> --timeout 1257 <timeout></computeroutput>: Waits for a particular value 1258 described by the pattern string to change or to be deleted or 1259 created. The pattern rules are the same as for the 1260 <command>enumerate</command> subcommand. 1261 </para> 1262 </listitem> 1263 1264 <listitem> 1265 <para> 1266 <computeroutput>delete <vm> 1267 <property></computeroutput>: Deletes a guest property 1268 which has been set previously. 1269 </para> 1270 </listitem> 1271 1272 </itemizedlist> 1273 1274 </sect1> 1113 <xi:include href="user_man_VBoxManage-guestproperty.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" /> 1275 1114 1276 1115 <sect1 id="vboxmanage-guestcontrol">
Note:
See TracChangeset
for help on using the changeset viewer.
