'require uci';
'require rpc';
'require validation';
+'require baseclass';
+'require firewall';
var proto_errors = {
CONNECT_FAILED: _('Connection attempt failed'),
- INVALID_ADDRESS: _('IP address in invalid'),
+ INVALID_ADDRESS: _('IP address is invalid'),
INVALID_GATEWAY: _('Gateway address is invalid'),
INVALID_LOCAL_ADDRESS: _('Local IP address is invalid'),
MISSING_ADDRESS: _('IP address is missing'),
var iface_patterns_virtual = [ ];
-var callLuciNetdevs = rpc.declare({
- object: 'luci',
+var callLuciNetworkDevices = rpc.declare({
+ object: 'luci-rpc',
method: 'getNetworkDevices',
expect: { '': {} }
});
-var callLuciWifidevs = rpc.declare({
- object: 'luci',
+var callLuciWirelessDevices = rpc.declare({
+ object: 'luci-rpc',
method: 'getWirelessDevices',
expect: { '': {} }
});
-var callLuciIfaddrs = rpc.declare({
- object: 'luci',
- method: 'getIfaddrs',
- expect: { result: [] }
+var callLuciBoardJSON = rpc.declare({
+ object: 'luci-rpc',
+ method: 'getBoardJSON'
});
-var callLuciBoardjson = rpc.declare({
- object: 'luci',
- method: 'getBoardJSON'
+var callLuciHostHints = rpc.declare({
+ object: 'luci-rpc',
+ method: 'getHostHints',
+ expect: { '': {} }
});
var callIwinfoAssoclist = rpc.declare({
expect: { results: [] }
});
-var callNetworkInterfaceStatus = rpc.declare({
+var callNetworkInterfaceDump = rpc.declare({
object: 'network.interface',
method: 'dump',
expect: { 'interface': [] }
});
-var callNetworkDeviceStatus = rpc.declare({
- object: 'network.device',
- method: 'status',
- expect: { '': {} }
-});
-
-var callGetProtoHandlers = rpc.declare({
+var callNetworkProtoHandlers = rpc.declare({
object: 'network',
method: 'get_proto_handlers',
expect: { '': {} }
});
-var callGetHostHints = rpc.declare({
- object: 'luci',
- method: 'getHostHints',
- expect: { '': {} }
-});
-
var _init = null,
_state = null,
_protocols = {},
_protospecs = {};
-function getInterfaceState(cache) {
- return callNetworkInterfaceStatus().then(function(state) {
- if (!Array.isArray(state))
- throw !1;
- return state;
- }).catch(function() {
- return [];
- });
-}
-
-function getDeviceState(cache) {
- return callNetworkDeviceStatus().then(function(state) {
- if (!L.isObject(state))
- throw !1;
- return state;
- }).catch(function() {
- return {};
- });
-}
-
-function getIfaddrState(cache) {
- return callLuciIfaddrs().then(function(addrs) {
- if (!Array.isArray(addrs))
- throw !1;
- return addrs;
- }).catch(function() {
- return [];
- });
-}
-
-function getNetdevState(cache) {
- return callLuciNetdevs().then(function(state) {
- if (!L.isObject(state))
- throw !1;
- return state;
- }).catch(function() {
- return {};
- });
-}
-
-function getWifidevState(cache) {
- return callLuciWifidevs().then(function(state) {
- if (!L.isObject(state))
- throw !1;
- return state;
- }).catch(function() {
- return {};
- });
-}
-
-function getBoardState(cache) {
- return callLuciBoardjson().then(function(state) {
- if (!L.isObject(state))
- throw !1;
- return state;
- }).catch(function() {
- return {};
- });
-}
-
function getProtocolHandlers(cache) {
- return callGetProtoHandlers().then(function(protos) {
- if (!L.isObject(protos))
- throw !1;
-
+ return callNetworkProtoHandlers().then(function(protos) {
/* Register "none" protocol */
if (!protos.hasOwnProperty('none'))
Object.assign(protos, { none: { no_device: false } });
/* Hack: emulate relayd protocol */
- if (!protos.hasOwnProperty('relay'))
+ if (!protos.hasOwnProperty('relay') && L.hasSystemFeature('relayd'))
Object.assign(protos, { relay: { no_device: true } });
Object.assign(_protospecs, protos);
});
}
-function getHostHints(cache) {
- return callGetHostHints().then(function(hosts) {
- if (!L.isObject(hosts))
- throw !1;
- return hosts;
- }).catch(function() {
- return {};
- });
-}
-
function getWifiStateBySid(sid) {
var s = uci.get('wireless', sid);
function initNetworkState(refresh) {
if (_state == null || refresh) {
_init = _init || Promise.all([
- getInterfaceState(), getDeviceState(), getBoardState(),
- getIfaddrState(), getNetdevState(), getWifidevState(),
- getHostHints(), getProtocolHandlers(),
- uci.load('network'), uci.load('wireless'), uci.load('luci')
+ L.resolveDefault(callNetworkInterfaceDump(), []),
+ L.resolveDefault(callLuciBoardJSON(), {}),
+ L.resolveDefault(callLuciNetworkDevices(), {}),
+ L.resolveDefault(callLuciWirelessDevices(), {}),
+ L.resolveDefault(callLuciHostHints(), {}),
+ getProtocolHandlers(),
+ L.resolveDefault(uci.load('network')),
+ L.resolveDefault(uci.load('wireless')),
+ L.resolveDefault(uci.load('luci'))
]).then(function(data) {
- var board = data[2], ifaddrs = data[3], devices = data[4];
+ var netifd_ifaces = data[0],
+ board_json = data[1],
+ luci_devs = data[2];
+
var s = {
isTunnel: {}, isBridge: {}, isSwitch: {}, isWifi: {},
- ifaces: data[0], devices: data[1], radios: data[5],
- hosts: data[6], netdevs: {}, bridges: {}, switches: {}
+ ifaces: netifd_ifaces, radios: data[3], hosts: data[4],
+ netdevs: {}, bridges: {}, switches: {}, hostapd: {}
};
- for (var i = 0, a; (a = ifaddrs[i]) != null; i++) {
- var name = a.name.replace(/:.+$/, '');
+ for (var name in luci_devs) {
+ var dev = luci_devs[name];
if (isVirtualIfname(name))
s.isTunnel[name] = true;
- if (s.isTunnel[name] || !(isIgnoredIfname(name) || isVirtualIfname(name))) {
- s.netdevs[name] = s.netdevs[name] || {
- idx: a.ifindex || i,
- name: name,
- rawname: a.name,
- flags: [],
- ipaddrs: [],
- ip6addrs: []
- };
-
- if (a.family == 'packet') {
- s.netdevs[name].flags = a.flags;
- s.netdevs[name].stats = a.data;
-
- if (a.addr != null && a.addr != '00:00:00:00:00:00' && a.addr.length == 17)
- s.netdevs[name].macaddr = a.addr;
- }
- else if (a.family == 'inet') {
- s.netdevs[name].ipaddrs.push(a.addr + '/' + a.netmask);
- }
- else if (a.family == 'inet6') {
- s.netdevs[name].ip6addrs.push(a.addr + '/' + a.netmask);
- }
- }
+ if (!s.isTunnel[name] && isIgnoredIfname(name))
+ continue;
+
+ s.netdevs[name] = s.netdevs[name] || {
+ idx: dev.ifindex,
+ name: name,
+ rawname: name,
+ flags: dev.flags,
+ stats: dev.stats,
+ macaddr: dev.mac,
+ type: dev.type,
+ mtu: dev.mtu,
+ qlen: dev.qlen,
+ wireless: dev.wireless,
+ ipaddrs: [],
+ ip6addrs: []
+ };
+
+ if (Array.isArray(dev.ipaddrs))
+ for (var i = 0; i < dev.ipaddrs.length; i++)
+ s.netdevs[name].ipaddrs.push(dev.ipaddrs[i].address + '/' + dev.ipaddrs[i].netmask);
+
+ if (Array.isArray(dev.ip6addrs))
+ for (var i = 0; i < dev.ip6addrs.length; i++)
+ s.netdevs[name].ip6addrs.push(dev.ip6addrs[i].address + '/' + dev.ip6addrs[i].netmask);
}
- for (var devname in devices) {
- var dev = devices[devname];
+ for (var name in luci_devs) {
+ var dev = luci_devs[name];
- if (dev.bridge) {
- var b = {
- name: devname,
- id: dev.id,
- stp: dev.stp,
- ifnames: []
- };
+ if (!dev.bridge)
+ continue;
- for (var i = 0; dev.ports && i < dev.ports.length; i++) {
- var subdev = s.netdevs[dev.ports[i]];
+ var b = {
+ name: name,
+ id: dev.id,
+ stp: dev.stp,
+ ifnames: []
+ };
- if (subdev == null)
- continue;
+ for (var i = 0; dev.ports && i < dev.ports.length; i++) {
+ var subdev = s.netdevs[dev.ports[i]];
- b.ifnames.push(subdev);
- subdev.bridge = b;
- }
+ if (subdev == null)
+ continue;
- s.bridges[devname] = b;
- s.isBridge[devname] = true;
+ b.ifnames.push(subdev);
+ subdev.bridge = b;
}
- if (s.netdevs.hasOwnProperty(devname)) {
- Object.assign(s.netdevs[devname], {
- macaddr: dev.mac,
- type: dev.type,
- mtu: dev.mtu,
- qlen: dev.qlen
- });
- }
+ s.bridges[name] = b;
+ s.isBridge[name] = true;
}
- if (L.isObject(board.switch)) {
- for (var switchname in board.switch) {
- var layout = board.switch[switchname],
+ if (L.isObject(board_json.switch)) {
+ for (var switchname in board_json.switch) {
+ var layout = board_json.switch[switchname],
netdevs = {},
nports = {},
ports = [],
}
}
- if (L.isObject(board.dsl) && L.isObject(board.dsl.modem)) {
- s.hasDSLModem = board.dsl.modem;
+ if (L.isObject(board_json.dsl) && L.isObject(board_json.dsl.modem)) {
+ s.hasDSLModem = board_json.dsl.modem;
}
_init = null;
- return (_state = s);
+ var objects = [];
+
+ if (L.isObject(s.radios))
+ for (var radio in s.radios)
+ if (L.isObject(s.radios[radio]) && Array.isArray(s.radios[radio].interfaces))
+ for (var i = 0; i < s.radios[radio].interfaces.length; i++)
+ if (L.isObject(s.radios[radio].interfaces[i]) && s.radios[radio].interfaces[i].ifname)
+ objects.push('hostapd.%s'.format(s.radios[radio].interfaces[i].ifname));
+
+ return (objects.length ? L.resolveDefault(rpc.list.apply(rpc, objects), {}) : Promise.resolve({})).then(function(res) {
+ for (var k in res) {
+ var m = k.match(/^hostapd\.(.+)$/);
+ if (m)
+ s.hostapd[m[1]] = res[k];
+ }
+
+ return (_state = s);
+ });
});
}
var Hosts, Network, Protocol, Device, WifiDevice, WifiNetwork;
-Network = L.Class.extend({
+/**
+ * @class network
+ * @memberof LuCI
+ * @hideconstructor
+ * @classdesc
+ *
+ * The `LuCI.network` class combines data from multiple `ubus` apis to
+ * provide an abstraction of the current network configuration state.
+ *
+ * It provides methods to enumerate interfaces and devices, to query
+ * current configuration details and to manipulate settings.
+ */
+Network = baseclass.extend(/** @lends LuCI.network.prototype */ {
+ /**
+ * Converts the given prefix size in bits to a netmask.
+ *
+ * @method
+ *
+ * @param {number} bits
+ * The prefix size in bits.
+ *
+ * @param {boolean} [v6=false]
+ * Whether to convert the bits value into an IPv4 netmask (`false`) or
+ * an IPv6 netmask (`true`).
+ *
+ * @returns {null|string}
+ * Returns a string containing the netmask corresponding to the bit count
+ * or `null` when the given amount of bits exceeds the maximum possible
+ * value of `32` for IPv4 or `128` for IPv6.
+ */
prefixToMask: prefixToMask,
+
+ /**
+ * Converts the given netmask to a prefix size in bits.
+ *
+ * @method
+ *
+ * @param {string} netmask
+ * The netmask to convert into a bit count.
+ *
+ * @param {boolean} [v6=false]
+ * Whether to parse the given netmask as IPv4 (`false`) or IPv6 (`true`)
+ * address.
+ *
+ * @returns {null|number}
+ * Returns the number of prefix bits contained in the netmask or `null`
+ * if the given netmask value was invalid.
+ */
maskToPrefix: maskToPrefix,
+
+ /**
+ * An encryption entry describes active wireless encryption settings
+ * such as the used key management protocols, active ciphers and
+ * protocol versions.
+ *
+ * @typedef {Object<string, boolean|Array<number|string>>} LuCI.network.WifiEncryption
+ * @memberof LuCI.network
+ *
+ * @property {boolean} enabled
+ * Specifies whether any kind of encryption, such as `WEP` or `WPA` is
+ * enabled. If set to `false`, then no encryption is active and the
+ * corresponding network is open.
+ *
+ * @property {string[]} [wep]
+ * When the `wep` property exists, the network uses WEP encryption.
+ * In this case, the property is set to an array of active WEP modes
+ * which might be either `open`, `shared` or both.
+ *
+ * @property {number[]} [wpa]
+ * When the `wpa` property exists, the network uses WPA security.
+ * In this case, the property is set to an array containing the WPA
+ * protocol versions used, e.g. `[ 1, 2 ]` for WPA/WPA2 mixed mode or
+ * `[ 3 ]` for WPA3-SAE.
+ *
+ * @property {string[]} [authentication]
+ * The `authentication` property only applies to WPA encryption and
+ * is defined when the `wpa` property is set as well. It points to
+ * an array of active authentication suites used by the network, e.g.
+ * `[ "psk" ]` for a WPA(2)-PSK network or `[ "psk", "sae" ]` for
+ * mixed WPA2-PSK/WPA3-SAE encryption.
+ *
+ * @property {string[]} [ciphers]
+ * If either WEP or WPA encryption is active, then the `ciphers`
+ * property will be set to an array describing the active encryption
+ * ciphers used by the network, e.g. `[ "tkip", "ccmp" ]` for a
+ * WPA/WPA2-PSK mixed network or `[ "wep-40", "wep-104" ]` for an
+ * WEP network.
+ */
+
+ /**
+ * Converts a given {@link LuCI.network.WifiEncryption encryption entry}
+ * into a human readable string such as `mixed WPA/WPA2 PSK (TKIP, CCMP)`
+ * or `WPA3 SAE (CCMP)`.
+ *
+ * @method
+ *
+ * @param {LuCI.network.WifiEncryption} encryption
+ * The wireless encryption entry to convert.
+ *
+ * @returns {null|string}
+ * Returns the description string for the given encryption entry or
+ * `null` if the given entry was invalid.
+ */
formatWifiEncryption: formatWifiEncryption,
+ /**
+ * Flushes the local network state cache and fetches updated information
+ * from the remote `ubus` apis.
+ *
+ * @returns {Promise<Object>}
+ * Returns a promise resolving to the internal network state object.
+ */
flushCache: function() {
initNetworkState(true);
return _init;
},
+ /**
+ * Instantiates the given {@link LuCI.network.Protocol Protocol} backend,
+ * optionally using the given network name.
+ *
+ * @param {string} protoname
+ * The protocol backend to use, e.g. `static` or `dhcp`.
+ *
+ * @param {string} [netname=__dummy__]
+ * The network name to use for the instantiated protocol. This should be
+ * usually set to one of the interfaces described in /etc/config/network
+ * but it is allowed to omit it, e.g. to query protocol capabilities
+ * without the need for an existing interface.
+ *
+ * @returns {null|LuCI.network.Protocol}
+ * Returns the instantiated protocol backend class or `null` if the given
+ * protocol isn't known.
+ */
getProtocol: function(protoname, netname) {
var v = _protocols[protoname];
if (v != null)
return null;
},
+ /**
+ * Obtains instances of all known {@link LuCI.network.Protocol Protocol}
+ * backend classes.
+ *
+ * @returns {Array<LuCI.network.Protocol>}
+ * Returns an array of protocol class instances.
+ */
getProtocols: function() {
var rv = [];
return rv;
},
+ /**
+ * Registers a new {@link LuCI.network.Protocol Protocol} subclass
+ * with the given methods and returns the resulting subclass value.
+ *
+ * This functions internally calls
+ * {@link LuCI.Class.extend Class.extend()} on the `Network.Protocol`
+ * base class.
+ *
+ * @param {string} protoname
+ * The name of the new protocol to register.
+ *
+ * @param {Object<string, *>} methods
+ * The member methods and values of the new `Protocol` subclass to
+ * be passed to {@link LuCI.Class.extend Class.extend()}.
+ *
+ * @returns {LuCI.network.Protocol}
+ * Returns the new `Protocol` subclass.
+ */
registerProtocol: function(protoname, methods) {
var spec = L.isObject(_protospecs) ? _protospecs[protoname] : null;
var proto = Protocol.extend(Object.assign({
return proto;
},
+ /**
+ * Registers a new regular expression pattern to recognize
+ * virtual interfaces.
+ *
+ * @param {RegExp} pat
+ * A `RegExp` instance to match a virtual interface name
+ * such as `6in4-wan` or `tun0`.
+ */
registerPatternVirtual: function(pat) {
iface_patterns_virtual.push(pat);
},
+ /**
+ * Registers a new human readable translation string for a `Protocol`
+ * error code.
+ *
+ * @param {string} code
+ * The `ubus` protocol error code to register a translation for, e.g.
+ * `NO_DEVICE`.
+ *
+ * @param {string} message
+ * The message to use as translation for the given protocol error code.
+ *
+ * @returns {boolean}
+ * Returns `true` if the error code description has been added or `false`
+ * if either the arguments were invalid or if there already was a
+ * description for the given code.
+ */
registerErrorCode: function(code, message) {
if (typeof(code) == 'string' &&
typeof(message) == 'string' &&
return false;
},
+ /**
+ * Adds a new network of the given name and update it with the given
+ * uci option values.
+ *
+ * If a network with the given name already exist but is empty, then
+ * this function will update its option, otherwise it will do nothing.
+ *
+ * @param {string} name
+ * The name of the network to add. Must be in the format `[a-zA-Z0-9_]+`.
+ *
+ * @param {Object<string, string|string[]>} [options]
+ * An object of uci option values to set on the new network or to
+ * update in an existing, empty network.
+ *
+ * @returns {Promise<null|LuCI.network.Protocol>}
+ * Returns a promise resolving to the `Protocol` subclass instance
+ * describing the added network or resolving to `null` if the name
+ * was invalid or if a non-empty network of the given name already
+ * existed.
+ */
addNetwork: function(name, options) {
return this.getNetwork(name).then(L.bind(function(existingNetwork) {
if (name != null && /^[a-zA-Z0-9_]+$/.test(name) && existingNetwork == null) {
}, this));
},
+ /**
+ * Get a {@link LuCI.network.Protocol Protocol} instance describing
+ * the network with the given name.
+ *
+ * @param {string} name
+ * The logical interface name of the network get, e.g. `lan` or `wan`.
+ *
+ * @returns {Promise<null|LuCI.network.Protocol>}
+ * Returns a promise resolving to a
+ * {@link LuCI.network.Protocol Protocol} subclass instance describing
+ * the network or `null` if the network did not exist.
+ */
getNetwork: function(name) {
return initNetworkState().then(L.bind(function() {
var section = (name != null) ? uci.get('network', name) : null;
}, this));
},
+ /**
+ * Gets an array containing all known networks.
+ *
+ * @returns {Promise<Array<LuCI.network.Protocol>>}
+ * Returns a promise resolving to a name-sorted array of
+ * {@link LuCI.network.Protocol Protocol} subclass instances
+ * describing all known networks.
+ */
getNetworks: function() {
return initNetworkState().then(L.bind(enumerateNetworks, this));
},
+ /**
+ * Deletes the given network and its references from the network and
+ * firewall configuration.
+ *
+ * @param {string} name
+ * The name of the network to delete.
+ *
+ * @returns {Promise<boolean>}
+ * Returns a promise resolving to either `true` if the network and
+ * references to it were successfully deleted from the configuration or
+ * `false` if the given network could not be found.
+ */
deleteNetwork: function(name) {
- var requireFirewall = Promise.resolve(L.require('firewall')).catch(function() {});
+ var requireFirewall = Promise.resolve(L.require('firewall')).catch(function() {}),
+ network = this.instantiateNetwork(name);
- return Promise.all([ requireFirewall, initNetworkState() ]).then(function() {
- var uciInterface = uci.get('network', name);
+ return Promise.all([ requireFirewall, initNetworkState() ]).then(function(res) {
+ var uciInterface = uci.get('network', name),
+ firewall = res[0];
if (uciInterface != null && uciInterface['.type'] == 'interface') {
- uci.remove('network', name);
+ return Promise.resolve(network ? network.deleteConfiguration() : null).then(function() {
+ uci.remove('network', name);
- uci.sections('luci', 'ifstate', function(s) {
- if (s.interface == name)
- uci.remove('luci', s['.name']);
- });
+ uci.sections('luci', 'ifstate', function(s) {
+ if (s.interface == name)
+ uci.remove('luci', s['.name']);
+ });
- uci.sections('network', 'alias', function(s) {
- if (s.interface == name)
- uci.remove('network', s['.name']);
- });
+ uci.sections('network', 'alias', function(s) {
+ if (s.interface == name)
+ uci.remove('network', s['.name']);
+ });
- uci.sections('network', 'route', function(s) {
- if (s.interface == name)
- uci.remove('network', s['.name']);
- });
+ uci.sections('network', 'route', function(s) {
+ if (s.interface == name)
+ uci.remove('network', s['.name']);
+ });
- uci.sections('network', 'route6', function(s) {
- if (s.interface == name)
- uci.remove('network', s['.name']);
- });
+ uci.sections('network', 'route6', function(s) {
+ if (s.interface == name)
+ uci.remove('network', s['.name']);
+ });
- uci.sections('wireless', 'wifi-iface', function(s) {
- var networks = L.toArray(s.network).filter(function(network) { return network != name });
+ uci.sections('wireless', 'wifi-iface', function(s) {
+ var networks = L.toArray(s.network).filter(function(network) { return network != name });
- if (networks.length > 0)
- uci.set('wireless', s['.name'], 'network', networks.join(' '));
- else
- uci.unset('wireless', s['.name'], 'network');
- });
+ if (networks.length > 0)
+ uci.set('wireless', s['.name'], 'network', networks.join(' '));
+ else
+ uci.unset('wireless', s['.name'], 'network');
+ });
- if (L.firewall)
- return L.firewall.deleteNetwork(name).then(function() { return true });
+ if (firewall)
+ return firewall.deleteNetwork(name).then(function() { return true });
- return true;
+ return true;
+ }).catch(function() {
+ return false;
+ });
}
return false;
});
},
+ /**
+ * Rename the given network and its references to a new name.
+ *
+ * @param {string} oldName
+ * The current name of the network.
+ *
+ * @param {string} newName
+ * The name to rename the network to, must be in the format
+ * `[a-z-A-Z0-9_]+`.
+ *
+ * @returns {Promise<boolean>}
+ * Returns a promise resolving to either `true` if the network was
+ * successfully renamed or `false` if the new name was invalid, if
+ * a network with the new name already exists or if the network to
+ * rename could not be found.
+ */
renameNetwork: function(oldName, newName) {
return initNetworkState().then(function() {
if (newName == null || !/^[a-zA-Z0-9_]+$/.test(newName) || uci.get('network', newName) != null)
});
},
+ /**
+ * Get a {@link LuCI.network.Device Device} instance describing the
+ * given network device.
+ *
+ * @param {string} name
+ * The name of the network device to get, e.g. `eth0` or `br-lan`.
+ *
+ * @returns {Promise<null|LuCI.network.Device>}
+ * Returns a promise resolving to the `Device` instance describing
+ * the network device or `null` if the given device name could not
+ * be found.
+ */
getDevice: function(name) {
return initNetworkState().then(L.bind(function() {
if (name == null)
}, this));
},
+ /**
+ * Get a sorted list of all found network devices.
+ *
+ * @returns {Promise<Array<LuCI.network.Device>>}
+ * Returns a promise resolving to a sorted array of `Device` class
+ * instances describing the network devices found on the system.
+ */
getDevices: function() {
return initNetworkState().then(L.bind(function() {
var devices = {};
if (devices.hasOwnProperty(ifname))
continue;
- if (isIgnoredIfname(ifname) || isVirtualIfname(ifname) || isWifiIfname(ifname))
+ if (isIgnoredIfname(ifname) || isWifiIfname(ifname))
+ continue;
+
+ if (_state.netdevs[ifname].wireless)
continue;
devices[ifname] = this.instantiateDevice(ifname);
devices[netid] = this.instantiateDevice(netid);
}
+ /* find uci declared devices */
+ var uciDevices = uci.sections('network', 'device');
+
+ for (var i = 0; i < uciDevices.length; i++) {
+ var type = uciDevices[i].type,
+ name = uciDevices[i].name;
+
+ if (!type || !name || devices.hasOwnProperty(name))
+ continue;
+
+ if (type == 'bridge')
+ _state.isBridge[name] = true;
+
+ devices[name] = this.instantiateDevice(name);
+ }
+
var rv = [];
for (var netdev in devices)
}, this));
},
+ /**
+ * Test if a given network device name is in the list of patterns for
+ * device names to ignore.
+ *
+ * Ignored device names are usually Linux network devices which are
+ * spawned implicitly by kernel modules such as `tunl0` or `hwsim0`
+ * and which are unsuitable for use in network configuration.
+ *
+ * @param {string} name
+ * The device name to test.
+ *
+ * @returns {boolean}
+ * Returns `true` if the given name is in the ignore pattern list,
+ * else returns `false`.
+ */
isIgnoredDevice: function(name) {
return isIgnoredIfname(name);
},
+ /**
+ * Get a {@link LuCI.network.WifiDevice WifiDevice} instance describing
+ * the given wireless radio.
+ *
+ * @param {string} devname
+ * The configuration name of the wireless radio to lookup, e.g. `radio0`
+ * for the first mac80211 phy on the system.
+ *
+ * @returns {Promise<null|LuCI.network.WifiDevice>}
+ * Returns a promise resolving to the `WifiDevice` instance describing
+ * the underlying radio device or `null` if the wireless radio could not
+ * be found.
+ */
getWifiDevice: function(devname) {
return initNetworkState().then(L.bind(function() {
var existingDevice = uci.get('wireless', devname);
}, this));
},
+ /**
+ * Obtain a list of all configured radio devices.
+ *
+ * @returns {Promise<Array<LuCI.network.WifiDevice>>}
+ * Returns a promise resolving to an array of `WifiDevice` instances
+ * describing the wireless radios configured in the system.
+ * The order of the array corresponds to the order of the radios in
+ * the configuration.
+ */
getWifiDevices: function() {
return initNetworkState().then(L.bind(function() {
var uciWifiDevices = uci.sections('wireless', 'wifi-device'),
}, this));
},
+ /**
+ * Get a {@link LuCI.network.WifiNetwork WifiNetwork} instance describing
+ * the given wireless network.
+ *
+ * @param {string} netname
+ * The name of the wireless network to lookup. This may be either an uci
+ * configuration section ID, a network ID in the form `radio#.network#`
+ * or a Linux network device name like `wlan0` which is resolved to the
+ * corresponding configuration section through `ubus` runtime information.
+ *
+ * @returns {Promise<null|LuCI.network.WifiNetwork>}
+ * Returns a promise resolving to the `WifiNetwork` instance describing
+ * the wireless network or `null` if the corresponding network could not
+ * be found.
+ */
getWifiNetwork: function(netname) {
- var sid, res, netid, radioname, radiostate, netstate;
-
+ return initNetworkState()
+ .then(L.bind(this.lookupWifiNetwork, this, netname));
+ },
+
+ /**
+ * Get an array of all {@link LuCI.network.WifiNetwork WifiNetwork}
+ * instances describing the wireless networks present on the system.
+ *
+ * @returns {Promise<Array<LuCI.network.WifiNetwork>>}
+ * Returns a promise resolving to an array of `WifiNetwork` instances
+ * describing the wireless networks. The array will be empty if no networks
+ * are found.
+ */
+ getWifiNetworks: function() {
return initNetworkState().then(L.bind(function() {
- sid = getWifiSidByNetid(netname);
-
- if (sid != null) {
- res = getWifiStateBySid(sid);
- netid = netname;
- radioname = res ? res[0] : null;
- radiostate = res ? res[1] : null;
- netstate = res ? res[2] : null;
- }
- else {
- res = getWifiStateByIfname(netname);
-
- if (res != null) {
- radioname = res[0];
- radiostate = res[1];
- netstate = res[2];
- sid = netstate.section;
- netid = L.toArray(getWifiNetidBySid(sid))[0];
- }
- else {
- res = getWifiStateBySid(netname);
+ var wifiIfaces = uci.sections('wireless', 'wifi-iface'),
+ rv = [];
- if (res != null) {
- radioname = res[0];
- radiostate = res[1];
- netstate = res[2];
- sid = netname;
- netid = L.toArray(getWifiNetidBySid(sid))[0];
- }
- else {
- res = getWifiNetidBySid(netname);
+ for (var i = 0; i < wifiIfaces.length; i++)
+ rv.push(this.lookupWifiNetwork(wifiIfaces[i]['.name']));
- if (res != null) {
- netid = res[0];
- radioname = res[1];
- sid = netname;
- }
- }
- }
- }
+ rv.sort(function(a, b) {
+ return (a.getID() > b.getID());
+ });
- return this.instantiateWifiNetwork(sid || netname, radioname, radiostate, netid, netstate);
+ return rv;
}, this));
},
+ /**
+ * Adds a new wireless network to the configuration and sets its options
+ * to the provided values.
+ *
+ * @param {Object<string, string|string[]>} options
+ * The options to set for the newly added wireless network. This object
+ * must at least contain a `device` property which is set to the radio
+ * name the new network belongs to.
+ *
+ * @returns {Promise<null|LuCI.network.WifiNetwork>}
+ * Returns a promise resolving to a `WifiNetwork` instance describing
+ * the newly added wireless network or `null` if the given options
+ * were invalid or if the associated radio device could not be found.
+ */
addWifiNetwork: function(options) {
return initNetworkState().then(L.bind(function() {
if (options == null ||
if (existingDevice == null || existingDevice['.type'] != 'wifi-device')
return null;
+ /* XXX: need to add a named section (wifinet#) here */
var sid = uci.add('wireless', 'wifi-iface');
for (var key in options)
if (options.hasOwnProperty(key))
}, this));
},
+ /**
+ * Deletes the given wireless network from the configuration.
+ *
+ * @param {string} netname
+ * The name of the network to remove. This may be either a
+ * network ID in the form `radio#.network#` or a Linux network device
+ * name like `wlan0` which is resolved to the corresponding configuration
+ * section through `ubus` runtime information.
+ *
+ * @returns {Promise<boolean>}
+ * Returns a promise resolving to `true` if the wireless network has been
+ * successfully deleted from the configuration or `false` if it could not
+ * be found.
+ */
deleteWifiNetwork: function(netname) {
return initNetworkState().then(L.bind(function() {
var sid = getWifiSidByIfname(netname);
}, this));
},
+ /* private */
getStatusByRoute: function(addr, mask) {
return initNetworkState().then(L.bind(function() {
var rv = [];
}
}
+ rv.sort(function(a, b) {
+ if (a.metric != b.metric)
+ return (a.metric - b.metric);
+
+ if (a.interface < b.interface)
+ return -1;
+ else if (a.interface > b.interface)
+ return 1;
+
+ return 0;
+ });
+
return rv;
}, this));
},
+ /* private */
getStatusByAddress: function(addr) {
return initNetworkState().then(L.bind(function() {
var rv = [];
}, this));
},
+ /**
+ * Get IPv4 wan networks.
+ *
+ * This function looks up all networks having a default `0.0.0.0/0` route
+ * and returns them as array.
+ *
+ * @returns {Promise<Array<LuCI.network.Protocol>>}
+ * Returns a promise resolving to an array of `Protocol` subclass
+ * instances describing the found default route interfaces.
+ */
getWANNetworks: function() {
return this.getStatusByRoute('0.0.0.0', 0).then(L.bind(function(statuses) {
- var rv = [];
+ var rv = [], seen = {};
- for (var i = 0; i < statuses.length; i++)
- rv.push(this.instantiateNetwork(statuses[i].interface, statuses[i].proto));
+ for (var i = 0; i < statuses.length; i++) {
+ if (!seen.hasOwnProperty(statuses[i].interface)) {
+ rv.push(this.instantiateNetwork(statuses[i].interface, statuses[i].proto));
+ seen[statuses[i].interface] = true;
+ }
+ }
return rv;
}, this));
},
+ /**
+ * Get IPv6 wan networks.
+ *
+ * This function looks up all networks having a default `::/0` route
+ * and returns them as array.
+ *
+ * @returns {Promise<Array<LuCI.network.Protocol>>}
+ * Returns a promise resolving to an array of `Protocol` subclass
+ * instances describing the found IPv6 default route interfaces.
+ */
getWAN6Networks: function() {
return this.getStatusByRoute('::', 0).then(L.bind(function(statuses) {
- var rv = [];
+ var rv = [], seen = {};
- for (var i = 0; i < statuses.length; i++)
- rv.push(this.instantiateNetwork(statuses[i].interface, statuses[i].proto));
+ for (var i = 0; i < statuses.length; i++) {
+ if (!seen.hasOwnProperty(statuses[i].interface)) {
+ rv.push(this.instantiateNetwork(statuses[i].interface, statuses[i].proto));
+ seen[statuses[i].interface] = true;
+ }
+ }
return rv;
}, this));
},
+ /**
+ * Describes an swconfig switch topology by specifying the CPU
+ * connections and external port labels of a switch.
+ *
+ * @typedef {Object<string, Object|Array>} SwitchTopology
+ * @memberof LuCI.network
+ *
+ * @property {Object<number, string>} netdevs
+ * The `netdevs` property points to an object describing the CPU port
+ * connections of the switch. The numeric key of the enclosed object is
+ * the port number, the value contains the Linux network device name the
+ * port is hardwired to.
+ *
+ * @property {Array<Object<string, boolean|number|string>>} ports
+ * The `ports` property points to an array describing the populated
+ * ports of the switch in the external label order. Each array item is
+ * an object containg the following keys:
+ * - `num` - the internal switch port number
+ * - `label` - the label of the port, e.g. `LAN 1` or `CPU (eth0)`
+ * - `device` - the connected Linux network device name (CPU ports only)
+ * - `tagged` - a boolean indicating whether the port must be tagged to
+ * function (CPU ports only)
+ */
+
+ /**
+ * Returns the topologies of all swconfig switches found on the system.
+ *
+ * @returns {Promise<Object<string, LuCI.network.SwitchTopology>>}
+ * Returns a promise resolving to an object containing the topologies
+ * of each switch. The object keys correspond to the name of the switches
+ * such as `switch0`, the values are
+ * {@link LuCI.network.SwitchTopology SwitchTopology} objects describing
+ * the layout.
+ */
getSwitchTopologies: function() {
return initNetworkState().then(function() {
return _state.switches;
});
},
+ /* private */
instantiateNetwork: function(name, proto) {
if (name == null)
return null;
return new protoClass(name);
},
+ /* private */
instantiateDevice: function(name, network, extend) {
if (extend != null)
return new (Device.extend(extend))(name, network);
return new Device(name, network);
},
+ /* private */
instantiateWifiDevice: function(radioname, radiostate) {
return new WifiDevice(radioname, radiostate);
},
- instantiateWifiNetwork: function(sid, radioname, radiostate, netid, netstate) {
- return new WifiNetwork(sid, radioname, radiostate, netid, netstate);
+ /* private */
+ instantiateWifiNetwork: function(sid, radioname, radiostate, netid, netstate, hostapd) {
+ return new WifiNetwork(sid, radioname, radiostate, netid, netstate, hostapd);
},
+ /* private */
+ lookupWifiNetwork: function(netname) {
+ var sid, res, netid, radioname, radiostate, netstate;
+
+ sid = getWifiSidByNetid(netname);
+
+ if (sid != null) {
+ res = getWifiStateBySid(sid);
+ netid = netname;
+ radioname = res ? res[0] : null;
+ radiostate = res ? res[1] : null;
+ netstate = res ? res[2] : null;
+ }
+ else {
+ res = getWifiStateByIfname(netname);
+
+ if (res != null) {
+ radioname = res[0];
+ radiostate = res[1];
+ netstate = res[2];
+ sid = netstate.section;
+ netid = L.toArray(getWifiNetidBySid(sid))[0];
+ }
+ else {
+ res = getWifiStateBySid(netname);
+
+ if (res != null) {
+ radioname = res[0];
+ radiostate = res[1];
+ netstate = res[2];
+ sid = netname;
+ netid = L.toArray(getWifiNetidBySid(sid))[0];
+ }
+ else {
+ res = getWifiNetidBySid(netname);
+
+ if (res != null) {
+ netid = res[0];
+ radioname = res[1];
+ sid = netname;
+ }
+ }
+ }
+ }
+
+ return this.instantiateWifiNetwork(sid || netname, radioname,
+ radiostate, netid, netstate,
+ netstate ? _state.hostapd[netstate.ifname] : null);
+ },
+
+ /**
+ * Obtains the the network device name of the given object.
+ *
+ * @param {LuCI.network.Protocol|LuCI.network.Device|LuCI.network.WifiDevice|LuCI.network.WifiNetwork|string} obj
+ * The object to get the device name from.
+ *
+ * @returns {null|string}
+ * Returns a string containing the device name or `null` if the given
+ * object could not be converted to a name.
+ */
getIfnameOf: function(obj) {
return ifnameOf(obj);
},
+ /**
+ * Queries the internal DSL modem type from board information.
+ *
+ * @returns {Promise<null|string>}
+ * Returns a promise resolving to the type of the internal modem
+ * (e.g. `vdsl`) or to `null` if no internal modem is present.
+ */
getDSLModemType: function() {
return initNetworkState().then(function() {
return _state.hasDSLModem ? _state.hasDSLModem.type : null;
});
},
+ /**
+ * Queries aggregated information about known hosts.
+ *
+ * This function aggregates information from various sources such as
+ * DHCP lease databases, ARP and IPv6 neighbour entries, wireless
+ * association list etc. and returns a {@link LuCI.network.Hosts Hosts}
+ * class instance describing the found hosts.
+ *
+ * @returns {Promise<LuCI.network.Hosts>}
+ * Returns a `Hosts` instance describing host known on the system.
+ */
getHostHints: function() {
return initNetworkState().then(function() {
return new Hosts(_state.hosts);
}
});
-Hosts = L.Class.extend({
+/**
+ * @class
+ * @memberof LuCI.network
+ * @hideconstructor
+ * @classdesc
+ *
+ * The `LuCI.network.Hosts` class encapsulates host information aggregated
+ * from multiple sources and provides convenience functions to access the
+ * host information by different criteria.
+ */
+Hosts = baseclass.extend(/** @lends LuCI.network.Hosts.prototype */ {
__init__: function(hosts) {
this.hosts = hosts;
},
+ /**
+ * Lookup the hostname associated with the given MAC address.
+ *
+ * @param {string} mac
+ * The MAC address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the hostname associated with the given MAC or `null` if
+ * no matching host could be found or if no hostname is known for
+ * the corresponding host.
+ */
getHostnameByMACAddr: function(mac) {
return this.hosts[mac] ? this.hosts[mac].name : null;
},
+ /**
+ * Lookup the IPv4 address associated with the given MAC address.
+ *
+ * @param {string} mac
+ * The MAC address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the IPv4 address associated with the given MAC or `null` if
+ * no matching host could be found or if no IPv4 address is known for
+ * the corresponding host.
+ */
getIPAddrByMACAddr: function(mac) {
return this.hosts[mac] ? this.hosts[mac].ipv4 : null;
},
+ /**
+ * Lookup the IPv6 address associated with the given MAC address.
+ *
+ * @param {string} mac
+ * The MAC address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the IPv6 address associated with the given MAC or `null` if
+ * no matching host could be found or if no IPv6 address is known for
+ * the corresponding host.
+ */
getIP6AddrByMACAddr: function(mac) {
return this.hosts[mac] ? this.hosts[mac].ipv6 : null;
},
+ /**
+ * Lookup the hostname associated with the given IPv4 address.
+ *
+ * @param {string} ipaddr
+ * The IPv4 address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the hostname associated with the given IPv4 or `null` if
+ * no matching host could be found or if no hostname is known for
+ * the corresponding host.
+ */
getHostnameByIPAddr: function(ipaddr) {
for (var mac in this.hosts)
if (this.hosts[mac].ipv4 == ipaddr && this.hosts[mac].name != null)
return null;
},
+ /**
+ * Lookup the MAC address associated with the given IPv4 address.
+ *
+ * @param {string} ipaddr
+ * The IPv4 address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the MAC address associated with the given IPv4 or `null` if
+ * no matching host could be found or if no MAC address is known for
+ * the corresponding host.
+ */
getMACAddrByIPAddr: function(ipaddr) {
for (var mac in this.hosts)
if (this.hosts[mac].ipv4 == ipaddr)
return null;
},
+ /**
+ * Lookup the hostname associated with the given IPv6 address.
+ *
+ * @param {string} ipaddr
+ * The IPv6 address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the hostname associated with the given IPv6 or `null` if
+ * no matching host could be found or if no hostname is known for
+ * the corresponding host.
+ */
getHostnameByIP6Addr: function(ip6addr) {
for (var mac in this.hosts)
if (this.hosts[mac].ipv6 == ip6addr && this.hosts[mac].name != null)
return null;
},
+ /**
+ * Lookup the MAC address associated with the given IPv6 address.
+ *
+ * @param {string} ipaddr
+ * The IPv6 address to lookup.
+ *
+ * @returns {null|string}
+ * Returns the MAC address associated with the given IPv6 or `null` if
+ * no matching host could be found or if no MAC address is known for
+ * the corresponding host.
+ */
getMACAddrByIP6Addr: function(ip6addr) {
for (var mac in this.hosts)
if (this.hosts[mac].ipv6 == ip6addr)
return null;
},
+ /**
+ * Return an array of (MAC address, name hint) tuples sorted by
+ * MAC address.
+ *
+ * @param {boolean} [preferIp6=false]
+ * Whether to prefer IPv6 addresses (`true`) or IPv4 addresses (`false`)
+ * as name hint when no hostname is known for a specific MAC address.
+ *
+ * @returns {Array<Array<string>>}
+ * Returns an array of arrays containing a name hint for each found
+ * MAC address on the system. The array is sorted ascending by MAC.
+ *
+ * Each item of the resulting array is a two element array with the
+ * MAC being the first element and the name hint being the second
+ * element. The name hint is either the hostname, an IPv4 or an IPv6
+ * address related to the MAC address.
+ *
+ * If no hostname but both IPv4 and IPv6 addresses are known, the
+ * `preferIP6` flag specifies whether the IPv6 or the IPv4 address
+ * is used as hint.
+ */
getMACHints: function(preferIp6) {
var rv = [];
for (var mac in this.hosts) {
}
});
-Protocol = L.Class.extend({
+/**
+ * @class
+ * @memberof LuCI.network
+ * @hideconstructor
+ * @classdesc
+ *
+ * The `Network.Protocol` class serves as base for protocol specific
+ * subclasses which describe logical UCI networks defined by `config
+ * interface` sections in `/etc/config/network`.
+ */
+Protocol = baseclass.extend(/** @lends LuCI.network.Protocol.prototype */ {
__init__: function(name) {
this.sid = name;
},
}
},
+ /**
+ * Read the given UCI option value of this network.
+ *
+ * @param {string} opt
+ * The UCI option name to read.
+ *
+ * @returns {null|string|string[]}
+ * Returns the UCI option value or `null` if the requested option is
+ * not found.
+ */
get: function(opt) {
return uci.get('network', this.sid, opt);
},
+ /**
+ * Set the given UCI option of this network to the given value.
+ *
+ * @param {string} opt
+ * The name of the UCI option to set.
+ *
+ * @param {null|string|string[]} val
+ * The value to set or `null` to remove the given option from the
+ * configuration.
+ */
set: function(opt, val) {
return uci.set('network', this.sid, opt, val);
},
+ /**
+ * Get the associared Linux network device of this network.
+ *
+ * @returns {null|string}
+ * Returns the name of the associated network device or `null` if
+ * it could not be determined.
+ */
getIfname: function() {
var ifname;
return (res != null ? res[0] : null);
},
+ /**
+ * Get the name of this network protocol class.
+ *
+ * This function will be overwritten by subclasses created by
+ * {@link LuCI.network#registerProtocol Network.registerProtocol()}.
+ *
+ * @abstract
+ * @returns {string}
+ * Returns the name of the network protocol implementation, e.g.
+ * `static` or `dhcp`.
+ */
getProtocol: function() {
return null;
},
+ /**
+ * Return a human readable description for the protcol, such as
+ * `Static address` or `DHCP client`.
+ *
+ * This function should be overwritten by subclasses.
+ *
+ * @abstract
+ * @returns {string}
+ * Returns the description string.
+ */
getI18n: function() {
switch (this.getProtocol()) {
case 'none': return _('Unmanaged');
}
},
+ /**
+ * Get the type of the underlying interface.
+ *
+ * This function actually is a convenience wrapper around
+ * `proto.get("type")` and is mainly used by other `LuCI.network` code
+ * to check whether the interface is declared as bridge in UCI.
+ *
+ * @returns {null|string}
+ * Returns the value of the `type` option of the associated logical
+ * interface or `null` if no `type` option is set.
+ */
getType: function() {
return this._get('type');
},
+ /**
+ * Get the name of the associated logical interface.
+ *
+ * @returns {string}
+ * Returns the logical interface name, such as `lan` or `wan`.
+ */
getName: function() {
return this.sid;
},
+ /**
+ * Get the uptime of the logical interface.
+ *
+ * @returns {number}
+ * Returns the uptime of the associated interface in seconds.
+ */
getUptime: function() {
return this._ubus('uptime') || 0;
},
+ /**
+ * Get the logical interface expiry time in seconds.
+ *
+ * For protocols that have a concept of a lease, such as DHCP or
+ * DHCPv6, this function returns the remaining time in seconds
+ * until the lease expires.
+ *
+ * @returns {number}
+ * Returns the amount of seconds until the lease expires or `-1`
+ * if it isn't applicable to the associated protocol.
+ */
getExpiry: function() {
var u = this._ubus('uptime'),
d = this._ubus('data');
return -1;
},
+ /**
+ * Get the metric value of the logical interface.
+ *
+ * @returns {number}
+ * Returns the current metric value used for device and network
+ * routes spawned by the associated logical interface.
+ */
getMetric: function() {
return this._ubus('metric') || 0;
},
+ /**
+ * Get the requested firewall zone name of the logical interface.
+ *
+ * Some protocol implementations request a specific firewall zone
+ * to trigger inclusion of their resulting network devices into the
+ * firewall rule set.
+ *
+ * @returns {null|string}
+ * Returns the requested firewall zone name as published in the
+ * `ubus` runtime information or `null` if the remote protocol
+ * handler didn't request a zone.
+ */
getZoneName: function() {
var d = this._ubus('data');
return null;
},
+ /**
+ * Query the first (primary) IPv4 address of the logical interface.
+ *
+ * @returns {null|string}
+ * Returns the primary IPv4 address registered by the protocol handler
+ * or `null` if no IPv4 addresses were set.
+ */
getIPAddr: function() {
var addrs = this._ubus('ipv4-address');
return ((Array.isArray(addrs) && addrs.length) ? addrs[0].address : null);
},
+ /**
+ * Query all IPv4 addresses of the logical interface.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv4 addresses in CIDR notation which have been
+ * registered by the protocol handler. The order of the resulting array
+ * follows the order of the addresses in `ubus` runtime information.
+ */
getIPAddrs: function() {
var addrs = this._ubus('ipv4-address'),
rv = [];
return rv;
},
+ /**
+ * Query the first (primary) IPv4 netmask of the logical interface.
+ *
+ * @returns {null|string}
+ * Returns the netmask of the primary IPv4 address registered by the
+ * protocol handler or `null` if no IPv4 addresses were set.
+ */
getNetmask: function() {
var addrs = this._ubus('ipv4-address');
if (Array.isArray(addrs) && addrs.length)
return prefixToMask(addrs[0].mask, false);
},
+ /**
+ * Query the gateway (nexthop) of the default route associated with
+ * this logical interface.
+ *
+ * @returns {string}
+ * Returns a string containing the IPv4 nexthop address of the associated
+ * default route or `null` if no default route was found.
+ */
getGatewayAddr: function() {
var routes = this._ubus('route');
return null;
},
+ /**
+ * Query the IPv4 DNS servers associated with the logical interface.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv4 DNS servers registered by the remote
+ * protocol backend.
+ */
getDNSAddrs: function() {
var addrs = this._ubus('dns-server'),
rv = [];
return rv;
},
+ /**
+ * Query the first (primary) IPv6 address of the logical interface.
+ *
+ * @returns {null|string}
+ * Returns the primary IPv6 address registered by the protocol handler
+ * in CIDR notation or `null` if no IPv6 addresses were set.
+ */
getIP6Addr: function() {
var addrs = this._ubus('ipv6-address');
return null;
},
+ /**
+ * Query all IPv6 addresses of the logical interface.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv6 addresses in CIDR notation which have been
+ * registered by the protocol handler. The order of the resulting array
+ * follows the order of the addresses in `ubus` runtime information.
+ */
getIP6Addrs: function() {
var addrs = this._ubus('ipv6-address'),
rv = [];
return rv;
},
+ /**
+ * Query the gateway (nexthop) of the IPv6 default route associated with
+ * this logical interface.
+ *
+ * @returns {string}
+ * Returns a string containing the IPv6 nexthop address of the associated
+ * default route or `null` if no default route was found.
+ */
+ getGateway6Addr: function() {
+ var routes = this._ubus('route');
+
+ if (Array.isArray(routes))
+ for (var i = 0; i < routes.length; i++)
+ if (typeof(routes[i]) == 'object' &&
+ routes[i].target == '::' &&
+ routes[i].mask == 0)
+ return routes[i].nexthop;
+
+ return null;
+ },
+
+ /**
+ * Query the IPv6 DNS servers associated with the logical interface.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv6 DNS servers registered by the remote
+ * protocol backend.
+ */
getDNS6Addrs: function() {
var addrs = this._ubus('dns-server'),
rv = [];
return rv;
},
+ /**
+ * Query the routed IPv6 prefix associated with the logical interface.
+ *
+ * @returns {null|string}
+ * Returns the routed IPv6 prefix registered by the remote protocol
+ * handler or `null` if no prefix is present.
+ */
getIP6Prefix: function() {
var prefixes = this._ubus('ipv6-prefix');
return null;
},
+ /**
+ * Query interface error messages published in `ubus` runtime state.
+ *
+ * Interface errors are emitted by remote protocol handlers if the setup
+ * of the underlying logical interface failed, e.g. due to bad
+ * configuration or network connectivity issues.
+ *
+ * This function will translate the found error codes to human readable
+ * messages using the descriptions registered by
+ * {@link LuCI.network#registerErrorCode Network.registerErrorCode()}
+ * and fall back to `"Unknown error (%s)"` where `%s` is replaced by the
+ * error code in case no translation can be found.
+ *
+ * @returns {string[]}
+ * Returns an array of translated interface error messages.
+ */
getErrors: function() {
var errors = this._ubus('errors'),
rv = null;
return rv;
},
+ /**
+ * Checks whether the underlying logical interface is declared as bridge.
+ *
+ * @returns {boolean}
+ * Returns `true` when the interface is declared with `option type bridge`
+ * and when the associated protocol implementation is not marked virtual
+ * or `false` when the logical interface is no bridge.
+ */
isBridge: function() {
return (!this.isVirtual() && this.getType() == 'bridge');
},
+ /**
+ * Get the name of the opkg package providing the protocol functionality.
+ *
+ * This function should be overwritten by protocol specific subclasses.
+ *
+ * @abstract
+ *
+ * @returns {string}
+ * Returns the name of the opkg package required for the protocol to
+ * function, e.g. `odhcp6c` for the `dhcpv6` prototocol.
+ */
getOpkgPackage: function() {
return null;
},
+ /**
+ * Check function for the protocol handler if a new interface is createable.
+ *
+ * This function should be overwritten by protocol specific subclasses.
+ *
+ * @abstract
+ *
+ * @param {string} ifname
+ * The name of the interface to be created.
+ *
+ * @returns {Promise<void>}
+ * Returns a promise resolving if new interface is createable, else
+ * rejects with an error message string.
+ */
+ isCreateable: function(ifname) {
+ return Promise.resolve(null);
+ },
+
+ /**
+ * Checks whether the protocol functionality is installed.
+ *
+ * This function exists for compatibility with old code, it always
+ * returns `true`.
+ *
+ * @deprecated
+ * @abstract
+ *
+ * @returns {boolean}
+ * Returns `true` if the protocol support is installed, else `false`.
+ */
isInstalled: function() {
return true;
},
+ /**
+ * Checks whether this protocol is "virtual".
+ *
+ * A "virtual" protocol is a protocol which spawns its own interfaces
+ * on demand instead of using existing physical interfaces.
+ *
+ * Examples for virtual protocols are `6in4` which `gre` spawn tunnel
+ * network device on startup, examples for non-virtual protcols are
+ * `dhcp` or `static` which apply IP configuration to existing interfaces.
+ *
+ * This function should be overwritten by subclasses.
+ *
+ * @returns {boolean}
+ * Returns a boolean indicating whether the underlying protocol spawns
+ * dynamic interfaces (`true`) or not (`false`).
+ */
isVirtual: function() {
return false;
},
+ /**
+ * Checks whether this protocol is "floating".
+ *
+ * A "floating" protocol is a protocol which spawns its own interfaces
+ * on demand, like a virtual one but which relies on an existinf lower
+ * level interface to initiate the connection.
+ *
+ * An example for such a protocol is "pppoe".
+ *
+ * This function exists for backwards compatibility with older code
+ * but should not be used anymore.
+ *
+ * @deprecated
+ * @returns {boolean}
+ * Returns a boolean indicating whether this protocol is floating (`true`)
+ * or not (`false`).
+ */
isFloating: function() {
return false;
},
+ /**
+ * Checks whether this logical interface is dynamic.
+ *
+ * A dynamic interface is an interface which has been created at runtime,
+ * e.g. as sub-interface of another interface, but which is not backed by
+ * any user configuration. Such dynamic interfaces cannot be edited but
+ * only brought down or restarted.
+ *
+ * @returns {boolean}
+ * Returns a boolean indicating whether this interface is dynamic (`true`)
+ * or not (`false`).
+ */
isDynamic: function() {
return (this._ubus('dynamic') == true);
},
+ /**
+ * Checks whether this interface is an alias interface.
+ *
+ * Alias interfaces are interfaces layering on top of another interface
+ * and are denoted by a special `@interfacename` notation in the
+ * underlying `ifname` option.
+ *
+ * @returns {null|string}
+ * Returns the name of the parent interface if this logical interface
+ * is an alias or `null` if it is not an alias interface.
+ */
isAlias: function() {
var ifnames = L.toArray(uci.get('network', this.sid, 'ifname')),
parent = null;
return parent;
},
+ /**
+ * Checks whether this logical interface is "empty", meaning that ut
+ * has no network devices attached.
+ *
+ * @returns {boolean}
+ * Returns `true` if this logical interface is empty, else `false`.
+ */
isEmpty: function() {
if (this.isFloating())
return false;
return empty;
},
+ /**
+ * Checks whether this logical interface is configured and running.
+ *
+ * @returns {boolean}
+ * Returns `true` when the interface is active or `false` when it is not.
+ */
isUp: function() {
return (this._ubus('up') == true);
},
+ /**
+ * Add the given network device to the logical interface.
+ *
+ * @param {LuCI.network.Protocol|LuCI.network.Device|LuCI.network.WifiDevice|LuCI.network.WifiNetwork|string} device
+ * The object or device name to add to the logical interface. In case the
+ * given argument is not a string, it is resolved though the
+ * {@link LuCI.network#getIfnameOf Network.getIfnameOf()} function.
+ *
+ * @returns {boolean}
+ * Returns `true` if the device name has been added or `false` if any
+ * argument was invalid, if the device was already part of the logical
+ * interface or if the logical interface is virtual.
+ */
addDevice: function(ifname) {
ifname = ifnameOf(ifname);
return appendValue('network', this.sid, 'ifname', ifname);
},
+ /**
+ * Remove the given network device from the logical interface.
+ *
+ * @param {LuCI.network.Protocol|LuCI.network.Device|LuCI.network.WifiDevice|LuCI.network.WifiNetwork|string} device
+ * The object or device name to remove from the logical interface. In case
+ * the given argument is not a string, it is resolved though the
+ * {@link LuCI.network#getIfnameOf Network.getIfnameOf()} function.
+ *
+ * @returns {boolean}
+ * Returns `true` if the device name has been added or `false` if any
+ * argument was invalid, if the device was already part of the logical
+ * interface or if the logical interface is virtual.
+ */
deleteDevice: function(ifname) {
var rv = false;
return rv;
},
+ /**
+ * Returns the Linux network device associated with this logical
+ * interface.
+ *
+ * @returns {LuCI.network.Device}
+ * Returns a `Network.Device` class instance representing the
+ * expected Linux network device according to the configuration.
+ */
getDevice: function() {
if (this.isVirtual()) {
var ifname = '%s-%s'.format(this.getProtocol(), this.sid);
_state.isTunnel[this.getProtocol() + '-' + this.sid] = true;
- return L.network.instantiateDevice(ifname, this);
+ return Network.prototype.instantiateDevice(ifname, this);
}
else if (this.isBridge()) {
var ifname = 'br-%s'.format(this.sid);
for (var i = 0; i < ifnames.length; i++) {
var m = ifnames[i].match(/^([^:/]+)/);
- return ((m && m[1]) ? L.network.instantiateDevice(m[1], this) : null);
+ return ((m && m[1]) ? Network.prototype.instantiateDevice(m[1], this) : null);
}
ifname = getWifiNetidByNetname(this.sid);
- return (ifname != null ? L.network.instantiateDevice(ifname[0], this) : null);
+ return (ifname != null ? Network.prototype.instantiateDevice(ifname[0], this) : null);
}
},
+ /**
+ * Returns the layer 2 linux network device currently associated
+ * with this logical interface.
+ *
+ * @returns {LuCI.network.Device}
+ * Returns a `Network.Device` class instance representing the Linux
+ * network device currently associated with the logical interface.
+ */
getL2Device: function() {
var ifname = this._ubus('device');
- return (ifname != null ? L.network.instantiateDevice(ifname, this) : null);
+ return (ifname != null ? Network.prototype.instantiateDevice(ifname, this) : null);
},
+ /**
+ * Returns the layer 3 linux network device currently associated
+ * with this logical interface.
+ *
+ * @returns {LuCI.network.Device}
+ * Returns a `Network.Device` class instance representing the Linux
+ * network device currently associated with the logical interface.
+ */
getL3Device: function() {
var ifname = this._ubus('l3_device');
- return (ifname != null ? L.network.instantiateDevice(ifname, this) : null);
- },
-
+ return (ifname != null ? Network.prototype.instantiateDevice(ifname, this) : null);
+ },
+
+ /**
+ * Returns a list of network sub-devices associated with this logical
+ * interface.
+ *
+ * @returns {null|Array<LuCI.network.Device>}
+ * Returns an array of of `Network.Device` class instances representing
+ * the sub-devices attached to this logical interface or `null` if the
+ * logical interface does not support sub-devices, e.g. because it is
+ * virtual and not a bridge.
+ */
getDevices: function() {
var rv = [];
var m = ifnames[i].match(/^([^:/]+)/);
if (m != null)
- rv.push(L.network.instantiateDevice(m[1], this));
+ rv.push(Network.prototype.instantiateDevice(m[1], this));
}
var uciWifiIfaces = uci.sections('wireless', 'wifi-iface');
var netid = getWifiNetidBySid(uciWifiIfaces[i]['.name']);
if (netid != null)
- rv.push(L.network.instantiateDevice(netid[0], this));
+ rv.push(Network.prototype.instantiateDevice(netid[0], this));
}
}
return rv;
},
+ /**
+ * Checks whether this logical interface contains the given device
+ * object.
+ *
+ * @param {LuCI.network.Protocol|LuCI.network.Device|LuCI.network.WifiDevice|LuCI.network.WifiNetwork|string} device
+ * The object or device name to check. In case the given argument is not
+ * a string, it is resolved though the
+ * {@link LuCI.network#getIfnameOf Network.getIfnameOf()} function.
+ *
+ * @returns {boolean}
+ * Returns `true` when this logical interface contains the given network
+ * device or `false` if not.
+ */
containsDevice: function(ifname) {
ifname = ifnameOf(ifname);
}
return false;
- }
+ },
+
+ /**
+ * Cleanup related configuration entries.
+ *
+ * This function will be invoked if an interface is about to be removed
+ * from the configuration and is responsible for performing any required
+ * cleanup tasks, such as unsetting uci entries in related configurations.
+ *
+ * It should be overwritten by protocol specific subclasses.
+ *
+ * @abstract
+ *
+ * @returns {*|Promise<*>}
+ * This function may return a promise which is awaited before the rest of
+ * the configuration is removed. Any non-promise return value and any
+ * resolved promise value is ignored. If the returned promise is rejected,
+ * the interface removal will be aborted.
+ */
+ deleteConfiguration: function() {}
});
-Device = L.Class.extend({
+/**
+ * @class
+ * @memberof LuCI.network
+ * @hideconstructor
+ * @classdesc
+ *
+ * A `Network.Device` class instance represents an underlying Linux network
+ * device and allows querying device details such as packet statistics or MTU.
+ */
+Device = baseclass.extend(/** @lends LuCI.network.Device.prototype */ {
__init__: function(ifname, network) {
var wif = getWifiSidByIfname(ifname);
return rv;
},
+ /**
+ * Get the name of the network device.
+ *
+ * @returns {string}
+ * Returns the name of the device, e.g. `eth0` or `wlan0`.
+ */
getName: function() {
return (this.wif != null ? this.wif.getIfname() : this.ifname);
},
+ /**
+ * Get the MAC address of the device.
+ *
+ * @returns {null|string}
+ * Returns the MAC address of the device or `null` if not applicable,
+ * e.g. for non-ethernet tunnel devices.
+ */
getMAC: function() {
var mac = this._devstate('macaddr');
return mac ? mac.toUpperCase() : null;
},
+ /**
+ * Get the MTU of the device.
+ *
+ * @returns {number}
+ * Returns the MTU of the device.
+ */
getMTU: function() {
return this._devstate('mtu');
},
+ /**
+ * Get the IPv4 addresses configured on the device.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv4 address strings.
+ */
getIPAddrs: function() {
var addrs = this._devstate('ipaddrs');
return (Array.isArray(addrs) ? addrs : []);
},
+ /**
+ * Get the IPv6 addresses configured on the device.
+ *
+ * @returns {string[]}
+ * Returns an array of IPv6 address strings.
+ */
getIP6Addrs: function() {
var addrs = this._devstate('ip6addrs');
return (Array.isArray(addrs) ? addrs : []);
},
+ /**
+ * Get the type of the device..
+ *
+ * @returns {string}
+ * Returns a string describing the type of the network device:
+ * - `alias` if it is an abstract alias device (`@` notation)
+ * - `wifi` if it is a wireless interface (e.g. `wlan0`)
+ * - `bridge` if it is a bridge device (e.g. `br-lan`)
+ * - `tunnel` if it is a tun or tap device (e.g. `tun0`)
+ * - `vlan` if it is a vlan device (e.g. `eth0.1`)
+ * - `switch` if it is a switch device (e.g.`eth1` connected to switch0)
+ * - `ethernet` for all other device types
+ */
getType: function() {
if (this.ifname != null && this.ifname.charAt(0) == '@')
return 'alias';
return 'ethernet';
},
+ /**
+ * Get a short description string for the device.
+ *
+ * @returns {string}
+ * Returns the device name for non-wifi devices or a string containing
+ * the operation mode and SSID for wifi devices.
+ */
getShortName: function() {
if (this.wif != null)
return this.wif.getShortName();
return this.ifname;
},
+ /**
+ * Get a long description string for the device.
+ *
+ * @returns {string}
+ * Returns a string containing the type description and device name
+ * for non-wifi devices or operation mode and ssid for wifi ones.
+ */
getI18n: function() {
if (this.wif != null) {
return '%s: %s "%s"'.format(
return '%s: "%s"'.format(this.getTypeI18n(), this.getName());
},
+ /**
+ * Get a string describing the device type.
+ *
+ * @returns {string}
+ * Returns a string describing the type, e.g. "Wireless Adapter" or
+ * "Bridge".
+ */
getTypeI18n: function() {
switch (this.getType()) {
case 'alias':
}
},
+ /**
+ * Get the associated bridge ports of the device.
+ *
+ * @returns {null|Array<LuCI.network.Device>}
+ * Returns an array of `Network.Device` instances representing the ports
+ * (slave interfaces) of the bridge or `null` when this device isn't
+ * a Linux bridge.
+ */
getPorts: function() {
var br = _state.bridges[this.ifname],
rv = [];
return null;
for (var i = 0; i < br.ifnames.length; i++)
- rv.push(L.network.instantiateDevice(br.ifnames[i].name));
+ rv.push(Network.prototype.instantiateDevice(br.ifnames[i].name));
rv.sort(deviceSort);
return rv;
},
+ /**
+ * Get the bridge ID
+ *
+ * @returns {null|string}
+ * Returns the ID of this network bridge or `null` if this network
+ * device is not a Linux bridge.
+ */
getBridgeID: function() {
var br = _state.bridges[this.ifname];
return (br != null ? br.id : null);
},
+ /**
+ * Get the bridge STP setting
+ *
+ * @returns {boolean}
+ * Returns `true` when this device is a Linux bridge and has `stp`
+ * enabled, else `false`.
+ */
getBridgeSTP: function() {
var br = _state.bridges[this.ifname];
return (br != null ? !!br.stp : false);
},
+ /**
+ * Checks whether this device is up.
+ *
+ * @returns {boolean}
+ * Returns `true` when the associated device is running pr `false`
+ * when it is down or absent.
+ */
isUp: function() {
var up = this._devstate('flags', 'up');
return up;
},
+ /**
+ * Checks whether this device is a Linux bridge.
+ *
+ * @returns {boolean}
+ * Returns `true` when the network device is present and a Linux bridge,
+ * else `false`.
+ */
isBridge: function() {
return (this.getType() == 'bridge');
},
+ /**
+ * Checks whether this device is part of a Linux bridge.
+ *
+ * @returns {boolean}
+ * Returns `true` when this network device is part of a bridge,
+ * else `false`.
+ */
isBridgePort: function() {
return (this._devstate('bridge') != null);
},
+ /**
+ * Get the amount of transmitted bytes.
+ *
+ * @returns {number}
+ * Returns the amount of bytes transmitted by the network device.
+ */
getTXBytes: function() {
var stat = this._devstate('stats');
return (stat != null ? stat.tx_bytes || 0 : 0);
},
+ /**
+ * Get the amount of received bytes.
+ *
+ * @returns {number}
+ * Returns the amount of bytes received by the network device.
+ */
getRXBytes: function() {
var stat = this._devstate('stats');
return (stat != null ? stat.rx_bytes || 0 : 0);
},
+ /**
+ * Get the amount of transmitted packets.
+ *
+ * @returns {number}
+ * Returns the amount of packets transmitted by the network device.
+ */
getTXPackets: function() {
var stat = this._devstate('stats');
return (stat != null ? stat.tx_packets || 0 : 0);
},
+ /**
+ * Get the amount of received packets.
+ *
+ * @returns {number}
+ * Returns the amount of packets received by the network device.
+ */
getRXPackets: function() {
var stat = this._devstate('stats');
return (stat != null ? stat.rx_packets || 0 : 0);
},
+ /**
+ * Get the primary logical interface this device is assigned to.
+ *
+ * @returns {null|LuCI.network.Protocol}
+ * Returns a `Network.Protocol` instance representing the logical
+ * interface this device is attached to or `null` if it is not
+ * assigned to any logical interface.
+ */
getNetwork: function() {
return this.getNetworks()[0];
},
+ /**
+ * Get the logical interfaces this device is assigned to.
+ *
+ * @returns {Array<LuCI.network.Protocol>}
+ * Returns an array of `Network.Protocol` instances representing the
+ * logical interfaces this device is assigned to.
+ */
getNetworks: function() {
if (this.networks == null) {
this.networks = [];
return this.networks;
},
+ /**
+ * Get the related wireless network this device is related to.
+ *
+ * @returns {null|LuCI.network.WifiNetwork}
+ * Returns a `Network.WifiNetwork` instance representing the wireless
+ * network corresponding to this network device or `null` if this device
+ * is not a wireless device.
+ */
getWifiNetwork: function() {
return (this.wif != null ? this.wif : null);
}
});
-WifiDevice = L.Class.extend({
+/**
+ * @class
+ * @memberof LuCI.network
+ * @hideconstructor
+ * @classdesc
+ *
+ * A `Network.WifiDevice` class instance represents a wireless radio device
+ * present on the system and provides wireless capability information as
+ * well as methods for enumerating related wireless networks.
+ */
+WifiDevice = baseclass.extend(/** @lends LuCI.network.WifiDevice.prototype */ {
__init__: function(name, radiostate) {
var uciWifiDevice = uci.get('wireless', name);
};
},
+ /* private */
ubus: function(/* ... */) {
var v = this._ubusdata;
return v;
},
+ /**
+ * Read the given UCI option value of this wireless device.
+ *
+ * @param {string} opt
+ * The UCI option name to read.
+ *
+ * @returns {null|string|string[]}
+ * Returns the UCI option value or `null` if the requested option is
+ * not found.
+ */
get: function(opt) {
return uci.get('wireless', this.sid, opt);
},
+ /**
+ * Set the given UCI option of this network to the given value.
+ *
+ * @param {string} opt
+ * The name of the UCI option to set.
+ *
+ * @param {null|string|string[]} val
+ * The value to set or `null` to remove the given option from the
+ * configuration.
+ */
set: function(opt, value) {
return uci.set('wireless', this.sid, opt, value);
},
+ /**
+ * Checks whether this wireless radio is disabled.
+ *
+ * @returns {boolean}
+ * Returns `true` when the wireless radio is marked as disabled in `ubus`
+ * runtime state or when the `disabled` option is set in the corresponding
+ * UCI configuration.
+ */
isDisabled: function() {
return this.ubus('dev', 'disabled') || this.get('disabled') == '1';
},
+ /**
+ * Get the configuration name of this wireless radio.
+ *
+ * @returns {string}
+ * Returns the UCI section name (e.g. `radio0`) of the corresponding
+ * radio configuration which also serves as unique logical identifier
+ * for the wireless phy.
+ */
getName: function() {
return this.sid;
},
+ /**
+ * Gets a list of supported hwmodes.
+ *
+ * The hwmode values describe the frequency band and wireless standard
+ * versions supported by the wireless phy.
+ *
+ * @returns {string[]}
+ * Returns an array of valid hwmode values for this radio. Currently
+ * known mode values are:
+ * - `a` - Legacy 802.11a mode, 5 GHz, up to 54 Mbit/s
+ * - `b` - Legacy 802.11b mode, 2.4 GHz, up to 11 Mbit/s
+ * - `g` - Legacy 802.11g mode, 2.4 GHz, up to 54 Mbit/s
+ * - `n` - IEEE 802.11n mode, 2.4 or 5 GHz, up to 600 Mbit/s
+ * - `ac` - IEEE 802.11ac mode, 5 GHz, up to 6770 Mbit/s
+ */
getHWModes: function() {
var hwmodes = this.ubus('dev', 'iwinfo', 'hwmodes');
return Array.isArray(hwmodes) ? hwmodes : [ 'b', 'g' ];
},
+ /**
+ * Gets a list of supported htmodes.
+ *
+ * The htmode values describe the wide-frequency options supported by
+ * the wireless phy.
+ *
+ * @returns {string[]}
+ * Returns an array of valid htmode values for this radio. Currently
+ * known mode values are:
+ * - `HT20` - applicable to IEEE 802.11n, 20 MHz wide channels
+ * - `HT40` - applicable to IEEE 802.11n, 40 MHz wide channels
+ * - `VHT20` - applicable to IEEE 802.11ac, 20 MHz wide channels
+ * - `VHT40` - applicable to IEEE 802.11ac, 40 MHz wide channels
+ * - `VHT80` - applicable to IEEE 802.11ac, 80 MHz wide channels
+ * - `VHT160` - applicable to IEEE 802.11ac, 160 MHz wide channels
+ */
getHTModes: function() {
var htmodes = this.ubus('dev', 'iwinfo', 'htmodes');
return (Array.isArray(htmodes) && htmodes.length) ? htmodes : null;
},
+ /**
+ * Get a string describing the wireless radio hardware.
+ *
+ * @returns {string}
+ * Returns the description string.
+ */
getI18n: function() {
var hw = this.ubus('dev', 'iwinfo', 'hardware'),
type = L.isObject(hw) ? hw.name : null;
return '%s 802.11%s Wireless Controller (%s)'.format(type || 'Generic', modestr, this.getName());
},
+ /**
+ * A wireless scan result object describes a neighbouring wireless
+ * network found in the vincinity.
+ *
+ * @typedef {Object<string, number|string|LuCI.network.WifiEncryption>} WifiScanResult
+ * @memberof LuCI.network
+ *
+ * @property {string} ssid
+ * The SSID / Mesh ID of the network.
+ *
+ * @property {string} bssid
+ * The BSSID if the network.
+ *
+ * @property {string} mode
+ * The operation mode of the network (`Master`, `Ad-Hoc`, `Mesh Point`).
+ *
+ * @property {number} channel
+ * The wireless channel of the network.
+ *
+ * @property {number} signal
+ * The received signal strength of the network in dBm.
+ *
+ * @property {number} quality
+ * The numeric quality level of the signal, can be used in conjunction
+ * with `quality_max` to calculate a quality percentage.
+ *
+ * @property {number} quality_max
+ * The maximum possible quality level of the signal, can be used in
+ * conjunction with `quality` to calculate a quality percentage.
+ *
+ * @property {LuCI.network.WifiEncryption} encryption
+ * The encryption used by the wireless network.
+ */
+
+ /**
+ * Trigger a wireless scan on this radio device and obtain a list of
+ * nearby networks.
+ *
+ * @returns {Promise<Array<LuCI.network.WifiScanResult>>}
+ * Returns a promise resolving to an array of scan result objects
+ * describing the networks found in the vincinity.
+ */
getScanList: function() {
return callIwinfoScan(this.sid);
},
+ /**
+ * Check whether the wireless radio is marked as up in the `ubus`
+ * runtime state.
+ *
+ * @returns {boolean}
+ * Returns `true` when the radio device is up, else `false`.
+ */
isUp: function() {
if (L.isObject(_state.radios[this.sid]))
return (_state.radios[this.sid].up == true);
return false;
},
+ /**
+ * Get the wifi network of the given name belonging to this radio device
+ *
+ * @param {string} network
+ * The name of the wireless network to lookup. This may be either an uci
+ * configuration section ID, a network ID in the form `radio#.network#`
+ * or a Linux network device name like `wlan0` which is resolved to the
+ * corresponding configuration section through `ubus` runtime information.
+ *
+ * @returns {Promise<LuCI.network.WifiNetwork>}
+ * Returns a promise resolving to a `Network.WifiNetwork` instance
+ * representing the wireless network and rejecting with `null` if
+ * the given network could not be found or is not associated with
+ * this radio device.
+ */
getWifiNetwork: function(network) {
- return L.network.getWifiNetwork(network).then(L.bind(function(networkInstance) {
+ return Network.prototype.getWifiNetwork(network).then(L.bind(function(networkInstance) {
var uciWifiIface = (networkInstance.sid ? uci.get('wireless', networkInstance.sid) : null);
if (uciWifiIface == null || uciWifiIface['.type'] != 'wifi-iface' || uciWifiIface.device != this.sid)
}, this));
},
+ /**
+ * Get all wireless networks associated with this wireless radio device.
+ *
+ * @returns {Promise<Array<LuCI.network.WifiNetwork>>}
+ * Returns a promise resolving to an array of `Network.WifiNetwork`
+ * instances respresenting the wireless networks associated with this
+ * radio device.
+ */
getWifiNetworks: function() {
- var uciWifiIfaces = uci.sections('wireless', 'wifi-iface'),
- tasks = [];
+ return Network.prototype.getWifiNetworks().then(L.bind(function(networks) {
+ var rv = [];
- for (var i = 0; i < uciWifiIfaces.length; i++)
- if (uciWifiIfaces[i].device == this.sid)
- tasks.push(L.network.getWifiNetwork(uciWifiIfaces[i]['.name']));
+ for (var i = 0; i < networks.length; i++)
+ if (networks[i].getWifiDeviceName() == this.getName())
+ rv.push(networks[i]);
- return Promise.all(tasks);
+ return rv;
+ }, this));
},
+ /**
+ * Adds a new wireless network associated with this radio device to the
+ * configuration and sets its options to the provided values.
+ *
+ * @param {Object<string, string|string[]>} [options]
+ * The options to set for the newly added wireless network.
+ *
+ * @returns {Promise<null|LuCI.network.WifiNetwork>}
+ * Returns a promise resolving to a `WifiNetwork` instance describing
+ * the newly added wireless network or `null` if the given options
+ * were invalid.
+ */
addWifiNetwork: function(options) {
if (!L.isObject(options))
options = {};
options.device = this.sid;
- return L.network.addWifiNetwork(options);
- },
-
+ return Network.prototype.addWifiNetwork(options);
+ },
+
+ /**
+ * Deletes the wireless network with the given name associated with this
+ * radio device.
+ *
+ * @param {string} network
+ * The name of the wireless network to lookup. This may be either an uci
+ * configuration section ID, a network ID in the form `radio#.network#`
+ * or a Linux network device name like `wlan0` which is resolved to the
+ * corresponding configuration section through `ubus` runtime information.
+ *
+ * @returns {Promise<boolean>}
+ * Returns a promise resolving to `true` when the wireless network was
+ * successfully deleted from the configuration or `false` when the given
+ * network could not be found or if the found network was not associated
+ * with this wireless radio device.
+ */
deleteWifiNetwork: function(network) {
var sid = null;
}
});
-WifiNetwork = L.Class.extend({
- __init__: function(sid, radioname, radiostate, netid, netstate) {
+/**
+ * @class
+ * @memberof LuCI.network
+ * @hideconstructor
+ * @classdesc
+ *
+ * A `Network.WifiNetwork` instance represents a wireless network (vif)
+ * configured on top of a radio device and provides functions for querying
+ * the runtime state of the network. Most radio devices support multiple
+ * such networks in parallel.
+ */
+WifiNetwork = baseclass.extend(/** @lends LuCI.network.WifiNetwork.prototype */ {
+ __init__: function(sid, radioname, radiostate, netid, netstate, hostapd) {
this.sid = sid;
this.netid = netid;
this._ubusdata = {
- radio: radioname,
- dev: radiostate,
- net: netstate
+ hostapd: hostapd,
+ radio: radioname,
+ dev: radiostate,
+ net: netstate
};
},
return v;
},
+ /**
+ * Read the given UCI option value of this wireless network.
+ *
+ * @param {string} opt
+ * The UCI option name to read.
+ *
+ * @returns {null|string|string[]}
+ * Returns the UCI option value or `null` if the requested option is
+ * not found.
+ */
get: function(opt) {
return uci.get('wireless', this.sid, opt);
},
+ /**
+ * Set the given UCI option of this network to the given value.
+ *
+ * @param {string} opt
+ * The name of the UCI option to set.
+ *
+ * @param {null|string|string[]} val
+ * The value to set or `null` to remove the given option from the
+ * configuration.
+ */
set: function(opt, value) {
return uci.set('wireless', this.sid, opt, value);
},
+ /**
+ * Checks whether this wireless network is disabled.
+ *
+ * @returns {boolean}
+ * Returns `true` when the wireless radio is marked as disabled in `ubus`
+ * runtime state or when the `disabled` option is set in the corresponding
+ * UCI configuration.
+ */
isDisabled: function() {
return this.ubus('dev', 'disabled') || this.get('disabled') == '1';
},
+ /**
+ * Get the configured operation mode of the wireless network.
+ *
+ * @returns {string}
+ * Returns the configured operation mode. Possible values are:
+ * - `ap` - Master (Access Point) mode
+ * - `sta` - Station (client) mode
+ * - `adhoc` - Ad-Hoc (IBSS) mode
+ * - `mesh` - Mesh (IEEE 802.11s) mode
+ * - `monitor` - Monitor mode
+ */
getMode: function() {
return this.ubus('net', 'config', 'mode') || this.get('mode') || 'ap';
},
+ /**
+ * Get the configured SSID of the wireless network.
+ *
+ * @returns {null|string}
+ * Returns the configured SSID value or `null` when this network is
+ * in mesh mode.
+ */
getSSID: function() {
if (this.getMode() == 'mesh')
return null;
return this.ubus('net', 'config', 'ssid') || this.get('ssid');
},
+ /**
+ * Get the configured Mesh ID of the wireless network.
+ *
+ * @returns {null|string}
+ * Returns the configured mesh ID value or `null` when this network
+ * is not in mesh mode.
+ */
getMeshID: function() {
if (this.getMode() != 'mesh')
return null;
return this.ubus('net', 'config', 'mesh_id') || this.get('mesh_id');
},
+ /**
+ * Get the configured BSSID of the wireless network.
+ *
+ * @returns {null|string}
+ * Returns the BSSID value or `null` if none has been specified.
+ */
getBSSID: function() {
return this.ubus('net', 'config', 'bssid') || this.get('bssid');
},
+ /**
+ * Get the names of the logical interfaces this wireless network is
+ * attached to.
+ *
+ * @returns {string[]}
+ * Returns an array of logical interface names.
+ */
getNetworkNames: function() {
return L.toArray(this.ubus('net', 'config', 'network') || this.get('network'));
},
+ /**
+ * Get the internal network ID of this wireless network.
+ *
+ * The network ID is a LuCI specific identifer in the form
+ * `radio#.network#` to identify wireless networks by their corresponding
+ * radio and network index numbers.
+ *
+ * @returns {string}
+ * Returns the LuCI specific network ID.
+ */
getID: function() {
return this.netid;
},
+ /**
+ * Get the configuration ID of this wireless network.
+ *
+ * @returns {string}
+ * Returns the corresponding UCI section ID of the network.
+ */
getName: function() {
return this.sid;
},
+ /**
+ * Get the Linux network device name.
+ *
+ * @returns {null|string}
+ * Returns the current Linux network device name as resolved from
+ * `ubus` runtime information or `null` if this network has no
+ * associated network device, e.g. when not configured or up.
+ */
getIfname: function() {
var ifname = this.ubus('net', 'ifname') || this.ubus('net', 'iwinfo', 'ifname');
return ifname;
},
+ /**
+ * Get the Linux VLAN network device names.
+ *
+ * @returns {string[]}
+ * Returns the current Linux VLAN network device name as resolved
+ * from `ubus` runtime information or empty array if this network
+ * has no associated VLAN network devices.
+ */
+ getVlanIfnames: function() {
+ var vlans = L.toArray(this.ubus('net', 'vlans')),
+ ifnames = [];
+
+ for (var i = 0; i < vlans.length; i++)
+ ifnames.push(vlans[i]['ifname']);
+
+ return ifnames;
+ },
+
+ /**
+ * Get the name of the corresponding wifi radio device.
+ *
+ * @returns {null|string}
+ * Returns the name of the radio device this network is configured on
+ * or `null` if it cannot be determined.
+ */
getWifiDeviceName: function() {
return this.ubus('radio') || this.get('device');
},
+ /**
+ * Get the corresponding wifi radio device.
+ *
+ * @returns {null|LuCI.network.WifiDevice}
+ * Returns a `Network.WifiDevice` instance representing the corresponding
+ * wifi radio device or `null` if the related radio device could not be
+ * found.
+ */
getWifiDevice: function() {
var radioname = this.getWifiDeviceName();
if (radioname == null)
return Promise.reject();
- return L.network.getWifiDevice(radioname);
- },
-
+ return Network.prototype.getWifiDevice(radioname);
+ },
+
+ /**
+ * Check whether the radio network is up.
+ *
+ * This function actually queries the up state of the related radio
+ * device and assumes this network to be up as well when the parent
+ * radio is up. This is due to the fact that OpenWrt does not control
+ * virtual interfaces individually but within one common hostapd
+ * instance.
+ *
+ * @returns {boolean}
+ * Returns `true` when the network is up, else `false`.
+ */
isUp: function() {
var device = this.getDevice();
return device.isUp();
},
+ /**
+ * Query the current operation mode from runtime information.
+ *
+ * @returns {string}
+ * Returns the human readable mode name as reported by `ubus` runtime
+ * state. Possible returned values are:
+ * - `Master`
+ * - `Ad-Hoc`
+ * - `Client`
+ * - `Monitor`
+ * - `Master (VLAN)`
+ * - `WDS`
+ * - `Mesh Point`
+ * - `P2P Client`
+ * - `P2P Go`
+ * - `Unknown`
+ */
getActiveMode: function() {
var mode = this.ubus('net', 'iwinfo', 'mode') || this.ubus('net', 'config', 'mode') || this.get('mode') || 'ap';
}
},
+ /**
+ * Query the current operation mode from runtime information as
+ * translated string.
+ *
+ * @returns {string}
+ * Returns the translated, human readable mode name as reported by
+ *`ubus` runtime state.
+ */
getActiveModeI18n: function() {
var mode = this.getActiveMode();
}
},
+ /**
+ * Query the current SSID from runtime information.
+ *
+ * @returns {string}
+ * Returns the current SSID or Mesh ID as reported by `ubus` runtime
+ * information.
+ */
getActiveSSID: function() {
return this.ubus('net', 'iwinfo', 'ssid') || this.ubus('net', 'config', 'ssid') || this.get('ssid');
},
+ /**
+ * Query the current BSSID from runtime information.
+ *
+ * @returns {string}
+ * Returns the current BSSID or Mesh ID as reported by `ubus` runtime
+ * information.
+ */
getActiveBSSID: function() {
return this.ubus('net', 'iwinfo', 'bssid') || this.ubus('net', 'config', 'bssid') || this.get('bssid');
},
+ /**
+ * Query the current encryption settings from runtime information.
+ *
+ * @returns {string}
+ * Returns a string describing the current encryption or `-` if the the
+ * encryption state could not be found in `ubus` runtime information.
+ */
getActiveEncryption: function() {
return formatWifiEncryption(this.ubus('net', 'iwinfo', 'encryption')) || '-';
},
+ /**
+ * A wireless peer entry describes the properties of a remote wireless
+ * peer associated with a local network.
+ *
+ * @typedef {Object<string, boolean|number|string|LuCI.network.WifiRateEntry>} WifiPeerEntry
+ * @memberof LuCI.network
+ *
+ * @property {string} mac
+ * The MAC address (BSSID).
+ *
+ * @property {number} signal
+ * The received signal strength.
+ *
+ * @property {number} [signal_avg]
+ * The average signal strength if supported by the driver.
+ *
+ * @property {number} [noise]
+ * The current noise floor of the radio. May be `0` or absent if not
+ * supported by the driver.
+ *
+ * @property {number} inactive
+ * The amount of milliseconds the peer has been inactive, e.g. due
+ * to powersave.
+ *
+ * @property {number} connected_time
+ * The amount of milliseconds the peer is associated to this network.
+ *
+ * @property {number} [thr]
+ * The estimated throughput of the peer, May be `0` or absent if not
+ * supported by the driver.
+ *
+ * @property {boolean} authorized
+ * Specifies whether the peer is authorized to associate to this network.
+ *
+ * @property {boolean} authenticated
+ * Specifies whether the peer completed authentication to this network.
+ *
+ * @property {string} preamble
+ * The preamble mode used by the peer. May be `long` or `short`.
+ *
+ * @property {boolean} wme
+ * Specifies whether the peer supports WME/WMM capabilities.
+ *
+ * @property {boolean} mfp
+ * Specifies whether management frame protection is active.
+ *
+ * @property {boolean} tdls
+ * Specifies whether TDLS is active.
+ *
+ * @property {number} [mesh llid]
+ * The mesh LLID, may be `0` or absent if not applicable or supported
+ * by the driver.
+ *
+ * @property {number} [mesh plid]
+ * The mesh PLID, may be `0` or absent if not applicable or supported
+ * by the driver.
+ *
+ * @property {string} [mesh plink]
+ * The mesh peer link state description, may be an empty string (`''`)
+ * or absent if not applicable or supported by the driver.
+ *
+ * The following states are known:
+ * - `LISTEN`
+ * - `OPN_SNT`
+ * - `OPN_RCVD`
+ * - `CNF_RCVD`
+ * - `ESTAB`
+ * - `HOLDING`
+ * - `BLOCKED`
+ * - `UNKNOWN`
+ *
+ * @property {number} [mesh local PS]
+ * The local powersafe mode for the peer link, may be an empty
+ * string (`''`) or absent if not applicable or supported by
+ * the driver.
+ *
+ * The following modes are known:
+ * - `ACTIVE` (no power save)
+ * - `LIGHT SLEEP`
+ * - `DEEP SLEEP`
+ * - `UNKNOWN`
+ *
+ * @property {number} [mesh peer PS]
+ * The remote powersafe mode for the peer link, may be an empty
+ * string (`''`) or absent if not applicable or supported by
+ * the driver.
+ *
+ * The following modes are known:
+ * - `ACTIVE` (no power save)
+ * - `LIGHT SLEEP`
+ * - `DEEP SLEEP`
+ * - `UNKNOWN`
+ *
+ * @property {number} [mesh non-peer PS]
+ * The powersafe mode for all non-peer neigbours, may be an empty
+ * string (`''`) or absent if not applicable or supported by the driver.
+ *
+ * The following modes are known:
+ * - `ACTIVE` (no power save)
+ * - `LIGHT SLEEP`
+ * - `DEEP SLEEP`
+ * - `UNKNOWN`
+ *
+ * @property {LuCI.network.WifiRateEntry} rx
+ * Describes the receiving wireless rate from the peer.
+ *
+ * @property {LuCI.network.WifiRateEntry} tx
+ * Describes the transmitting wireless rate to the peer.
+ */
+
+ /**
+ * A wireless rate entry describes the properties of a wireless
+ * transmission rate to or from a peer.
+ *
+ * @typedef {Object<string, boolean|number>} WifiRateEntry
+ * @memberof LuCI.network
+ *
+ * @property {number} [drop_misc]
+ * The amount of received misc. packages that have been dropped, e.g.
+ * due to corruption or missing authentication. Only applicable to
+ * receiving rates.
+ *
+ * @property {number} packets
+ * The amount of packets that have been received or sent.
+ *
+ * @property {number} bytes
+ * The amount of bytes that have been received or sent.
+ *
+ * @property {number} [failed]
+ * The amount of failed tranmission attempts. Only applicable to
+ * transmit rates.
+ *
+ * @property {number} [retries]
+ * The amount of retried transmissions. Only applicable to transmit
+ * rates.
+ *
+ * @property {boolean} is_ht
+ * Specifies whether this rate is an HT (IEEE 802.11n) rate.
+ *
+ * @property {boolean} is_vht
+ * Specifies whether this rate is an VHT (IEEE 802.11ac) rate.
+ *
+ * @property {number} mhz
+ * The channel width in MHz used for the transmission.
+ *
+ * @property {number} rate
+ * The bitrate in bit/s of the transmission.
+ *
+ * @property {number} [mcs]
+ * The MCS index of the used transmission rate. Only applicable to
+ * HT or VHT rates.
+ *
+ * @property {number} [40mhz]
+ * Specifies whether the tranmission rate used 40MHz wide channel.
+ * Only applicable to HT or VHT rates.
+ *
+ * Note: this option exists for backwards compatibility only and its
+ * use is discouraged. The `mhz` field should be used instead to
+ * determine the channel width.
+ *
+ * @property {boolean} [short_gi]
+ * Specifies whether a short guard interval is used for the transmission.
+ * Only applicable to HT or VHT rates.
+ *
+ * @property {number} [nss]
+ * Specifies the number of spatial streams used by the transmission.
+ * Only applicable to VHT rates.
+ */
+
+ /**
+ * Fetch the list of associated peers.
+ *
+ * @returns {Promise<Array<LuCI.network.WifiPeerEntry>>}
+ * Returns a promise resolving to an array of wireless peers associated
+ * with this network.
+ */
getAssocList: function() {
- return callIwinfoAssoclist(this.getIfname());
+ var tasks = [];
+ var ifnames = [ this.getIfname() ].concat(this.getVlanIfnames());
+
+ for (var i = 0; i < ifnames.length; i++)
+ tasks.push(callIwinfoAssoclist(ifnames[i]));
+
+ return Promise.all(tasks).then(function(values) {
+ return Array.prototype.concat.apply([], values);
+ });
},
+ /**
+ * Query the current operating frequency of the wireless network.
+ *
+ * @returns {null|string}
+ * Returns the current operating frequency of the network from `ubus`
+ * runtime information in GHz or `null` if the information is not
+ * available.
+ */
getFrequency: function() {
var freq = this.ubus('net', 'iwinfo', 'frequency');
return null;
},
+ /**
+ * Query the current average bitrate of all peers associated to this
+ * wireless network.
+ *
+ * @returns {null|number}
+ * Returns the average bit rate among all peers associated to the network
+ * as reported by `ubus` runtime information or `null` if the information
+ * is not available.
+ */
getBitRate: function() {
var rate = this.ubus('net', 'iwinfo', 'bitrate');
return null;
},
+ /**
+ * Query the current wireless channel.
+ *
+ * @returns {null|number}
+ * Returns the wireless channel as reported by `ubus` runtime information
+ * or `null` if it cannot be determined.
+ */
getChannel: function() {
return this.ubus('net', 'iwinfo', 'channel') || this.ubus('dev', 'config', 'channel') || this.get('channel');
},
+ /**
+ * Query the current wireless signal.
+ *
+ * @returns {null|number}
+ * Returns the wireless signal in dBm as reported by `ubus` runtime
+ * information or `null` if it cannot be determined.
+ */
getSignal: function() {
return this.ubus('net', 'iwinfo', 'signal') || 0;
},
+ /**
+ * Query the current radio noise floor.
+ *
+ * @returns {number}
+ * Returns the radio noise floor in dBm as reported by `ubus` runtime
+ * information or `0` if it cannot be determined.
+ */
getNoise: function() {
return this.ubus('net', 'iwinfo', 'noise') || 0;
},
+ /**
+ * Query the current country code.
+ *
+ * @returns {string}
+ * Returns the wireless country code as reported by `ubus` runtime
+ * information or `00` if it cannot be determined.
+ */
getCountryCode: function() {
return this.ubus('net', 'iwinfo', 'country') || this.ubus('dev', 'config', 'country') || '00';
},
+ /**
+ * Query the current radio TX power.
+ *
+ * @returns {null|number}
+ * Returns the wireless network transmit power in dBm as reported by
+ * `ubus` runtime information or `null` if it cannot be determined.
+ */
getTXPower: function() {
return this.ubus('net', 'iwinfo', 'txpower');
},
+ /**
+ * Query the radio TX power offset.
+ *
+ * Some wireless radios have a fixed power offset, e.g. due to the
+ * use of external amplifiers.
+ *
+ * @returns {number}
+ * Returns the wireless network transmit power offset in dBm as reported
+ * by `ubus` runtime information or `0` if there is no offset, or if it
+ * cannot be determined.
+ */
getTXPowerOffset: function() {
return this.ubus('net', 'iwinfo', 'txpower_offset') || 0;
},
+ /**
+ * Calculate the current signal.
+ *
+ * @deprecated
+ * @returns {number}
+ * Returns the calculated signal level, which is the difference between
+ * noise and signal (SNR), divided by 5.
+ */
getSignalLevel: function(signal, noise) {
if (this.getActiveBSSID() == '00:00:00:00:00:00')
return -1;
return 0;
},
+ /**
+ * Calculate the current signal quality percentage.
+ *
+ * @returns {number}
+ * Returns the calculated signal quality in percent. The value is
+ * calculated from the `quality` and `quality_max` indicators reported
+ * by `ubus` runtime state.
+ */
getSignalPercent: function() {
var qc = this.ubus('net', 'iwinfo', 'quality') || 0,
qm = this.ubus('net', 'iwinfo', 'quality_max') || 0;
return 0;
},
+ /**
+ * Get a short description string for this wireless network.
+ *
+ * @returns {string}
+ * Returns a string describing this network, consisting of the
+ * active operation mode, followed by either the SSID, BSSID or
+ * internal network ID, depending on which information is available.
+ */
getShortName: function() {
return '%s "%s"'.format(
this.getActiveModeI18n(),
this.getActiveSSID() || this.getActiveBSSID() || this.getID());
},
+ /**
+ * Get a description string for this wireless network.
+ *
+ * @returns {string}
+ * Returns a string describing this network, consisting of the
+ * term `Wireless Network`, followed by the active operation mode,
+ * the SSID, BSSID or internal network ID and the Linux network device
+ * name, depending on which information is available.
+ */
getI18n: function() {
return '%s: %s "%s" (%s)'.format(
_('Wireless Network'),
this.getIfname());
},
+ /**
+ * Get the primary logical interface this wireless network is attached to.
+ *
+ * @returns {null|LuCI.network.Protocol}
+ * Returns a `Network.Protocol` instance representing the logical
+ * interface or `null` if this network is not attached to any logical
+ * interface.
+ */
getNetwork: function() {
return this.getNetworks()[0];
},
+ /**
+ * Get the logical interfaces this wireless network is attached to.
+ *
+ * @returns {Array<LuCI.network.Protocol>}
+ * Returns an array of `Network.Protocol` instances representing the
+ * logical interfaces this wireless network is attached to.
+ */
getNetworks: function() {
var networkNames = this.getNetworkNames(),
networks = [];
if (uciInterface == null || uciInterface['.type'] != 'interface')
continue;
- networks.push(L.network.instantiateNetwork(networkNames[i]));
+ networks.push(Network.prototype.instantiateNetwork(networkNames[i]));
}
networks.sort(networkSort);
return networks;
},
+ /**
+ * Get the associated Linux network device.
+ *
+ * @returns {LuCI.network.Device}
+ * Returns a `Network.Device` instance representing the Linux network
+ * device associted with this wireless network.
+ */
getDevice: function() {
- return L.network.instantiateDevice(this.getIfname());
+ return Network.prototype.instantiateDevice(this.getIfname());
+ },
+
+ /**
+ * Check whether this wifi network supports deauthenticating clients.
+ *
+ * @returns {boolean}
+ * Returns `true` when this wifi network instance supports forcibly
+ * deauthenticating clients, otherwise `false`.
+ */
+ isClientDisconnectSupported: function() {
+ return L.isObject(this.ubus('hostapd', 'del_client'));
+ },
+
+ /**
+ * Forcibly disconnect the given client from the wireless network.
+ *
+ * @param {string} mac
+ * The MAC address of the client to disconnect.
+ *
+ * @param {boolean} [deauth=false]
+ * Specifies whether to deauthenticate (`true`) or disassociate (`false`)
+ * the client.
+ *
+ * @param {number} [reason=1]
+ * Specifies the IEEE 802.11 reason code to disassoc/deauth the client
+ * with. Default is `1` which corresponds to `Unspecified reason`.
+ *
+ * @param {number} [ban_time=0]
+ * Specifies the amount of milliseconds to ban the client from
+ * reconnecting. By default, no ban time is set which allows the client
+ * to reassociate / reauthenticate immediately.
+ *
+ * @returns {Promise<number>}
+ * Returns a promise resolving to the underlying ubus call result code
+ * which is typically `0`, even for not existing MAC addresses.
+ * The promise might reject with an error in case invalid arguments
+ * are passed.
+ */
+ disconnectClient: function(mac, deauth, reason, ban_time) {
+ if (reason == null || reason == 0)
+ reason = 1;
+
+ if (ban_time == 0)
+ ban_time = null;
+
+ return rpc.declare({
+ object: 'hostapd.%s'.format(this.getIfname()),
+ method: 'del_client',
+ params: [ 'addr', 'deauth', 'reason', 'ban_time' ]
+ })(mac, deauth, reason, ban_time);
}
});