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 
29  boolean enabled;
32  };
33 
35  structure DnsSettings_2_0_0 {
36  vector<string> serverAddrs;
37  vector<string> searchSuffixes;
39  };
40 
44  vector<IpRoute> staticRoutes;
45  };
46 
51  };
52 
58  };
59 
62  string ifName;
63  string addr;
64  };
65 
67  structure PortForwardingInfo {
68  boolean enabled;
69  boolean nodeIndexValid;
70  int nodeIndex;
71  boolean slaveConnected;
73  vector<PortForwardingMasterAddrInfo> masterIPv4AddrInfos;
75  vector<PortForwardingMasterAddrInfo> masterIPv6AddrInfos;
76  };
77 
79  structure DnsInfo {
80  vector<string> serverAddrs;
81  vector<string> searchSuffixes;
83  };
84 
86  structure RoutingInfo {
87  vector<IpRoute> ipv4Routes;
88  vector<IpRoute> ipv6Routes;
89  };
90 
92  structure CommonInfo {
96  };
97 
99  enumeration IpConfigMethod {
103  };
104 
107  boolean enabled;
111  };
112 
114  structure InterfaceIPv4Info {
115  boolean enabled;
117  vector<IpAddrCidr> addrsCidr;
118  string dhcpServerAddr;
120  };
121 
123  structure InterfaceIPv6Info {
124  boolean enabled;
126  vector<IpAddrCidr> addrsCidr;
127  string dhcpServerId;
129  boolean raManaged;
130  boolean raOtherConf;
131  };
132 
135  boolean enabled;
138  };
139 
141  enumeration InterfaceType {
145  };
146 
148  enumeration InterfaceOpState {
152  UP
153  };
154 
156  structure InterfaceInfo {
157  string name;
158  string label;
160  boolean enabled;
161  string masterIfName;
163  string macAddr;
166  };
167 
172  };
173 
178  };
179 
181  enumeration EapStatus {
186  };
187 
190  string identity;
191  string password;
192  boolean clearPassword;
194  string clientPrivKey;
199  string caCertChain;
203  string authServerName;
205  };
206 
208  enumeration EthSpeed {
213  };
214 
216  enumeration EthDuplexMode {
220  };
221 
223  enumeration EthAuthType {
226  };
227 
229  structure EthLinkMode {
232  };
233 
235  structure EthSettings_2_0_0 {
239  };
240 
242  structure EthInfo_1_0_1 {
245  boolean linkModeValid;
246  boolean autonegEnabled;
247  boolean linkDetected;
248  vector<EthLinkMode> supportedLinkModes;
249  };
250 
252  enumeration WlanSecProtocol {
254  };
255 
257  enumeration WlanAuthType_2_0_0 {
261  };
262 
264  structure WlanSettings_3_0_0 {
265  boolean enableHT;
266  string ssid;
267  string bssid;
270  string psk;
271  boolean clearPsk;
273  };
274 
276  enumeration WlanChannelWidth {
277  CHANNEL_WIDTH_UNKNOWN,
278  CHANNEL_WIDTH_20_NO_HT,
279  CHANNEL_WIDTH_20,
280  CHANNEL_WIDTH_40,
281  CHANNEL_WIDTH_80,
282  CHANNEL_WIDTH_80P80,
283  CHANNEL_WIDTH_160
284  };
285 
287  structure WlanInfo {
288  boolean associated;
289  string ssid;
290  string bssid;
291  int channel;
293  };
294 
296  structure Settings_3_0_0 {
298  map<string, InterfaceSettings_2_0_0> ifMap;
299  map<string, EthSettings_2_0_0> ethMap;
300  map<string, WlanSettings_3_0_0> wlanMap;
301  };
302 
304  structure Info_1_0_1 {
306  map<string, InterfaceInfo> ifMap;
307  map<string, EthInfo_1_0_1> ethMap;
308  map<string, WlanInfo> wlanMap;
309  };
310 
314  string appProtoName;
316  };
317 
318  /* ---- event definitions ---- */
319 
321  valueobject CommonInfoChangedEvent extends idl.Event {
322  CommonInfo commonInfo;
323  };
324 
326  valueobject InterfaceInfoChangedEvent extends idl.Event {
327  InterfaceInfo ifInfo;
328  };
329 
331  valueobject EthInfoChangedEvent_1_0_1 extends idl.Event {
332  string ifName;
333  string ifLabel;
335  };
336 
338  valueobject WlanInfoChangedEvent extends idl.Event {
339  string ifName;
341  };
342 
344  valueobject LinkStateChangedEvent extends idl.Event {
345  string ifName;
346  string ifLabel;
349  };
350 
352  valueobject PortForwardingSlavePresenceStateChangedEvent extends idl.Event {
353  boolean slavePresent;
354  };
355 
357  interface Net_5_0_0 {
358 
360  constant int SUCCESS = 0;
361 
363  constant int ERR_DNS_TOO_MANY_SERVERS = 100;
364  constant int ERR_DNS_INVALID_SERVER = 101;
365  constant int ERR_DNS_TOO_MANY_SEARCH_SUFFIXES = 102;
366  constant int ERR_DNS_INVALID_SEARCH_SUFFIX = 103;
367 
369  constant int ERR_ROUTING_IPV4_INVALID_DFLT_GATEWAY_ADDR = 200;
370  constant int ERR_ROUTING_IPV6_INVALID_DFLT_GATEWAY_ADDR = 201;
371  constant int ERR_ROUTING_IPV4_INVALID_DEST_ADDR = 202;
372  constant int ERR_ROUTING_IPV6_INVALID_DEST_ADDR = 203;
373  constant int ERR_ROUTING_IPV4_INVALID_DEST_PREFIX_LEN = 204;
374  constant int ERR_ROUTING_IPV6_INVALID_DEST_PREFIX_LEN = 205;
375  constant int ERR_ROUTING_IPV4_INVALID_NEXTHOP_ADDR = 206;
376  constant int ERR_ROUTING_IPV6_INVALID_NEXTHOP_ADDR = 207;
377  constant int ERR_ROUTING_IPV4_INVALID_INTERFACE = 208;
378  constant int ERR_ROUTING_IPV6_INVALID_INTERFACE = 209;
379  constant int ERR_ROUTING_IPV4_DEST_IS_NO_NETWORK_ADDR = 210;
380  constant int ERR_ROUTING_IPV6_DEST_IS_NO_NETWORK_ADDR = 211;
381  constant int ERR_ROUTING_IPV4_DEST_IS_DUPLICATE = 212;
382  constant int ERR_ROUTING_IPV6_DEST_IS_DUPLICATE = 213;
383  constant int ERR_ROUTING_IPV4_NO_NEXTHOP_OR_INTERFACE = 214;
384  constant int ERR_ROUTING_IPV6_NO_NEXTHOP_OR_INTERFACE = 215;
385  constant int ERR_ROUTING_IPV4_NEXTHOP_AND_INTERFACE_SET = 216;
386  constant int ERR_ROUTING_IPV6_NEXTHOP_AND_INTERFACE_SET = 217;
387 
389  constant int ERR_PF_INVALID_MASTER_DOWNSTREAM_INTERFACE = 300;
390  constant int ERR_PF_NO_WORKING_MASTER_UPSTREAM_INTERFACE= 301;
391 
393  constant int ERR_IF_IPV4_INVALID_CONFIG_METHOD = 400;
394  constant int ERR_IF_IPV6_INVALID_CONFIG_METHOD = 401;
395  constant int ERR_IF_IPV4_INVALID_STATIC_ADDR = 402;
396  constant int ERR_IF_IPV6_INVALID_STATIC_ADDR = 403;
397  constant int ERR_IF_IPV4_INVALID_STATIC_PREFIX_LEN = 404;
398  constant int ERR_IF_IPV6_INVALID_STATIC_PREFIX_LEN = 405;
399  constant int ERR_IF_IPV4_INVALID_DHCP_PREF_HOSTNAME = 406;
400  constant int ERR_IF_IPV6_INVALID_DHCP_PREF_HOSTNAME = 407;
401  constant int ERR_IF_EAP_INVALID_IDENTITY = 408;
402  constant int ERR_IF_EAP_INVALID_PASSWORD = 409;
403  constant int ERR_IF_EAP_INVALID_CLIENT_CERT = 410;
404  constant int ERR_IF_EAP_INVALID_CLIENT_PRIV_KEY_OR_PWD = 411;
405  constant int ERR_IF_EAP_CLIENT_CERT_PRIV_KEY_MISMATCH = 412;
406  constant int ERR_IF_EAP_INVALID_CA_CERT = 413;
407  constant int ERR_IF_EAP_CA_CERT_VERIFY_FAILED = 414;
408  constant int ERR_IF_EAP_INVALID_AUTH_SERVER_NAME = 415;
409 
411  constant int ERR_ETH_IF_UNSUPPORTED_LINKMODE = 500;
412 
414  constant int ERR_WLAN_IF_INVALID_SSID = 600;
415  constant int ERR_WLAN_IF_INVALID_BSSID = 601;
416  constant int ERR_WLAN_IF_INVALID_PSK = 602;
417 
423  Info_1_0_1 getInfo();
424 
430  Settings_3_0_0 getSettings();
431 
440  int setSettings(in Settings_3_0_0 settings);
441 
447  vector<PortForwardingProtocolMapping> getPortForwardingProtocolMappings();
448 
449  };
450 
451 }
PortForwardingInfo portForwarding
Port forwarding info.
Definition: Net.idl:95
InterfaceOpState ifState
Current operational interface state.
Definition: Net.idl:348
WlanAuthType_2_0_0 authType
Authentication type.
Definition: Net.idl:269
EAP authentication failed.
Definition: Net.idl:184
CommonSettings_2_0_0 common
Common network settings.
Definition: Net.idl:297
boolean resolverPrefersIPv6
Resolver should prefer IPv6 addresses.
Definition: Net.idl:82
vector< string > searchSuffixes
List of domain search suffixes.
Definition: Net.idl:37
string clientPrivKey
client private key (always empty on retrieval!)
Definition: Net.idl:194
PortForwardingRole role
The role of the node (master or slave)
Definition: Net.idl:30
Interface is up and running.
Definition: Net.idl:152
Use auto-negotiation to set speed.
Definition: Net.idl:209
Half duplex.
Definition: Net.idl:218
MSCHAPv2 authentication.
Definition: Net.idl:176
Ethernet interface.
Definition: Net.idl:142
boolean clearPsk
Set to true when PSK should be cleared.
Definition: Net.idl:271
No authentication.
Definition: Net.idl:224
Interface specific IP settings.
Definition: Net.idl:106
string password
EAP password (always empty on retrieval!)
Definition: Net.idl:191
EapOuterAuthMethod_2_0_0 outerMethod
Outer authentication method.
Definition: Net.idl:197
vector< IpAddrCidr > addrsCidr
List of active IPv4 addresses with prefix length.
Definition: Net.idl:117
string identity
EAP identity.
Definition: Net.idl:190
Ethernet interface settings.
Definition: Net.idl:235
Network info.
Definition: Net.idl:304
string bssid
BSSID of associated access point.
Definition: Net.idl:290
WlanInfo wlanInfo
Current WLAN interface specific info.
Definition: Net.idl:340
boolean forceTrustedCert
Enforce trusted certificates.
Definition: Net.idl:200
string ifName
interface name on master
Definition: Net.idl:62
string transportProtoName
Transport protocol name.
Definition: Net.idl:315
string psk
Pre-shared key (always empty on retrieval!)
Definition: Net.idl:270
Interface specific settings.
Definition: Net.idl:134
IpAddrCidr staticAddrCidr
Statically assigned IPv4/IPv6 address (CIDR)
Definition: Net.idl:109
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:125
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:108
string caCertChain
CA certificate chain.
Definition: Net.idl:199
EAP authentication succeeded.
Definition: Net.idl:185
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:128
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:110
Use auto-negotiation to set duplex mode.
Definition: Net.idl:217
Port forwarding info.
Definition: Net.idl:67
EthDuplexMode duplexMode
Interface duplex mode.
Definition: Net.idl:231
Ethernet link mode.
Definition: Net.idl:229
InterfaceIpSettings_2_0_0 ipv4
Interface specific IPv4 settings.
Definition: Net.idl:136
map< string, WlanInfo > wlanMap
WLAN specific interface info.
Definition: Net.idl:308
IPv4/IPv6 route.
Definition: Net.idl:15
Network settings.
Definition: Net.idl:296
Full duplex.
Definition: Net.idl:219
string macAddr
MAC address of the interface.
Definition: Net.idl:163
string ssid
SSID of the wireless network.
Definition: Net.idl:289
EthLinkMode linkMode
Current link mode.
Definition: Net.idl:244
DNS info.
Definition: Net.idl:79
int nodeIndex
Index of the node in the port forwarding cascade.
Definition: Net.idl:70
IpConfigMethod configMethod
Interface configuration method.
Definition: Net.idl:116
int appProtoId
Application protocol id.
Definition: Net.idl:313
Routing settings.
Definition: Net.idl:48
boolean resolverPrefersIPv6
Resolver should prefer IPv6 addresses.
Definition: Net.idl:38
EapAuthSettings_3_0_0 eap
EAP Settings for 802::1x authentication.
Definition: Net.idl:238
Interface specific IPv6 info.
Definition: Net.idl:123
TLS authentication.
Definition: Net.idl:171
802::1x (EAP) authentication
Definition: Net.idl:260
boolean allowOffTimeRangeCerts
allow expired and not yet valid TLS certs
Definition: Net.idl:201
string bssid
BSSID (empty for automatic AP selection)
Definition: Net.idl:267
1000 MBit/s (1 GBit/s)
Definition: Net.idl:212
DnsInfo dns
DNS info.
Definition: Net.idl:93
WLAN interface.
Definition: Net.idl:143
InterfaceType
The interface type.
Definition: Net.idl:141
Bride interface.
Definition: Net.idl:144
boolean linkDetected
true if a link is detected
Definition: Net.idl:247
string dhcpServerId
DHCPv6 server id or empty.
Definition: Net.idl:127
string appProtoName
Application protocol name.
Definition: Net.idl:314
boolean associated
true if assoiated to an access point
Definition: Net.idl:288
DnsSettings_2_0_0 dns
DNS settings.
Definition: Net.idl:55
InterfaceType type
Interface type.
Definition: Net.idl:159
boolean nodeIndexValid
true if nodeIndex is valid
Definition: Net.idl:69
IpRoutingSettings_2_0_0 ipv6
IPv6 routing settings.
Definition: Net.idl:50
WlanSecProtocol
WLAN security protocol.
Definition: Net.idl:252
boolean enabled
The dynamic enabled state.
Definition: Net.idl:160
EAP authentication pending.
Definition: Net.idl:183
string clientCertChain
client certificate chain
Definition: Net.idl:193
map< string, InterfaceInfo > ifMap
Common interface info.
Definition: Net.idl:306
No automatic configuration.
Definition: Net.idl:100
WlanChannelWidth
WLAN channel width.
Definition: Net.idl:276
IP protocol specific routing settings.
Definition: Net.idl:42
RoutingInfo routing
Routing info.
Definition: Net.idl:94
boolean slaveConnected
true if this node has a slave connected
Definition: Net.idl:71
vector< string > serverAddrs
List of domain name servers addresses (IPv4/IPv6)
Definition: Net.idl:36
EAP authentication settings.
Definition: Net.idl:189
Basic IDL definitions.
Definition: Event.idl:6
boolean raOtherConf
"OtherConf" flag set in router announcements
Definition: Net.idl:130
Interface is not present.
Definition: Net.idl:149
int channel
Channel number.
Definition: Net.idl:291
EapAuthSettings_3_0_0 eap
EAP Settings for 802::1x authentication.
Definition: Net.idl:272
map< string, EthInfo_1_0_1 > ethMap
Ethernet specific interface info.
Definition: Net.idl:307
string dhcpPreferredHostname
Preferred hostname (only used with DHCP)
Definition: Net.idl:119
string defaultGatewayAddr
Default gateway address.
Definition: Net.idl:43
Interface specific IPv4 info.
Definition: Net.idl:114
boolean raManaged
"Managed" flag set in router announcements
Definition: Net.idl:129
Network Configuration.
Definition: Diagnostics.idl:4
EthLinkMode linkMode
Link mode.
Definition: Net.idl:236
Routing info.
Definition: Net.idl:86
802::1x (EAP) authentication
Definition: Net.idl:225
IpRoutingSettings_2_0_0 ipv4
IPv4 routing settings.
Definition: Net.idl:49
EapStatus eapStatus
status of EAP authentication
Definition: Net.idl:243
Port forwarding settings.
Definition: Net.idl:28
WLAN interface settings.
Definition: Net.idl:264
EAP authentication disabled.
Definition: Net.idl:182
InterfaceIpSettings_2_0_0 ipv6
Interface specific IPv6 settings.
Definition: Net.idl:137
EthSpeed
Ethernet speed.
Definition: Net.idl:208
boolean enabled
true if port forwarding is enabled
Definition: Net.idl:68
WLAN interface info.
Definition: Net.idl:287
vector< IpRoute > ipv4Routes
List of active IPv4 routes.
Definition: Net.idl:87
boolean enableHT
Enable high throughput features (802::11n)
Definition: Net.idl:265
boolean autonegEnabled
true if auto-negotiation is enabled
Definition: Net.idl:246
EapStatus
EAP authentication status.
Definition: Net.idl:181
Node is the port forwarding master.
Definition: Net.idl:23
string dhcpServerAddr
IPv4 address of DHCP server or empty.
Definition: Net.idl:118
WlanAuthType_2_0_0
WLAN authentication type.
Definition: Net.idl:257
EthInfo_1_0_1 ethInfo
Current ethernet interface specific info.
Definition: Net.idl:334
string ssid
SSID of the wireless network.
Definition: Net.idl:266
10 MBit/s
Definition: Net.idl:210
No authentication.
Definition: Net.idl:258
EthSpeed speed
Interface speed.
Definition: Net.idl:230
vector< EthLinkMode > supportedLinkModes
Supported link modes.
Definition: Net.idl:248
PortForwardingRole
Role of the node when port forwarding is enabled.
Definition: Net.idl:22
CommonInfo common
Common network info.
Definition: Net.idl:305
Use DHCP for automatic configuration (IPv4 only)
Definition: Net.idl:101
string masterDownstreamIfName
Master downstream interface (usb: any USB iface)
Definition: Net.idl:72
Interface has no link.
Definition: Net.idl:151
InterfaceType ifType
interface type
Definition: Net.idl:347
PEAP authentication.
Definition: Net.idl:170
EapInnerAuthMethod_2_0_0
EAP inner authentication method.
Definition: Net.idl:175
EthAuthType
Ethernet authentication type.
Definition: Net.idl:223
string masterIfName
Master interface (set for bridged interfaces)
Definition: Net.idl:161
map< string, WlanSettings_3_0_0 > wlanMap
WLAN specific interface settings.
Definition: Net.idl:300
vector< string > searchSuffixes
List of active domain search suffixes.
Definition: Net.idl:81
Node is a port forwarding slave.
Definition: Net.idl:24
Pre-shared key authentication.
Definition: Net.idl:259
InterfaceOpState state
Operational state of the interface.
Definition: Net.idl:162
vector< IpAddrCidr > addrsCidr
List of active IPv6 addresses with prefix length.
Definition: Net.idl:126
boolean enabled
Controls if port forwarding is enabled.
Definition: Net.idl:29
WlanChannelWidth channelWidth
Channel width (this is an id and no frequency!)
Definition: Net.idl:292
Common settings.
Definition: Net.idl:54
string label
Interface label (used in user interfaces)
Definition: Net.idl:158
EthAuthType authType
Authentication type.
Definition: Net.idl:237
string name
Internal interface name.
Definition: Net.idl:157
Mapping from application protocol id to name and transport protocol.
Definition: Net.idl:312
boolean clearClientPrivKey
Set to true to clear the client private key.
Definition: Net.idl:195
boolean enabled
Controls if interface is enabled.
Definition: Net.idl:135
EthDuplexMode
Ethernet duplex mode.
Definition: Net.idl:216
WlanSecProtocol secProtocol
Security protocol (WPA2)
Definition: Net.idl:268
EapInnerAuthMethod_2_0_0 innerMethod
Inner authentication method.
Definition: Net.idl:198
valueobject CommonInfoChangedEvent
Event that is send when common network info has changed.
Definition: Net.idl:322
Network configuration interface.
Definition: Net.idl:357
boolean enabled
true if IPv6 is enabled
Definition: Net.idl:124
boolean clearPassword
Set to true when password should be cleared.
Definition: Net.idl:192
InterfaceIPv4Info ipv4
Interface specific IPv4 info.
Definition: Net.idl:164
Common info.
Definition: Net.idl:92
Interface specific info.
Definition: Net.idl:156
IPv4/IPv6 address and prefix len.
Definition: Net.idl:9
Port forwarding master address info for an interface.
Definition: Net.idl:61
vector< string > serverAddrs
List of active domain name server addresses.
Definition: Net.idl:80
EapOuterAuthMethod_2_0_0
EAP outer authentication method.
Definition: Net.idl:169
map< string, InterfaceSettings_2_0_0 > ifMap
Common interface settings.
Definition: Net.idl:298
boolean enabled
true if IPv4 is enabled
Definition: Net.idl:115
InterfaceOpState
Interface operational state.
Definition: Net.idl:148
vector< IpRoute > staticRoutes
List of static routes.
Definition: Net.idl:44
string clientPrivKeyPassword
password of client private key
Definition: Net.idl:196
Use automatic configuration (IPv6 only)
Definition: Net.idl:102
TLS authentication.
Definition: Net.idl:177
InterfaceIPv6Info ipv6
Interface specific IPv6 info.
Definition: Net.idl:165
RoutingSettings_2_0_0 routing
Routing settings.
Definition: Net.idl:56
string addr
IPv4/IPv6 address on the interface.
Definition: Net.idl:63
vector< PortForwardingMasterAddrInfo > masterIPv6AddrInfos
Master address info for IPv6.
Definition: Net.idl:75
Interface is down.
Definition: Net.idl:150
IpConfigMethod
IP configuration method.
Definition: Net.idl:99
DNS settings.
Definition: Net.idl:35
map< string, EthSettings_2_0_0 > ethMap
Ethernet specific interface settings.
Definition: Net.idl:299
vector< IpRoute > ipv6Routes
List of active IPv6 routes.
Definition: Net.idl:88
boolean enabled
Controls if IPv4/IPv6 is enabled.
Definition: Net.idl:107
boolean linkModeValid
true if linkMode is valid
Definition: Net.idl:245
Ethernet interface info.
Definition: Net.idl:242
string masterDownstreamIfName
Master downstream interface (usb: any USB iface)
Definition: Net.idl:31
boolean allowNotYetValidCertsIfTimeBeforeBuild
allow not yet valid TLS certs if
Definition: Net.idl:202
WPA2 security protocol.
Definition: Net.idl:253
string ifLabel
interface label
Definition: Net.idl:333
PortForwardingSettings_2_0_0 portForwarding
Port forwarding settings.
Definition: Net.idl:57
100 MBit/s
Definition: Net.idl:211