Raritan PX2/PX3 JSON-RPC API
Net.idl
1 #include <Event.idl>
2 
6 module net {
7 
9  structure IpAddrCidr {
10  string addr; // IP address
11  int prefixLen; // Length of network prefix in the IP address
12  };
13 
15  structure IpRoute {
16  IpAddrCidr destNetAddrCidr; // Destination network address (CIDR)
17  string nextHopAddr; // Address of the next hop (empty when ifName is set)
18  string ifName; // Destination interface (empty if nextHopAddr is set)
19  };
20 
22  enumeration PortForwardingRole {
25  };
26 
28  [sparse_in]
30  boolean enabled;
33  };
34 
36  [sparse_in]
37  structure DnsSettings_2_0_0 {
38  vector<string> serverAddrs;
39  vector<string> searchSuffixes;
41  };
42 
44  [sparse_in]
47  vector<IpRoute> staticRoutes;
48  };
49 
51  [sparse_in]
55  };
56 
58  [sparse_in]
63  };
64 
67  string ifName;
68  string addr;
69  };
70 
72  structure PortForwardingInfo {
73  boolean enabled;
74  boolean nodeIndexValid;
75  int nodeIndex;
76  boolean slaveConnected;
78  vector<PortForwardingMasterAddrInfo> masterIPv4AddrInfos;
80  vector<PortForwardingMasterAddrInfo> masterIPv6AddrInfos;
81  };
82 
84  structure DnsInfo {
85  vector<string> serverAddrs;
86  vector<string> searchSuffixes;
88  };
89 
91  structure RoutingInfo {
92  vector<IpRoute> ipv4Routes;
93  vector<IpRoute> ipv6Routes;
94  };
95 
97  structure CommonInfo {
101  };
102 
104  enumeration IpConfigMethod {
108  };
109 
111  [sparse_in]
113  boolean enabled;
117  };
118 
120  structure InterfaceIPv4Info {
121  boolean enabled;
123  vector<IpAddrCidr> addrsCidr;
124  string dhcpServerAddr;
126  };
127 
129  structure InterfaceIPv6Info {
130  boolean enabled;
132  vector<IpAddrCidr> addrsCidr;
133  string dhcpServerId;
135  boolean raManaged;
136  boolean raOtherConf;
137  };
138 
140  [sparse_in]
142  boolean enabled;
145  };
146 
148  enumeration InterfaceType {
152  };
153 
155  enumeration InterfaceOpState {
159  UP
160  };
161 
163  structure InterfaceInfo {
164  string name;
165  string label;
167  boolean enabled;
168  string masterIfName;
170  string macAddr;
173  };
174 
176  enumeration EthSpeed {
181  };
182 
184  enumeration EthDuplexMode {
188  };
189 
191  structure EthLinkMode {
194  };
195 
197  structure EthSettings {
199  };
200 
202  structure EthInfo {
204  boolean linkModeValid;
205  boolean autonegEnabled;
206  boolean linkDetected;
207  vector<EthLinkMode> supportedLinkModes;
208  };
209 
211  enumeration WlanSecProtocol {
213  };
214 
216  enumeration WlanAuthType {
217  NONE,
218  PSK,
220  };
221 
223  enumeration EapOuterAuthMethod {
225  };
226 
228  enumeration EapInnerAuthMethod {
230  };
231 
233  [sparse_in]
235  string identity;
236  string password;
237  boolean clearPassword;
240  string caCertChain;
244  string authServerName;
246  };
247 
249  [sparse_in]
250  structure WlanSettings_2_0_0 {
251  boolean enableHT;
252  string ssid;
253  string bssid;
256  string psk;
257  boolean clearPsk;
259  };
260 
262  enumeration WlanChannelWidth {
263  CHANNEL_WIDTH_UNKNOWN,
264  CHANNEL_WIDTH_20_NO_HT,
265  CHANNEL_WIDTH_20,
266  CHANNEL_WIDTH_40,
267  CHANNEL_WIDTH_80,
268  CHANNEL_WIDTH_80P80,
269  CHANNEL_WIDTH_160
270  };
271 
273  structure WlanInfo {
274  boolean associated;
275  string ssid;
276  string bssid;
277  int channel;
279  };
280 
282  [sparse_in]
283  structure Settings_2_0_0 {
285  map<string, InterfaceSettings_2_0_0> ifMap;
286  map<string, EthSettings> ethMap;
287  map<string, WlanSettings_2_0_0> wlanMap;
288  };
289 
291  structure Info {
293  map<string, InterfaceInfo> ifMap;
294  map<string, EthInfo> ethMap;
295  map<string, WlanInfo> wlanMap;
296  };
297 
301  string appProtoName;
303  };
304 
305  /* ---- event definitions ---- */
306 
308  valueobject CommonInfoChangedEvent extends idl.Event {
309  CommonInfo commonInfo;
310  };
311 
313  valueobject InterfaceInfoChangedEvent extends idl.Event {
314  InterfaceInfo ifInfo;
315  };
316 
318  valueobject EthInfoChangedEvent extends idl.Event {
319  string ifName;
321  };
322 
324  valueobject WlanInfoChangedEvent extends idl.Event {
325  string ifName;
327  };
328 
330  valueobject LinkStateChangedEvent extends idl.Event {
331  string ifName;
332  string ifLabel;
335  };
336 
338  valueobject PortForwardingSlavePresenceStateChangedEvent extends idl.Event {
339  boolean slavePresent;
340  };
341 
343  interface Net_4_0_1 {
344 
346  constant int SUCCESS = 0;
347 
349  constant int ERR_DNS_TOO_MANY_SERVERS = 100;
350  constant int ERR_DNS_INVALID_SERVER = 101;
351  constant int ERR_DNS_TOO_MANY_SEARCH_SUFFIXES = 102;
352  constant int ERR_DNS_INVALID_SEARCH_SUFFIX = 103;
353 
355  constant int ERR_ROUTING_IPV4_INVALID_DFLT_GATEWAY_ADDR = 200;
356  constant int ERR_ROUTING_IPV6_INVALID_DFLT_GATEWAY_ADDR = 201;
357  constant int ERR_ROUTING_IPV4_INVALID_DEST_ADDR = 202;
358  constant int ERR_ROUTING_IPV6_INVALID_DEST_ADDR = 203;
359  constant int ERR_ROUTING_IPV4_INVALID_DEST_PREFIX_LEN = 204;
360  constant int ERR_ROUTING_IPV6_INVALID_DEST_PREFIX_LEN = 205;
361  constant int ERR_ROUTING_IPV4_INVALID_NEXTHOP_ADDR = 206;
362  constant int ERR_ROUTING_IPV6_INVALID_NEXTHOP_ADDR = 207;
363  constant int ERR_ROUTING_IPV4_INVALID_INTERFACE = 208;
364  constant int ERR_ROUTING_IPV6_INVALID_INTERFACE = 209;
365  constant int ERR_ROUTING_IPV4_DEST_IS_NO_NETWORK_ADDR = 210;
366  constant int ERR_ROUTING_IPV6_DEST_IS_NO_NETWORK_ADDR = 211;
367  constant int ERR_ROUTING_IPV4_DEST_IS_DUPLICATE = 212;
368  constant int ERR_ROUTING_IPV6_DEST_IS_DUPLICATE = 213;
369  constant int ERR_ROUTING_IPV4_NO_NEXTHOP_OR_INTERFACE = 214;
370  constant int ERR_ROUTING_IPV6_NO_NEXTHOP_OR_INTERFACE = 215;
371  constant int ERR_ROUTING_IPV4_NEXTHOP_AND_INTERFACE_SET = 216;
372  constant int ERR_ROUTING_IPV6_NEXTHOP_AND_INTERFACE_SET = 217;
373 
375  constant int ERR_PF_INVALID_MASTER_DOWNSTREAM_INTERFACE = 300;
376  constant int ERR_PF_NO_WORKING_MASTER_UPSTREAM_INTERFACE= 301;
377 
379  constant int ERR_IF_IPV4_INVALID_CONFIG_METHOD = 400;
380  constant int ERR_IF_IPV6_INVALID_CONFIG_METHOD = 401;
381  constant int ERR_IF_IPV4_INVALID_STATIC_ADDR = 402;
382  constant int ERR_IF_IPV6_INVALID_STATIC_ADDR = 403;
383  constant int ERR_IF_IPV4_INVALID_STATIC_PREFIX_LEN = 404;
384  constant int ERR_IF_IPV6_INVALID_STATIC_PREFIX_LEN = 405;
385  constant int ERR_IF_IPV4_INVALID_DHCP_PREF_HOSTNAME = 406;
386  constant int ERR_IF_IPV6_INVALID_DHCP_PREF_HOSTNAME = 407;
387 
389  constant int ERR_ETH_IF_UNSUPPORTED_LINKMODE = 500;
390 
392  constant int ERR_WLAN_IF_INVALID_SSID = 600;
393  constant int ERR_WLAN_IF_INVALID_BSSID = 601;
394  constant int ERR_WLAN_IF_INVALID_PSK = 602;
395  constant int ERR_WLAN_IF_INVALID_EAP_IDENTITY = 603;
396  constant int ERR_WLAN_IF_INVALID_EAP_PASSWORD = 604;
397  constant int ERR_WLAN_IF_INVALID_EAP_CERT = 605;
398  constant int ERR_WLAN_IF_EAP_CERT_VERIFY_FAILED = 606;
399  constant int ERR_WLAN_IF_INVALID_EAP_AUTH_SERVER_NAME = 607;
400 
406  Info getInfo();
407 
413  Settings_2_0_0 getSettings();
414 
426  int setSettings(in Settings_2_0_0 settings);
427 
433  vector<PortForwardingProtocolMapping> getPortForwardingProtocolMappings();
434 
435  };
436 
437 }
PortForwardingInfo portForwarding
Port forwarding info.
Definition: Net.idl:100
InterfaceOpState ifState
Current operational interface state.
Definition: Net.idl:334
boolean resolverPrefersIPv6
Resolver should prefer IPv6 addresses.
Definition: Net.idl:87
vector< EthLinkMode > supportedLinkModes
Supported link modes.
Definition: Net.idl:207
map< string, EthInfo > ethMap
Ethernet specific interface info.
Definition: Net.idl:294
vector< string > searchSuffixes
List of domain search suffixes.
Definition: Net.idl:39
PortForwardingRole role
The role of the node (master or slave)
Definition: Net.idl:31
EAP authentication.
Definition: Net.idl:219
Interface is up and running.
Definition: Net.idl:159
Use auto-negotiation to set speed.
Definition: Net.idl:177
Half duplex.
Definition: Net.idl:186
Ethernet interface.
Definition: Net.idl:149
Interface specific IP settings.
Definition: Net.idl:112
EapAuthSettings_2_0_0 eap
Settings for EAP authentication.
Definition: Net.idl:258
vector< IpAddrCidr > addrsCidr
List of active IPv4 addresses with prefix length.
Definition: Net.idl:123
Pre-shared key authentication.
Definition: Net.idl:218
string bssid
BSSID of associated access point.
Definition: Net.idl:276
WlanInfo wlanInfo
Current WLAN interface specific info.
Definition: Net.idl:326
boolean enableHT
Enable high throughput features (802::11n)
Definition: Net.idl:251
PEAP authentication.
Definition: Net.idl:224
string ifName
interface name on master
Definition: Net.idl:67
string transportProtoName
Transport protocol name.
Definition: Net.idl:302
Interface specific settings.
Definition: Net.idl:141
IpAddrCidr staticAddrCidr
Statically assigned IPv4/IPv6 address (CIDR)
Definition: Net.idl:115
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:131
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:114
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:134
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:116
Use auto-negotiation to set duplex mode.
Definition: Net.idl:185
Port forwarding info.
Definition: Net.idl:72
EthDuplexMode duplexMode
Interface duplex mode.
Definition: Net.idl:193
Ethernet link mode.
Definition: Net.idl:191
InterfaceIpSettings_2_0_0 ipv4
Interface specific IPv4 settings.
Definition: Net.idl:143
IPv4/IPv6 route.
Definition: Net.idl:15
boolean forceTrustedCert
Enforce trusted certificates.
Definition: Net.idl:241
Full duplex.
Definition: Net.idl:187
string macAddr
MAC address of the interface.
Definition: Net.idl:170
string ssid
SSID of the wireless network.
Definition: Net.idl:275
DNS info.
Definition: Net.idl:84
int nodeIndex
Index of the node in the port forwarding cascade.
Definition: Net.idl:75
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:122
int appProtoId
Application protocol id.
Definition: Net.idl:300
boolean linkModeValid
true if linkMode is valid
Definition: Net.idl:204
Routing settings.
Definition: Net.idl:52
boolean resolverPrefersIPv6
Resolver should prefer IPv6 addresses.
Definition: Net.idl:40
Interface specific IPv6 info.
Definition: Net.idl:129
1000 MBit/s (1 GBit/s)
Definition: Net.idl:180
DnsInfo dns
DNS info.
Definition: Net.idl:98
WLAN interface.
Definition: Net.idl:150
InterfaceType
The interface type.
Definition: Net.idl:148
Bride interface.
Definition: Net.idl:151
CommonInfo common
Common network info.
Definition: Net.idl:292
WLAN interface settings.
Definition: Net.idl:250
string password
EAP password (always empty on retrieval!)
Definition: Net.idl:236
EthLinkMode linkMode
Current link mode.
Definition: Net.idl:203
string dhcpServerId
DHCPv6 server id or empty.
Definition: Net.idl:133
valueobject InterfaceInfoChangedEvent
Event that is send when common interface specific network info has changed.
Definition: Net.idl:310
string appProtoName
Application protocol name.
Definition: Net.idl:301
MSCHAPv2 authentication.
Definition: Net.idl:229
valueobject LinkStateChangedEvent
Event that is send when the operational state of an interface changed.
Definition: Net.idl:327
boolean associated
true if assoiated to an access point
Definition: Net.idl:274
DnsSettings_2_0_0 dns
DNS settings.
Definition: Net.idl:60
InterfaceType type
Interface type.
Definition: Net.idl:166
string bssid
BSSID (empty for automatic AP selection)
Definition: Net.idl:253
boolean nodeIndexValid
true if nodeIndex is valid
Definition: Net.idl:74
IpRoutingSettings_2_0_0 ipv6
IPv6 routing settings.
Definition: Net.idl:54
WlanSecProtocol
WLAN security protocol.
Definition: Net.idl:211
boolean enabled
The dynamic enabled state.
Definition: Net.idl:167
No automatic configuration.
Definition: Net.idl:105
WlanChannelWidth
WLAN channel width.
Definition: Net.idl:262
IP protocol specific routing settings.
Definition: Net.idl:45
RoutingInfo routing
Routing info.
Definition: Net.idl:99
boolean slaveConnected
true if this node has a slave connected
Definition: Net.idl:76
Ethernet interface settings.
Definition: Net.idl:197
vector< string > serverAddrs
List of domain name servers addresses (IPv4/IPv6)
Definition: Net.idl:38
Basic IDL definitions.
Definition: Event.idl:6
boolean raOtherConf
"OtherConf" flag set in router announcements
Definition: Net.idl:136
map< string, WlanSettings_2_0_0 > wlanMap
WLAN specific interface settings.
Definition: Net.idl:287
Interface is not present.
Definition: Net.idl:156
int channel
Channel number.
Definition: Net.idl:277
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:125
string defaultGatewayAddr
Default gateway address.
Definition: Net.idl:46
Interface specific IPv4 info.
Definition: Net.idl:120
valueobject PortForwardingSlavePresenceStateChangedEvent
Event that is send when the presence state of a downstream port forwarding slave changes.
Definition: Net.idl:335
map< string, WlanInfo > wlanMap
WLAN specific interface info.
Definition: Net.idl:295
boolean raManaged
"Managed" flag set in router announcements
Definition: Net.idl:135
Network Configuration.
Definition: Diagnostics.idl:4
Routing info.
Definition: Net.idl:91
IpRoutingSettings_2_0_0 ipv4
IPv4 routing settings.
Definition: Net.idl:53
Port forwarding settings.
Definition: Net.idl:29
InterfaceIpSettings_2_0_0 ipv6
Interface specific IPv6 settings.
Definition: Net.idl:144
EthSpeed
Ethernet speed.
Definition: Net.idl:176
boolean linkDetected
true if a link is detected
Definition: Net.idl:206
boolean enabled
true if port forwarding is enabled
Definition: Net.idl:73
WLAN interface info.
Definition: Net.idl:273
vector< IpRoute > ipv4Routes
List of active IPv4 routes.
Definition: Net.idl:92
Node is the port forwarding master.
Definition: Net.idl:23
EapOuterAuthMethod
EAP outer authentication method.
Definition: Net.idl:223
map< string, InterfaceInfo > ifMap
Common interface info.
Definition: Net.idl:293
valueobject WlanInfoChangedEvent
Event that is send when WLAN interface specific network info has changed.
Definition: Net.idl:321
string dhcpServerAddr
IPv4 address of DHCP server or empty.
Definition: Net.idl:124
10 MBit/s
Definition: Net.idl:178
EthLinkMode linkMode
Link mode.
Definition: Net.idl:198
EthSpeed speed
Interface speed.
Definition: Net.idl:192
PortForwardingRole
Role of the node when port forwarding is enabled.
Definition: Net.idl:22
Use DHCP for automatic configuration (IPv4 only)
Definition: Net.idl:106
string masterDownstreamIfName
Master downstream interface (usb: any USB iface)
Definition: Net.idl:77
Interface has no link.
Definition: Net.idl:158
string identity
EAP identity.
Definition: Net.idl:235
InterfaceType ifType
interface type
Definition: Net.idl:333
EAP authentication settings.
Definition: Net.idl:234
string masterIfName
Master interface (set for bridged interfaces)
Definition: Net.idl:168
WlanAuthType authType
Authentication type.
Definition: Net.idl:255
vector< string > searchSuffixes
List of active domain search suffixes.
Definition: Net.idl:86
Node is a port forwarding slave.
Definition: Net.idl:24
string ssid
SSID of the wireless network.
Definition: Net.idl:252
InterfaceOpState state
Operational state of the interface.
Definition: Net.idl:169
boolean allowOffTimeRangeCerts
allow expired and not yet valid TLS certs
Definition: Net.idl:242
vector< IpAddrCidr > addrsCidr
List of active IPv6 addresses with prefix length.
Definition: Net.idl:132
Network settings.
Definition: Net.idl:283
boolean enabled
Controls if port forwarding is enabled.
Definition: Net.idl:30
WlanChannelWidth channelWidth
Channel width (this is an id and no frequency!)
Definition: Net.idl:278
Common settings.
Definition: Net.idl:59
map< string, InterfaceSettings_2_0_0 > ifMap
Common interface settings.
Definition: Net.idl:285
string label
Interface label (used in user interfaces)
Definition: Net.idl:165
EapOuterAuthMethod outerMethod
Outer authentication method.
Definition: Net.idl:238
EapInnerAuthMethod innerMethod
Inner authentication method.
Definition: Net.idl:239
string name
Internal interface name.
Definition: Net.idl:164
Mapping from application protocol id to name and transport protocol.
Definition: Net.idl:299
Network configuration interface.
Definition: Net.idl:343
boolean enabled
Controls if interface is enabled.
Definition: Net.idl:142
EthDuplexMode
Ethernet duplex mode.
Definition: Net.idl:184
valueobject CommonInfoChangedEvent
Event that is send when common network info has changed.
Definition: Net.idl:309
boolean enabled
true if IPv6 is enabled
Definition: Net.idl:130
InterfaceIPv4Info ipv4
Interface specific IPv4 info.
Definition: Net.idl:171
Common info.
Definition: Net.idl:97
map< string, EthSettings > ethMap
Ethernet specific interface settings.
Definition: Net.idl:286
Interface specific info.
Definition: Net.idl:163
IPv4/IPv6 address and prefix len.
Definition: Net.idl:9
Port forwarding master address info for an interface.
Definition: Net.idl:66
vector< string > serverAddrs
List of active domain name server addresses.
Definition: Net.idl:85
Network info.
Definition: Net.idl:291
valueobject EthInfoChangedEvent
Event that is send when ethernet interface specific network info has changed.
Definition: Net.idl:315
string psk
Pre-shared key (always empty on retrieval!)
Definition: Net.idl:256
boolean enabled
true if IPv4 is enabled
Definition: Net.idl:121
InterfaceOpState
Interface operational state.
Definition: Net.idl:155
vector< IpRoute > staticRoutes
List of static routes.
Definition: Net.idl:47
Use automatic configuration (IPv6 only)
Definition: Net.idl:107
InterfaceIPv6Info ipv6
Interface specific IPv6 info.
Definition: Net.idl:172
RoutingSettings_2_0_0 routing
Routing settings.
Definition: Net.idl:61
WlanSecProtocol secProtocol
Security protocol (WPA2)
Definition: Net.idl:254
string addr
IPv4/IPv6 address on the interface.
Definition: Net.idl:68
CommonSettings_2_0_0 common
Common network settings.
Definition: Net.idl:284
vector< PortForwardingMasterAddrInfo > masterIPv6AddrInfos
Master address info for IPv6.
Definition: Net.idl:80
Interface is down.
Definition: Net.idl:157
IpConfigMethod
IP configuration method.
Definition: Net.idl:104
DNS settings.
Definition: Net.idl:37
EapInnerAuthMethod
EAP inner authentication method.
Definition: Net.idl:228
vector< IpRoute > ipv6Routes
List of active IPv6 routes.
Definition: Net.idl:93
boolean autonegEnabled
true if auto-negotiation is enabled
Definition: Net.idl:205
boolean clearPsk
Set to true when PSK should be cleared.
Definition: Net.idl:257
boolean clearPassword
Set to true when password should be cleared.
Definition: Net.idl:237
WlanAuthType
WLAN authentication type.
Definition: Net.idl:216
boolean enabled
Controls if IPv4/IPv6 is enabled.
Definition: Net.idl:113
EthInfo ethInfo
Current ethernet interface specific info.
Definition: Net.idl:320
string masterDownstreamIfName
Master downstream interface (usb: any USB iface)
Definition: Net.idl:32
boolean allowNotYetValidCertsIfTimeBeforeBuild
allow not yet valid TLS certs if
Definition: Net.idl:243
WPA2 security protocol.
Definition: Net.idl:212
string ifLabel
interface label
Definition: Net.idl:332
Ethernet interface info.
Definition: Net.idl:202
string caCertChain
CA certificate chain.
Definition: Net.idl:240
PortForwardingSettings_2_0_0 portForwarding
Port forwarding settings.
Definition: Net.idl:62
100 MBit/s
Definition: Net.idl:179