settings.h@ 70606

Last change on this file since 70606 was 70606, checked in by vboxsync, 7 years ago
updates (bugref:9087)
Property svn:eol-style set to `native` Property svn:keywords set to `Date Revision Author Id`
File size: 39.2 KB

Line
1	/** @file
2	* Settings file data structures.
3	*
4	* These structures are created by the settings file loader and filled with values
5	* copied from the raw XML data. This was all new with VirtualBox 3.1 and allows us
6	* to finally make the XML reader version-independent and read VirtualBox XML files
7	* from earlier and even newer (future) versions without requiring complicated,
8	* tedious and error-prone XSLT conversions.
9	*
10	* It is this file that defines all structures that map VirtualBox global and
11	* machine settings to XML files. These structures are used by the rest of Main,
12	* even though this header file does not require anything else in Main.
13	*
14	* Note: Headers in Main code have been tweaked to only declare the structures
15	* defined here so that this header need only be included from code files that
16	* actually use these structures.
17	*/
18
19	/*
20	* Copyright (C) 2007-2017 Oracle Corporation
21	*
22	* This file is part of VirtualBox Open Source Edition (OSE), as
23	* available from http://www.virtualbox.org. This file is free software;
24	* you can redistribute it and/or modify it under the terms of the GNU
25	* General Public License (GPL) as published by the Free Software
26	* Foundation, in version 2 as it comes in the "COPYING" file of the
27	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
28	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
29	*
30	* The contents of this file may alternatively be used under the terms
31	* of the Common Development and Distribution License Version 1.0
32	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
33	* VirtualBox OSE distribution, in which case the provisions of the
34	* CDDL are applicable instead of those of the GPL.
35	*
36	* You may elect to license modified versions of this file under the
37	* terms and conditions of either the GPL or the CDDL or both.
38	*/
39
40	#ifndef ___VBox_settings_h
41	#define ___VBox_settings_h
42
43	#include <iprt/time.h>
44
45	#include "VBox/com/VirtualBox.h"
46
47	#include <VBox/com/Guid.h>
48	#include <VBox/com/string.h>
49
50	#include <list>
51	#include <map>
52	#include <vector>
53
54	/**
55	* Maximum depth of a medium tree, to prevent stack overflows.
56	* XPCOM has a relatively low stack size for its workers, and we have
57	* to avoid crashes due to exceeding the limit both on reading and
58	* writing config files.
59	*/
60	#define SETTINGS_MEDIUM_DEPTH_MAX 300
61
62	/**
63	* Maximum depth of the snapshot tree, to prevent stack overflows.
64	* XPCOM has a relatively low stack size for its workers, and we have
65	* to avoid crashes due to exceeding the limit both on reading and
66	* writing config files. The bottleneck is reading config files with
67	* deep snapshot nesting, as libxml2 needs quite some stack space,
68	* so with the current stack size the margin isn't big.
69	*/
70	#define SETTINGS_SNAPSHOT_DEPTH_MAX 250
71
72	namespace xml
73	{
74	class ElementNode;
75	}
76
77	namespace settings
78	{
79
80	class ConfigFileError;
81
82	////////////////////////////////////////////////////////////////////////////////
83	//
84	// Structures shared between Machine XML and VirtualBox.xml
85	//
86	////////////////////////////////////////////////////////////////////////////////
87
88	typedef std::map<com::Utf8Str, com::Utf8Str> StringsMap;
89	typedef std::list<com::Utf8Str> StringsList;
90
91	/**
92	* USB device filter definition. This struct is used both in MainConfigFile
93	* (for global USB filters) and MachineConfigFile (for machine filters).
94	*
95	* NOTE: If you add any fields in here, you must update a) the constructor and b)
96	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
97	* your settings might never get saved.
98	*/
99	struct USBDeviceFilter
100	{
101	USBDeviceFilter();
102
103	bool operator==(const USBDeviceFilter&u) const;
104
105	com::Utf8Str strName;
106	bool fActive;
107	com::Utf8Str strVendorId,
108	strProductId,
109	strRevision,
110	strManufacturer,
111	strProduct,
112	strSerialNumber,
113	strPort;
114	USBDeviceFilterAction_T action; // only used with host USB filters
115	com::Utf8Str strRemote; // irrelevant for host USB objects
116	uint32_t ulMaskedInterfaces; // irrelevant for host USB objects
117	};
118
119	typedef std::list<USBDeviceFilter> USBDeviceFiltersList;
120
121	struct Medium;
122	typedef std::list<Medium> MediaList;
123
124	/**
125	* NOTE: If you add any fields in here, you must update a) the constructor and b)
126	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
127	* your settings might never get saved.
128	*/
129	struct Medium
130	{
131	Medium();
132
133	bool operator==(const Medium &m) const;
134
135	com::Guid uuid;
136	com::Utf8Str strLocation;
137	com::Utf8Str strDescription;
138
139	// the following are for hard disks only:
140	com::Utf8Str strFormat;
141	bool fAutoReset; // optional, only for diffs, default is false
142	StringsMap properties;
143	MediumType_T hdType;
144
145	MediaList llChildren; // only used with hard disks
146
147	static const struct Medium Empty;
148	};
149
150	/**
151	* A media registry. Starting with VirtualBox 3.3, this can appear in both the
152	* VirtualBox.xml file as well as machine XML files with settings version 1.11
153	* or higher, so these lists are now in ConfigFileBase.
154	*
155	* NOTE: If you add any fields in here, you must update a) the constructor and b)
156	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
157	* your settings might never get saved.
158	*/
159	struct MediaRegistry
160	{
161	bool operator==(const MediaRegistry &m) const;
162
163	MediaList llHardDisks,
164	llDvdImages,
165	llFloppyImages;
166	};
167
168	/**
169	* NOTE: If you add any fields in here, you must update a) the constructor and b)
170	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
171	* your settings might never get saved.
172	*/
173	struct NATRule
174	{
175	NATRule();
176
177	bool operator==(const NATRule &r) const;
178
179	com::Utf8Str strName;
180	NATProtocol_T proto;
181	uint16_t u16HostPort;
182	com::Utf8Str strHostIP;
183	uint16_t u16GuestPort;
184	com::Utf8Str strGuestIP;
185	};
186	typedef std::map<com::Utf8Str, NATRule> NATRulesMap;
187
188	struct NATHostLoopbackOffset
189	{
190	NATHostLoopbackOffset();
191
192	bool operator==(const NATHostLoopbackOffset &o) const;
193
194	bool operator==(const com::Utf8Str& strAddr)
195	{
196	return strLoopbackHostAddress == strAddr;
197	}
198
199	bool operator==(uint32_t off)
200	{
201	return u32Offset == off;
202	}
203
204	/** Note: 128/8 is only acceptable */
205	com::Utf8Str strLoopbackHostAddress;
206	uint32_t u32Offset;
207	};
208
209	typedef std::list<NATHostLoopbackOffset> NATLoopbackOffsetList;
210
211	typedef std::vector<uint8_t> IconBlob;
212
213	/**
214	* Common base class for both MainConfigFile and MachineConfigFile
215	* which contains some common logic for both.
216	*/
217	class ConfigFileBase
218	{
219	public:
220	bool fileExists();
221
222	void copyBaseFrom(const ConfigFileBase &b);
223
224	protected:
225	ConfigFileBase(const com::Utf8Str *pstrFilename);
226	/* Note: this copy constructor doesn't create a full copy of other, cause
227	* the file based stuff (xml doc) could not be copied. */
228	ConfigFileBase(const ConfigFileBase &other);
229
230	~ConfigFileBase();
231
232	typedef enum {Error, HardDisk, DVDImage, FloppyImage} MediaType;
233
234	static const char *stringifyMediaType(MediaType t);
235	SettingsVersion_T parseVersion(const com::Utf8Str &strVersion,
236	const xml::ElementNode *pElm);
237	void parseUUID(com::Guid &guid,
238	const com::Utf8Str &strUUID,
239	const xml::ElementNode *pElm) const;
240	void parseTimestamp(RTTIMESPEC &timestamp,
241	const com::Utf8Str &str,
242	const xml::ElementNode *pElm) const;
243	void parseBase64(IconBlob &binary,
244	const com::Utf8Str &str,
245	const xml::ElementNode *pElm) const;
246	com::Utf8Str stringifyTimestamp(const RTTIMESPEC &tm) const;
247	void toBase64(com::Utf8Str &str,
248	const IconBlob &binary) const;
249
250	void readExtraData(const xml::ElementNode &elmExtraData,
251	StringsMap &map);
252	void readUSBDeviceFilters(const xml::ElementNode &elmDeviceFilters,
253	USBDeviceFiltersList &ll);
254	void readMediumOne(MediaType t, const xml::ElementNode &elmMedium, Medium &med);
255	void readMedium(MediaType t, uint32_t depth, const xml::ElementNode &elmMedium, Medium &med);
256	void readMediaRegistry(const xml::ElementNode &elmMediaRegistry, MediaRegistry &mr);
257	void readNATForwardRulesMap(const xml::ElementNode &elmParent, NATRulesMap &mapRules);
258	void readNATLoopbacks(const xml::ElementNode &elmParent, NATLoopbackOffsetList &llLoopBacks);
259
260	void setVersionAttribute(xml::ElementNode &elm);
261	void specialBackupIfFirstBump();
262	void createStubDocument();
263
264	void buildExtraData(xml::ElementNode &elmParent, const StringsMap &me);
265	void buildUSBDeviceFilters(xml::ElementNode &elmParent,
266	const USBDeviceFiltersList &ll,
267	bool fHostMode);
268	void buildMedium(MediaType t,
269	uint32_t depth,
270	xml::ElementNode &elmMedium,
271	const Medium &mdm);
272	void buildMediaRegistry(xml::ElementNode &elmParent,
273	const MediaRegistry &mr);
274	void buildNATForwardRulesMap(xml::ElementNode &elmParent, const NATRulesMap &mapRules);
275	void buildNATLoopbacks(xml::ElementNode &elmParent, const NATLoopbackOffsetList &natLoopbackList);
276	void clearDocument();
277
278	struct Data;
279	Data *m;
280
281	friend class ConfigFileError;
282	};
283
284	////////////////////////////////////////////////////////////////////////////////
285	//
286	// VirtualBox.xml structures
287	//
288	////////////////////////////////////////////////////////////////////////////////
289
290	struct USBDeviceSource
291	{
292	com::Utf8Str strName;
293	com::Utf8Str strBackend;
294	com::Utf8Str strAddress;
295	StringsMap properties;
296	};
297
298	typedef std::list<USBDeviceSource> USBDeviceSourcesList;
299
300	struct Host
301	{
302	USBDeviceFiltersList llUSBDeviceFilters;
303	USBDeviceSourcesList llUSBDeviceSources;
304	};
305
306	struct SystemProperties
307	{
308	SystemProperties();
309
310	com::Utf8Str strDefaultMachineFolder;
311	com::Utf8Str strDefaultHardDiskFolder;
312	com::Utf8Str strDefaultHardDiskFormat;
313	com::Utf8Str strVRDEAuthLibrary;
314	com::Utf8Str strWebServiceAuthLibrary;
315	com::Utf8Str strDefaultVRDEExtPack;
316	com::Utf8Str strAutostartDatabasePath;
317	com::Utf8Str strDefaultAdditionsISO;
318	com::Utf8Str strDefaultFrontend;
319	com::Utf8Str strLoggingLevel;
320	uint32_t ulLogHistoryCount;
321	bool fExclusiveHwVirt;
322	};
323
324	struct MachineRegistryEntry
325	{
326	com::Guid uuid;
327	com::Utf8Str strSettingsFile;
328	};
329
330	typedef std::list<MachineRegistryEntry> MachinesRegistry;
331
332	struct DhcpOptValue
333	{
334	DhcpOptValue();
335	DhcpOptValue(const com::Utf8Str &aText, DhcpOptEncoding_T aEncoding = DhcpOptEncoding_Legacy);
336
337	com::Utf8Str text;
338	DhcpOptEncoding_T encoding;
339	};
340
341	typedef std::map<DhcpOpt_T, DhcpOptValue> DhcpOptionMap;
342	typedef DhcpOptionMap::value_type DhcpOptValuePair;
343	typedef DhcpOptionMap::iterator DhcpOptIterator;
344	typedef DhcpOptionMap::const_iterator DhcpOptConstIterator;
345
346	typedef struct VmNameSlotKey
347	{
348	VmNameSlotKey(const com::Utf8Str& aVmName, LONG aSlot);
349
350	bool operator<(const VmNameSlotKey& that) const;
351
352	const com::Utf8Str VmName;
353	LONG Slot;
354	} VmNameSlotKey;
355
356	typedef std::map<VmNameSlotKey, DhcpOptionMap> VmSlot2OptionsMap;
357	typedef VmSlot2OptionsMap::value_type VmSlot2OptionsPair;
358	typedef VmSlot2OptionsMap::iterator VmSlot2OptionsIterator;
359	typedef VmSlot2OptionsMap::const_iterator VmSlot2OptionsConstIterator;
360
361	struct DHCPServer
362	{
363	DHCPServer();
364
365	com::Utf8Str strNetworkName,
366	strIPAddress,
367	strIPLower,
368	strIPUpper;
369	bool fEnabled;
370	DhcpOptionMap GlobalDhcpOptions;
371	VmSlot2OptionsMap VmSlot2OptionsM;
372	};
373
374	typedef std::list<DHCPServer> DHCPServersList;
375
376
377	/**
378	* NAT Networking settings (NAT service).
379	*/
380	struct NATNetwork
381	{
382	NATNetwork();
383
384	com::Utf8Str strNetworkName;
385	com::Utf8Str strIPv4NetworkCidr;
386	com::Utf8Str strIPv6Prefix;
387	bool fEnabled;
388	bool fIPv6Enabled;
389	bool fAdvertiseDefaultIPv6Route;
390	bool fNeedDhcpServer;
391	uint32_t u32HostLoopback6Offset;
392	NATLoopbackOffsetList llHostLoopbackOffsetList;
393	NATRulesMap mapPortForwardRules4;
394	NATRulesMap mapPortForwardRules6;
395	};
396
397	typedef std::list<NATNetwork> NATNetworksList;
398
399
400	class MainConfigFile : public ConfigFileBase
401	{
402	public:
403	MainConfigFile(const com::Utf8Str *pstrFilename);
404
405	void readMachineRegistry(const xml::ElementNode &elmMachineRegistry);
406	void readDHCPServers(const xml::ElementNode &elmDHCPServers);
407	void readDhcpOptions(DhcpOptionMap& map, const xml::ElementNode& options);
408	void readNATNetworks(const xml::ElementNode &elmNATNetworks);
409
410	void write(const com::Utf8Str strFilename);
411
412	Host host;
413	SystemProperties systemProperties;
414	MediaRegistry mediaRegistry;
415	MachinesRegistry llMachines;
416	DHCPServersList llDhcpServers;
417	NATNetworksList llNATNetworks;
418	StringsMap mapExtraDataItems;
419
420	private:
421	void bumpSettingsVersionIfNeeded();
422	void buildUSBDeviceSources(xml::ElementNode &elmParent, const USBDeviceSourcesList &ll);
423	void readUSBDeviceSources(const xml::ElementNode &elmDeviceSources, USBDeviceSourcesList &ll);
424	};
425
426	////////////////////////////////////////////////////////////////////////////////
427	//
428	// Machine XML structures
429	//
430	////////////////////////////////////////////////////////////////////////////////
431
432	/**
433	* NOTE: If you add any fields in here, you must update a) the constructor and b)
434	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
435	* your settings might never get saved.
436	*/
437	struct VRDESettings
438	{
439	VRDESettings();
440
441	bool areDefaultSettings(SettingsVersion_T sv) const;
442
443	bool operator==(const VRDESettings& v) const;
444
445	bool fEnabled;
446	AuthType_T authType;
447	uint32_t ulAuthTimeout;
448	com::Utf8Str strAuthLibrary;
449	bool fAllowMultiConnection,
450	fReuseSingleConnection;
451	com::Utf8Str strVrdeExtPack;
452	StringsMap mapProperties;
453	};
454
455	/**
456	* NOTE: If you add any fields in here, you must update a) the constructor and b)
457	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
458	* your settings might never get saved.
459	*/
460	struct BIOSSettings
461	{
462	BIOSSettings();
463
464	bool areDefaultSettings() const;
465
466	bool operator==(const BIOSSettings &d) const;
467
468	bool fACPIEnabled,
469	fIOAPICEnabled,
470	fLogoFadeIn,
471	fLogoFadeOut,
472	fPXEDebugEnabled;
473	uint32_t ulLogoDisplayTime;
474	BIOSBootMenuMode_T biosBootMenuMode;
475	APICMode_T apicMode; // requires settings version 1.16 (VirtualBox 5.1)
476	int64_t llTimeOffset;
477	com::Utf8Str strLogoImagePath;
478	};
479
480	/**
481	* NOTE: If you add any fields in here, you must update a) the constructor and b)
482	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
483	* your settings might never get saved.
484	*/
485	struct USBController
486	{
487	USBController();
488
489	bool operator==(const USBController &u) const;
490
491	com::Utf8Str strName;
492	USBControllerType_T enmType;
493	};
494
495	typedef std::list<USBController> USBControllerList;
496
497	struct USB
498	{
499	USB();
500
501	bool operator==(const USB &u) const;
502
503	/** List of USB controllers present. */
504	USBControllerList llUSBControllers;
505	/** List of USB device filters. */
506	USBDeviceFiltersList llDeviceFilters;
507	};
508
509	struct NAT
510	{
511	NAT();
512
513	bool areDNSDefaultSettings() const;
514	bool areAliasDefaultSettings() const;
515	bool areTFTPDefaultSettings() const;
516	bool areDefaultSettings() const;
517
518	bool operator==(const NAT &n) const;
519
520	com::Utf8Str strNetwork;
521	com::Utf8Str strBindIP;
522	uint32_t u32Mtu;
523	uint32_t u32SockRcv;
524	uint32_t u32SockSnd;
525	uint32_t u32TcpRcv;
526	uint32_t u32TcpSnd;
527	com::Utf8Str strTFTPPrefix;
528	com::Utf8Str strTFTPBootFile;
529	com::Utf8Str strTFTPNextServer;
530	bool fDNSPassDomain;
531	bool fDNSProxy;
532	bool fDNSUseHostResolver;
533	bool fAliasLog;
534	bool fAliasProxyOnly;
535	bool fAliasUseSamePorts;
536	NATRulesMap mapRules;
537	};
538
539	/**
540	* NOTE: If you add any fields in here, you must update a) the constructor and b)
541	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
542	* your settings might never get saved.
543	*/
544	struct NetworkAdapter
545	{
546	NetworkAdapter();
547
548	bool areGenericDriverDefaultSettings() const;
549	bool areDefaultSettings(SettingsVersion_T sv) const;
550	bool areDisabledDefaultSettings() const;
551
552	bool operator==(const NetworkAdapter &n) const;
553
554	uint32_t ulSlot;
555
556	NetworkAdapterType_T type;
557	bool fEnabled;
558	com::Utf8Str strMACAddress;
559	bool fCableConnected;
560	uint32_t ulLineSpeed;
561	NetworkAdapterPromiscModePolicy_T enmPromiscModePolicy;
562	bool fTraceEnabled;
563	com::Utf8Str strTraceFile;
564
565	NetworkAttachmentType_T mode;
566	NAT nat;
567	com::Utf8Str strBridgedName;
568	com::Utf8Str strHostOnlyName;
569	com::Utf8Str strInternalNetworkName;
570	com::Utf8Str strGenericDriver;
571	StringsMap genericProperties;
572	com::Utf8Str strNATNetworkName;
573	uint32_t ulBootPriority;
574	com::Utf8Str strBandwidthGroup; // requires settings version 1.13 (VirtualBox 4.2)
575	};
576
577	typedef std::list<NetworkAdapter> NetworkAdaptersList;
578
579	/**
580	* NOTE: If you add any fields in here, you must update a) the constructor and b)
581	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
582	* your settings might never get saved.
583	*/
584	struct SerialPort
585	{
586	SerialPort();
587
588	bool operator==(const SerialPort &n) const;
589
590	uint32_t ulSlot;
591
592	bool fEnabled;
593	uint32_t ulIOBase;
594	uint32_t ulIRQ;
595	PortMode_T portMode;
596	com::Utf8Str strPath;
597	bool fServer;
598	};
599
600	typedef std::list<SerialPort> SerialPortsList;
601
602	/**
603	* NOTE: If you add any fields in here, you must update a) the constructor and b)
604	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
605	* your settings might never get saved.
606	*/
607	struct ParallelPort
608	{
609	ParallelPort();
610
611	bool operator==(const ParallelPort &d) const;
612
613	uint32_t ulSlot;
614
615	bool fEnabled;
616	uint32_t ulIOBase;
617	uint32_t ulIRQ;
618	com::Utf8Str strPath;
619	};
620
621	typedef std::list<ParallelPort> ParallelPortsList;
622
623	/**
624	* NOTE: If you add any fields in here, you must update a) the constructor and b)
625	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
626	* your settings might never get saved.
627	*/
628	struct AudioAdapter
629	{
630	AudioAdapter();
631
632	bool areDefaultSettings(SettingsVersion_T sv) const;
633
634	bool operator==(const AudioAdapter &a) const;
635
636	bool fEnabled;
637	bool fEnabledIn;
638	bool fEnabledOut;
639	AudioControllerType_T controllerType;
640	AudioCodecType_T codecType;
641	AudioDriverType_T driverType;
642	settings::StringsMap properties;
643	};
644
645	/**
646	* NOTE: If you add any fields in here, you must update a) the constructor and b)
647	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
648	* your settings might never get saved.
649	*/
650	struct SharedFolder
651	{
652	SharedFolder();
653
654	bool operator==(const SharedFolder &a) const;
655
656	com::Utf8Str strName,
657	strHostPath;
658	bool fWritable;
659	bool fAutoMount;
660	};
661
662	typedef std::list<SharedFolder> SharedFoldersList;
663
664	/**
665	* NOTE: If you add any fields in here, you must update a) the constructor and b)
666	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
667	* your settings might never get saved.
668	*/
669	struct GuestProperty
670	{
671	GuestProperty();
672
673	bool operator==(const GuestProperty &g) const;
674
675	com::Utf8Str strName,
676	strValue;
677	uint64_t timestamp;
678	com::Utf8Str strFlags;
679	};
680
681	typedef std::list<GuestProperty> GuestPropertiesList;
682
683	typedef std::map<uint32_t, DeviceType_T> BootOrderMap;
684
685	/**
686	* NOTE: If you add any fields in here, you must update a) the constructor and b)
687	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
688	* your settings might never get saved.
689	*/
690	struct CpuIdLeaf
691	{
692	CpuIdLeaf();
693
694	bool operator==(const CpuIdLeaf &c) const;
695
696	uint32_t idx;
697	uint32_t idxSub;
698	uint32_t uEax;
699	uint32_t uEbx;
700	uint32_t uEcx;
701	uint32_t uEdx;
702	};
703
704	typedef std::list<CpuIdLeaf> CpuIdLeafsList;
705
706	/**
707	* NOTE: If you add any fields in here, you must update a) the constructor and b)
708	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
709	* your settings might never get saved.
710	*/
711	struct Cpu
712	{
713	Cpu();
714
715	bool operator==(const Cpu &c) const;
716
717	uint32_t ulId;
718	};
719
720	typedef std::list<Cpu> CpuList;
721
722	/**
723	* NOTE: If you add any fields in here, you must update a) the constructor and b)
724	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
725	* your settings might never get saved.
726	*/
727	struct BandwidthGroup
728	{
729	BandwidthGroup();
730
731	bool operator==(const BandwidthGroup &i) const;
732
733	com::Utf8Str strName;
734	uint64_t cMaxBytesPerSec;
735	BandwidthGroupType_T enmType;
736	};
737
738	typedef std::list<BandwidthGroup> BandwidthGroupList;
739
740	/**
741	* NOTE: If you add any fields in here, you must update a) the constructor and b)
742	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
743	* your settings might never get saved.
744	*/
745	struct IOSettings
746	{
747	IOSettings();
748
749	bool areIOCacheDefaultSettings() const;
750	bool areDefaultSettings() const;
751
752	bool operator==(const IOSettings &i) const;
753
754	bool fIOCacheEnabled;
755	uint32_t ulIOCacheSize;
756	BandwidthGroupList llBandwidthGroups;
757	};
758
759	/**
760	* NOTE: If you add any fields in here, you must update a) the constructor and b)
761	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
762	* your settings might never get saved.
763	*/
764	struct HostPCIDeviceAttachment
765	{
766	HostPCIDeviceAttachment();
767
768	bool operator==(const HostPCIDeviceAttachment &a) const;
769
770	com::Utf8Str strDeviceName;
771	uint32_t uHostAddress;
772	uint32_t uGuestAddress;
773	};
774
775	typedef std::list<HostPCIDeviceAttachment> HostPCIDeviceAttachmentList;
776
777	/**
778	* A device attached to a storage controller. This can either be a
779	* hard disk or a DVD drive or a floppy drive and also specifies
780	* which medium is "in" the drive; as a result, this is a combination
781	* of the Main IMedium and IMediumAttachment interfaces.
782	*
783	* NOTE: If you add any fields in here, you must update a) the constructor and b)
784	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
785	* your settings might never get saved.
786	*/
787	struct AttachedDevice
788	{
789	AttachedDevice();
790
791	bool operator==(const AttachedDevice &a) const;
792
793	DeviceType_T deviceType; // only HardDisk, DVD or Floppy are allowed
794
795	// DVDs can be in pass-through mode:
796	bool fPassThrough;
797
798	// Whether guest-triggered eject of DVDs will keep the medium in the
799	// VM config or not:
800	bool fTempEject;
801
802	// Whether the medium is non-rotational:
803	bool fNonRotational;
804
805	// Whether the medium supports discarding unused blocks:
806	bool fDiscard;
807
808	// Whether the medium is hot-pluggable:
809	bool fHotPluggable;
810
811	int32_t lPort;
812	int32_t lDevice;
813
814	// if an image file is attached to the device (ISO, RAW, or hard disk image such as VDI),
815	// this is its UUID; it depends on deviceType which media registry this then needs to
816	// be looked up in. If no image file (only permitted for DVDs and floppies), then the UUID is NULL
817	com::Guid uuid;
818
819	// for DVDs and floppies, the attachment can also be a host device:
820	com::Utf8Str strHostDriveSrc; // if != NULL, value of <HostDrive>/@src
821
822	// Bandwidth group the device is attached to.
823	com::Utf8Str strBwGroup;
824	};
825
826	typedef std::list<AttachedDevice> AttachedDevicesList;
827
828	/**
829	* NOTE: If you add any fields in here, you must update a) the constructor and b)
830	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
831	* your settings might never get saved.
832	*/
833	struct StorageController
834	{
835	StorageController();
836
837	bool operator==(const StorageController &s) const;
838
839	com::Utf8Str strName;
840	StorageBus_T storageBus; // _SATA, _SCSI, _IDE, _SAS
841	StorageControllerType_T controllerType;
842	uint32_t ulPortCount;
843	uint32_t ulInstance;
844	bool fUseHostIOCache;
845	bool fBootable;
846
847	// only for when controllerType == StorageControllerType_IntelAhci:
848	int32_t lIDE0MasterEmulationPort,
849	lIDE0SlaveEmulationPort,
850	lIDE1MasterEmulationPort,
851	lIDE1SlaveEmulationPort;
852
853	AttachedDevicesList llAttachedDevices;
854	};
855
856	typedef std::list<StorageController> StorageControllersList;
857
858	/**
859	* We wrap the storage controllers list into an extra struct so we can
860	* use an undefined struct without needing std::list<> in all the headers.
861	*
862	* NOTE: If you add any fields in here, you must update a) the constructor and b)
863	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
864	* your settings might never get saved.
865	*/
866	struct Storage
867	{
868	bool operator==(const Storage &s) const;
869
870	StorageControllersList llStorageControllers;
871	};
872
873	/**
874	* Representation of Machine hardware; this is used in the MachineConfigFile.hardwareMachine
875	* field.
876	*
877	* NOTE: If you add any fields in here, you must update a) the constructor and b)
878	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
879	* your settings might never get saved.
880	*/
881	struct Hardware
882	{
883	Hardware();
884
885	bool areParavirtDefaultSettings(SettingsVersion_T sv) const;
886	bool areBootOrderDefaultSettings() const;
887	bool areDisplayDefaultSettings() const;
888	bool areVideoCaptureDefaultSettings() const;
889	bool areAllNetworkAdaptersDefaultSettings(SettingsVersion_T sv) const;
890
891	bool operator==(const Hardware&) const;
892
893	com::Utf8Str strVersion; // hardware version, optional
894	com::Guid uuid; // hardware uuid, optional (null).
895
896	bool fHardwareVirt,
897	fNestedPaging,
898	fLargePages,
899	fVPID,
900	fUnrestrictedExecution,
901	fHardwareVirtForce,
902	fSyntheticCpu,
903	fTripleFaultReset,
904	fPAE,
905	fAPIC, // requires settings version 1.16 (VirtualBox 5.1)
906	fX2APIC; // requires settings version 1.16 (VirtualBox 5.1)
907	bool fIBPBOnVMExit; //< added out of cycle, after 1.16 was out.
908	bool fIBPBOnVMEntry; //< added out of cycle, after 1.16 was out.
909	typedef enum LongModeType { LongMode_Enabled, LongMode_Disabled, LongMode_Legacy } LongModeType;
910	LongModeType enmLongMode;
911	uint32_t cCPUs;
912	bool fCpuHotPlug; // requires settings version 1.10 (VirtualBox 3.2)
913	CpuList llCpus; // requires settings version 1.10 (VirtualBox 3.2)
914	bool fHPETEnabled; // requires settings version 1.10 (VirtualBox 3.2)
915	uint32_t ulCpuExecutionCap; // requires settings version 1.11 (VirtualBox 3.3)
916	uint32_t uCpuIdPortabilityLevel; // requires settings version 1.15 (VirtualBox 5.0)
917	com::Utf8Str strCpuProfile; // requires settings version 1.16 (VirtualBox 5.1)
918
919	CpuIdLeafsList llCpuIdLeafs;
920
921	uint32_t ulMemorySizeMB;
922
923	BootOrderMap mapBootOrder; // item 0 has highest priority
924
925	GraphicsControllerType_T graphicsControllerType;
926	uint32_t ulVRAMSizeMB;
927	uint32_t cMonitors;
928	bool fAccelerate3D,
929	fAccelerate2DVideo; // requires settings version 1.8 (VirtualBox 3.1)
930
931	uint32_t ulVideoCaptureHorzRes; // requires settings version 1.14 (VirtualBox 4.3)
932	uint32_t ulVideoCaptureVertRes; // requires settings version 1.14 (VirtualBox 4.3)
933	uint32_t ulVideoCaptureRate; // requires settings version 1.14 (VirtualBox 4.3)
934	uint32_t ulVideoCaptureFPS; // requires settings version 1.14 (VirtualBox 4.3)
935	uint32_t ulVideoCaptureMaxTime; // requires settings version 1.14 (VirtualBox 4.3)
936	uint32_t ulVideoCaptureMaxSize; // requires settings version 1.14 (VirtualBox 4.3)
937	bool fVideoCaptureEnabled; // requires settings version 1.14 (VirtualBox 4.3)
938	uint64_t u64VideoCaptureScreens; // requires settings version 1.14 (VirtualBox 4.3)
939	com::Utf8Str strVideoCaptureFile; // requires settings version 1.14 (VirtualBox 4.3)
940	com::Utf8Str strVideoCaptureOptions; // new since VirtualBox 5.2.
941
942	FirmwareType_T firmwareType; // requires settings version 1.9 (VirtualBox 3.1)
943
944	PointingHIDType_T pointingHIDType; // requires settings version 1.10 (VirtualBox 3.2)
945	KeyboardHIDType_T keyboardHIDType; // requires settings version 1.10 (VirtualBox 3.2)
946
947	ChipsetType_T chipsetType; // requires settings version 1.11 (VirtualBox 4.0)
948	ParavirtProvider_T paravirtProvider; // requires settings version 1.15 (VirtualBox 4.4)
949	com::Utf8Str strParavirtDebug; // requires settings version 1.16 (VirtualBox 5.1)
950
951	bool fEmulatedUSBCardReader; // 1.12 (VirtualBox 4.1)
952
953	VRDESettings vrdeSettings;
954
955	BIOSSettings biosSettings;
956	USB usbSettings;
957	NetworkAdaptersList llNetworkAdapters;
958	SerialPortsList llSerialPorts;
959	ParallelPortsList llParallelPorts;
960	AudioAdapter audioAdapter;
961	Storage storage;
962
963	// technically these two have no business in the hardware section, but for some
964	// clever reason <Hardware> is where they are in the XML....
965	SharedFoldersList llSharedFolders;
966	ClipboardMode_T clipboardMode;
967	DnDMode_T dndMode;
968
969	uint32_t ulMemoryBalloonSize;
970	bool fPageFusionEnabled;
971
972	GuestPropertiesList llGuestProperties;
973
974	IOSettings ioSettings; // requires settings version 1.10 (VirtualBox 3.2)
975	HostPCIDeviceAttachmentList pciAttachments; // requires settings version 1.12 (VirtualBox 4.1)
976
977	com::Utf8Str strDefaultFrontend; // requires settings version 1.14 (VirtualBox 4.3)
978	};
979
980	/**
981	* Settings that has to do with debugging.
982	*/
983	struct Debugging
984	{
985	Debugging();
986
987	bool areDefaultSettings() const;
988
989	bool operator==(const Debugging &rOther) const;
990
991	bool fTracingEnabled;
992	bool fAllowTracingToAccessVM;
993	com::Utf8Str strTracingConfig;
994	};
995
996	/**
997	* Settings that has to do with autostart.
998	*/
999	struct Autostart
1000	{
1001	Autostart();
1002
1003	bool areDefaultSettings() const;
1004
1005	bool operator==(const Autostart &rOther) const;
1006
1007	bool fAutostartEnabled;
1008	uint32_t uAutostartDelay;
1009	AutostopType_T enmAutostopType;
1010	};
1011
1012	struct Snapshot;
1013	typedef std::list<Snapshot> SnapshotsList;
1014
1015	/**
1016	* NOTE: If you add any fields in here, you must update a) the constructor and b)
1017	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
1018	* your settings might never get saved.
1019	*/
1020	struct Snapshot
1021	{
1022	Snapshot();
1023
1024	bool operator==(const Snapshot &s) const;
1025
1026	com::Guid uuid;
1027	com::Utf8Str strName,
1028	strDescription; // optional
1029	RTTIMESPEC timestamp;
1030
1031	com::Utf8Str strStateFile; // for online snapshots only
1032
1033	Hardware hardware;
1034
1035	Debugging debugging;
1036	Autostart autostart;
1037
1038	SnapshotsList llChildSnapshots;
1039
1040	static const struct Snapshot Empty;
1041	};
1042
1043	/**
1044	* NOTE: If you add any fields in here, you must update a) the constructor and b)
1045	* the operator== which is used by MachineConfigFile::operator==(), or otherwise
1046	* your settings might never get saved.
1047	*/
1048	struct MachineUserData
1049	{
1050	MachineUserData();
1051
1052	bool operator==(const MachineUserData &c) const;
1053
1054	com::Utf8Str strName;
1055	bool fDirectoryIncludesUUID;
1056	bool fNameSync;
1057	com::Utf8Str strDescription;
1058	StringsList llGroups;
1059	com::Utf8Str strOsType;
1060	com::Utf8Str strSnapshotFolder;
1061	bool fTeleporterEnabled;
1062	uint32_t uTeleporterPort;
1063	com::Utf8Str strTeleporterAddress;
1064	com::Utf8Str strTeleporterPassword;
1065	FaultToleranceState_T enmFaultToleranceState;
1066	uint32_t uFaultTolerancePort;
1067	com::Utf8Str strFaultToleranceAddress;
1068	com::Utf8Str strFaultTolerancePassword;
1069	uint32_t uFaultToleranceInterval;
1070	bool fRTCUseUTC;
1071	IconBlob ovIcon;
1072	com::Utf8Str strVMPriority;
1073	};
1074
1075
1076	/**
1077	* MachineConfigFile represents an XML machine configuration. All the machine settings
1078	* that go out to the XML (or are read from it) are in here.
1079	*
1080	* NOTE: If you add any fields in here, you must update a) the constructor and b)
1081	* the operator== which is used by Machine::saveSettings(), or otherwise your settings
1082	* might never get saved.
1083	*/
1084	class MachineConfigFile : public ConfigFileBase
1085	{
1086	public:
1087	com::Guid uuid;
1088
1089	MachineUserData machineUserData;
1090
1091	com::Utf8Str strStateFile;
1092	bool fCurrentStateModified; // optional, default is true
1093	RTTIMESPEC timeLastStateChange; // optional, defaults to now
1094	bool fAborted; // optional, default is false
1095
1096	com::Guid uuidCurrentSnapshot;
1097
1098	Hardware hardwareMachine;
1099	MediaRegistry mediaRegistry;
1100	Debugging debugging;
1101	Autostart autostart;
1102
1103	StringsMap mapExtraDataItems;
1104
1105	SnapshotsList llFirstSnapshot; // first snapshot or empty list if there's none
1106
1107	MachineConfigFile(const com::Utf8Str *pstrFilename);
1108
1109	bool operator==(const MachineConfigFile &m) const;
1110
1111	bool canHaveOwnMediaRegistry() const;
1112
1113	void importMachineXML(const xml::ElementNode &elmMachine);
1114
1115	void write(const com::Utf8Str &strFilename);
1116
1117	enum
1118	{
1119	BuildMachineXML_IncludeSnapshots = 0x01,
1120	BuildMachineXML_WriteVBoxVersionAttribute = 0x02,
1121	BuildMachineXML_SkipRemovableMedia = 0x04,
1122	BuildMachineXML_MediaRegistry = 0x08,
1123	BuildMachineXML_SuppressSavedState = 0x10
1124	};
1125	void buildMachineXML(xml::ElementNode &elmMachine,
1126	uint32_t fl,
1127	std::list<xml::ElementNode> pllElementsWithUuidAttributes);
1128
1129	static bool isAudioDriverAllowedOnThisHost(AudioDriverType_T drv);
1130	static AudioDriverType_T getHostDefaultAudioDriver();
1131
1132	private:
1133	void readNetworkAdapters(const xml::ElementNode &elmHardware, NetworkAdaptersList &ll);
1134	void readAttachedNetworkMode(const xml::ElementNode &pelmMode, bool fEnabled, NetworkAdapter &nic);
1135	void readCpuIdTree(const xml::ElementNode &elmCpuid, CpuIdLeafsList &ll);
1136	void readCpuTree(const xml::ElementNode &elmCpu, CpuList &ll);
1137	void readSerialPorts(const xml::ElementNode &elmUART, SerialPortsList &ll);
1138	void readParallelPorts(const xml::ElementNode &elmLPT, ParallelPortsList &ll);
1139	void readAudioAdapter(const xml::ElementNode &elmAudioAdapter, AudioAdapter &aa);
1140	void readGuestProperties(const xml::ElementNode &elmGuestProperties, Hardware &hw);
1141	void readStorageControllerAttributes(const xml::ElementNode &elmStorageController, StorageController &sctl);
1142	void readHardware(const xml::ElementNode &elmHardware, Hardware &hw);
1143	void readHardDiskAttachments_pre1_7(const xml::ElementNode &elmHardDiskAttachments, Storage &strg);
1144	void readStorageControllers(const xml::ElementNode &elmStorageControllers, Storage &strg);
1145	void readDVDAndFloppies_pre1_9(const xml::ElementNode &elmHardware, Storage &strg);
1146	void readTeleporter(const xml::ElementNode pElmTeleporter, MachineUserData pUserData);
1147	void readDebugging(const xml::ElementNode pElmDbg, Debugging pDbg);
1148	void readAutostart(const xml::ElementNode pElmAutostart, Autostart pAutostart);
1149	void readGroups(const xml::ElementNode elmGroups, StringsList pllGroups);
1150	bool readSnapshot(const com::Guid &curSnapshotUuid, uint32_t depth, const xml::ElementNode &elmSnapshot, Snapshot &snap);
1151	void convertOldOSType_pre1_5(com::Utf8Str &str);
1152	void readMachine(const xml::ElementNode &elmMachine);
1153
1154	void buildHardwareXML(xml::ElementNode &elmParent, const Hardware &hw, uint32_t fl, std::list<xml::ElementNode> pllElementsWithUuidAttributes);
1155	void buildNetworkXML(NetworkAttachmentType_T mode, bool fEnabled, xml::ElementNode &elmParent, const NetworkAdapter &nic);
1156	void buildStorageControllersXML(xml::ElementNode &elmParent,
1157	const Storage &st,
1158	bool fSkipRemovableMedia,
1159	std::list<xml::ElementNode> pllElementsWithUuidAttributes);
1160	void buildDebuggingXML(xml::ElementNode pElmParent, const Debugging pDbg);
1161	void buildAutostartXML(xml::ElementNode pElmParent, const Autostart pAutostart);
1162	void buildGroupsXML(xml::ElementNode pElmParent, const StringsList pllGroups);
1163	void buildSnapshotXML(uint32_t depth, xml::ElementNode &elmParent, const Snapshot &snap);
1164
1165	void bumpSettingsVersionIfNeeded();
1166	};
1167
1168	} // namespace settings
1169
1170
1171	#endif /* ___VBox_settings_h */

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/include/VBox/settings.h@ 70606

Download in other formats: