1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/* $Id: DHCPServerImpl.h $ */
/** @file
* VirtualBox COM class implementation
*/
/*
* Copyright (C) 2006-2023 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, in version 3 of the
* License.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* SPDX-License-Identifier: GPL-3.0-only
*/
#ifndef MAIN_INCLUDED_DHCPServerImpl_h
#define MAIN_INCLUDED_DHCPServerImpl_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include "DHCPServerWrap.h"
#include <map>
namespace settings
{
struct DHCPServer;
struct DhcpOptValue;
typedef std::map<DHCPOption_T, DhcpOptValue> DhcpOptionMap;
}
class DHCPConfig;
class DHCPIndividualConfig;
/**
* A DHCP server for internal host-only & NAT networks.
*
* Old notes:
*
* for server configuration needs, it's perhaps better to use (VM,slot) pair
* (vm-name, slot) <----> (MAC)
*
* but for client configuration, when server will have MACs at hand, it'd be
* easier to requiest options by MAC.
* (MAC) <----> (option-list)
*
* Doubts: What should be done if MAC changed for (vm-name, slot), when syncing should?
* XML: serialization of dependecy (DHCP options) - (VM,slot) shouldn't be done via MAC in
* the middle.
*/
class ATL_NO_VTABLE DHCPServer
: public DHCPServerWrap
{
public:
/** @name Constructors and destructors
* @{ */
DECLARE_COMMON_CLASS_METHODS(DHCPServer)
HRESULT FinalConstruct();
void FinalRelease();
HRESULT init(VirtualBox *aVirtualBox, const com::Utf8Str &aName);
HRESULT init(VirtualBox *aVirtualBox, const settings::DHCPServer &data);
void uninit();
/** @} */
/** @name Public internal methods.
* @{ */
HRESULT i_saveSettings(settings::DHCPServer &data);
HRESULT i_removeConfig(DHCPConfig *pConfig, DHCPConfigScope_T enmScope);
/** @} */
private:
/** @name IDHCPServer Properties
* @{ */
HRESULT getEventSource(ComPtr<IEventSource> &aEventSource) RT_OVERRIDE;
HRESULT getEnabled(BOOL *aEnabled) RT_OVERRIDE;
HRESULT setEnabled(BOOL aEnabled) RT_OVERRIDE;
HRESULT getIPAddress(com::Utf8Str &aIPAddress) RT_OVERRIDE;
HRESULT getNetworkMask(com::Utf8Str &aNetworkMask) RT_OVERRIDE;
HRESULT getNetworkName(com::Utf8Str &aName) RT_OVERRIDE;
HRESULT getLowerIP(com::Utf8Str &aIPAddress) RT_OVERRIDE;
HRESULT getUpperIP(com::Utf8Str &aIPAddress) RT_OVERRIDE;
HRESULT setConfiguration(const com::Utf8Str &aIPAddress, const com::Utf8Str &aNetworkMask,
const com::Utf8Str &aFromIPAddress, const com::Utf8Str &aToIPAddress) RT_OVERRIDE;
HRESULT getGlobalConfig(ComPtr<IDHCPGlobalConfig> &aGlobalConfig) RT_OVERRIDE;
HRESULT getGroupConfigs(std::vector<ComPtr<IDHCPGroupConfig> > &aGroupConfigs) RT_OVERRIDE;
HRESULT getIndividualConfigs(std::vector<ComPtr<IDHCPIndividualConfig> > &aIndividualConfigs) ;
/** @} */
/** @name IDHCPServer Methods
* @{ */
HRESULT start(const com::Utf8Str &aTrunkName, const com::Utf8Str &aTrunkType) RT_OVERRIDE;
HRESULT stop() RT_OVERRIDE;
HRESULT restart() RT_OVERRIDE;
HRESULT findLeaseByMAC(const com::Utf8Str &aMac, LONG aType, com::Utf8Str &aAddress, com::Utf8Str &aState,
LONG64 *aIssued, LONG64 *aExpire) RT_OVERRIDE;
HRESULT getConfig(DHCPConfigScope_T aScope, const com::Utf8Str &aName, ULONG aSlot, BOOL aMayAdd,
ComPtr<IDHCPConfig> &aConfig) RT_OVERRIDE;
/** @} */
/** @name Helpers
* @{ */
HRESULT i_doSaveSettings();
HRESULT i_calcLeasesConfigAndLogFilenames(const com::Utf8Str &aNetwork) RT_NOEXCEPT;
HRESULT i_writeDhcpdConfig(const char *pszFilename, uint32_t uMACAddressVersion) RT_NOEXCEPT;
HRESULT i_vmNameToIdAndValidateSlot(const com::Utf8Str &aVmName, ULONG a_uSlot, com::Guid &idMachine);
HRESULT i_vmNameAndSlotToConfig(const com::Utf8Str &a_strVmName, ULONG a_uSlot, bool a_fCreateIfNeeded,
ComObjPtr<DHCPIndividualConfig> &a_rPtrConfig);
/** @} */
/** Private data */
struct Data;
/** Private data. */
Data *m;
};
#endif /* !MAIN_INCLUDED_DHCPServerImpl_h */
|
