VirtualBox

source: vbox/trunk/src/VBox/Frontends/VBoxManage/VBoxManageModifyVM.cpp@ 82442

Last change on this file since 82442 was 82442, checked in by vboxsync, 5 years ago

build fix for prev change
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 136.7 KB
Line 
1/* $Id: VBoxManageModifyVM.cpp 82442 2019-12-05 23:20:16Z vboxsync $ */
2/** @file
3 * VBoxManage - Implementation of modifyvm command.
4 */
5
6/*
7 * Copyright (C) 2006-2019 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.215389.xyz. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18
19/*********************************************************************************************************************************
20* Header Files *
21*********************************************************************************************************************************/
22#ifndef VBOX_ONLY_DOCS
23#include <VBox/com/com.h>
24#include <VBox/com/array.h>
25#include <VBox/com/ErrorInfo.h>
26#include <VBox/com/errorprint.h>
27#include <VBox/com/VirtualBox.h>
28#endif /* !VBOX_ONLY_DOCS */
29
30#include <iprt/cidr.h>
31#include <iprt/ctype.h>
32#include <iprt/file.h>
33#include <iprt/param.h>
34#include <iprt/path.h>
35#include <iprt/stream.h>
36#include <iprt/string.h>
37#include <iprt/getopt.h>
38#include <VBox/log.h>
39#include "VBoxManage.h"
40
41#ifndef VBOX_ONLY_DOCS
42using namespace com;
43/** @todo refine this after HDD changes; MSC 8.0/64 has trouble with handleModifyVM. */
44#if defined(_MSC_VER)
45# pragma optimize("g", off)
46# if _MSC_VER < RT_MSC_VER_VC120
47# pragma warning(disable:4748)
48# endif
49#endif
50
51enum
52{
53 MODIFYVM_NAME = 1000,
54 MODIFYVM_GROUPS,
55 MODIFYVM_DESCRIPTION,
56 MODIFYVM_OSTYPE,
57 MODIFYVM_ICONFILE,
58 MODIFYVM_MEMORY,
59 MODIFYVM_PAGEFUSION,
60 MODIFYVM_VRAM,
61 MODIFYVM_FIRMWARE,
62 MODIFYVM_ACPI,
63 MODIFYVM_IOAPIC,
64 MODIFYVM_PAE,
65 MODIFYVM_LONGMODE,
66 MODIFYVM_CPUID_PORTABILITY,
67 MODIFYVM_TFRESET,
68 MODIFYVM_APIC,
69 MODIFYVM_X2APIC,
70 MODIFYVM_PARAVIRTPROVIDER,
71 MODIFYVM_PARAVIRTDEBUG,
72 MODIFYVM_HWVIRTEX,
73 MODIFYVM_NESTEDPAGING,
74 MODIFYVM_LARGEPAGES,
75 MODIFYVM_VTXVPID,
76 MODIFYVM_VTXUX,
77 MODIFYVM_IBPB_ON_VM_EXIT,
78 MODIFYVM_IBPB_ON_VM_ENTRY,
79 MODIFYVM_SPEC_CTRL,
80 MODIFYVM_L1D_FLUSH_ON_SCHED,
81 MODIFYVM_L1D_FLUSH_ON_VM_ENTRY,
82 MODIFYVM_MDS_CLEAR_ON_SCHED,
83 MODIFYVM_MDS_CLEAR_ON_VM_ENTRY,
84 MODIFYVM_NESTED_HW_VIRT,
85 MODIFYVM_CPUS,
86 MODIFYVM_CPUHOTPLUG,
87 MODIFYVM_CPU_PROFILE,
88 MODIFYVM_PLUGCPU,
89 MODIFYVM_UNPLUGCPU,
90 MODIFYVM_SETCPUID,
91 MODIFYVM_SETCPUID_OLD,
92 MODIFYVM_DELCPUID,
93 MODIFYVM_DELCPUID_OLD,
94 MODIFYVM_DELALLCPUID,
95 MODIFYVM_GRAPHICSCONTROLLER,
96 MODIFYVM_MONITORCOUNT,
97 MODIFYVM_ACCELERATE3D,
98#ifdef VBOX_WITH_VIDEOHWACCEL
99 MODIFYVM_ACCELERATE2DVIDEO,
100#endif
101 MODIFYVM_BIOSLOGOFADEIN,
102 MODIFYVM_BIOSLOGOFADEOUT,
103 MODIFYVM_BIOSLOGODISPLAYTIME,
104 MODIFYVM_BIOSLOGOIMAGEPATH,
105 MODIFYVM_BIOSBOOTMENU,
106 MODIFYVM_BIOSAPIC,
107 MODIFYVM_BIOSSYSTEMTIMEOFFSET,
108 MODIFYVM_BIOSPXEDEBUG,
109 MODIFYVM_SYSTEMUUIDLE,
110 MODIFYVM_BOOT,
111 MODIFYVM_HDA, // deprecated
112 MODIFYVM_HDB, // deprecated
113 MODIFYVM_HDD, // deprecated
114 MODIFYVM_IDECONTROLLER, // deprecated
115 MODIFYVM_SATAPORTCOUNT, // deprecated
116 MODIFYVM_SATAPORT, // deprecated
117 MODIFYVM_SATA, // deprecated
118 MODIFYVM_SCSIPORT, // deprecated
119 MODIFYVM_SCSITYPE, // deprecated
120 MODIFYVM_SCSI, // deprecated
121 MODIFYVM_DVDPASSTHROUGH, // deprecated
122 MODIFYVM_DVD, // deprecated
123 MODIFYVM_FLOPPY, // deprecated
124 MODIFYVM_NICTRACEFILE,
125 MODIFYVM_NICTRACE,
126 MODIFYVM_NICPROPERTY,
127 MODIFYVM_NICTYPE,
128 MODIFYVM_NICSPEED,
129 MODIFYVM_NICBOOTPRIO,
130 MODIFYVM_NICPROMISC,
131 MODIFYVM_NICBWGROUP,
132 MODIFYVM_NIC,
133 MODIFYVM_CABLECONNECTED,
134 MODIFYVM_BRIDGEADAPTER,
135 MODIFYVM_HOSTONLYADAPTER,
136 MODIFYVM_INTNET,
137 MODIFYVM_GENERICDRV,
138 MODIFYVM_NATNETWORKNAME,
139 MODIFYVM_NATNET,
140 MODIFYVM_NATBINDIP,
141 MODIFYVM_NATSETTINGS,
142 MODIFYVM_NATPF,
143 MODIFYVM_NATALIASMODE,
144 MODIFYVM_NATTFTPPREFIX,
145 MODIFYVM_NATTFTPFILE,
146 MODIFYVM_NATTFTPSERVER,
147 MODIFYVM_NATDNSPASSDOMAIN,
148 MODIFYVM_NATDNSPROXY,
149 MODIFYVM_NATDNSHOSTRESOLVER,
150 MODIFYVM_MACADDRESS,
151 MODIFYVM_HIDPTR,
152 MODIFYVM_HIDKBD,
153 MODIFYVM_UARTMODE,
154 MODIFYVM_UARTTYPE,
155 MODIFYVM_UART,
156#if defined(RT_OS_LINUX) || defined(RT_OS_WINDOWS)
157 MODIFYVM_LPTMODE,
158 MODIFYVM_LPT,
159#endif
160 MODIFYVM_GUESTMEMORYBALLOON,
161 MODIFYVM_AUDIOCONTROLLER,
162 MODIFYVM_AUDIOCODEC,
163 MODIFYVM_AUDIO,
164 MODIFYVM_AUDIOIN,
165 MODIFYVM_AUDIOOUT,
166#ifdef VBOX_WITH_SHARED_CLIPBOARD
167 MODIFYVM_CLIPBOARD_MODE,
168# ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS
169 MODIFYVM_CLIPBOARD_FILE_TRANSFERS,
170# endif
171#endif
172 MODIFYVM_DRAGANDDROP,
173 MODIFYVM_VRDPPORT, /* VRDE: deprecated */
174 MODIFYVM_VRDPADDRESS, /* VRDE: deprecated */
175 MODIFYVM_VRDPAUTHTYPE, /* VRDE: deprecated */
176 MODIFYVM_VRDPMULTICON, /* VRDE: deprecated */
177 MODIFYVM_VRDPREUSECON, /* VRDE: deprecated */
178 MODIFYVM_VRDPVIDEOCHANNEL, /* VRDE: deprecated */
179 MODIFYVM_VRDPVIDEOCHANNELQUALITY, /* VRDE: deprecated */
180 MODIFYVM_VRDP, /* VRDE: deprecated */
181 MODIFYVM_VRDEPROPERTY,
182 MODIFYVM_VRDEPORT,
183 MODIFYVM_VRDEADDRESS,
184 MODIFYVM_VRDEAUTHTYPE,
185 MODIFYVM_VRDEAUTHLIBRARY,
186 MODIFYVM_VRDEMULTICON,
187 MODIFYVM_VRDEREUSECON,
188 MODIFYVM_VRDEVIDEOCHANNEL,
189 MODIFYVM_VRDEVIDEOCHANNELQUALITY,
190 MODIFYVM_VRDE_EXTPACK,
191 MODIFYVM_VRDE,
192 MODIFYVM_RTCUSEUTC,
193 MODIFYVM_USBRENAME,
194 MODIFYVM_USBXHCI,
195 MODIFYVM_USBEHCI,
196 MODIFYVM_USBOHCI,
197 MODIFYVM_SNAPSHOTFOLDER,
198 MODIFYVM_TELEPORTER_ENABLED,
199 MODIFYVM_TELEPORTER_PORT,
200 MODIFYVM_TELEPORTER_ADDRESS,
201 MODIFYVM_TELEPORTER_PASSWORD,
202 MODIFYVM_TELEPORTER_PASSWORD_FILE,
203 MODIFYVM_TRACING_ENABLED,
204 MODIFYVM_TRACING_CONFIG,
205 MODIFYVM_TRACING_ALLOW_VM_ACCESS,
206 MODIFYVM_HARDWARE_UUID,
207 MODIFYVM_HPET,
208 MODIFYVM_IOCACHE,
209 MODIFYVM_IOCACHESIZE,
210 MODIFYVM_CPU_EXECTUION_CAP,
211 MODIFYVM_AUTOSTART_ENABLED,
212 MODIFYVM_AUTOSTART_DELAY,
213 MODIFYVM_AUTOSTOP_TYPE,
214#ifdef VBOX_WITH_PCI_PASSTHROUGH
215 MODIFYVM_ATTACH_PCI,
216 MODIFYVM_DETACH_PCI,
217#endif
218#ifdef VBOX_WITH_USB_CARDREADER
219 MODIFYVM_USBCARDREADER,
220#endif
221#ifdef VBOX_WITH_RECORDING
222 MODIFYVM_RECORDING,
223 MODIFYVM_RECORDING_FEATURES,
224 MODIFYVM_RECORDING_SCREENS,
225 MODIFYVM_RECORDING_FILENAME,
226 MODIFYVM_RECORDING_VIDEO_WIDTH,
227 MODIFYVM_RECORDING_VIDEO_HEIGHT,
228 MODIFYVM_RECORDING_VIDEO_RES,
229 MODIFYVM_RECORDING_VIDEO_RATE,
230 MODIFYVM_RECORDING_VIDEO_FPS,
231 MODIFYVM_RECORDING_MAXTIME,
232 MODIFYVM_RECORDING_MAXSIZE,
233 MODIFYVM_RECORDING_OPTIONS,
234#endif
235 MODIFYVM_CHIPSET,
236 MODIFYVM_DEFAULTFRONTEND,
237 MODIFYVM_VMPROC_PRIORITY
238};
239
240static const RTGETOPTDEF g_aModifyVMOptions[] =
241{
242/** @todo Convert to dash separated names like --triple-fault-reset! Please
243 * do that for all new options as we don't need more character soups
244 * around VirtualBox - typedefs more than covers that demand! */
245 { "--name", MODIFYVM_NAME, RTGETOPT_REQ_STRING },
246 { "--groups", MODIFYVM_GROUPS, RTGETOPT_REQ_STRING },
247 { "--description", MODIFYVM_DESCRIPTION, RTGETOPT_REQ_STRING },
248 { "--ostype", MODIFYVM_OSTYPE, RTGETOPT_REQ_STRING },
249 { "--iconfile", MODIFYVM_ICONFILE, RTGETOPT_REQ_STRING },
250 { "--memory", MODIFYVM_MEMORY, RTGETOPT_REQ_UINT32 },
251 { "--pagefusion", MODIFYVM_PAGEFUSION, RTGETOPT_REQ_BOOL_ONOFF },
252 { "--vram", MODIFYVM_VRAM, RTGETOPT_REQ_UINT32 },
253 { "--firmware", MODIFYVM_FIRMWARE, RTGETOPT_REQ_STRING },
254 { "--acpi", MODIFYVM_ACPI, RTGETOPT_REQ_BOOL_ONOFF },
255 { "--ioapic", MODIFYVM_IOAPIC, RTGETOPT_REQ_BOOL_ONOFF },
256 { "--pae", MODIFYVM_PAE, RTGETOPT_REQ_BOOL_ONOFF },
257 { "--longmode", MODIFYVM_LONGMODE, RTGETOPT_REQ_BOOL_ONOFF },
258 { "--cpuid-portability-level", MODIFYVM_CPUID_PORTABILITY, RTGETOPT_REQ_UINT32 },
259 { "--triplefaultreset", MODIFYVM_TFRESET, RTGETOPT_REQ_BOOL_ONOFF },
260 { "--apic", MODIFYVM_APIC, RTGETOPT_REQ_BOOL_ONOFF },
261 { "--x2apic", MODIFYVM_X2APIC, RTGETOPT_REQ_BOOL_ONOFF },
262 { "--paravirtprovider", MODIFYVM_PARAVIRTPROVIDER, RTGETOPT_REQ_STRING },
263 { "--paravirtdebug", MODIFYVM_PARAVIRTDEBUG, RTGETOPT_REQ_STRING },
264 { "--hwvirtex", MODIFYVM_HWVIRTEX, RTGETOPT_REQ_BOOL_ONOFF },
265 { "--nestedpaging", MODIFYVM_NESTEDPAGING, RTGETOPT_REQ_BOOL_ONOFF },
266 { "--largepages", MODIFYVM_LARGEPAGES, RTGETOPT_REQ_BOOL_ONOFF },
267 { "--vtxvpid", MODIFYVM_VTXVPID, RTGETOPT_REQ_BOOL_ONOFF },
268 { "--vtxux", MODIFYVM_VTXUX, RTGETOPT_REQ_BOOL_ONOFF },
269 { "--ibpb-on-vm-exit", MODIFYVM_IBPB_ON_VM_EXIT, RTGETOPT_REQ_BOOL_ONOFF },
270 { "--ibpb-on-vm-entry", MODIFYVM_IBPB_ON_VM_ENTRY, RTGETOPT_REQ_BOOL_ONOFF },
271 { "--spec-ctrl", MODIFYVM_SPEC_CTRL, RTGETOPT_REQ_BOOL_ONOFF },
272 { "--l1d-flush-on-sched", MODIFYVM_L1D_FLUSH_ON_SCHED, RTGETOPT_REQ_BOOL_ONOFF },
273 { "--l1d-flush-on-vm-entry", MODIFYVM_L1D_FLUSH_ON_VM_ENTRY, RTGETOPT_REQ_BOOL_ONOFF },
274 { "--mds-clear-on-sched", MODIFYVM_MDS_CLEAR_ON_SCHED, RTGETOPT_REQ_BOOL_ONOFF },
275 { "--mds-clear-on-vm-entry", MODIFYVM_MDS_CLEAR_ON_VM_ENTRY, RTGETOPT_REQ_BOOL_ONOFF },
276 { "--nested-hw-virt", MODIFYVM_NESTED_HW_VIRT, RTGETOPT_REQ_BOOL_ONOFF },
277 { "--cpuid-set", MODIFYVM_SETCPUID, RTGETOPT_REQ_UINT32_OPTIONAL_PAIR | RTGETOPT_FLAG_HEX },
278 { "--cpuid-remove", MODIFYVM_DELCPUID, RTGETOPT_REQ_UINT32_OPTIONAL_PAIR | RTGETOPT_FLAG_HEX },
279 { "--cpuidset", MODIFYVM_SETCPUID_OLD, RTGETOPT_REQ_UINT32 | RTGETOPT_FLAG_HEX },
280 { "--cpuidremove", MODIFYVM_DELCPUID_OLD, RTGETOPT_REQ_UINT32 | RTGETOPT_FLAG_HEX },
281 { "--cpuidremoveall", MODIFYVM_DELALLCPUID, RTGETOPT_REQ_NOTHING},
282 { "--cpus", MODIFYVM_CPUS, RTGETOPT_REQ_UINT32 },
283 { "--cpuhotplug", MODIFYVM_CPUHOTPLUG, RTGETOPT_REQ_BOOL_ONOFF },
284 { "--cpu-profile", MODIFYVM_CPU_PROFILE, RTGETOPT_REQ_STRING },
285 { "--plugcpu", MODIFYVM_PLUGCPU, RTGETOPT_REQ_UINT32 },
286 { "--unplugcpu", MODIFYVM_UNPLUGCPU, RTGETOPT_REQ_UINT32 },
287 { "--cpuexecutioncap", MODIFYVM_CPU_EXECTUION_CAP, RTGETOPT_REQ_UINT32 },
288 { "--rtcuseutc", MODIFYVM_RTCUSEUTC, RTGETOPT_REQ_BOOL_ONOFF },
289 { "--graphicscontroller", MODIFYVM_GRAPHICSCONTROLLER, RTGETOPT_REQ_STRING },
290 { "--monitorcount", MODIFYVM_MONITORCOUNT, RTGETOPT_REQ_UINT32 },
291 { "--accelerate3d", MODIFYVM_ACCELERATE3D, RTGETOPT_REQ_BOOL_ONOFF },
292#ifdef VBOX_WITH_VIDEOHWACCEL
293 { "--accelerate2dvideo", MODIFYVM_ACCELERATE2DVIDEO, RTGETOPT_REQ_BOOL_ONOFF },
294#endif
295 { "--bioslogofadein", MODIFYVM_BIOSLOGOFADEIN, RTGETOPT_REQ_BOOL_ONOFF },
296 { "--bioslogofadeout", MODIFYVM_BIOSLOGOFADEOUT, RTGETOPT_REQ_BOOL_ONOFF },
297 { "--bioslogodisplaytime", MODIFYVM_BIOSLOGODISPLAYTIME, RTGETOPT_REQ_UINT32 },
298 { "--bioslogoimagepath", MODIFYVM_BIOSLOGOIMAGEPATH, RTGETOPT_REQ_STRING },
299 { "--biosbootmenu", MODIFYVM_BIOSBOOTMENU, RTGETOPT_REQ_STRING },
300 { "--biossystemtimeoffset", MODIFYVM_BIOSSYSTEMTIMEOFFSET, RTGETOPT_REQ_INT64 },
301 { "--biosapic", MODIFYVM_BIOSAPIC, RTGETOPT_REQ_STRING },
302 { "--biospxedebug", MODIFYVM_BIOSPXEDEBUG, RTGETOPT_REQ_BOOL_ONOFF },
303 { "--system-uuid-le", MODIFYVM_SYSTEMUUIDLE, RTGETOPT_REQ_BOOL_ONOFF },
304 { "--boot", MODIFYVM_BOOT, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
305 { "--hda", MODIFYVM_HDA, RTGETOPT_REQ_STRING },
306 { "--hdb", MODIFYVM_HDB, RTGETOPT_REQ_STRING },
307 { "--hdd", MODIFYVM_HDD, RTGETOPT_REQ_STRING },
308 { "--idecontroller", MODIFYVM_IDECONTROLLER, RTGETOPT_REQ_STRING },
309 { "--sataportcount", MODIFYVM_SATAPORTCOUNT, RTGETOPT_REQ_UINT32 },
310 { "--sataport", MODIFYVM_SATAPORT, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
311 { "--sata", MODIFYVM_SATA, RTGETOPT_REQ_STRING },
312 { "--scsiport", MODIFYVM_SCSIPORT, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
313 { "--scsitype", MODIFYVM_SCSITYPE, RTGETOPT_REQ_STRING },
314 { "--scsi", MODIFYVM_SCSI, RTGETOPT_REQ_STRING },
315 { "--dvdpassthrough", MODIFYVM_DVDPASSTHROUGH, RTGETOPT_REQ_STRING },
316 { "--dvd", MODIFYVM_DVD, RTGETOPT_REQ_STRING },
317 { "--floppy", MODIFYVM_FLOPPY, RTGETOPT_REQ_STRING },
318 { "--nictracefile", MODIFYVM_NICTRACEFILE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
319 { "--nictrace", MODIFYVM_NICTRACE, RTGETOPT_REQ_BOOL_ONOFF | RTGETOPT_FLAG_INDEX },
320 { "--nicproperty", MODIFYVM_NICPROPERTY, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
321 { "--nictype", MODIFYVM_NICTYPE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
322 { "--nicspeed", MODIFYVM_NICSPEED, RTGETOPT_REQ_UINT32 | RTGETOPT_FLAG_INDEX },
323 { "--nicbootprio", MODIFYVM_NICBOOTPRIO, RTGETOPT_REQ_UINT32 | RTGETOPT_FLAG_INDEX },
324 { "--nicpromisc", MODIFYVM_NICPROMISC, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
325 { "--nicbandwidthgroup", MODIFYVM_NICBWGROUP, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
326 { "--nic", MODIFYVM_NIC, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
327 { "--cableconnected", MODIFYVM_CABLECONNECTED, RTGETOPT_REQ_BOOL_ONOFF | RTGETOPT_FLAG_INDEX },
328 { "--bridgeadapter", MODIFYVM_BRIDGEADAPTER, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
329 { "--hostonlyadapter", MODIFYVM_HOSTONLYADAPTER, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
330 { "--intnet", MODIFYVM_INTNET, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
331 { "--nicgenericdrv", MODIFYVM_GENERICDRV, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
332 { "--nat-network", MODIFYVM_NATNETWORKNAME, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
333 { "--natnetwork", MODIFYVM_NATNETWORKNAME, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
334 { "--natnet", MODIFYVM_NATNET, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
335 { "--natbindip", MODIFYVM_NATBINDIP, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
336 { "--natsettings", MODIFYVM_NATSETTINGS, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
337 { "--natpf", MODIFYVM_NATPF, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
338 { "--nataliasmode", MODIFYVM_NATALIASMODE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
339 { "--nattftpprefix", MODIFYVM_NATTFTPPREFIX, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
340 { "--nattftpfile", MODIFYVM_NATTFTPFILE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
341 { "--nattftpserver", MODIFYVM_NATTFTPSERVER, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
342 { "--natdnspassdomain", MODIFYVM_NATDNSPASSDOMAIN, RTGETOPT_REQ_BOOL_ONOFF | RTGETOPT_FLAG_INDEX },
343 { "--natdnsproxy", MODIFYVM_NATDNSPROXY, RTGETOPT_REQ_BOOL_ONOFF | RTGETOPT_FLAG_INDEX },
344 { "--natdnshostresolver", MODIFYVM_NATDNSHOSTRESOLVER, RTGETOPT_REQ_BOOL_ONOFF | RTGETOPT_FLAG_INDEX },
345 { "--macaddress", MODIFYVM_MACADDRESS, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
346 { "--mouse", MODIFYVM_HIDPTR, RTGETOPT_REQ_STRING },
347 { "--keyboard", MODIFYVM_HIDKBD, RTGETOPT_REQ_STRING },
348 { "--uartmode", MODIFYVM_UARTMODE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
349 { "--uarttype", MODIFYVM_UARTTYPE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
350 { "--uart", MODIFYVM_UART, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
351#if defined(RT_OS_LINUX) || defined(RT_OS_WINDOWS)
352 { "--lptmode", MODIFYVM_LPTMODE, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
353 { "--lpt", MODIFYVM_LPT, RTGETOPT_REQ_STRING | RTGETOPT_FLAG_INDEX },
354#endif
355 { "--guestmemoryballoon", MODIFYVM_GUESTMEMORYBALLOON, RTGETOPT_REQ_UINT32 },
356 { "--audiocontroller", MODIFYVM_AUDIOCONTROLLER, RTGETOPT_REQ_STRING },
357 { "--audiocodec", MODIFYVM_AUDIOCODEC, RTGETOPT_REQ_STRING },
358 { "--audio", MODIFYVM_AUDIO, RTGETOPT_REQ_STRING },
359 { "--audioin", MODIFYVM_AUDIOIN, RTGETOPT_REQ_BOOL_ONOFF },
360 { "--audioout", MODIFYVM_AUDIOOUT, RTGETOPT_REQ_BOOL_ONOFF },
361#ifdef VBOX_WITH_SHARED_CLIPBOARD
362 { "--clipboard-mode", MODIFYVM_CLIPBOARD_MODE, RTGETOPT_REQ_STRING },
363# ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS
364 { "--clipboard-file-transfers", MODIFYVM_CLIPBOARD_FILE_TRANSFERS, RTGETOPT_REQ_STRING },
365# endif
366#endif
367 { "--draganddrop", MODIFYVM_DRAGANDDROP, RTGETOPT_REQ_STRING },
368 { "--vrdpport", MODIFYVM_VRDPPORT, RTGETOPT_REQ_STRING }, /* deprecated */
369 { "--vrdpaddress", MODIFYVM_VRDPADDRESS, RTGETOPT_REQ_STRING }, /* deprecated */
370 { "--vrdpauthtype", MODIFYVM_VRDPAUTHTYPE, RTGETOPT_REQ_STRING }, /* deprecated */
371 { "--vrdpmulticon", MODIFYVM_VRDPMULTICON, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
372 { "--vrdpreusecon", MODIFYVM_VRDPREUSECON, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
373 { "--vrdpvideochannel", MODIFYVM_VRDPVIDEOCHANNEL, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
374 { "--vrdpvideochannelquality", MODIFYVM_VRDPVIDEOCHANNELQUALITY, RTGETOPT_REQ_STRING }, /* deprecated */
375 { "--vrdp", MODIFYVM_VRDP, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
376 { "--vrdeproperty", MODIFYVM_VRDEPROPERTY, RTGETOPT_REQ_STRING },
377 { "--vrdeport", MODIFYVM_VRDEPORT, RTGETOPT_REQ_STRING },
378 { "--vrdeaddress", MODIFYVM_VRDEADDRESS, RTGETOPT_REQ_STRING },
379 { "--vrdeauthtype", MODIFYVM_VRDEAUTHTYPE, RTGETOPT_REQ_STRING },
380 { "--vrdeauthlibrary", MODIFYVM_VRDEAUTHLIBRARY, RTGETOPT_REQ_STRING },
381 { "--vrdemulticon", MODIFYVM_VRDEMULTICON, RTGETOPT_REQ_BOOL_ONOFF },
382 { "--vrdereusecon", MODIFYVM_VRDEREUSECON, RTGETOPT_REQ_BOOL_ONOFF },
383 { "--vrdevideochannel", MODIFYVM_VRDEVIDEOCHANNEL, RTGETOPT_REQ_BOOL_ONOFF },
384 { "--vrdevideochannelquality", MODIFYVM_VRDEVIDEOCHANNELQUALITY, RTGETOPT_REQ_STRING },
385 { "--vrdeextpack", MODIFYVM_VRDE_EXTPACK, RTGETOPT_REQ_STRING },
386 { "--vrde", MODIFYVM_VRDE, RTGETOPT_REQ_BOOL_ONOFF },
387 { "--usbrename", MODIFYVM_USBRENAME, RTGETOPT_REQ_STRING },
388 { "--usbxhci", MODIFYVM_USBXHCI, RTGETOPT_REQ_BOOL_ONOFF },
389 { "--usbehci", MODIFYVM_USBEHCI, RTGETOPT_REQ_BOOL_ONOFF },
390 { "--usbohci", MODIFYVM_USBOHCI, RTGETOPT_REQ_BOOL_ONOFF },
391 { "--usb", MODIFYVM_USBOHCI, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
392 { "--snapshotfolder", MODIFYVM_SNAPSHOTFOLDER, RTGETOPT_REQ_STRING },
393 { "--teleporter", MODIFYVM_TELEPORTER_ENABLED, RTGETOPT_REQ_BOOL_ONOFF },
394 { "--teleporterenabled", MODIFYVM_TELEPORTER_ENABLED, RTGETOPT_REQ_BOOL_ONOFF }, /* deprecated */
395 { "--teleporterport", MODIFYVM_TELEPORTER_PORT, RTGETOPT_REQ_UINT32 },
396 { "--teleporteraddress", MODIFYVM_TELEPORTER_ADDRESS, RTGETOPT_REQ_STRING },
397 { "--teleporterpassword", MODIFYVM_TELEPORTER_PASSWORD, RTGETOPT_REQ_STRING },
398 { "--teleporterpasswordfile", MODIFYVM_TELEPORTER_PASSWORD_FILE, RTGETOPT_REQ_STRING },
399 { "--tracing-enabled", MODIFYVM_TRACING_ENABLED, RTGETOPT_REQ_BOOL_ONOFF },
400 { "--tracing-config", MODIFYVM_TRACING_CONFIG, RTGETOPT_REQ_STRING },
401 { "--tracing-allow-vm-access", MODIFYVM_TRACING_ALLOW_VM_ACCESS, RTGETOPT_REQ_BOOL_ONOFF },
402 { "--hardwareuuid", MODIFYVM_HARDWARE_UUID, RTGETOPT_REQ_STRING },
403 { "--hpet", MODIFYVM_HPET, RTGETOPT_REQ_BOOL_ONOFF },
404 { "--iocache", MODIFYVM_IOCACHE, RTGETOPT_REQ_BOOL_ONOFF },
405 { "--iocachesize", MODIFYVM_IOCACHESIZE, RTGETOPT_REQ_UINT32 },
406 { "--chipset", MODIFYVM_CHIPSET, RTGETOPT_REQ_STRING },
407#ifdef VBOX_WITH_RECORDING
408 { "--recording", MODIFYVM_RECORDING, RTGETOPT_REQ_BOOL_ONOFF },
409 { "--recordingscreens", MODIFYVM_RECORDING_SCREENS, RTGETOPT_REQ_STRING },
410 { "--recordingfile", MODIFYVM_RECORDING_FILENAME, RTGETOPT_REQ_STRING },
411 { "--recordingmaxtime", MODIFYVM_RECORDING_MAXTIME, RTGETOPT_REQ_INT32 },
412 { "--recordingmaxsize", MODIFYVM_RECORDING_MAXSIZE, RTGETOPT_REQ_INT32 },
413 { "--recordingopts", MODIFYVM_RECORDING_OPTIONS, RTGETOPT_REQ_STRING },
414 { "--recordingoptions", MODIFYVM_RECORDING_OPTIONS, RTGETOPT_REQ_STRING },
415 { "--recordingvideores", MODIFYVM_RECORDING_VIDEO_RES, RTGETOPT_REQ_STRING },
416 { "--recordingvideoresolution", MODIFYVM_RECORDING_VIDEO_RES, RTGETOPT_REQ_STRING },
417 { "--recordingvideorate", MODIFYVM_RECORDING_VIDEO_RATE, RTGETOPT_REQ_UINT32 },
418 { "--recordingvideofps", MODIFYVM_RECORDING_VIDEO_FPS, RTGETOPT_REQ_UINT32 },
419#endif
420 { "--autostart-enabled", MODIFYVM_AUTOSTART_ENABLED, RTGETOPT_REQ_BOOL_ONOFF },
421 { "--autostart-delay", MODIFYVM_AUTOSTART_DELAY, RTGETOPT_REQ_UINT32 },
422 { "--autostop-type", MODIFYVM_AUTOSTOP_TYPE, RTGETOPT_REQ_STRING },
423#ifdef VBOX_WITH_PCI_PASSTHROUGH
424 { "--pciattach", MODIFYVM_ATTACH_PCI, RTGETOPT_REQ_STRING },
425 { "--pcidetach", MODIFYVM_DETACH_PCI, RTGETOPT_REQ_STRING },
426#endif
427#ifdef VBOX_WITH_USB_CARDREADER
428 { "--usbcardreader", MODIFYVM_USBCARDREADER, RTGETOPT_REQ_BOOL_ONOFF },
429#endif
430 { "--defaultfrontend", MODIFYVM_DEFAULTFRONTEND, RTGETOPT_REQ_STRING },
431 { "--vm-process-priority", MODIFYVM_VMPROC_PRIORITY, RTGETOPT_REQ_STRING },
432};
433
434static void vrdeWarningDeprecatedOption(const char *pszOption)
435{
436 RTStrmPrintf(g_pStdErr, "Warning: '--vrdp%s' is deprecated. Use '--vrde%s'.\n", pszOption, pszOption);
437}
438
439#ifdef VBOX_WITH_PCI_PASSTHROUGH
440/** Parse PCI address in format 01:02.03 and convert it to the numeric representation. */
441static int32_t parsePci(const char* szPciAddr)
442{
443 char* pszNext = (char*)szPciAddr;
444 int rc;
445 uint8_t aVals[3] = {0, 0, 0};
446
447 rc = RTStrToUInt8Ex(pszNext, &pszNext, 16, &aVals[0]);
448 if (RT_FAILURE(rc) || pszNext == NULL || *pszNext != ':')
449 return -1;
450
451 rc = RTStrToUInt8Ex(pszNext+1, &pszNext, 16, &aVals[1]);
452 if (RT_FAILURE(rc) || pszNext == NULL || *pszNext != '.')
453 return -1;
454
455 rc = RTStrToUInt8Ex(pszNext+1, &pszNext, 16, &aVals[2]);
456 if (RT_FAILURE(rc) || pszNext == NULL)
457 return -1;
458
459 return (aVals[0] << 8) | (aVals[1] << 3) | (aVals[2] << 0);
460}
461#endif
462
463void parseGroups(const char *pcszGroups, com::SafeArray<BSTR> *pGroups)
464{
465 while (pcszGroups)
466 {
467 char *pComma = RTStrStr(pcszGroups, ",");
468 if (pComma)
469 {
470 Bstr(pcszGroups, pComma - pcszGroups).detachTo(pGroups->appendedRaw());
471 pcszGroups = pComma + 1;
472 }
473 else
474 {
475 Bstr(pcszGroups).detachTo(pGroups->appendedRaw());
476 pcszGroups = NULL;
477 }
478 }
479}
480
481#ifdef VBOX_WITH_RECORDING
482static int parseScreens(const char *pcszScreens, com::SafeArray<BOOL> *pScreens)
483{
484 while (pcszScreens && *pcszScreens)
485 {
486 char *pszNext;
487 uint32_t iScreen;
488 int rc = RTStrToUInt32Ex(pcszScreens, &pszNext, 0, &iScreen);
489 if (RT_FAILURE(rc))
490 return 1;
491 if (iScreen >= pScreens->size())
492 return 1;
493 if (pszNext && *pszNext)
494 {
495 pszNext = RTStrStripL(pszNext);
496 if (*pszNext != ',')
497 return 1;
498 pszNext++;
499 }
500 (*pScreens)[iScreen] = true;
501 pcszScreens = pszNext;
502 }
503 return 0;
504}
505#endif
506
507static int parseNum(uint32_t uIndex, unsigned cMaxIndex, const char *pszName)
508{
509 if ( uIndex >= 1
510 && uIndex <= cMaxIndex)
511 return uIndex;
512 errorArgument("Invalid %s number %u", pszName, uIndex);
513 return 0;
514}
515
516VMProcPriority_T nameToVMProcPriority(const char *pszName)
517{
518 if (!RTStrICmp(pszName, "default"))
519 return VMProcPriority_Default;
520 if (!RTStrICmp(pszName, "flat"))
521 return VMProcPriority_Flat;
522 if (!RTStrICmp(pszName, "low"))
523 return VMProcPriority_Low;
524 if (!RTStrICmp(pszName, "normal"))
525 return VMProcPriority_Normal;
526 if (!RTStrICmp(pszName, "high"))
527 return VMProcPriority_High;
528
529 return VMProcPriority_Invalid;
530}
531
532RTEXITCODE handleModifyVM(HandlerArg *a)
533{
534 int c;
535 HRESULT rc;
536 Bstr name;
537
538 /* VM ID + at least one parameter. Parameter arguments are checked
539 * individually. */
540 if (a->argc < 2)
541 return errorSyntax(USAGE_MODIFYVM, "Not enough parameters");
542
543 /* try to find the given sessionMachine */
544 ComPtr<IMachine> machine;
545 CHECK_ERROR_RET(a->virtualBox, FindMachine(Bstr(a->argv[0]).raw(),
546 machine.asOutParam()), RTEXITCODE_FAILURE);
547
548
549 /* Get the number of network adapters */
550 ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, machine);
551
552 /* open a session for the VM */
553 CHECK_ERROR_RET(machine, LockMachine(a->session, LockType_Write), RTEXITCODE_FAILURE);
554
555 /* get the mutable session sessionMachine */
556 ComPtr<IMachine> sessionMachine;
557 CHECK_ERROR_RET(a->session, COMGETTER(Machine)(sessionMachine.asOutParam()), RTEXITCODE_FAILURE);
558
559 ComPtr<IBIOSSettings> biosSettings;
560 sessionMachine->COMGETTER(BIOSSettings)(biosSettings.asOutParam());
561
562 ComPtr<IGraphicsAdapter> pGraphicsAdapter;
563 sessionMachine->COMGETTER(GraphicsAdapter)(pGraphicsAdapter.asOutParam());
564
565 RTGETOPTSTATE GetOptState;
566 RTGetOptInit(&GetOptState, a->argc, a->argv, g_aModifyVMOptions,
567 RT_ELEMENTS(g_aModifyVMOptions), 1, RTGETOPTINIT_FLAGS_NO_STD_OPTS);
568
569 RTGETOPTUNION ValueUnion;
570 while ( SUCCEEDED (rc)
571 && (c = RTGetOpt(&GetOptState, &ValueUnion)))
572 {
573 switch (c)
574 {
575 case MODIFYVM_NAME:
576 {
577 CHECK_ERROR(sessionMachine, COMSETTER(Name)(Bstr(ValueUnion.psz).raw()));
578 break;
579 }
580 case MODIFYVM_GROUPS:
581 {
582 com::SafeArray<BSTR> groups;
583 parseGroups(ValueUnion.psz, &groups);
584 CHECK_ERROR(sessionMachine, COMSETTER(Groups)(ComSafeArrayAsInParam(groups)));
585 break;
586 }
587 case MODIFYVM_DESCRIPTION:
588 {
589 CHECK_ERROR(sessionMachine, COMSETTER(Description)(Bstr(ValueUnion.psz).raw()));
590 break;
591 }
592 case MODIFYVM_OSTYPE:
593 {
594 CHECK_ERROR(sessionMachine, COMSETTER(OSTypeId)(Bstr(ValueUnion.psz).raw()));
595 break;
596 }
597
598 case MODIFYVM_ICONFILE:
599 {
600 RTFILE iconFile;
601 int vrc = RTFileOpen(&iconFile, ValueUnion.psz, RTFILE_O_READ | RTFILE_O_OPEN | RTFILE_O_DENY_WRITE);
602 if (RT_FAILURE(vrc))
603 {
604 RTMsgError("Cannot open file \"%s\": %Rrc", ValueUnion.psz, vrc);
605 rc = E_FAIL;
606 break;
607 }
608 uint64_t cbSize;
609 vrc = RTFileQuerySize(iconFile, &cbSize);
610 if (RT_FAILURE(vrc))
611 {
612 RTMsgError("Cannot get size of file \"%s\": %Rrc", ValueUnion.psz, vrc);
613 rc = E_FAIL;
614 break;
615 }
616 if (cbSize > _256K)
617 {
618 RTMsgError("File \"%s\" is bigger than 256KByte", ValueUnion.psz);
619 rc = E_FAIL;
620 break;
621 }
622 SafeArray<BYTE> icon((size_t)cbSize);
623 rc = RTFileRead(iconFile, icon.raw(), (size_t)cbSize, NULL);
624 if (RT_FAILURE(vrc))
625 {
626 RTMsgError("Cannot read contents of file \"%s\": %Rrc", ValueUnion.psz, vrc);
627 rc = E_FAIL;
628 break;
629 }
630 RTFileClose(iconFile);
631 CHECK_ERROR(sessionMachine, COMSETTER(Icon)(ComSafeArrayAsInParam(icon)));
632 break;
633 }
634
635 case MODIFYVM_MEMORY:
636 {
637 CHECK_ERROR(sessionMachine, COMSETTER(MemorySize)(ValueUnion.u32));
638 break;
639 }
640
641 case MODIFYVM_PAGEFUSION:
642 {
643 CHECK_ERROR(sessionMachine, COMSETTER(PageFusionEnabled)(ValueUnion.f));
644 break;
645 }
646
647 case MODIFYVM_VRAM:
648 {
649 CHECK_ERROR(pGraphicsAdapter, COMSETTER(VRAMSize)(ValueUnion.u32));
650 break;
651 }
652
653 case MODIFYVM_FIRMWARE:
654 {
655 if (!RTStrICmp(ValueUnion.psz, "efi"))
656 {
657 CHECK_ERROR(sessionMachine, COMSETTER(FirmwareType)(FirmwareType_EFI));
658 }
659 else if (!RTStrICmp(ValueUnion.psz, "efi32"))
660 {
661 CHECK_ERROR(sessionMachine, COMSETTER(FirmwareType)(FirmwareType_EFI32));
662 }
663 else if (!RTStrICmp(ValueUnion.psz, "efi64"))
664 {
665 CHECK_ERROR(sessionMachine, COMSETTER(FirmwareType)(FirmwareType_EFI64));
666 }
667 else if (!RTStrICmp(ValueUnion.psz, "efidual"))
668 {
669 CHECK_ERROR(sessionMachine, COMSETTER(FirmwareType)(FirmwareType_EFIDUAL));
670 }
671 else if (!RTStrICmp(ValueUnion.psz, "bios"))
672 {
673 CHECK_ERROR(sessionMachine, COMSETTER(FirmwareType)(FirmwareType_BIOS));
674 }
675 else
676 {
677 errorArgument("Invalid --firmware argument '%s'", ValueUnion.psz);
678 rc = E_FAIL;
679 }
680 break;
681 }
682
683 case MODIFYVM_ACPI:
684 {
685 CHECK_ERROR(biosSettings, COMSETTER(ACPIEnabled)(ValueUnion.f));
686 break;
687 }
688
689 case MODIFYVM_IOAPIC:
690 {
691 CHECK_ERROR(biosSettings, COMSETTER(IOAPICEnabled)(ValueUnion.f));
692 break;
693 }
694
695 case MODIFYVM_PAE:
696 {
697 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_PAE, ValueUnion.f));
698 break;
699 }
700
701 case MODIFYVM_LONGMODE:
702 {
703 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_LongMode, ValueUnion.f));
704 break;
705 }
706
707 case MODIFYVM_CPUID_PORTABILITY:
708 {
709 CHECK_ERROR(sessionMachine, COMSETTER(CPUIDPortabilityLevel)(ValueUnion.u32));
710 break;
711 }
712
713 case MODIFYVM_TFRESET:
714 {
715 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_TripleFaultReset, ValueUnion.f));
716 break;
717 }
718
719 case MODIFYVM_APIC:
720 {
721 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_APIC, ValueUnion.f));
722 break;
723 }
724
725 case MODIFYVM_X2APIC:
726 {
727 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_X2APIC, ValueUnion.f));
728 break;
729 }
730
731 case MODIFYVM_PARAVIRTPROVIDER:
732 {
733 if ( !RTStrICmp(ValueUnion.psz, "none")
734 || !RTStrICmp(ValueUnion.psz, "disabled"))
735 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_None));
736 else if (!RTStrICmp(ValueUnion.psz, "default"))
737 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_Default));
738 else if (!RTStrICmp(ValueUnion.psz, "legacy"))
739 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_Legacy));
740 else if (!RTStrICmp(ValueUnion.psz, "minimal"))
741 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_Minimal));
742 else if (!RTStrICmp(ValueUnion.psz, "hyperv"))
743 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_HyperV));
744 else if (!RTStrICmp(ValueUnion.psz, "kvm"))
745 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtProvider)(ParavirtProvider_KVM));
746 else
747 {
748 errorArgument("Invalid --paravirtprovider argument '%s'", ValueUnion.psz);
749 rc = E_FAIL;
750 }
751 break;
752 }
753
754 case MODIFYVM_PARAVIRTDEBUG:
755 {
756 CHECK_ERROR(sessionMachine, COMSETTER(ParavirtDebug)(Bstr(ValueUnion.psz).raw()));
757 break;
758 }
759
760 case MODIFYVM_HWVIRTEX:
761 {
762 CHECK_ERROR(sessionMachine, SetHWVirtExProperty(HWVirtExPropertyType_Enabled, ValueUnion.f));
763 break;
764 }
765
766 case MODIFYVM_SETCPUID:
767 case MODIFYVM_SETCPUID_OLD:
768 {
769 uint32_t const idx = c == MODIFYVM_SETCPUID ? ValueUnion.PairU32.uFirst : ValueUnion.u32;
770 uint32_t const idxSub = c == MODIFYVM_SETCPUID ? ValueUnion.PairU32.uSecond : UINT32_MAX;
771 uint32_t aValue[4];
772 for (unsigned i = 0; i < 4; i++)
773 {
774 int vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_UINT32 | RTGETOPT_FLAG_HEX);
775 if (RT_FAILURE(vrc))
776 return errorSyntax(USAGE_MODIFYVM, "Missing or Invalid argument to '%s'", GetOptState.pDef->pszLong);
777 aValue[i] = ValueUnion.u32;
778 }
779 CHECK_ERROR(sessionMachine, SetCPUIDLeaf(idx, idxSub, aValue[0], aValue[1], aValue[2], aValue[3]));
780 break;
781 }
782
783 case MODIFYVM_DELCPUID:
784 CHECK_ERROR(sessionMachine, RemoveCPUIDLeaf(ValueUnion.PairU32.uFirst, ValueUnion.PairU32.uSecond));
785 break;
786
787 case MODIFYVM_DELCPUID_OLD:
788 CHECK_ERROR(sessionMachine, RemoveCPUIDLeaf(ValueUnion.u32, UINT32_MAX));
789 break;
790
791 case MODIFYVM_DELALLCPUID:
792 {
793 CHECK_ERROR(sessionMachine, RemoveAllCPUIDLeaves());
794 break;
795 }
796
797 case MODIFYVM_NESTEDPAGING:
798 {
799 CHECK_ERROR(sessionMachine, SetHWVirtExProperty(HWVirtExPropertyType_NestedPaging, ValueUnion.f));
800 break;
801 }
802
803 case MODIFYVM_LARGEPAGES:
804 {
805 CHECK_ERROR(sessionMachine, SetHWVirtExProperty(HWVirtExPropertyType_LargePages, ValueUnion.f));
806 break;
807 }
808
809 case MODIFYVM_VTXVPID:
810 {
811 CHECK_ERROR(sessionMachine, SetHWVirtExProperty(HWVirtExPropertyType_VPID, ValueUnion.f));
812 break;
813 }
814
815 case MODIFYVM_VTXUX:
816 {
817 CHECK_ERROR(sessionMachine, SetHWVirtExProperty(HWVirtExPropertyType_UnrestrictedExecution, ValueUnion.f));
818 break;
819 }
820
821 case MODIFYVM_IBPB_ON_VM_EXIT:
822 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_IBPBOnVMExit, ValueUnion.f));
823 break;
824
825 case MODIFYVM_IBPB_ON_VM_ENTRY:
826 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_IBPBOnVMEntry, ValueUnion.f));
827 break;
828
829 case MODIFYVM_SPEC_CTRL:
830 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_SpecCtrl, ValueUnion.f));
831 break;
832
833 case MODIFYVM_L1D_FLUSH_ON_SCHED:
834 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_L1DFlushOnEMTScheduling, ValueUnion.f));
835 break;
836
837 case MODIFYVM_L1D_FLUSH_ON_VM_ENTRY:
838 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_L1DFlushOnVMEntry, ValueUnion.f));
839 break;
840
841 case MODIFYVM_MDS_CLEAR_ON_SCHED:
842 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_MDSClearOnEMTScheduling, ValueUnion.f));
843 break;
844
845 case MODIFYVM_MDS_CLEAR_ON_VM_ENTRY:
846 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_MDSClearOnVMEntry, ValueUnion.f));
847 break;
848
849 case MODIFYVM_NESTED_HW_VIRT:
850 CHECK_ERROR(sessionMachine, SetCPUProperty(CPUPropertyType_HWVirt, ValueUnion.f));
851 break;
852
853 case MODIFYVM_CPUS:
854 {
855 CHECK_ERROR(sessionMachine, COMSETTER(CPUCount)(ValueUnion.u32));
856 break;
857 }
858
859 case MODIFYVM_RTCUSEUTC:
860 {
861 CHECK_ERROR(sessionMachine, COMSETTER(RTCUseUTC)(ValueUnion.f));
862 break;
863 }
864
865 case MODIFYVM_CPUHOTPLUG:
866 {
867 CHECK_ERROR(sessionMachine, COMSETTER(CPUHotPlugEnabled)(ValueUnion.f));
868 break;
869 }
870
871 case MODIFYVM_CPU_PROFILE:
872 {
873 CHECK_ERROR(sessionMachine, COMSETTER(CPUProfile)(Bstr(ValueUnion.psz).raw()));
874 break;
875 }
876
877 case MODIFYVM_PLUGCPU:
878 {
879 CHECK_ERROR(sessionMachine, HotPlugCPU(ValueUnion.u32));
880 break;
881 }
882
883 case MODIFYVM_UNPLUGCPU:
884 {
885 CHECK_ERROR(sessionMachine, HotUnplugCPU(ValueUnion.u32));
886 break;
887 }
888
889 case MODIFYVM_CPU_EXECTUION_CAP:
890 {
891 CHECK_ERROR(sessionMachine, COMSETTER(CPUExecutionCap)(ValueUnion.u32));
892 break;
893 }
894
895 case MODIFYVM_GRAPHICSCONTROLLER:
896 {
897 if ( !RTStrICmp(ValueUnion.psz, "none")
898 || !RTStrICmp(ValueUnion.psz, "disabled"))
899 CHECK_ERROR(pGraphicsAdapter, COMSETTER(GraphicsControllerType)(GraphicsControllerType_Null));
900 else if ( !RTStrICmp(ValueUnion.psz, "vboxvga")
901 || !RTStrICmp(ValueUnion.psz, "vbox")
902 || !RTStrICmp(ValueUnion.psz, "vga")
903 || !RTStrICmp(ValueUnion.psz, "vesa"))
904 CHECK_ERROR(pGraphicsAdapter, COMSETTER(GraphicsControllerType)(GraphicsControllerType_VBoxVGA));
905#ifdef VBOX_WITH_VMSVGA
906 else if ( !RTStrICmp(ValueUnion.psz, "vmsvga")
907 || !RTStrICmp(ValueUnion.psz, "vmware"))
908 CHECK_ERROR(pGraphicsAdapter, COMSETTER(GraphicsControllerType)(GraphicsControllerType_VMSVGA));
909 else if ( !RTStrICmp(ValueUnion.psz, "vboxsvga")
910 || !RTStrICmp(ValueUnion.psz, "svga"))
911 CHECK_ERROR(pGraphicsAdapter, COMSETTER(GraphicsControllerType)(GraphicsControllerType_VBoxSVGA));
912#endif
913 else
914 {
915 errorArgument("Invalid --graphicscontroller argument '%s'", ValueUnion.psz);
916 rc = E_FAIL;
917 }
918 break;
919 }
920
921 case MODIFYVM_MONITORCOUNT:
922 {
923 CHECK_ERROR(pGraphicsAdapter, COMSETTER(MonitorCount)(ValueUnion.u32));
924 break;
925 }
926
927 case MODIFYVM_ACCELERATE3D:
928 {
929 CHECK_ERROR(pGraphicsAdapter, COMSETTER(Accelerate3DEnabled)(ValueUnion.f));
930 break;
931 }
932
933#ifdef VBOX_WITH_VIDEOHWACCEL
934 case MODIFYVM_ACCELERATE2DVIDEO:
935 {
936 CHECK_ERROR(pGraphicsAdapter, COMSETTER(Accelerate2DVideoEnabled)(ValueUnion.f));
937 break;
938 }
939#endif
940
941 case MODIFYVM_BIOSLOGOFADEIN:
942 {
943 CHECK_ERROR(biosSettings, COMSETTER(LogoFadeIn)(ValueUnion.f));
944 break;
945 }
946
947 case MODIFYVM_BIOSLOGOFADEOUT:
948 {
949 CHECK_ERROR(biosSettings, COMSETTER(LogoFadeOut)(ValueUnion.f));
950 break;
951 }
952
953 case MODIFYVM_BIOSLOGODISPLAYTIME:
954 {
955 CHECK_ERROR(biosSettings, COMSETTER(LogoDisplayTime)(ValueUnion.u32));
956 break;
957 }
958
959 case MODIFYVM_BIOSLOGOIMAGEPATH:
960 {
961 CHECK_ERROR(biosSettings, COMSETTER(LogoImagePath)(Bstr(ValueUnion.psz).raw()));
962 break;
963 }
964
965 case MODIFYVM_BIOSBOOTMENU:
966 {
967 if (!RTStrICmp(ValueUnion.psz, "disabled"))
968 {
969 CHECK_ERROR(biosSettings, COMSETTER(BootMenuMode)(BIOSBootMenuMode_Disabled));
970 }
971 else if (!RTStrICmp(ValueUnion.psz, "menuonly"))
972 {
973 CHECK_ERROR(biosSettings, COMSETTER(BootMenuMode)(BIOSBootMenuMode_MenuOnly));
974 }
975 else if (!RTStrICmp(ValueUnion.psz, "messageandmenu"))
976 {
977 CHECK_ERROR(biosSettings, COMSETTER(BootMenuMode)(BIOSBootMenuMode_MessageAndMenu));
978 }
979 else
980 {
981 errorArgument("Invalid --biosbootmenu argument '%s'", ValueUnion.psz);
982 rc = E_FAIL;
983 }
984 break;
985 }
986
987 case MODIFYVM_BIOSAPIC:
988 {
989 if (!RTStrICmp(ValueUnion.psz, "disabled"))
990 {
991 CHECK_ERROR(biosSettings, COMSETTER(APICMode)(APICMode_Disabled));
992 }
993 else if ( !RTStrICmp(ValueUnion.psz, "apic")
994 || !RTStrICmp(ValueUnion.psz, "lapic")
995 || !RTStrICmp(ValueUnion.psz, "xapic"))
996 {
997 CHECK_ERROR(biosSettings, COMSETTER(APICMode)(APICMode_APIC));
998 }
999 else if (!RTStrICmp(ValueUnion.psz, "x2apic"))
1000 {
1001 CHECK_ERROR(biosSettings, COMSETTER(APICMode)(APICMode_X2APIC));
1002 }
1003 else
1004 {
1005 errorArgument("Invalid --biosapic argument '%s'", ValueUnion.psz);
1006 rc = E_FAIL;
1007 }
1008 break;
1009 }
1010
1011 case MODIFYVM_BIOSSYSTEMTIMEOFFSET:
1012 {
1013 CHECK_ERROR(biosSettings, COMSETTER(TimeOffset)(ValueUnion.i64));
1014 break;
1015 }
1016
1017 case MODIFYVM_BIOSPXEDEBUG:
1018 {
1019 CHECK_ERROR(biosSettings, COMSETTER(PXEDebugEnabled)(ValueUnion.f));
1020 break;
1021 }
1022
1023 case MODIFYVM_SYSTEMUUIDLE:
1024 {
1025 CHECK_ERROR(biosSettings, COMSETTER(SMBIOSUuidLittleEndian)(ValueUnion.f));
1026 break;
1027 }
1028
1029 case MODIFYVM_BOOT:
1030 {
1031 if (!RTStrICmp(ValueUnion.psz, "none"))
1032 {
1033 CHECK_ERROR(sessionMachine, SetBootOrder(GetOptState.uIndex, DeviceType_Null));
1034 }
1035 else if (!RTStrICmp(ValueUnion.psz, "floppy"))
1036 {
1037 CHECK_ERROR(sessionMachine, SetBootOrder(GetOptState.uIndex, DeviceType_Floppy));
1038 }
1039 else if (!RTStrICmp(ValueUnion.psz, "dvd"))
1040 {
1041 CHECK_ERROR(sessionMachine, SetBootOrder(GetOptState.uIndex, DeviceType_DVD));
1042 }
1043 else if (!RTStrICmp(ValueUnion.psz, "disk"))
1044 {
1045 CHECK_ERROR(sessionMachine, SetBootOrder(GetOptState.uIndex, DeviceType_HardDisk));
1046 }
1047 else if (!RTStrICmp(ValueUnion.psz, "net"))
1048 {
1049 CHECK_ERROR(sessionMachine, SetBootOrder(GetOptState.uIndex, DeviceType_Network));
1050 }
1051 else
1052 return errorArgument("Invalid boot device '%s'", ValueUnion.psz);
1053 break;
1054 }
1055
1056 case MODIFYVM_HDA: // deprecated
1057 case MODIFYVM_HDB: // deprecated
1058 case MODIFYVM_HDD: // deprecated
1059 case MODIFYVM_SATAPORT: // deprecated
1060 {
1061 uint32_t u1 = 0, u2 = 0;
1062 Bstr bstrController = L"IDE Controller";
1063
1064 switch (c)
1065 {
1066 case MODIFYVM_HDA: // deprecated
1067 u1 = 0;
1068 break;
1069
1070 case MODIFYVM_HDB: // deprecated
1071 u1 = 0;
1072 u2 = 1;
1073 break;
1074
1075 case MODIFYVM_HDD: // deprecated
1076 u1 = 1;
1077 u2 = 1;
1078 break;
1079
1080 case MODIFYVM_SATAPORT: // deprecated
1081 u1 = GetOptState.uIndex;
1082 bstrController = L"SATA";
1083 break;
1084 }
1085
1086 if (!RTStrICmp(ValueUnion.psz, "none"))
1087 {
1088 sessionMachine->DetachDevice(bstrController.raw(), u1, u2);
1089 }
1090 else
1091 {
1092 ComPtr<IMedium> hardDisk;
1093 rc = openMedium(a, ValueUnion.psz, DeviceType_HardDisk,
1094 AccessMode_ReadWrite, hardDisk,
1095 false /* fForceNewUuidOnOpen */,
1096 false /* fSilent */);
1097 if (FAILED(rc))
1098 break;
1099 if (hardDisk)
1100 {
1101 CHECK_ERROR(sessionMachine, AttachDevice(bstrController.raw(),
1102 u1, u2,
1103 DeviceType_HardDisk,
1104 hardDisk));
1105 }
1106 else
1107 rc = E_FAIL;
1108 }
1109 break;
1110 }
1111
1112 case MODIFYVM_IDECONTROLLER: // deprecated
1113 {
1114 ComPtr<IStorageController> storageController;
1115 CHECK_ERROR(sessionMachine, GetStorageControllerByName(Bstr("IDE Controller").raw(),
1116 storageController.asOutParam()));
1117
1118 if (!RTStrICmp(ValueUnion.psz, "PIIX3"))
1119 {
1120 CHECK_ERROR(storageController, COMSETTER(ControllerType)(StorageControllerType_PIIX3));
1121 }
1122 else if (!RTStrICmp(ValueUnion.psz, "PIIX4"))
1123 {
1124 CHECK_ERROR(storageController, COMSETTER(ControllerType)(StorageControllerType_PIIX4));
1125 }
1126 else if (!RTStrICmp(ValueUnion.psz, "ICH6"))
1127 {
1128 CHECK_ERROR(storageController, COMSETTER(ControllerType)(StorageControllerType_ICH6));
1129 }
1130 else
1131 {
1132 errorArgument("Invalid --idecontroller argument '%s'", ValueUnion.psz);
1133 rc = E_FAIL;
1134 }
1135 break;
1136 }
1137
1138 case MODIFYVM_SATAPORTCOUNT: // deprecated
1139 {
1140 ComPtr<IStorageController> SataCtl;
1141 CHECK_ERROR(sessionMachine, GetStorageControllerByName(Bstr("SATA").raw(),
1142 SataCtl.asOutParam()));
1143
1144 if (SUCCEEDED(rc) && ValueUnion.u32 > 0)
1145 CHECK_ERROR(SataCtl, COMSETTER(PortCount)(ValueUnion.u32));
1146 break;
1147 }
1148
1149 case MODIFYVM_SATA: // deprecated
1150 {
1151 if (!RTStrICmp(ValueUnion.psz, "on") || !RTStrICmp(ValueUnion.psz, "enable"))
1152 {
1153 ComPtr<IStorageController> ctl;
1154 CHECK_ERROR(sessionMachine, AddStorageController(Bstr("SATA").raw(),
1155 StorageBus_SATA,
1156 ctl.asOutParam()));
1157 CHECK_ERROR(ctl, COMSETTER(ControllerType)(StorageControllerType_IntelAhci));
1158 }
1159 else if (!RTStrICmp(ValueUnion.psz, "off") || !RTStrICmp(ValueUnion.psz, "disable"))
1160 CHECK_ERROR(sessionMachine, RemoveStorageController(Bstr("SATA").raw()));
1161 else
1162 return errorArgument("Invalid --usb argument '%s'", ValueUnion.psz);
1163 break;
1164 }
1165
1166 case MODIFYVM_SCSIPORT: // deprecated
1167 {
1168 if (!RTStrICmp(ValueUnion.psz, "none"))
1169 {
1170 rc = sessionMachine->DetachDevice(Bstr("LsiLogic").raw(),
1171 GetOptState.uIndex, 0);
1172 if (FAILED(rc))
1173 CHECK_ERROR(sessionMachine, DetachDevice(Bstr("BusLogic").raw(),
1174 GetOptState.uIndex, 0));
1175 }
1176 else
1177 {
1178 ComPtr<IMedium> hardDisk;
1179 rc = openMedium(a, ValueUnion.psz, DeviceType_HardDisk,
1180 AccessMode_ReadWrite, hardDisk,
1181 false /* fForceNewUuidOnOpen */,
1182 false /* fSilent */);
1183 if (FAILED(rc))
1184 break;
1185 if (hardDisk)
1186 {
1187 rc = sessionMachine->AttachDevice(Bstr("LsiLogic").raw(),
1188 GetOptState.uIndex, 0,
1189 DeviceType_HardDisk,
1190 hardDisk);
1191 if (FAILED(rc))
1192 CHECK_ERROR(sessionMachine,
1193 AttachDevice(Bstr("BusLogic").raw(),
1194 GetOptState.uIndex, 0,
1195 DeviceType_HardDisk,
1196 hardDisk));
1197 }
1198 else
1199 rc = E_FAIL;
1200 }
1201 break;
1202 }
1203
1204 case MODIFYVM_SCSITYPE: // deprecated
1205 {
1206 ComPtr<IStorageController> ctl;
1207
1208 if (!RTStrICmp(ValueUnion.psz, "LsiLogic"))
1209 {
1210 rc = sessionMachine->RemoveStorageController(Bstr("BusLogic").raw());
1211 if (FAILED(rc))
1212 CHECK_ERROR(sessionMachine, RemoveStorageController(Bstr("LsiLogic").raw()));
1213
1214 CHECK_ERROR(sessionMachine,
1215 AddStorageController(Bstr("LsiLogic").raw(),
1216 StorageBus_SCSI,
1217 ctl.asOutParam()));
1218
1219 if (SUCCEEDED(rc))
1220 CHECK_ERROR(ctl, COMSETTER(ControllerType)(StorageControllerType_LsiLogic));
1221 }
1222 else if (!RTStrICmp(ValueUnion.psz, "BusLogic"))
1223 {
1224 rc = sessionMachine->RemoveStorageController(Bstr("LsiLogic").raw());
1225 if (FAILED(rc))
1226 CHECK_ERROR(sessionMachine, RemoveStorageController(Bstr("BusLogic").raw()));
1227
1228 CHECK_ERROR(sessionMachine,
1229 AddStorageController(Bstr("BusLogic").raw(),
1230 StorageBus_SCSI,
1231 ctl.asOutParam()));
1232
1233 if (SUCCEEDED(rc))
1234 CHECK_ERROR(ctl, COMSETTER(ControllerType)(StorageControllerType_BusLogic));
1235 }
1236 else
1237 return errorArgument("Invalid --scsitype argument '%s'", ValueUnion.psz);
1238 break;
1239 }
1240
1241 case MODIFYVM_SCSI: // deprecated
1242 {
1243 if (!RTStrICmp(ValueUnion.psz, "on") || !RTStrICmp(ValueUnion.psz, "enable"))
1244 {
1245 ComPtr<IStorageController> ctl;
1246
1247 CHECK_ERROR(sessionMachine, AddStorageController(Bstr("BusLogic").raw(),
1248 StorageBus_SCSI,
1249 ctl.asOutParam()));
1250 if (SUCCEEDED(rc))
1251 CHECK_ERROR(ctl, COMSETTER(ControllerType)(StorageControllerType_BusLogic));
1252 }
1253 else if (!RTStrICmp(ValueUnion.psz, "off") || !RTStrICmp(ValueUnion.psz, "disable"))
1254 {
1255 rc = sessionMachine->RemoveStorageController(Bstr("BusLogic").raw());
1256 if (FAILED(rc))
1257 CHECK_ERROR(sessionMachine, RemoveStorageController(Bstr("LsiLogic").raw()));
1258 }
1259 break;
1260 }
1261
1262 case MODIFYVM_DVDPASSTHROUGH: // deprecated
1263 {
1264 CHECK_ERROR(sessionMachine, PassthroughDevice(Bstr("IDE Controller").raw(),
1265 1, 0,
1266 !RTStrICmp(ValueUnion.psz, "on")));
1267 break;
1268 }
1269
1270 case MODIFYVM_DVD: // deprecated
1271 {
1272 ComPtr<IMedium> dvdMedium;
1273
1274 /* unmount? */
1275 if (!RTStrICmp(ValueUnion.psz, "none"))
1276 {
1277 /* nothing to do, NULL object will cause unmount */
1278 }
1279 /* host drive? */
1280 else if (!RTStrNICmp(ValueUnion.psz, RT_STR_TUPLE("host:")))
1281 {
1282 ComPtr<IHost> host;
1283 CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
1284 rc = host->FindHostDVDDrive(Bstr(ValueUnion.psz + 5).raw(),
1285 dvdMedium.asOutParam());
1286 if (!dvdMedium)
1287 {
1288 /* 2nd try: try with the real name, important on Linux+libhal */
1289 char szPathReal[RTPATH_MAX];
1290 if (RT_FAILURE(RTPathReal(ValueUnion.psz + 5, szPathReal, sizeof(szPathReal))))
1291 {
1292 errorArgument("Invalid host DVD drive name \"%s\"", ValueUnion.psz + 5);
1293 rc = E_FAIL;
1294 break;
1295 }
1296 rc = host->FindHostDVDDrive(Bstr(szPathReal).raw(),
1297 dvdMedium.asOutParam());
1298 if (!dvdMedium)
1299 {
1300 errorArgument("Invalid host DVD drive name \"%s\"", ValueUnion.psz + 5);
1301 rc = E_FAIL;
1302 break;
1303 }
1304 }
1305 }
1306 else
1307 {
1308 rc = openMedium(a, ValueUnion.psz, DeviceType_DVD,
1309 AccessMode_ReadOnly, dvdMedium,
1310 false /* fForceNewUuidOnOpen */,
1311 false /* fSilent */);
1312 if (FAILED(rc))
1313 break;
1314 if (!dvdMedium)
1315 {
1316 rc = E_FAIL;
1317 break;
1318 }
1319 }
1320
1321 CHECK_ERROR(sessionMachine, MountMedium(Bstr("IDE Controller").raw(),
1322 1, 0,
1323 dvdMedium,
1324 FALSE /* aForce */));
1325 break;
1326 }
1327
1328 case MODIFYVM_FLOPPY: // deprecated
1329 {
1330 ComPtr<IMedium> floppyMedium;
1331 ComPtr<IMediumAttachment> floppyAttachment;
1332 sessionMachine->GetMediumAttachment(Bstr("Floppy Controller").raw(),
1333 0, 0, floppyAttachment.asOutParam());
1334
1335 /* disable? */
1336 if (!RTStrICmp(ValueUnion.psz, "disabled"))
1337 {
1338 /* disable the controller */
1339 if (floppyAttachment)
1340 CHECK_ERROR(sessionMachine, DetachDevice(Bstr("Floppy Controller").raw(),
1341 0, 0));
1342 }
1343 else
1344 {
1345 /* enable the controller */
1346 if (!floppyAttachment)
1347 CHECK_ERROR(sessionMachine, AttachDeviceWithoutMedium(Bstr("Floppy Controller").raw(),
1348 0, 0,
1349 DeviceType_Floppy));
1350
1351 /* unmount? */
1352 if ( !RTStrICmp(ValueUnion.psz, "none")
1353 || !RTStrICmp(ValueUnion.psz, "empty")) // deprecated
1354 {
1355 /* nothing to do, NULL object will cause unmount */
1356 }
1357 /* host drive? */
1358 else if (!RTStrNICmp(ValueUnion.psz, RT_STR_TUPLE("host:")))
1359 {
1360 ComPtr<IHost> host;
1361 CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
1362 rc = host->FindHostFloppyDrive(Bstr(ValueUnion.psz + 5).raw(),
1363 floppyMedium.asOutParam());
1364 if (!floppyMedium)
1365 {
1366 errorArgument("Invalid host floppy drive name \"%s\"", ValueUnion.psz + 5);
1367 rc = E_FAIL;
1368 break;
1369 }
1370 }
1371 else
1372 {
1373 rc = openMedium(a, ValueUnion.psz, DeviceType_Floppy,
1374 AccessMode_ReadWrite, floppyMedium,
1375 false /* fForceNewUuidOnOpen */,
1376 false /* fSilent */);
1377 if (FAILED(rc))
1378 break;
1379 if (!floppyMedium)
1380 {
1381 rc = E_FAIL;
1382 break;
1383 }
1384 }
1385 CHECK_ERROR(sessionMachine, MountMedium(Bstr("Floppy Controller").raw(),
1386 0, 0,
1387 floppyMedium,
1388 FALSE /* aForce */));
1389 }
1390 break;
1391 }
1392
1393 case MODIFYVM_NICTRACEFILE:
1394 {
1395
1396 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1397 break;
1398
1399 ComPtr<INetworkAdapter> nic;
1400 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1401 ASSERT(nic);
1402
1403 CHECK_ERROR(nic, COMSETTER(TraceFile)(Bstr(ValueUnion.psz).raw()));
1404 break;
1405 }
1406
1407 case MODIFYVM_NICTRACE:
1408 {
1409 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1410 break;
1411
1412 ComPtr<INetworkAdapter> nic;
1413 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1414 ASSERT(nic);
1415
1416 CHECK_ERROR(nic, COMSETTER(TraceEnabled)(ValueUnion.f));
1417 break;
1418 }
1419
1420 case MODIFYVM_NICPROPERTY:
1421 {
1422 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1423 break;
1424
1425 ComPtr<INetworkAdapter> nic;
1426 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1427 ASSERT(nic);
1428
1429 if (nic)
1430 {
1431 /* Parse 'name=value' */
1432 char *pszProperty = RTStrDup(ValueUnion.psz);
1433 if (pszProperty)
1434 {
1435 char *pDelimiter = strchr(pszProperty, '=');
1436 if (pDelimiter)
1437 {
1438 *pDelimiter = '\0';
1439
1440 Bstr bstrName = pszProperty;
1441 Bstr bstrValue = &pDelimiter[1];
1442 CHECK_ERROR(nic, SetProperty(bstrName.raw(), bstrValue.raw()));
1443 }
1444 else
1445 {
1446 errorArgument("Invalid --nicproperty%d argument '%s'", GetOptState.uIndex, ValueUnion.psz);
1447 rc = E_FAIL;
1448 }
1449 RTStrFree(pszProperty);
1450 }
1451 else
1452 {
1453 RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for --nicproperty%d '%s'\n", GetOptState.uIndex, ValueUnion.psz);
1454 rc = E_FAIL;
1455 }
1456 }
1457 break;
1458 }
1459 case MODIFYVM_NICTYPE:
1460 {
1461 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1462 break;
1463
1464 ComPtr<INetworkAdapter> nic;
1465 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1466 ASSERT(nic);
1467
1468 if (!RTStrICmp(ValueUnion.psz, "Am79C970A"))
1469 {
1470 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_Am79C970A));
1471 }
1472 else if (!RTStrICmp(ValueUnion.psz, "Am79C973"))
1473 {
1474 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_Am79C973));
1475 }
1476 else if (!RTStrICmp(ValueUnion.psz, "Am79C960"))
1477 {
1478 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_Am79C960));
1479 }
1480#ifdef VBOX_WITH_E1000
1481 else if (!RTStrICmp(ValueUnion.psz, "82540EM"))
1482 {
1483 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_I82540EM));
1484 }
1485 else if (!RTStrICmp(ValueUnion.psz, "82543GC"))
1486 {
1487 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_I82543GC));
1488 }
1489 else if (!RTStrICmp(ValueUnion.psz, "82545EM"))
1490 {
1491 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_I82545EM));
1492 }
1493#endif
1494#ifdef VBOX_WITH_VIRTIO
1495 else if (!RTStrICmp(ValueUnion.psz, "virtio"))
1496 {
1497 CHECK_ERROR(nic, COMSETTER(AdapterType)(NetworkAdapterType_Virtio));
1498 }
1499#endif /* VBOX_WITH_VIRTIO */
1500 else
1501 {
1502 errorArgument("Invalid NIC type '%s' specified for NIC %u", ValueUnion.psz, GetOptState.uIndex);
1503 rc = E_FAIL;
1504 }
1505 break;
1506 }
1507
1508 case MODIFYVM_NICSPEED:
1509 {
1510 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1511 break;
1512
1513 ComPtr<INetworkAdapter> nic;
1514 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1515 ASSERT(nic);
1516
1517 CHECK_ERROR(nic, COMSETTER(LineSpeed)(ValueUnion.u32));
1518 break;
1519 }
1520
1521 case MODIFYVM_NICBOOTPRIO:
1522 {
1523 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1524 break;
1525
1526 ComPtr<INetworkAdapter> nic;
1527 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1528 ASSERT(nic);
1529
1530 /* Somewhat arbitrary limitation - we can pass a list of up to 4 PCI devices
1531 * to the PXE ROM, hence only boot priorities 1-4 are allowed (in addition to
1532 * 0 for the default lowest priority).
1533 */
1534 if (ValueUnion.u32 > 4)
1535 {
1536 errorArgument("Invalid boot priority '%u' specfied for NIC %u", ValueUnion.u32, GetOptState.uIndex);
1537 rc = E_FAIL;
1538 }
1539 else
1540 {
1541 CHECK_ERROR(nic, COMSETTER(BootPriority)(ValueUnion.u32));
1542 }
1543 break;
1544 }
1545
1546 case MODIFYVM_NICPROMISC:
1547 {
1548 NetworkAdapterPromiscModePolicy_T enmPromiscModePolicy;
1549 if (!RTStrICmp(ValueUnion.psz, "deny"))
1550 enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_Deny;
1551 else if ( !RTStrICmp(ValueUnion.psz, "allow-vms")
1552 || !RTStrICmp(ValueUnion.psz, "allow-network"))
1553 enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowNetwork;
1554 else if (!RTStrICmp(ValueUnion.psz, "allow-all"))
1555 enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowAll;
1556 else
1557 {
1558 errorArgument("Unknown promiscuous mode policy '%s'", ValueUnion.psz);
1559 rc = E_INVALIDARG;
1560 break;
1561 }
1562
1563 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1564 break;
1565
1566 ComPtr<INetworkAdapter> nic;
1567 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1568 ASSERT(nic);
1569
1570 CHECK_ERROR(nic, COMSETTER(PromiscModePolicy)(enmPromiscModePolicy));
1571 break;
1572 }
1573
1574 case MODIFYVM_NICBWGROUP:
1575 {
1576 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1577 break;
1578
1579 ComPtr<INetworkAdapter> nic;
1580 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1581 ASSERT(nic);
1582
1583 if (!RTStrICmp(ValueUnion.psz, "none"))
1584 {
1585 /* Just remove the bandwidth group. */
1586 CHECK_ERROR(nic, COMSETTER(BandwidthGroup)(NULL));
1587 }
1588 else
1589 {
1590 ComPtr<IBandwidthControl> bwCtrl;
1591 ComPtr<IBandwidthGroup> bwGroup;
1592
1593 CHECK_ERROR(sessionMachine, COMGETTER(BandwidthControl)(bwCtrl.asOutParam()));
1594
1595 if (SUCCEEDED(rc))
1596 {
1597 CHECK_ERROR(bwCtrl, GetBandwidthGroup(Bstr(ValueUnion.psz).raw(), bwGroup.asOutParam()));
1598 if (SUCCEEDED(rc))
1599 {
1600 CHECK_ERROR(nic, COMSETTER(BandwidthGroup)(bwGroup));
1601 }
1602 }
1603 }
1604 break;
1605 }
1606
1607 case MODIFYVM_NIC:
1608 {
1609 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1610 break;
1611
1612 ComPtr<INetworkAdapter> nic;
1613 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1614 ASSERT(nic);
1615
1616 if (!RTStrICmp(ValueUnion.psz, "none"))
1617 {
1618 CHECK_ERROR(nic, COMSETTER(Enabled)(FALSE));
1619 }
1620 else if (!RTStrICmp(ValueUnion.psz, "null"))
1621 {
1622 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1623 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_Null));
1624 }
1625 else if (!RTStrICmp(ValueUnion.psz, "nat"))
1626 {
1627 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1628 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_NAT));
1629 }
1630 else if ( !RTStrICmp(ValueUnion.psz, "bridged")
1631 || !RTStrICmp(ValueUnion.psz, "hostif")) /* backward compatibility */
1632 {
1633 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1634 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_Bridged));
1635 }
1636 else if (!RTStrICmp(ValueUnion.psz, "intnet"))
1637 {
1638 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1639 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_Internal));
1640 }
1641 else if (!RTStrICmp(ValueUnion.psz, "hostonly"))
1642 {
1643
1644 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1645 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_HostOnly));
1646 }
1647 else if (!RTStrICmp(ValueUnion.psz, "generic"))
1648 {
1649
1650 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1651 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic));
1652 }
1653 else if (!RTStrICmp(ValueUnion.psz, "natnetwork"))
1654 {
1655
1656 CHECK_ERROR(nic, COMSETTER(Enabled)(TRUE));
1657 CHECK_ERROR(nic, COMSETTER(AttachmentType)(NetworkAttachmentType_NATNetwork));
1658 }
1659 else
1660 {
1661 errorArgument("Invalid type '%s' specfied for NIC %u", ValueUnion.psz, GetOptState.uIndex);
1662 rc = E_FAIL;
1663 }
1664 break;
1665 }
1666
1667 case MODIFYVM_CABLECONNECTED:
1668 {
1669 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1670 break;
1671
1672 ComPtr<INetworkAdapter> nic;
1673 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1674 ASSERT(nic);
1675
1676 CHECK_ERROR(nic, COMSETTER(CableConnected)(ValueUnion.f));
1677 break;
1678 }
1679
1680 case MODIFYVM_BRIDGEADAPTER:
1681 {
1682 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1683 break;
1684
1685 ComPtr<INetworkAdapter> nic;
1686 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1687 ASSERT(nic);
1688
1689 /* remove it? */
1690 if (!RTStrICmp(ValueUnion.psz, "none"))
1691 {
1692 CHECK_ERROR(nic, COMSETTER(BridgedInterface)(Bstr().raw()));
1693 }
1694 else
1695 {
1696 CHECK_ERROR(nic, COMSETTER(BridgedInterface)(Bstr(ValueUnion.psz).raw()));
1697 }
1698 break;
1699 }
1700
1701 case MODIFYVM_HOSTONLYADAPTER:
1702 {
1703 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1704 break;
1705
1706 ComPtr<INetworkAdapter> nic;
1707 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1708 ASSERT(nic);
1709
1710 /* remove it? */
1711 if (!RTStrICmp(ValueUnion.psz, "none"))
1712 {
1713 CHECK_ERROR(nic, COMSETTER(HostOnlyInterface)(Bstr().raw()));
1714 }
1715 else
1716 {
1717 CHECK_ERROR(nic, COMSETTER(HostOnlyInterface)(Bstr(ValueUnion.psz).raw()));
1718 }
1719 break;
1720 }
1721
1722 case MODIFYVM_INTNET:
1723 {
1724 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1725 break;
1726
1727 ComPtr<INetworkAdapter> nic;
1728 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1729 ASSERT(nic);
1730
1731 /* remove it? */
1732 if (!RTStrICmp(ValueUnion.psz, "none"))
1733 {
1734 CHECK_ERROR(nic, COMSETTER(InternalNetwork)(Bstr().raw()));
1735 }
1736 else
1737 {
1738 CHECK_ERROR(nic, COMSETTER(InternalNetwork)(Bstr(ValueUnion.psz).raw()));
1739 }
1740 break;
1741 }
1742
1743 case MODIFYVM_GENERICDRV:
1744 {
1745 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1746 break;
1747
1748 ComPtr<INetworkAdapter> nic;
1749 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1750 ASSERT(nic);
1751
1752 CHECK_ERROR(nic, COMSETTER(GenericDriver)(Bstr(ValueUnion.psz).raw()));
1753 break;
1754 }
1755
1756 case MODIFYVM_NATNETWORKNAME:
1757 {
1758 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1759 break;
1760
1761 ComPtr<INetworkAdapter> nic;
1762 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1763 ASSERT(nic);
1764
1765 CHECK_ERROR(nic, COMSETTER(NATNetwork)(Bstr(ValueUnion.psz).raw()));
1766 break;
1767 }
1768
1769 case MODIFYVM_NATNET:
1770 {
1771 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1772 break;
1773
1774 ComPtr<INetworkAdapter> nic;
1775 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1776 ASSERT(nic);
1777
1778 ComPtr<INATEngine> engine;
1779 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1780
1781 const char *psz = ValueUnion.psz;
1782 if (!RTStrICmp("default", psz))
1783 psz = "";
1784
1785 CHECK_ERROR(engine, COMSETTER(Network)(Bstr(psz).raw()));
1786 break;
1787 }
1788
1789 case MODIFYVM_NATBINDIP:
1790 {
1791 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1792 break;
1793
1794 ComPtr<INetworkAdapter> nic;
1795 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1796 ASSERT(nic);
1797
1798 ComPtr<INATEngine> engine;
1799 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1800
1801 CHECK_ERROR(engine, COMSETTER(HostIP)(Bstr(ValueUnion.psz).raw()));
1802 break;
1803 }
1804
1805#define ITERATE_TO_NEXT_TERM(ch) \
1806 do { \
1807 while (*ch != ',') \
1808 { \
1809 if (*ch == 0) \
1810 { \
1811 return errorSyntax(USAGE_MODIFYVM, \
1812 "Missing or Invalid argument to '%s'", \
1813 GetOptState.pDef->pszLong); \
1814 } \
1815 ch++; \
1816 } \
1817 *ch = '\0'; \
1818 ch++; \
1819 } while(0)
1820
1821 case MODIFYVM_NATSETTINGS:
1822 {
1823 ComPtr<INetworkAdapter> nic;
1824 ComPtr<INATEngine> engine;
1825 char *strMtu;
1826 char *strSockSnd;
1827 char *strSockRcv;
1828 char *strTcpSnd;
1829 char *strTcpRcv;
1830 char *strRaw = RTStrDup(ValueUnion.psz);
1831 char *ch = strRaw;
1832 strMtu = RTStrStrip(ch);
1833 ITERATE_TO_NEXT_TERM(ch);
1834 strSockSnd = RTStrStrip(ch);
1835 ITERATE_TO_NEXT_TERM(ch);
1836 strSockRcv = RTStrStrip(ch);
1837 ITERATE_TO_NEXT_TERM(ch);
1838 strTcpSnd = RTStrStrip(ch);
1839 ITERATE_TO_NEXT_TERM(ch);
1840 strTcpRcv = RTStrStrip(ch);
1841
1842 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1843 break;
1844
1845 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1846 ASSERT(nic);
1847
1848 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1849 CHECK_ERROR(engine, SetNetworkSettings(RTStrToUInt32(strMtu), RTStrToUInt32(strSockSnd), RTStrToUInt32(strSockRcv),
1850 RTStrToUInt32(strTcpSnd), RTStrToUInt32(strTcpRcv)));
1851 break;
1852 }
1853
1854
1855 case MODIFYVM_NATPF:
1856 {
1857 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1858 break;
1859
1860 ComPtr<INetworkAdapter> nic;
1861 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1862 ASSERT(nic);
1863
1864 ComPtr<INATEngine> engine;
1865 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1866
1867 /* format name:proto:hostip:hostport:guestip:guestport*/
1868 if (RTStrCmp(ValueUnion.psz, "delete") != 0)
1869 {
1870 char *strName;
1871 char *strProto;
1872 char *strHostIp;
1873 char *strHostPort;
1874 char *strGuestIp;
1875 char *strGuestPort;
1876 char *strRaw = RTStrDup(ValueUnion.psz);
1877 char *ch = strRaw;
1878 strName = RTStrStrip(ch);
1879 ITERATE_TO_NEXT_TERM(ch);
1880 strProto = RTStrStrip(ch);
1881 ITERATE_TO_NEXT_TERM(ch);
1882 strHostIp = RTStrStrip(ch);
1883 ITERATE_TO_NEXT_TERM(ch);
1884 strHostPort = RTStrStrip(ch);
1885 ITERATE_TO_NEXT_TERM(ch);
1886 strGuestIp = RTStrStrip(ch);
1887 ITERATE_TO_NEXT_TERM(ch);
1888 strGuestPort = RTStrStrip(ch);
1889 NATProtocol_T proto;
1890 if (RTStrICmp(strProto, "udp") == 0)
1891 proto = NATProtocol_UDP;
1892 else if (RTStrICmp(strProto, "tcp") == 0)
1893 proto = NATProtocol_TCP;
1894 else
1895 {
1896 errorArgument("Invalid proto '%s' specfied for NIC %u", ValueUnion.psz, GetOptState.uIndex);
1897 rc = E_FAIL;
1898 break;
1899 }
1900 CHECK_ERROR(engine, AddRedirect(Bstr(strName).raw(), proto,
1901 Bstr(strHostIp).raw(),
1902 RTStrToUInt16(strHostPort),
1903 Bstr(strGuestIp).raw(),
1904 RTStrToUInt16(strGuestPort)));
1905 }
1906 else
1907 {
1908 /* delete NAT Rule operation */
1909 int vrc;
1910 vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_STRING);
1911 if (RT_FAILURE(vrc))
1912 return errorSyntax(USAGE_MODIFYVM, "Not enough parameters");
1913 CHECK_ERROR(engine, RemoveRedirect(Bstr(ValueUnion.psz).raw()));
1914 }
1915 break;
1916 }
1917 #undef ITERATE_TO_NEXT_TERM
1918 case MODIFYVM_NATALIASMODE:
1919 {
1920 ComPtr<INetworkAdapter> nic;
1921 ComPtr<INATEngine> engine;
1922 uint32_t aliasMode = 0;
1923
1924 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1925 ASSERT(nic);
1926
1927 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1928 if (RTStrCmp(ValueUnion.psz, "default") == 0)
1929 aliasMode = 0;
1930 else
1931 {
1932 char *token = (char *)ValueUnion.psz;
1933 while (token)
1934 {
1935 if (RTStrNCmp(token, RT_STR_TUPLE("log")) == 0)
1936 aliasMode |= NATAliasMode_AliasLog;
1937 else if (RTStrNCmp(token, RT_STR_TUPLE("proxyonly")) == 0)
1938 aliasMode |= NATAliasMode_AliasProxyOnly;
1939 else if (RTStrNCmp(token, RT_STR_TUPLE("sameports")) == 0)
1940 aliasMode |= NATAliasMode_AliasUseSamePorts;
1941 token = RTStrStr(token, ",");
1942 if (token == NULL)
1943 break;
1944 token++;
1945 }
1946 }
1947 CHECK_ERROR(engine, COMSETTER(AliasMode)(aliasMode));
1948 break;
1949 }
1950
1951 case MODIFYVM_NATTFTPPREFIX:
1952 {
1953 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1954 break;
1955
1956 ComPtr<INetworkAdapter> nic;
1957 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1958 ASSERT(nic);
1959
1960 ComPtr<INATEngine> engine;
1961 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1962
1963 CHECK_ERROR(engine, COMSETTER(TFTPPrefix)(Bstr(ValueUnion.psz).raw()));
1964 break;
1965 }
1966
1967 case MODIFYVM_NATTFTPFILE:
1968 {
1969 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1970 break;
1971
1972 ComPtr<INetworkAdapter> nic;
1973 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1974 ASSERT(nic);
1975
1976 ComPtr<INATEngine> engine;
1977 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1978
1979 CHECK_ERROR(engine, COMSETTER(TFTPBootFile)(Bstr(ValueUnion.psz).raw()));
1980 break;
1981 }
1982
1983 case MODIFYVM_NATTFTPSERVER:
1984 {
1985 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
1986 break;
1987
1988 ComPtr<INetworkAdapter> nic;
1989 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
1990 ASSERT(nic);
1991
1992 ComPtr<INATEngine> engine;
1993 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
1994
1995 CHECK_ERROR(engine, COMSETTER(TFTPNextServer)(Bstr(ValueUnion.psz).raw()));
1996 break;
1997 }
1998 case MODIFYVM_NATDNSPASSDOMAIN:
1999 {
2000 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
2001 break;
2002
2003 ComPtr<INetworkAdapter> nic;
2004 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
2005 ASSERT(nic);
2006
2007 ComPtr<INATEngine> engine;
2008 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
2009
2010 CHECK_ERROR(engine, COMSETTER(DNSPassDomain)(ValueUnion.f));
2011 break;
2012 }
2013
2014 case MODIFYVM_NATDNSPROXY:
2015 {
2016 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
2017 break;
2018
2019 ComPtr<INetworkAdapter> nic;
2020 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
2021 ASSERT(nic);
2022
2023 ComPtr<INATEngine> engine;
2024 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
2025
2026 CHECK_ERROR(engine, COMSETTER(DNSProxy)(ValueUnion.f));
2027 break;
2028 }
2029
2030 case MODIFYVM_NATDNSHOSTRESOLVER:
2031 {
2032 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
2033 break;
2034
2035 ComPtr<INetworkAdapter> nic;
2036 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
2037 ASSERT(nic);
2038
2039 ComPtr<INATEngine> engine;
2040 CHECK_ERROR(nic, COMGETTER(NATEngine)(engine.asOutParam()));
2041
2042 CHECK_ERROR(engine, COMSETTER(DNSUseHostResolver)(ValueUnion.f));
2043 break;
2044 }
2045 case MODIFYVM_MACADDRESS:
2046 {
2047 if (!parseNum(GetOptState.uIndex, NetworkAdapterCount, "NIC"))
2048 break;
2049
2050 ComPtr<INetworkAdapter> nic;
2051 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(GetOptState.uIndex - 1, nic.asOutParam()));
2052 ASSERT(nic);
2053
2054 /* generate one? */
2055 if (!RTStrICmp(ValueUnion.psz, "auto"))
2056 {
2057 CHECK_ERROR(nic, COMSETTER(MACAddress)(Bstr().raw()));
2058 }
2059 else
2060 {
2061 CHECK_ERROR(nic, COMSETTER(MACAddress)(Bstr(ValueUnion.psz).raw()));
2062 }
2063 break;
2064 }
2065
2066 case MODIFYVM_HIDPTR:
2067 {
2068 bool fEnableUsb = false;
2069 if (!RTStrICmp(ValueUnion.psz, "ps2"))
2070 {
2071 CHECK_ERROR(sessionMachine, COMSETTER(PointingHIDType)(PointingHIDType_PS2Mouse));
2072 }
2073 else if (!RTStrICmp(ValueUnion.psz, "usb"))
2074 {
2075 CHECK_ERROR(sessionMachine, COMSETTER(PointingHIDType)(PointingHIDType_USBMouse));
2076 if (SUCCEEDED(rc))
2077 fEnableUsb = true;
2078 }
2079 else if (!RTStrICmp(ValueUnion.psz, "usbtablet"))
2080 {
2081 CHECK_ERROR(sessionMachine, COMSETTER(PointingHIDType)(PointingHIDType_USBTablet));
2082 if (SUCCEEDED(rc))
2083 fEnableUsb = true;
2084 }
2085 else if (!RTStrICmp(ValueUnion.psz, "usbmultitouch"))
2086 {
2087 CHECK_ERROR(sessionMachine, COMSETTER(PointingHIDType)(PointingHIDType_USBMultiTouch));
2088 if (SUCCEEDED(rc))
2089 fEnableUsb = true;
2090 }
2091 else
2092 {
2093 errorArgument("Invalid type '%s' specfied for pointing device", ValueUnion.psz);
2094 rc = E_FAIL;
2095 }
2096 if (fEnableUsb)
2097 {
2098 /* Make sure either the OHCI or xHCI controller is enabled. */
2099 ULONG cOhciCtrls = 0;
2100 ULONG cXhciCtrls = 0;
2101 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_OHCI, &cOhciCtrls);
2102 if (SUCCEEDED(rc)) {
2103 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_XHCI, &cXhciCtrls);
2104 if ( SUCCEEDED(rc)
2105 && cOhciCtrls + cXhciCtrls == 0)
2106 {
2107 /* If there's nothing, enable OHCI (always available). */
2108 ComPtr<IUSBController> UsbCtl;
2109 CHECK_ERROR(sessionMachine, AddUSBController(Bstr("OHCI").raw(), USBControllerType_OHCI,
2110 UsbCtl.asOutParam()));
2111 }
2112 }
2113 }
2114 break;
2115 }
2116
2117 case MODIFYVM_HIDKBD:
2118 {
2119 bool fEnableUsb = false;
2120 if (!RTStrICmp(ValueUnion.psz, "ps2"))
2121 {
2122 CHECK_ERROR(sessionMachine, COMSETTER(KeyboardHIDType)(KeyboardHIDType_PS2Keyboard));
2123 }
2124 else if (!RTStrICmp(ValueUnion.psz, "usb"))
2125 {
2126 CHECK_ERROR(sessionMachine, COMSETTER(KeyboardHIDType)(KeyboardHIDType_USBKeyboard));
2127 if (SUCCEEDED(rc))
2128 fEnableUsb = true;
2129 }
2130 else
2131 {
2132 errorArgument("Invalid type '%s' specfied for keyboard", ValueUnion.psz);
2133 rc = E_FAIL;
2134 }
2135 if (fEnableUsb)
2136 {
2137 /* Make sure either the OHCI or xHCI controller is enabled. */
2138 ULONG cOhciCtrls = 0;
2139 ULONG cXhciCtrls = 0;
2140 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_OHCI, &cOhciCtrls);
2141 if (SUCCEEDED(rc)) {
2142 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_XHCI, &cXhciCtrls);
2143 if ( SUCCEEDED(rc)
2144 && cOhciCtrls + cXhciCtrls == 0)
2145 {
2146 /* If there's nothing, enable OHCI (always available). */
2147 ComPtr<IUSBController> UsbCtl;
2148 CHECK_ERROR(sessionMachine, AddUSBController(Bstr("OHCI").raw(), USBControllerType_OHCI,
2149 UsbCtl.asOutParam()));
2150 }
2151 }
2152 }
2153 break;
2154 }
2155
2156 case MODIFYVM_UARTMODE:
2157 {
2158 ComPtr<ISerialPort> uart;
2159
2160 CHECK_ERROR_BREAK(sessionMachine, GetSerialPort(GetOptState.uIndex - 1, uart.asOutParam()));
2161 ASSERT(uart);
2162
2163 if (!RTStrICmp(ValueUnion.psz, "disconnected"))
2164 {
2165 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_Disconnected));
2166 }
2167 else if ( !RTStrICmp(ValueUnion.psz, "server")
2168 || !RTStrICmp(ValueUnion.psz, "client")
2169 || !RTStrICmp(ValueUnion.psz, "tcpserver")
2170 || !RTStrICmp(ValueUnion.psz, "tcpclient")
2171 || !RTStrICmp(ValueUnion.psz, "file"))
2172 {
2173 const char *pszMode = ValueUnion.psz;
2174
2175 int vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_STRING);
2176 if (RT_FAILURE(vrc))
2177 return errorSyntax(USAGE_MODIFYVM,
2178 "Missing or Invalid argument to '%s'",
2179 GetOptState.pDef->pszLong);
2180
2181 CHECK_ERROR(uart, COMSETTER(Path)(Bstr(ValueUnion.psz).raw()));
2182
2183 if (!RTStrICmp(pszMode, "server"))
2184 {
2185 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostPipe));
2186 CHECK_ERROR(uart, COMSETTER(Server)(TRUE));
2187 }
2188 else if (!RTStrICmp(pszMode, "client"))
2189 {
2190 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostPipe));
2191 CHECK_ERROR(uart, COMSETTER(Server)(FALSE));
2192 }
2193 else if (!RTStrICmp(pszMode, "tcpserver"))
2194 {
2195 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_TCP));
2196 CHECK_ERROR(uart, COMSETTER(Server)(TRUE));
2197 }
2198 else if (!RTStrICmp(pszMode, "tcpclient"))
2199 {
2200 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_TCP));
2201 CHECK_ERROR(uart, COMSETTER(Server)(FALSE));
2202 }
2203 else if (!RTStrICmp(pszMode, "file"))
2204 {
2205 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_RawFile));
2206 }
2207 }
2208 else
2209 {
2210 CHECK_ERROR(uart, COMSETTER(Path)(Bstr(ValueUnion.psz).raw()));
2211 CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostDevice));
2212 }
2213 break;
2214 }
2215
2216 case MODIFYVM_UARTTYPE:
2217 {
2218 ComPtr<ISerialPort> uart;
2219
2220 CHECK_ERROR_BREAK(sessionMachine, GetSerialPort(GetOptState.uIndex - 1, uart.asOutParam()));
2221 ASSERT(uart);
2222
2223 if (!RTStrICmp(ValueUnion.psz, "16450"))
2224 {
2225 CHECK_ERROR(uart, COMSETTER(UartType)(UartType_U16450));
2226 }
2227 else if (!RTStrICmp(ValueUnion.psz, "16550A"))
2228 {
2229 CHECK_ERROR(uart, COMSETTER(UartType)(UartType_U16550A));
2230 }
2231 else if (!RTStrICmp(ValueUnion.psz, "16750"))
2232 {
2233 CHECK_ERROR(uart, COMSETTER(UartType)(UartType_U16750));
2234 }
2235 else
2236 return errorSyntax(USAGE_MODIFYVM,
2237 "Invalid argument to '%s'",
2238 GetOptState.pDef->pszLong);
2239 break;
2240 }
2241
2242 case MODIFYVM_UART:
2243 {
2244 ComPtr<ISerialPort> uart;
2245
2246 CHECK_ERROR_BREAK(sessionMachine, GetSerialPort(GetOptState.uIndex - 1, uart.asOutParam()));
2247 ASSERT(uart);
2248
2249 if (!RTStrICmp(ValueUnion.psz, "off") || !RTStrICmp(ValueUnion.psz, "disable"))
2250 CHECK_ERROR(uart, COMSETTER(Enabled)(FALSE));
2251 else
2252 {
2253 const char *pszIOBase = ValueUnion.psz;
2254 uint32_t uVal = 0;
2255
2256 int vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_UINT32) != MODIFYVM_UART;
2257 if (RT_FAILURE(vrc))
2258 return errorSyntax(USAGE_MODIFYVM,
2259 "Missing or Invalid argument to '%s'",
2260 GetOptState.pDef->pszLong);
2261
2262 CHECK_ERROR(uart, COMSETTER(IRQ)(ValueUnion.u32));
2263
2264 vrc = RTStrToUInt32Ex(pszIOBase, NULL, 0, &uVal);
2265 if (vrc != VINF_SUCCESS || uVal == 0)
2266 return errorArgument("Error parsing UART I/O base '%s'", pszIOBase);
2267 CHECK_ERROR(uart, COMSETTER(IOBase)(uVal));
2268
2269 CHECK_ERROR(uart, COMSETTER(Enabled)(TRUE));
2270 }
2271 break;
2272 }
2273
2274#if defined(RT_OS_LINUX) || defined(RT_OS_WINDOWS)
2275 case MODIFYVM_LPTMODE:
2276 {
2277 ComPtr<IParallelPort> lpt;
2278
2279 CHECK_ERROR_BREAK(sessionMachine, GetParallelPort(GetOptState.uIndex - 1, lpt.asOutParam()));
2280 ASSERT(lpt);
2281
2282 CHECK_ERROR(lpt, COMSETTER(Path)(Bstr(ValueUnion.psz).raw()));
2283 break;
2284 }
2285
2286 case MODIFYVM_LPT:
2287 {
2288 ComPtr<IParallelPort> lpt;
2289
2290 CHECK_ERROR_BREAK(sessionMachine, GetParallelPort(GetOptState.uIndex - 1, lpt.asOutParam()));
2291 ASSERT(lpt);
2292
2293 if (!RTStrICmp(ValueUnion.psz, "off") || !RTStrICmp(ValueUnion.psz, "disable"))
2294 CHECK_ERROR(lpt, COMSETTER(Enabled)(FALSE));
2295 else
2296 {
2297 const char *pszIOBase = ValueUnion.psz;
2298 uint32_t uVal = 0;
2299
2300 int vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_UINT32) != MODIFYVM_LPT;
2301 if (RT_FAILURE(vrc))
2302 return errorSyntax(USAGE_MODIFYVM,
2303 "Missing or Invalid argument to '%s'",
2304 GetOptState.pDef->pszLong);
2305
2306 CHECK_ERROR(lpt, COMSETTER(IRQ)(ValueUnion.u32));
2307
2308 vrc = RTStrToUInt32Ex(pszIOBase, NULL, 0, &uVal);
2309 if (vrc != VINF_SUCCESS || uVal == 0)
2310 return errorArgument("Error parsing LPT I/O base '%s'", pszIOBase);
2311 CHECK_ERROR(lpt, COMSETTER(IOBase)(uVal));
2312
2313 CHECK_ERROR(lpt, COMSETTER(Enabled)(TRUE));
2314 }
2315 break;
2316 }
2317#endif
2318
2319 case MODIFYVM_GUESTMEMORYBALLOON:
2320 {
2321 CHECK_ERROR(sessionMachine, COMSETTER(MemoryBalloonSize)(ValueUnion.u32));
2322 break;
2323 }
2324
2325 case MODIFYVM_AUDIOCONTROLLER:
2326 {
2327 ComPtr<IAudioAdapter> audioAdapter;
2328 sessionMachine->COMGETTER(AudioAdapter)(audioAdapter.asOutParam());
2329 ASSERT(audioAdapter);
2330
2331 if (!RTStrICmp(ValueUnion.psz, "sb16"))
2332 CHECK_ERROR(audioAdapter, COMSETTER(AudioController)(AudioControllerType_SB16));
2333 else if (!RTStrICmp(ValueUnion.psz, "ac97"))
2334 CHECK_ERROR(audioAdapter, COMSETTER(AudioController)(AudioControllerType_AC97));
2335 else if (!RTStrICmp(ValueUnion.psz, "hda"))
2336 CHECK_ERROR(audioAdapter, COMSETTER(AudioController)(AudioControllerType_HDA));
2337 else
2338 {
2339 errorArgument("Invalid --audiocontroller argument '%s'", ValueUnion.psz);
2340 rc = E_FAIL;
2341 }
2342 break;
2343 }
2344
2345 case MODIFYVM_AUDIOCODEC:
2346 {
2347 ComPtr<IAudioAdapter> audioAdapter;
2348 sessionMachine->COMGETTER(AudioAdapter)(audioAdapter.asOutParam());
2349 ASSERT(audioAdapter);
2350
2351 if (!RTStrICmp(ValueUnion.psz, "sb16"))
2352 CHECK_ERROR(audioAdapter, COMSETTER(AudioCodec)(AudioCodecType_SB16));
2353 else if (!RTStrICmp(ValueUnion.psz, "stac9700"))
2354 CHECK_ERROR(audioAdapter, COMSETTER(AudioCodec)(AudioCodecType_STAC9700));
2355 else if (!RTStrICmp(ValueUnion.psz, "ad1980"))
2356 CHECK_ERROR(audioAdapter, COMSETTER(AudioCodec)(AudioCodecType_AD1980));
2357 else if (!RTStrICmp(ValueUnion.psz, "stac9221"))
2358 CHECK_ERROR(audioAdapter, COMSETTER(AudioCodec)(AudioCodecType_STAC9221));
2359 else
2360 {
2361 errorArgument("Invalid --audiocodec argument '%s'", ValueUnion.psz);
2362 rc = E_FAIL;
2363 }
2364 break;
2365 }
2366
2367 case MODIFYVM_AUDIO:
2368 {
2369 ComPtr<IAudioAdapter> audioAdapter;
2370 sessionMachine->COMGETTER(AudioAdapter)(audioAdapter.asOutParam());
2371 ASSERT(audioAdapter);
2372/** @todo r=klaus: don't unconditionally bolt together setting the audio driver
2373 * and enabling the device. Doing this more cleverly allows changing the audio
2374 * driver for VMs in saved state, which can be very useful when moving VMs
2375 * between systems with different setup. The driver doesn't leave any traces in
2376 * saved state. The GUI also might learn this trick if it doesn't use it
2377 * already. */
2378
2379 /* disable? */
2380 if (!RTStrICmp(ValueUnion.psz, "none"))
2381 {
2382 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(false));
2383 }
2384 else if (!RTStrICmp(ValueUnion.psz, "null"))
2385 {
2386 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_Null));
2387 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2388 }
2389#ifdef RT_OS_WINDOWS
2390#ifdef VBOX_WITH_WINMM
2391 else if (!RTStrICmp(ValueUnion.psz, "winmm"))
2392 {
2393 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_WinMM));
2394 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2395 }
2396#endif
2397 else if (!RTStrICmp(ValueUnion.psz, "dsound"))
2398 {
2399 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_DirectSound));
2400 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2401 }
2402#endif /* RT_OS_WINDOWS */
2403#ifdef VBOX_WITH_AUDIO_OSS
2404 else if (!RTStrICmp(ValueUnion.psz, "oss"))
2405 {
2406 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_OSS));
2407 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2408 }
2409#endif
2410#ifdef VBOX_WITH_AUDIO_ALSA
2411 else if (!RTStrICmp(ValueUnion.psz, "alsa"))
2412 {
2413 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_ALSA));
2414 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2415 }
2416#endif
2417#ifdef VBOX_WITH_AUDIO_PULSE
2418 else if (!RTStrICmp(ValueUnion.psz, "pulse"))
2419 {
2420 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_Pulse));
2421 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2422 }
2423#endif
2424#ifdef RT_OS_DARWIN
2425 else if (!RTStrICmp(ValueUnion.psz, "coreaudio"))
2426 {
2427 CHECK_ERROR(audioAdapter, COMSETTER(AudioDriver)(AudioDriverType_CoreAudio));
2428 CHECK_ERROR(audioAdapter, COMSETTER(Enabled)(true));
2429 }
2430#endif /* !RT_OS_DARWIN */
2431 else
2432 {
2433 errorArgument("Invalid --audio argument '%s'", ValueUnion.psz);
2434 rc = E_FAIL;
2435 }
2436 break;
2437 }
2438
2439 case MODIFYVM_AUDIOIN:
2440 {
2441 ComPtr<IAudioAdapter> audioAdapter;
2442 sessionMachine->COMGETTER(AudioAdapter)(audioAdapter.asOutParam());
2443 ASSERT(audioAdapter);
2444
2445 CHECK_ERROR(audioAdapter, COMSETTER(EnabledIn)(ValueUnion.f));
2446 break;
2447 }
2448
2449 case MODIFYVM_AUDIOOUT:
2450 {
2451 ComPtr<IAudioAdapter> audioAdapter;
2452 sessionMachine->COMGETTER(AudioAdapter)(audioAdapter.asOutParam());
2453 ASSERT(audioAdapter);
2454
2455 CHECK_ERROR(audioAdapter, COMSETTER(EnabledOut)(ValueUnion.f));
2456 break;
2457 }
2458
2459#ifdef VBOX_WITH_SHARED_CLIPBOARD
2460 case MODIFYVM_CLIPBOARD_MODE:
2461 {
2462 ClipboardMode_T mode = ClipboardMode_Disabled; /* Shut up MSC */
2463 if (!RTStrICmp(ValueUnion.psz, "disabled"))
2464 mode = ClipboardMode_Disabled;
2465 else if (!RTStrICmp(ValueUnion.psz, "hosttoguest"))
2466 mode = ClipboardMode_HostToGuest;
2467 else if (!RTStrICmp(ValueUnion.psz, "guesttohost"))
2468 mode = ClipboardMode_GuestToHost;
2469 else if (!RTStrICmp(ValueUnion.psz, "bidirectional"))
2470 mode = ClipboardMode_Bidirectional;
2471 else
2472 {
2473 errorArgument("Invalid --clipboard-mode argument '%s'", ValueUnion.psz);
2474 rc = E_FAIL;
2475 }
2476 if (SUCCEEDED(rc))
2477 {
2478 CHECK_ERROR(sessionMachine, COMSETTER(ClipboardMode)(mode));
2479 }
2480 break;
2481 }
2482
2483# ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS
2484 case MODIFYVM_CLIPBOARD_FILE_TRANSFERS:
2485 {
2486 BOOL fEnabled = false; /* Shut up MSC */
2487 if (!RTStrICmp(ValueUnion.psz, "enabled"))
2488 fEnabled = true;
2489 else if (!RTStrICmp(ValueUnion.psz, "disabled"))
2490 fEnabled = false;
2491 else
2492 {
2493 errorArgument("Invalid --clipboard-file-transfers argument '%s'", ValueUnion.psz);
2494 rc = E_FAIL;
2495 }
2496 if (SUCCEEDED(rc))
2497 {
2498 CHECK_ERROR(sessionMachine, COMSETTER(ClipboardFileTransfersEnabled)(fEnabled));
2499 }
2500 break;
2501 }
2502# endif /* VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS */
2503#endif /* VBOX_WITH_SHARED_CLIPBOARD */
2504
2505 case MODIFYVM_DRAGANDDROP:
2506 {
2507 DnDMode_T mode = DnDMode_Disabled; /* Shut up MSC */
2508 if (!RTStrICmp(ValueUnion.psz, "disabled"))
2509 mode = DnDMode_Disabled;
2510 else if (!RTStrICmp(ValueUnion.psz, "hosttoguest"))
2511 mode = DnDMode_HostToGuest;
2512 else if (!RTStrICmp(ValueUnion.psz, "guesttohost"))
2513 mode = DnDMode_GuestToHost;
2514 else if (!RTStrICmp(ValueUnion.psz, "bidirectional"))
2515 mode = DnDMode_Bidirectional;
2516 else
2517 {
2518 errorArgument("Invalid --draganddrop argument '%s'", ValueUnion.psz);
2519 rc = E_FAIL;
2520 }
2521 if (SUCCEEDED(rc))
2522 {
2523 CHECK_ERROR(sessionMachine, COMSETTER(DnDMode)(mode));
2524 }
2525 break;
2526 }
2527
2528 case MODIFYVM_VRDE_EXTPACK:
2529 {
2530 ComPtr<IVRDEServer> vrdeServer;
2531 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2532 ASSERT(vrdeServer);
2533
2534 if (vrdeServer)
2535 {
2536 if (RTStrICmp(ValueUnion.psz, "default") != 0)
2537 {
2538 Bstr bstr(ValueUnion.psz);
2539 CHECK_ERROR(vrdeServer, COMSETTER(VRDEExtPack)(bstr.raw()));
2540 }
2541 else
2542 CHECK_ERROR(vrdeServer, COMSETTER(VRDEExtPack)(Bstr().raw()));
2543 }
2544 break;
2545 }
2546
2547 case MODIFYVM_VRDEPROPERTY:
2548 {
2549 ComPtr<IVRDEServer> vrdeServer;
2550 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2551 ASSERT(vrdeServer);
2552
2553 if (vrdeServer)
2554 {
2555 /* Parse 'name=value' */
2556 char *pszProperty = RTStrDup(ValueUnion.psz);
2557 if (pszProperty)
2558 {
2559 char *pDelimiter = strchr(pszProperty, '=');
2560 if (pDelimiter)
2561 {
2562 *pDelimiter = '\0';
2563
2564 Bstr bstrName = pszProperty;
2565 Bstr bstrValue = &pDelimiter[1];
2566 CHECK_ERROR(vrdeServer, SetVRDEProperty(bstrName.raw(), bstrValue.raw()));
2567 }
2568 else
2569 {
2570 RTStrFree(pszProperty);
2571
2572 errorArgument("Invalid --vrdeproperty argument '%s'", ValueUnion.psz);
2573 rc = E_FAIL;
2574 break;
2575 }
2576 RTStrFree(pszProperty);
2577 }
2578 else
2579 {
2580 RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for VRDE property '%s'\n", ValueUnion.psz);
2581 rc = E_FAIL;
2582 }
2583 }
2584 break;
2585 }
2586
2587 case MODIFYVM_VRDPPORT:
2588 vrdeWarningDeprecatedOption("port");
2589 RT_FALL_THRU();
2590
2591 case MODIFYVM_VRDEPORT:
2592 {
2593 ComPtr<IVRDEServer> vrdeServer;
2594 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2595 ASSERT(vrdeServer);
2596
2597 if (!RTStrICmp(ValueUnion.psz, "default"))
2598 CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), Bstr("0").raw()));
2599 else
2600 CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), Bstr(ValueUnion.psz).raw()));
2601 break;
2602 }
2603
2604 case MODIFYVM_VRDPADDRESS:
2605 vrdeWarningDeprecatedOption("address");
2606 RT_FALL_THRU();
2607
2608 case MODIFYVM_VRDEADDRESS:
2609 {
2610 ComPtr<IVRDEServer> vrdeServer;
2611 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2612 ASSERT(vrdeServer);
2613
2614 CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("TCP/Address").raw(), Bstr(ValueUnion.psz).raw()));
2615 break;
2616 }
2617
2618 case MODIFYVM_VRDPAUTHTYPE:
2619 vrdeWarningDeprecatedOption("authtype");
2620 RT_FALL_THRU();
2621 case MODIFYVM_VRDEAUTHTYPE:
2622 {
2623 ComPtr<IVRDEServer> vrdeServer;
2624 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2625 ASSERT(vrdeServer);
2626
2627 if (!RTStrICmp(ValueUnion.psz, "null"))
2628 {
2629 CHECK_ERROR(vrdeServer, COMSETTER(AuthType)(AuthType_Null));
2630 }
2631 else if (!RTStrICmp(ValueUnion.psz, "external"))
2632 {
2633 CHECK_ERROR(vrdeServer, COMSETTER(AuthType)(AuthType_External));
2634 }
2635 else if (!RTStrICmp(ValueUnion.psz, "guest"))
2636 {
2637 CHECK_ERROR(vrdeServer, COMSETTER(AuthType)(AuthType_Guest));
2638 }
2639 else
2640 {
2641 errorArgument("Invalid --vrdeauthtype argument '%s'", ValueUnion.psz);
2642 rc = E_FAIL;
2643 }
2644 break;
2645 }
2646
2647 case MODIFYVM_VRDEAUTHLIBRARY:
2648 {
2649 ComPtr<IVRDEServer> vrdeServer;
2650 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2651 ASSERT(vrdeServer);
2652
2653 if (vrdeServer)
2654 {
2655 if (RTStrICmp(ValueUnion.psz, "default") != 0)
2656 {
2657 Bstr bstr(ValueUnion.psz);
2658 CHECK_ERROR(vrdeServer, COMSETTER(AuthLibrary)(bstr.raw()));
2659 }
2660 else
2661 CHECK_ERROR(vrdeServer, COMSETTER(AuthLibrary)(Bstr().raw()));
2662 }
2663 break;
2664 }
2665
2666 case MODIFYVM_VRDPMULTICON:
2667 vrdeWarningDeprecatedOption("multicon");
2668 RT_FALL_THRU();
2669 case MODIFYVM_VRDEMULTICON:
2670 {
2671 ComPtr<IVRDEServer> vrdeServer;
2672 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2673 ASSERT(vrdeServer);
2674
2675 CHECK_ERROR(vrdeServer, COMSETTER(AllowMultiConnection)(ValueUnion.f));
2676 break;
2677 }
2678
2679 case MODIFYVM_VRDPREUSECON:
2680 vrdeWarningDeprecatedOption("reusecon");
2681 RT_FALL_THRU();
2682 case MODIFYVM_VRDEREUSECON:
2683 {
2684 ComPtr<IVRDEServer> vrdeServer;
2685 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2686 ASSERT(vrdeServer);
2687
2688 CHECK_ERROR(vrdeServer, COMSETTER(ReuseSingleConnection)(ValueUnion.f));
2689 break;
2690 }
2691
2692 case MODIFYVM_VRDPVIDEOCHANNEL:
2693 vrdeWarningDeprecatedOption("videochannel");
2694 RT_FALL_THRU();
2695 case MODIFYVM_VRDEVIDEOCHANNEL:
2696 {
2697 ComPtr<IVRDEServer> vrdeServer;
2698 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2699 ASSERT(vrdeServer);
2700
2701 CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("VideoChannel/Enabled").raw(),
2702 ValueUnion.f? Bstr("true").raw(): Bstr("false").raw()));
2703 break;
2704 }
2705
2706 case MODIFYVM_VRDPVIDEOCHANNELQUALITY:
2707 vrdeWarningDeprecatedOption("videochannelquality");
2708 RT_FALL_THRU();
2709 case MODIFYVM_VRDEVIDEOCHANNELQUALITY:
2710 {
2711 ComPtr<IVRDEServer> vrdeServer;
2712 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2713 ASSERT(vrdeServer);
2714
2715 CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("VideoChannel/Quality").raw(),
2716 Bstr(ValueUnion.psz).raw()));
2717 break;
2718 }
2719
2720 case MODIFYVM_VRDP:
2721 vrdeWarningDeprecatedOption("");
2722 RT_FALL_THRU();
2723 case MODIFYVM_VRDE:
2724 {
2725 ComPtr<IVRDEServer> vrdeServer;
2726 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
2727 ASSERT(vrdeServer);
2728
2729 CHECK_ERROR(vrdeServer, COMSETTER(Enabled)(ValueUnion.f));
2730 break;
2731 }
2732
2733 case MODIFYVM_USBRENAME:
2734 {
2735 const char *pszName = ValueUnion.psz;
2736 int vrc = RTGetOptFetchValue(&GetOptState, &ValueUnion, RTGETOPT_REQ_STRING);
2737 if (RT_FAILURE(vrc))
2738 return errorSyntax(USAGE_MODIFYVM,
2739 "Missing or Invalid argument to '%s'",
2740 GetOptState.pDef->pszLong);
2741 const char *pszNewName = ValueUnion.psz;
2742
2743 SafeIfaceArray<IUSBController> ctrls;
2744 CHECK_ERROR(sessionMachine, COMGETTER(USBControllers)(ComSafeArrayAsOutParam(ctrls)));
2745 bool fRenamed = false;
2746 for (size_t i = 0; i < ctrls.size(); i++)
2747 {
2748 ComPtr<IUSBController> pCtrl = ctrls[i];
2749 Bstr bstrName;
2750 CHECK_ERROR(pCtrl, COMGETTER(Name)(bstrName.asOutParam()));
2751 if (bstrName == pszName)
2752 {
2753 bstrName = pszNewName;
2754 CHECK_ERROR(pCtrl, COMSETTER(Name)(bstrName.raw()));
2755 fRenamed = true;
2756 }
2757 }
2758 if (!fRenamed)
2759 {
2760 errorArgument("Invalid --usbrename parameters, nothing renamed");
2761 rc = E_FAIL;
2762 }
2763 break;
2764 }
2765
2766 case MODIFYVM_USBXHCI:
2767 {
2768 ULONG cXhciCtrls = 0;
2769 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_XHCI, &cXhciCtrls);
2770 if (SUCCEEDED(rc))
2771 {
2772 if (!cXhciCtrls && ValueUnion.f)
2773 {
2774 ComPtr<IUSBController> UsbCtl;
2775 CHECK_ERROR(sessionMachine, AddUSBController(Bstr("xHCI").raw(), USBControllerType_XHCI,
2776 UsbCtl.asOutParam()));
2777 }
2778 else if (cXhciCtrls && !ValueUnion.f)
2779 {
2780 SafeIfaceArray<IUSBController> ctrls;
2781 CHECK_ERROR(sessionMachine, COMGETTER(USBControllers)(ComSafeArrayAsOutParam(ctrls)));
2782 for (size_t i = 0; i < ctrls.size(); i++)
2783 {
2784 ComPtr<IUSBController> pCtrl = ctrls[i];
2785 USBControllerType_T enmType;
2786 CHECK_ERROR(pCtrl, COMGETTER(Type)(&enmType));
2787 if (enmType == USBControllerType_XHCI)
2788 {
2789 Bstr ctrlName;
2790 CHECK_ERROR(pCtrl, COMGETTER(Name)(ctrlName.asOutParam()));
2791 CHECK_ERROR(sessionMachine, RemoveUSBController(ctrlName.raw()));
2792 }
2793 }
2794 }
2795 }
2796 break;
2797 }
2798
2799 case MODIFYVM_USBEHCI:
2800 {
2801 ULONG cEhciCtrls = 0;
2802 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_EHCI, &cEhciCtrls);
2803 if (SUCCEEDED(rc))
2804 {
2805 if (!cEhciCtrls && ValueUnion.f)
2806 {
2807 ComPtr<IUSBController> UsbCtl;
2808 CHECK_ERROR(sessionMachine, AddUSBController(Bstr("EHCI").raw(), USBControllerType_EHCI,
2809 UsbCtl.asOutParam()));
2810 }
2811 else if (cEhciCtrls && !ValueUnion.f)
2812 {
2813 SafeIfaceArray<IUSBController> ctrls;
2814 CHECK_ERROR(sessionMachine, COMGETTER(USBControllers)(ComSafeArrayAsOutParam(ctrls)));
2815 for (size_t i = 0; i < ctrls.size(); i++)
2816 {
2817 ComPtr<IUSBController> pCtrl = ctrls[i];
2818 USBControllerType_T enmType;
2819 CHECK_ERROR(pCtrl, COMGETTER(Type)(&enmType));
2820 if (enmType == USBControllerType_EHCI)
2821 {
2822 Bstr ctrlName;
2823 CHECK_ERROR(pCtrl, COMGETTER(Name)(ctrlName.asOutParam()));
2824 CHECK_ERROR(sessionMachine, RemoveUSBController(ctrlName.raw()));
2825 }
2826 }
2827 }
2828 }
2829 break;
2830 }
2831
2832 case MODIFYVM_USBOHCI:
2833 {
2834 ULONG cOhciCtrls = 0;
2835 rc = sessionMachine->GetUSBControllerCountByType(USBControllerType_OHCI, &cOhciCtrls);
2836 if (SUCCEEDED(rc))
2837 {
2838 if (!cOhciCtrls && ValueUnion.f)
2839 {
2840 ComPtr<IUSBController> UsbCtl;
2841 CHECK_ERROR(sessionMachine, AddUSBController(Bstr("OHCI").raw(), USBControllerType_OHCI,
2842 UsbCtl.asOutParam()));
2843 }
2844 else if (cOhciCtrls && !ValueUnion.f)
2845 {
2846 SafeIfaceArray<IUSBController> ctrls;
2847 CHECK_ERROR(sessionMachine, COMGETTER(USBControllers)(ComSafeArrayAsOutParam(ctrls)));
2848 for (size_t i = 0; i < ctrls.size(); i++)
2849 {
2850 ComPtr<IUSBController> pCtrl = ctrls[i];
2851 USBControllerType_T enmType;
2852 CHECK_ERROR(pCtrl, COMGETTER(Type)(&enmType));
2853 if (enmType == USBControllerType_OHCI)
2854 {
2855 Bstr ctrlName;
2856 CHECK_ERROR(pCtrl, COMGETTER(Name)(ctrlName.asOutParam()));
2857 CHECK_ERROR(sessionMachine, RemoveUSBController(ctrlName.raw()));
2858 }
2859 }
2860 }
2861 }
2862 break;
2863 }
2864
2865 case MODIFYVM_SNAPSHOTFOLDER:
2866 {
2867 if (!RTStrICmp(ValueUnion.psz, "default"))
2868 CHECK_ERROR(sessionMachine, COMSETTER(SnapshotFolder)(Bstr().raw()));
2869 else
2870 CHECK_ERROR(sessionMachine, COMSETTER(SnapshotFolder)(Bstr(ValueUnion.psz).raw()));
2871 break;
2872 }
2873
2874 case MODIFYVM_TELEPORTER_ENABLED:
2875 {
2876 CHECK_ERROR(sessionMachine, COMSETTER(TeleporterEnabled)(ValueUnion.f));
2877 break;
2878 }
2879
2880 case MODIFYVM_TELEPORTER_PORT:
2881 {
2882 CHECK_ERROR(sessionMachine, COMSETTER(TeleporterPort)(ValueUnion.u32));
2883 break;
2884 }
2885
2886 case MODIFYVM_TELEPORTER_ADDRESS:
2887 {
2888 CHECK_ERROR(sessionMachine, COMSETTER(TeleporterAddress)(Bstr(ValueUnion.psz).raw()));
2889 break;
2890 }
2891
2892 case MODIFYVM_TELEPORTER_PASSWORD:
2893 {
2894 CHECK_ERROR(sessionMachine, COMSETTER(TeleporterPassword)(Bstr(ValueUnion.psz).raw()));
2895 break;
2896 }
2897
2898 case MODIFYVM_TELEPORTER_PASSWORD_FILE:
2899 {
2900 Utf8Str password;
2901 RTEXITCODE rcExit = readPasswordFile(ValueUnion.psz, &password);
2902 if (rcExit != RTEXITCODE_SUCCESS)
2903 rc = E_FAIL;
2904 else
2905 CHECK_ERROR(sessionMachine, COMSETTER(TeleporterPassword)(Bstr(password).raw()));
2906 break;
2907 }
2908
2909 case MODIFYVM_TRACING_ENABLED:
2910 {
2911 CHECK_ERROR(sessionMachine, COMSETTER(TracingEnabled)(ValueUnion.f));
2912 break;
2913 }
2914
2915 case MODIFYVM_TRACING_CONFIG:
2916 {
2917 CHECK_ERROR(sessionMachine, COMSETTER(TracingConfig)(Bstr(ValueUnion.psz).raw()));
2918 break;
2919 }
2920
2921 case MODIFYVM_TRACING_ALLOW_VM_ACCESS:
2922 {
2923 CHECK_ERROR(sessionMachine, COMSETTER(AllowTracingToAccessVM)(ValueUnion.f));
2924 break;
2925 }
2926
2927 case MODIFYVM_HARDWARE_UUID:
2928 {
2929 CHECK_ERROR(sessionMachine, COMSETTER(HardwareUUID)(Bstr(ValueUnion.psz).raw()));
2930 break;
2931 }
2932
2933 case MODIFYVM_HPET:
2934 {
2935 CHECK_ERROR(sessionMachine, COMSETTER(HPETEnabled)(ValueUnion.f));
2936 break;
2937 }
2938
2939 case MODIFYVM_IOCACHE:
2940 {
2941 CHECK_ERROR(sessionMachine, COMSETTER(IOCacheEnabled)(ValueUnion.f));
2942 break;
2943 }
2944
2945 case MODIFYVM_IOCACHESIZE:
2946 {
2947 CHECK_ERROR(sessionMachine, COMSETTER(IOCacheSize)(ValueUnion.u32));
2948 break;
2949 }
2950
2951 case MODIFYVM_CHIPSET:
2952 {
2953 if (!RTStrICmp(ValueUnion.psz, "piix3"))
2954 {
2955 CHECK_ERROR(sessionMachine, COMSETTER(ChipsetType)(ChipsetType_PIIX3));
2956 }
2957 else if (!RTStrICmp(ValueUnion.psz, "ich9"))
2958 {
2959 CHECK_ERROR(sessionMachine, COMSETTER(ChipsetType)(ChipsetType_ICH9));
2960 BOOL fIoApic = FALSE;
2961 CHECK_ERROR(biosSettings, COMGETTER(IOAPICEnabled)(&fIoApic));
2962 if (!fIoApic)
2963 {
2964 RTStrmPrintf(g_pStdErr, "*** I/O APIC must be enabled for ICH9, enabling. ***\n");
2965 CHECK_ERROR(biosSettings, COMSETTER(IOAPICEnabled)(TRUE));
2966 }
2967 }
2968 else
2969 {
2970 errorArgument("Invalid --chipset argument '%s' (valid: piix3,ich9)", ValueUnion.psz);
2971 rc = E_FAIL;
2972 }
2973 break;
2974 }
2975#ifdef VBOX_WITH_RECORDING
2976 case MODIFYVM_RECORDING:
2977 RT_FALL_THROUGH();
2978 case MODIFYVM_RECORDING_SCREENS:
2979 RT_FALL_THROUGH();
2980 case MODIFYVM_RECORDING_FILENAME:
2981 RT_FALL_THROUGH();
2982 case MODIFYVM_RECORDING_VIDEO_WIDTH:
2983 RT_FALL_THROUGH();
2984 case MODIFYVM_RECORDING_VIDEO_HEIGHT:
2985 RT_FALL_THROUGH();
2986 case MODIFYVM_RECORDING_VIDEO_RES:
2987 RT_FALL_THROUGH();
2988 case MODIFYVM_RECORDING_VIDEO_RATE:
2989 RT_FALL_THROUGH();
2990 case MODIFYVM_RECORDING_VIDEO_FPS:
2991 RT_FALL_THROUGH();
2992 case MODIFYVM_RECORDING_MAXTIME:
2993 RT_FALL_THROUGH();
2994 case MODIFYVM_RECORDING_MAXSIZE:
2995 RT_FALL_THROUGH();
2996 case MODIFYVM_RECORDING_OPTIONS:
2997 {
2998 ComPtr<IRecordingSettings> recordingSettings;
2999 CHECK_ERROR_BREAK(sessionMachine, COMGETTER(RecordingSettings)(recordingSettings.asOutParam()));
3000 SafeIfaceArray <IRecordingScreenSettings> saRecordingScreenScreens;
3001 CHECK_ERROR_BREAK(recordingSettings, COMGETTER(Screens)(ComSafeArrayAsOutParam(saRecordingScreenScreens)));
3002
3003 switch (c)
3004 {
3005 case MODIFYVM_RECORDING:
3006 {
3007 CHECK_ERROR(recordingSettings, COMSETTER(Enabled)(ValueUnion.f));
3008 break;
3009 }
3010 case MODIFYVM_RECORDING_SCREENS:
3011 {
3012 ULONG cMonitors = 64;
3013 CHECK_ERROR(pGraphicsAdapter, COMGETTER(MonitorCount)(&cMonitors));
3014 com::SafeArray<BOOL> screens(cMonitors);
3015 if (parseScreens(ValueUnion.psz, &screens))
3016 {
3017 errorArgument("Invalid list of screens specified\n");
3018 rc = E_FAIL;
3019 break;
3020 }
3021
3022 if (cMonitors > saRecordingScreenScreens.size()) /* Paranoia. */
3023 cMonitors = (ULONG)saRecordingScreenScreens.size();
3024
3025 for (size_t i = 0; i < cMonitors; ++i)
3026 CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(Enabled)(screens[i]));
3027 break;
3028 }
3029 case MODIFYVM_RECORDING_FILENAME:
3030 {
3031 Bstr bstr;
3032 /* empty string will fall through, leaving bstr empty */
3033 if (*ValueUnion.psz)
3034 {
3035 char szVCFileAbs[RTPATH_MAX] = "";
3036 int vrc = RTPathAbs(ValueUnion.psz, szVCFileAbs, sizeof(szVCFileAbs));
3037 if (RT_FAILURE(vrc))
3038 {
3039 errorArgument("Cannot convert filename \"%s\" to absolute path\n", ValueUnion.psz);
3040 rc = E_FAIL;
3041 break;
3042 }
3043 bstr = szVCFileAbs;
3044 }
3045
3046 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3047 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(Filename)(bstr.raw()));
3048 break;
3049 }
3050 case MODIFYVM_RECORDING_VIDEO_WIDTH:
3051 {
3052 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3053 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoWidth)(ValueUnion.u32));
3054 break;
3055 }
3056 case MODIFYVM_RECORDING_VIDEO_HEIGHT:
3057 {
3058 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3059 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoHeight)(ValueUnion.u32));
3060 break;
3061 }
3062 case MODIFYVM_RECORDING_VIDEO_RES:
3063 {
3064 uint32_t uWidth = 0;
3065 char *pszNext;
3066 int vrc = RTStrToUInt32Ex(ValueUnion.psz, &pszNext, 0, &uWidth);
3067 if (RT_FAILURE(vrc) || vrc != VWRN_TRAILING_CHARS || !pszNext || *pszNext != 'x')
3068 {
3069 errorArgument("Error parsing video resolution '%s' (expected <width>x<height>)", ValueUnion.psz);
3070 rc = E_FAIL;
3071 break;
3072 }
3073 uint32_t uHeight = 0;
3074 vrc = RTStrToUInt32Ex(pszNext+1, NULL, 0, &uHeight);
3075 if (vrc != VINF_SUCCESS)
3076 {
3077 errorArgument("Error parsing video resolution '%s' (expected <width>x<height>)", ValueUnion.psz);
3078 rc = E_FAIL;
3079 break;
3080 }
3081
3082 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3083 {
3084 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoWidth)(uWidth));
3085 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoHeight)(uHeight));
3086 }
3087 break;
3088 }
3089 case MODIFYVM_RECORDING_VIDEO_RATE:
3090 {
3091 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3092 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoRate)(ValueUnion.u32));
3093 break;
3094 }
3095 case MODIFYVM_RECORDING_VIDEO_FPS:
3096 {
3097 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3098 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(VideoFPS)(ValueUnion.u32));
3099 break;
3100 }
3101 case MODIFYVM_RECORDING_MAXTIME:
3102 {
3103 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3104 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(MaxTime)(ValueUnion.u32));
3105 break;
3106 }
3107 case MODIFYVM_RECORDING_MAXSIZE:
3108 {
3109 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3110 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(MaxFileSize)(ValueUnion.u32));
3111 break;
3112 }
3113 case MODIFYVM_RECORDING_OPTIONS:
3114 {
3115 Bstr bstr(ValueUnion.psz);
3116 for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
3117 CHECK_ERROR(saRecordingScreenScreens[i], COMSETTER(Options)(bstr.raw()));
3118 break;
3119 }
3120 }
3121
3122 break;
3123 }
3124#endif
3125 case MODIFYVM_AUTOSTART_ENABLED:
3126 {
3127 CHECK_ERROR(sessionMachine, COMSETTER(AutostartEnabled)(ValueUnion.f));
3128 break;
3129 }
3130
3131 case MODIFYVM_AUTOSTART_DELAY:
3132 {
3133 CHECK_ERROR(sessionMachine, COMSETTER(AutostartDelay)(ValueUnion.u32));
3134 break;
3135 }
3136
3137 case MODIFYVM_AUTOSTOP_TYPE:
3138 {
3139 AutostopType_T enmAutostopType = AutostopType_Disabled;
3140
3141 if (!RTStrICmp(ValueUnion.psz, "disabled"))
3142 enmAutostopType = AutostopType_Disabled;
3143 else if (!RTStrICmp(ValueUnion.psz, "savestate"))
3144 enmAutostopType = AutostopType_SaveState;
3145 else if (!RTStrICmp(ValueUnion.psz, "poweroff"))
3146 enmAutostopType = AutostopType_PowerOff;
3147 else if (!RTStrICmp(ValueUnion.psz, "acpishutdown"))
3148 enmAutostopType = AutostopType_AcpiShutdown;
3149 else
3150 {
3151 errorArgument("Invalid --autostop-type argument '%s' (valid: disabled, savestate, poweroff, acpishutdown)", ValueUnion.psz);
3152 rc = E_FAIL;
3153 }
3154
3155 if (SUCCEEDED(rc))
3156 CHECK_ERROR(sessionMachine, COMSETTER(AutostopType)(enmAutostopType));
3157 break;
3158 }
3159#ifdef VBOX_WITH_PCI_PASSTHROUGH
3160 case MODIFYVM_ATTACH_PCI:
3161 {
3162 const char* pAt = strchr(ValueUnion.psz, '@');
3163 int32_t iHostAddr, iGuestAddr;
3164
3165 iHostAddr = parsePci(ValueUnion.psz);
3166 iGuestAddr = pAt != NULL ? parsePci(pAt + 1) : iHostAddr;
3167
3168 if (iHostAddr == -1 || iGuestAddr == -1)
3169 {
3170 errorArgument("Invalid --pciattach argument '%s' (valid: 'HB:HD.HF@GB:GD.GF' or just 'HB:HD.HF')", ValueUnion.psz);
3171 rc = E_FAIL;
3172 }
3173 else
3174 {
3175 CHECK_ERROR(sessionMachine, AttachHostPCIDevice(iHostAddr, iGuestAddr, TRUE));
3176 }
3177
3178 break;
3179 }
3180 case MODIFYVM_DETACH_PCI:
3181 {
3182 int32_t iHostAddr;
3183
3184 iHostAddr = parsePci(ValueUnion.psz);
3185 if (iHostAddr == -1)
3186 {
3187 errorArgument("Invalid --pcidetach argument '%s' (valid: 'HB:HD.HF')", ValueUnion.psz);
3188 rc = E_FAIL;
3189 }
3190 else
3191 {
3192 CHECK_ERROR(sessionMachine, DetachHostPCIDevice(iHostAddr));
3193 }
3194
3195 break;
3196 }
3197#endif
3198
3199#ifdef VBOX_WITH_USB_CARDREADER
3200 case MODIFYVM_USBCARDREADER:
3201 {
3202 CHECK_ERROR(sessionMachine, COMSETTER(EmulatedUSBCardReaderEnabled)(ValueUnion.f));
3203 break;
3204 }
3205#endif /* VBOX_WITH_USB_CARDREADER */
3206
3207 case MODIFYVM_DEFAULTFRONTEND:
3208 {
3209 Bstr bstr(ValueUnion.psz);
3210 if (bstr == "default")
3211 bstr = Bstr::Empty;
3212 CHECK_ERROR(sessionMachine, COMSETTER(DefaultFrontend)(bstr.raw()));
3213 break;
3214 }
3215
3216 case MODIFYVM_VMPROC_PRIORITY:
3217 {
3218 VMProcPriority_T enmPriority = nameToVMProcPriority(ValueUnion.psz);
3219 if (enmPriority == VMProcPriority_Invalid)
3220 {
3221 errorArgument("Invalid --vm-process-priority '%s'", ValueUnion.psz);
3222 rc = E_FAIL;
3223 }
3224 else
3225 {
3226 CHECK_ERROR(sessionMachine, COMSETTER(VMProcessPriority)(enmPriority));
3227 }
3228 break;
3229 }
3230
3231 default:
3232 {
3233 errorGetOpt(USAGE_MODIFYVM, c, &ValueUnion);
3234 rc = E_FAIL;
3235 break;
3236 }
3237 }
3238 }
3239
3240 /* commit changes */
3241 if (SUCCEEDED(rc))
3242 CHECK_ERROR(sessionMachine, SaveSettings());
3243
3244 /* it's important to always close sessions */
3245 a->session->UnlockMachine();
3246
3247 return SUCCEEDED(rc) ? RTEXITCODE_SUCCESS : RTEXITCODE_FAILURE;
3248}
3249
3250#endif /* !VBOX_ONLY_DOCS */
Note: See TracBrowser for help on using the repository browser.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette