systeminformation
Version:
Advanced, lightweight system and OS information library
1,464 lines (1,375 loc) • 72.9 kB
JavaScript
'use strict';
// @ts-check
// ==================================================================================
// network.js
// ----------------------------------------------------------------------------------
// Description: System Information - library
// for Node.js
// Copyright: (c) 2014 - 2026
// Author: Sebastian Hildebrandt
// ----------------------------------------------------------------------------------
// License: MIT
// ==================================================================================
// 9. Network
// ----------------------------------------------------------------------------------
const os = require('os');
const exec = require('child_process').exec;
const execSync = require('child_process').execSync;
const fs = require('fs');
const util = require('./util');
const _platform = process.platform;
const _linux = _platform === 'linux' || _platform === 'android';
const _darwin = _platform === 'darwin';
const _windows = _platform === 'win32';
const _freebsd = _platform === 'freebsd';
const _openbsd = _platform === 'openbsd';
const _netbsd = _platform === 'netbsd';
const _sunos = _platform === 'sunos';
const _network = {};
let _default_iface = '';
let _ifaces = {};
let _dhcpNics = [];
let _networkInterfaces = [];
let _mac = {};
let pathToIp;
function getDefaultNetworkInterface() {
let ifacename = '';
let ifacenameFirst = '';
try {
const ifaces = os.networkInterfaces();
let scopeid = 9999;
// fallback - "first" external interface (sorted by scopeid)
for (let dev in ifaces) {
if ({}.hasOwnProperty.call(ifaces, dev)) {
ifaces[dev].forEach((details) => {
if (details && details.internal === false) {
ifacenameFirst = ifacenameFirst || dev; // fallback if no scopeid
if (details.scopeid && details.scopeid < scopeid) {
ifacename = dev;
scopeid = details.scopeid;
}
}
});
}
}
ifacename = ifacename || ifacenameFirst || '';
if (_windows) {
// https://www.inetdaemon.com/tutorials/internet/ip/routing/default_route.shtml
let defaultIp = '';
const cmd = 'netstat -r';
const result = execSync(cmd, util.execOptsWin);
const lines = result.toString().split(os.EOL);
lines.forEach((line) => {
line = line.replace(/\s+/g, ' ').trim();
if (line.indexOf('0.0.0.0 0.0.0.0') > -1 && !/[a-zA-Z]/.test(line)) {
const parts = line.split(' ');
if (parts.length >= 5) {
defaultIp = parts[parts.length - 2];
}
}
});
if (defaultIp) {
for (let dev in ifaces) {
if ({}.hasOwnProperty.call(ifaces, dev)) {
ifaces[dev].forEach((details) => {
if (details && details.address && details.address === defaultIp) {
ifacename = dev;
}
});
}
}
}
}
if (_linux) {
const cmd = 'ip route 2> /dev/null | grep default';
const result = execSync(cmd, util.execOptsLinux);
const parts = result.toString().split('\n')[0].split(/\s+/);
if (parts[0] === 'none' && parts[5]) {
ifacename = parts[5];
} else if (parts[4]) {
ifacename = parts[4];
}
if (ifacename.indexOf(':') > -1) {
ifacename = ifacename.split(':')[1].trim();
}
}
if (_darwin || _freebsd || _openbsd || _netbsd || _sunos) {
let cmd = '';
if (_linux) {
cmd = "ip route 2> /dev/null | grep default | awk '{print $5}'";
}
if (_darwin) {
cmd = "route -n get default 2>/dev/null | grep interface: | awk '{print $2}'";
}
if (_freebsd || _openbsd || _netbsd || _sunos) {
cmd = 'route get 0.0.0.0 | grep interface:';
}
const result = execSync(cmd);
ifacename = result.toString().split('\n')[0];
if (ifacename.indexOf(':') > -1) {
ifacename = ifacename.split(':')[1].trim();
}
}
} catch (e) {
util.noop();
}
if (ifacename) {
_default_iface = ifacename;
}
return _default_iface;
}
exports.getDefaultNetworkInterface = getDefaultNetworkInterface;
function getMacAddresses() {
let iface = '';
let mac = '';
const result = {};
if (_linux || _freebsd || _openbsd || _netbsd) {
if (typeof pathToIp === 'undefined') {
try {
const lines = execSync('which ip', util.execOptsLinux).toString().split('\n');
if (lines.length && lines[0].indexOf(':') === -1 && lines[0].indexOf('/') === 0) {
pathToIp = lines[0];
} else {
pathToIp = '';
}
} catch (e) {
pathToIp = '';
}
}
try {
const cmd = 'export LC_ALL=C; ' + (pathToIp ? pathToIp + ' link show up' : '/sbin/ifconfig') + '; unset LC_ALL';
const res = execSync(cmd, util.execOptsLinux);
const lines = res.toString().split('\n');
for (let i = 0; i < lines.length; i++) {
if (lines[i] && lines[i][0] !== ' ') {
if (pathToIp) {
const nextline = lines[i + 1].trim().split(' ');
if (nextline[0] === 'link/ether') {
iface = lines[i].split(' ')[1];
iface = iface.slice(0, iface.length - 1);
mac = nextline[1];
}
} else {
iface = lines[i].split(' ')[0];
mac = lines[i].split('HWaddr ')[1];
}
if (iface && mac) {
result[iface] = mac.trim();
iface = '';
mac = '';
}
}
}
} catch (e) {
util.noop();
}
}
if (_darwin) {
try {
const cmd = '/sbin/ifconfig';
let res = execSync(cmd);
const lines = res.toString().split('\n');
for (let i = 0; i < lines.length; i++) {
if (lines[i] && lines[i][0] !== '\t' && lines[i].indexOf(':') > 0) {
iface = lines[i].split(':')[0];
} else if (lines[i].indexOf('\tether ') === 0) {
mac = lines[i].split('\tether ')[1];
if (iface && mac) {
result[iface] = mac.trim();
iface = '';
mac = '';
}
}
}
} catch (e) {
util.noop();
}
}
return result;
}
function networkInterfaceDefault(callback) {
return new Promise((resolve) => {
process.nextTick(() => {
const result = getDefaultNetworkInterface();
if (callback) {
callback(result);
}
resolve(result);
});
});
}
exports.networkInterfaceDefault = networkInterfaceDefault;
// --------------------------
// NET - interfaces
function parseLinesWindowsNics(sections, nconfigsections) {
const nics = [];
for (let i in sections) {
try {
if ({}.hasOwnProperty.call(sections, i)) {
if (sections[i].trim() !== '') {
let lines = sections[i].trim().split('\r\n');
let linesNicConfig = null;
try {
linesNicConfig = nconfigsections && nconfigsections[i] ? nconfigsections[i].trim().split('\r\n') : [];
} catch (e) {
util.noop();
}
const netEnabled = util.getValue(lines, 'NetEnabled', ':');
let adapterType = util.getValue(lines, 'AdapterTypeID', ':') === '9' ? 'wireless' : 'wired';
const ifacename = util.getValue(lines, 'Name', ':').replace(/\]/g, ')').replace(/\[/g, '(');
const iface = util.getValue(lines, 'NetConnectionID', ':').replace(/\]/g, ')').replace(/\[/g, '(');
if (ifacename.toLowerCase().indexOf('wi-fi') >= 0 || ifacename.toLowerCase().indexOf('wireless') >= 0) {
adapterType = 'wireless';
}
if (netEnabled !== '') {
const speed = parseInt(util.getValue(lines, 'speed', ':').trim(), 10) / 1000000;
nics.push({
mac: util.getValue(lines, 'MACAddress', ':').toLowerCase(),
dhcp: util.getValue(linesNicConfig, 'dhcpEnabled', ':').toLowerCase() === 'true',
name: ifacename,
iface,
netEnabled: netEnabled === 'TRUE',
speed: isNaN(speed) ? null : speed,
operstate: util.getValue(lines, 'NetConnectionStatus', ':') === '2' ? 'up' : 'down',
type: adapterType
});
}
}
}
} catch (e) {
util.noop();
}
}
return nics;
}
function getWindowsNics() {
return new Promise((resolve) => {
process.nextTick(() => {
let cmd = 'Get-CimInstance Win32_NetworkAdapter | fl *' + "; echo '#-#-#-#';";
cmd += 'Get-CimInstance Win32_NetworkAdapterConfiguration | fl DHCPEnabled' + '';
try {
util.powerShell(cmd).then((data) => {
data = data.split('#-#-#-#');
const nsections = (data[0] || '').split(/\n\s*\n/);
const nconfigsections = (data[1] || '').split(/\n\s*\n/);
resolve(parseLinesWindowsNics(nsections, nconfigsections));
});
} catch (e) {
resolve([]);
}
});
});
}
function getWindowsDNSsuffixes() {
let iface = {};
let dnsSuffixes = {
primaryDNS: '',
exitCode: 0,
ifaces: []
};
try {
const ipconfig = execSync('ipconfig /all', util.execOptsWin);
const ipconfigArray = ipconfig.split('\r\n\r\n');
ipconfigArray.forEach((element, index) => {
if (index === 1) {
const longPrimaryDNS = element.split('\r\n').filter((element) => {
return element.toUpperCase().includes('DNS');
});
const primaryDNS = longPrimaryDNS[0].substring(longPrimaryDNS[0].lastIndexOf(':') + 1);
dnsSuffixes.primaryDNS = primaryDNS.trim();
if (!dnsSuffixes.primaryDNS) {
dnsSuffixes.primaryDNS = 'Not defined';
}
}
if (index > 1) {
if (index % 2 === 0) {
const name = element.substring(element.lastIndexOf(' ') + 1).replace(':', '');
iface.name = name;
} else {
const connectionSpecificDNS = element.split('\r\n').filter((element) => {
return element.toUpperCase().includes('DNS');
});
const dnsSuffix = connectionSpecificDNS[0].substring(connectionSpecificDNS[0].lastIndexOf(':') + 1);
iface.dnsSuffix = dnsSuffix.trim();
dnsSuffixes.ifaces.push(iface);
iface = {};
}
}
});
return dnsSuffixes;
} catch (error) {
return {
primaryDNS: '',
exitCode: 0,
ifaces: []
};
}
}
function getWindowsIfaceDNSsuffix(ifaces, ifacename) {
let dnsSuffix = '';
// Adding (.) to ensure ifacename compatibility when duplicated iface-names
const interfaceName = ifacename + '.';
try {
const connectionDnsSuffix = ifaces
.filter((iface) => {
return interfaceName.includes(iface.name + '.');
})
.map((iface) => iface.dnsSuffix);
if (connectionDnsSuffix[0]) {
dnsSuffix = connectionDnsSuffix[0];
}
if (!dnsSuffix) {
dnsSuffix = '';
}
return dnsSuffix;
} catch (error) {
return 'Unknown';
}
}
function getWindowsWiredProfilesInformation() {
try {
const result = execSync('netsh lan show profiles', util.execOptsWin);
const profileList = result.split('\r\nProfile on interface');
return profileList;
} catch (error) {
if (error.status === 1 && error.stdout.includes('AutoConfig')) {
return 'Disabled';
}
return [];
}
}
function getWindowsWirelessIfaceSSID(interfaceName) {
try {
const result = execSync(`netsh wlan show interface name="${interfaceName}" | findstr "SSID"`, util.execOptsWin);
const SSID = result.split('\r\n').shift();
const parseSSID = SSID.split(':').pop().trim();
return parseSSID;
} catch (error) {
return 'Unknown';
}
}
function getWindowsIEEE8021x(connectionType, iface, ifaces) {
let i8021x = {
state: 'Unknown',
protocol: 'Unknown'
};
if (ifaces === 'Disabled') {
i8021x.state = 'Disabled';
i8021x.protocol = 'Not defined';
return i8021x;
}
if (connectionType === 'wired' && ifaces.length > 0) {
try {
// Get 802.1x information by interface name
const iface8021xInfo = ifaces.find((element) => {
return element.includes(iface + '\r\n');
});
const arrayIface8021xInfo = iface8021xInfo.split('\r\n');
const state8021x = arrayIface8021xInfo.find((element) => {
return element.includes('802.1x');
});
if (state8021x.includes('Disabled')) {
i8021x.state = 'Disabled';
i8021x.protocol = 'Not defined';
} else if (state8021x.includes('Enabled')) {
const protocol8021x = arrayIface8021xInfo.find((element) => {
return element.includes('EAP');
});
i8021x.protocol = protocol8021x.split(':').pop();
i8021x.state = 'Enabled';
}
} catch (error) {
return i8021x;
}
} else if (connectionType === 'wireless') {
let i8021xState = '';
let i8021xProtocol = '';
try {
const SSID = getWindowsWirelessIfaceSSID(iface);
if (SSID !== 'Unknown') {
let ifaceSanitized = '';
const s = util.isPrototypePolluted() ? '---' : util.sanitizeShellString(SSID);
const l = util.mathMin(s.length, 32);
for (let i = 0; i <= l; i++) {
if (s[i] !== undefined) {
ifaceSanitized = ifaceSanitized + s[i];
}
}
i8021xState = execSync(`netsh wlan show profiles "${ifaceSanitized}" | findstr "802.1X"`, util.execOptsWin);
i8021xProtocol = execSync(`netsh wlan show profiles "${ifaceSanitized}" | findstr "EAP"`, util.execOptsWin);
}
if (i8021xState.includes(':') && i8021xProtocol.includes(':')) {
i8021x.state = i8021xState.split(':').pop();
i8021x.protocol = i8021xProtocol.split(':').pop();
}
} catch (error) {
if (error.status === 1 && error.stdout.includes('AutoConfig')) {
i8021x.state = 'Disabled';
i8021x.protocol = 'Not defined';
}
return i8021x;
}
}
return i8021x;
}
function splitSectionsNics(lines) {
const result = [];
let section = [];
lines.forEach((line) => {
if (!line.startsWith('\t') && !line.startsWith(' ')) {
if (section.length) {
result.push(section);
section = [];
}
}
section.push(line);
});
if (section.length) {
result.push(section);
}
return result;
}
function parseLinesDarwinNics(sections) {
let nics = [];
sections.forEach((section) => {
let nic = {
iface: '',
mtu: null,
mac: '',
ip6: '',
ip4: '',
speed: null,
type: '',
operstate: '',
duplex: '',
internal: false
};
const first = section[0];
nic.iface = first.split(':')[0].trim();
const parts = first.split('> mtu');
nic.mtu = parts.length > 1 ? parseInt(parts[1], 10) : null;
if (isNaN(nic.mtu)) {
nic.mtu = null;
}
nic.internal = parts[0].toLowerCase().indexOf('loopback') > -1;
section.forEach((line) => {
if (line.trim().startsWith('ether ')) {
nic.mac = line.split('ether ')[1].toLowerCase().trim();
}
if (line.trim().startsWith('inet6 ') && !nic.ip6) {
nic.ip6 = line.split('inet6 ')[1].toLowerCase().split('%')[0].split(' ')[0];
}
if (line.trim().startsWith('inet ') && !nic.ip4) {
nic.ip4 = line.split('inet ')[1].toLowerCase().split(' ')[0];
}
});
let speed = util.getValue(section, 'link rate');
nic.speed = speed ? parseFloat(speed) : null;
if (nic.speed === null) {
speed = util.getValue(section, 'uplink rate');
nic.speed = speed ? parseFloat(speed) : null;
if (nic.speed !== null && speed.toLowerCase().indexOf('gbps') >= 0) {
nic.speed = nic.speed * 1000;
}
} else {
if (speed.toLowerCase().indexOf('gbps') >= 0) {
nic.speed = nic.speed * 1000;
}
}
nic.type = util.getValue(section, 'type').toLowerCase().indexOf('wi-fi') > -1 ? 'wireless' : 'wired';
const operstate = util.getValue(section, 'status').toLowerCase();
nic.operstate = operstate === 'active' ? 'up' : operstate === 'inactive' ? 'down' : 'unknown';
nic.duplex = util.getValue(section, 'media').toLowerCase().indexOf('half-duplex') > -1 ? 'half' : 'full';
if (nic.ip6 || nic.ip4 || nic.mac) {
nics.push(nic);
}
});
return nics;
}
function getDarwinNics() {
const cmd = '/sbin/ifconfig -v';
try {
const lines = execSync(cmd, { maxBuffer: 1024 * 102400 })
.toString()
.split('\n');
const nsections = splitSectionsNics(lines);
return parseLinesDarwinNics(nsections);
} catch {
return [];
}
}
function getLinuxIfaceConnectionName(interfaceName) {
const cmd = `nmcli device status 2>/dev/null | grep ${interfaceName}`;
try {
const result = execSync(cmd, util.execOptsLinux).toString();
const resultFormat = result.replace(/\s+/g, ' ').trim();
const connectionNameLines = resultFormat.split(' ').slice(3);
const connectionName = connectionNameLines.join(' ');
return connectionName !== '--' ? connectionName : '';
} catch {
return '';
}
}
function checkLinuxDCHPInterfaces(file) {
let result = [];
try {
const cmd = `cat ${file} 2> /dev/null | grep 'iface\\|source'`;
const lines = execSync(cmd, util.execOptsLinux).toString().split('\n');
lines.forEach((line) => {
const parts = line.replace(/\s+/g, ' ').trim().split(' ');
if (parts.length >= 4) {
if (line.toLowerCase().indexOf(' inet ') >= 0 && line.toLowerCase().indexOf('dhcp') >= 0) {
result.push(parts[1]);
}
}
if (line.toLowerCase().includes('source')) {
const file = line.split(' ')[1];
result = result.concat(checkLinuxDCHPInterfaces(file));
}
});
} catch {
util.noop();
}
return result;
}
function getLinuxDHCPNics() {
// alternate methods getting interfaces using DHCP
const cmd = 'ip a 2> /dev/null';
let result = [];
try {
const lines = execSync(cmd, util.execOptsLinux).toString().split('\n');
const nsections = splitSectionsNics(lines);
result = parseLinuxDHCPNics(nsections);
} catch {
util.noop();
}
try {
result = checkLinuxDCHPInterfaces('/etc/network/interfaces');
} catch {
util.noop();
}
return result;
}
function parseLinuxDHCPNics(sections) {
const result = [];
if (sections && sections.length) {
sections.forEach((lines) => {
if (lines && lines.length) {
const parts = lines[0].split(':');
if (parts.length > 2) {
for (let line of lines) {
if (line.indexOf(' inet ') >= 0 && line.indexOf(' dynamic ') >= 0) {
const parts2 = line.split(' ');
const nic = parts2[parts2.length - 1].trim();
result.push(nic);
break;
}
}
}
}
});
}
return result;
}
function getLinuxIfaceDHCPstatus(iface, connectionName, DHCPNics) {
let result = false;
if (connectionName) {
const cmd = `nmcli connection show "${connectionName}" 2>/dev/null | grep ipv4.method;`;
try {
const lines = execSync(cmd, util.execOptsLinux).toString();
const resultFormat = lines.replace(/\s+/g, ' ').trim();
const dhcStatus = resultFormat.split(' ').slice(1).toString();
switch (dhcStatus) {
case 'auto':
result = true;
break;
default:
result = false;
break;
}
return result;
} catch {
return DHCPNics.indexOf(iface) >= 0;
}
} else {
return DHCPNics.indexOf(iface) >= 0;
}
}
function getDarwinIfaceDHCPstatus(iface) {
let result = false;
const cmd = `ipconfig getpacket "${iface}" 2>/dev/null | grep lease_time;`;
try {
const lines = execSync(cmd).toString().split('\n');
if (lines.length && lines[0].startsWith('lease_time')) {
result = true;
}
} catch {
util.noop();
}
return result;
}
function getLinuxIfaceDNSsuffix(connectionName) {
if (connectionName) {
const cmd = `nmcli connection show "${connectionName}" 2>/dev/null | grep ipv4.dns-search;`;
try {
const result = execSync(cmd, util.execOptsLinux).toString();
const resultFormat = result.replace(/\s+/g, ' ').trim();
const dnsSuffix = resultFormat.split(' ').slice(1).toString();
return dnsSuffix === '--' ? 'Not defined' : dnsSuffix;
} catch {
return 'Unknown';
}
} else {
return 'Unknown';
}
}
function getLinuxIfaceIEEE8021xAuth(connectionName) {
if (connectionName) {
const cmd = `nmcli connection show "${connectionName}" 2>/dev/null | grep 802-1x.eap;`;
try {
const result = execSync(cmd, util.execOptsLinux).toString();
const resultFormat = result.replace(/\s+/g, ' ').trim();
const authenticationProtocol = resultFormat.split(' ').slice(1).toString();
return authenticationProtocol === '--' ? '' : authenticationProtocol;
} catch {
return 'Not defined';
}
} else {
return 'Not defined';
}
}
function getLinuxIfaceIEEE8021xState(authenticationProtocol) {
if (authenticationProtocol) {
if (authenticationProtocol === 'Not defined') {
return 'Disabled';
}
return 'Enabled';
} else {
return 'Unknown';
}
}
function testVirtualNic(iface, ifaceName, mac) {
const virtualMacs = [
'00:00:00:00:00:00',
'00:03:FF',
'00:05:69',
'00:0C:29',
'00:0F:4B',
'00:13:07',
'00:13:BE',
'00:15:5d',
'00:16:3E',
'00:1C:42',
'00:21:F6',
'00:24:0B',
'00:50:56',
'00:A0:B1',
'00:E0:C8',
'08:00:27',
'0A:00:27',
'18:92:2C',
'16:DF:49',
'3C:F3:92',
'54:52:00',
'FC:15:97'
];
if (mac) {
return (
virtualMacs.filter((item) => {
return mac.toUpperCase().toUpperCase().startsWith(item.substring(0, mac.length));
}).length > 0 ||
iface.toLowerCase().indexOf(' virtual ') > -1 ||
ifaceName.toLowerCase().indexOf(' virtual ') > -1 ||
iface.toLowerCase().indexOf('vethernet ') > -1 ||
ifaceName.toLowerCase().indexOf('vethernet ') > -1 ||
iface.toLowerCase().startsWith('veth') ||
ifaceName.toLowerCase().startsWith('veth') ||
iface.toLowerCase().startsWith('vboxnet') ||
ifaceName.toLowerCase().startsWith('vboxnet')
);
} else {
return false;
}
}
function networkInterfaces(callback, rescan, defaultString) {
if (typeof callback === 'string') {
defaultString = callback;
rescan = true;
callback = null;
}
if (typeof callback === 'boolean') {
rescan = callback;
callback = null;
defaultString = '';
}
if (typeof rescan === 'undefined') {
rescan = true;
}
defaultString = defaultString || '';
defaultString = '' + defaultString;
return new Promise((resolve) => {
process.nextTick(() => {
const ifaces = os.networkInterfaces();
let result = [];
let nics = [];
let dnsSuffixes = [];
let nics8021xInfo = [];
// seperate handling in OSX
if (_darwin || _freebsd || _openbsd || _netbsd) {
if (JSON.stringify(ifaces) === JSON.stringify(_ifaces) && !rescan) {
// no changes - just return object
result = _networkInterfaces;
if (callback) {
callback(result);
}
resolve(result);
} else {
const defaultInterface = getDefaultNetworkInterface();
_ifaces = JSON.parse(JSON.stringify(ifaces));
nics = getDarwinNics();
nics.forEach((nic) => {
let ip4link = '';
let ip4linksubnet = '';
let ip6link = '';
let ip6linksubnet = '';
nic.ip4 = '';
nic.ip6 = '';
if ({}.hasOwnProperty.call(ifaces, nic.iface)) {
ifaces[nic.iface].forEach((details) => {
if (details.family === 'IPv4' || details.family === 4) {
if (!nic.ip4 && !nic.ip4.match(/^169.254/i)) {
nic.ip4 = details.address;
nic.ip4subnet = details.netmask;
}
if (nic.ip4.match(/^169.254/i)) {
ip4link = details.address;
ip4linksubnet = details.netmask;
}
}
if (details.family === 'IPv6' || details.family === 6) {
if (!nic.ip6 && !nic.ip6.match(/^fe80::/i)) {
nic.ip6 = details.address;
nic.ip6subnet = details.netmask;
}
if (nic.ip6.match(/^fe80::/i)) {
ip6link = details.address;
ip6linksubnet = details.netmask;
}
}
});
}
if (!nic.ip4 && ip4link) {
nic.ip4 = ip4link;
nic.ip4subnet = ip4linksubnet;
}
if (!nic.ip6 && ip6link) {
nic.ip6 = ip6link;
nic.ip6subnet = ip6linksubnet;
}
let ifaceSanitized = '';
const s = util.isPrototypePolluted() ? '---' : util.sanitizeShellString(nic.iface);
const l = util.mathMin(s.length, 2000);
for (let i = 0; i <= l; i++) {
if (s[i] !== undefined) {
ifaceSanitized = ifaceSanitized + s[i];
}
}
result.push({
iface: nic.iface,
ifaceName: nic.iface,
default: nic.iface === defaultInterface,
ip4: nic.ip4,
ip4subnet: nic.ip4subnet || '',
ip6: nic.ip6,
ip6subnet: nic.ip6subnet || '',
mac: nic.mac,
internal: nic.internal,
virtual: nic.internal ? false : testVirtualNic(nic.iface, nic.iface, nic.mac),
operstate: nic.operstate,
type: nic.type,
duplex: nic.duplex,
mtu: nic.mtu,
speed: nic.speed,
dhcp: getDarwinIfaceDHCPstatus(ifaceSanitized),
dnsSuffix: '',
ieee8021xAuth: '',
ieee8021xState: '',
carrierChanges: 0
});
});
_networkInterfaces = result;
if (defaultString.toLowerCase().indexOf('default') >= 0) {
result = result.filter((item) => item.default);
if (result.length > 0) {
result = result[0];
} else {
result = [];
}
}
if (callback) {
callback(result);
}
resolve(result);
}
}
if (_linux) {
if (JSON.stringify(ifaces) === JSON.stringify(_ifaces) && !rescan) {
// no changes - just return object
result = _networkInterfaces;
if (callback) {
callback(result);
}
resolve(result);
} else {
_ifaces = JSON.parse(JSON.stringify(ifaces));
_dhcpNics = getLinuxDHCPNics();
const defaultInterface = getDefaultNetworkInterface();
for (let dev in ifaces) {
let ip4 = '';
let ip4subnet = '';
let ip6 = '';
let ip6subnet = '';
let mac = '';
let duplex = '';
let mtu = '';
let speed = null;
let carrierChanges = 0;
let dhcp = false;
let dnsSuffix = '';
let ieee8021xAuth = '';
let ieee8021xState = '';
let type = '';
let ip4link = '';
let ip4linksubnet = '';
let ip6link = '';
let ip6linksubnet = '';
if ({}.hasOwnProperty.call(ifaces, dev)) {
const ifaceName = dev;
ifaces[dev].forEach((details) => {
if (details.family === 'IPv4' || details.family === 4) {
if (!ip4 && !ip4.match(/^169.254/i)) {
ip4 = details.address;
ip4subnet = details.netmask;
}
if (ip4.match(/^169.254/i)) {
ip4link = details.address;
ip4linksubnet = details.netmask;
}
}
if (details.family === 'IPv6' || details.family === 6) {
if (!ip6 && !ip6.match(/^fe80::/i)) {
ip6 = details.address;
ip6subnet = details.netmask;
}
if (ip6.match(/^fe80::/i)) {
ip6link = details.address;
ip6linksubnet = details.netmask;
}
}
mac = details.mac;
// fallback due to https://github.com/nodejs/node/issues/13581 (node 8.1 - node 8.2)
const nodeMainVersion = parseInt(process.versions.node.split('.'), 10);
if (mac.indexOf('00:00:0') > -1 && (_linux || _darwin) && !details.internal && nodeMainVersion >= 8 && nodeMainVersion <= 11) {
if (Object.keys(_mac).length === 0) {
_mac = getMacAddresses();
}
mac = _mac[dev] || '';
}
});
if (!ip4 && ip4link) {
ip4 = ip4link;
ip4subnet = ip4linksubnet;
}
if (!ip6 && ip6link) {
ip6 = ip6link;
ip6subnet = ip6linksubnet;
}
const iface = dev.split(':')[0].trim().toLowerCase();
let ifaceSanitized = '';
const s = util.isPrototypePolluted() ? '---' : util.sanitizeShellString(iface);
const l = util.mathMin(s.length, 2000);
for (let i = 0; i <= l; i++) {
if (s[i] !== undefined) {
ifaceSanitized = ifaceSanitized + s[i];
}
}
const cmd = `echo -n "addr_assign_type: "; cat /sys/class/net/${ifaceSanitized}/addr_assign_type 2>/dev/null; echo;
echo -n "address: "; cat /sys/class/net/${ifaceSanitized}/address 2>/dev/null; echo;
echo -n "addr_len: "; cat /sys/class/net/${ifaceSanitized}/addr_len 2>/dev/null; echo;
echo -n "broadcast: "; cat /sys/class/net/${ifaceSanitized}/broadcast 2>/dev/null; echo;
echo -n "carrier: "; cat /sys/class/net/${ifaceSanitized}/carrier 2>/dev/null; echo;
echo -n "carrier_changes: "; cat /sys/class/net/${ifaceSanitized}/carrier_changes 2>/dev/null; echo;
echo -n "dev_id: "; cat /sys/class/net/${ifaceSanitized}/dev_id 2>/dev/null; echo;
echo -n "dev_port: "; cat /sys/class/net/${ifaceSanitized}/dev_port 2>/dev/null; echo;
echo -n "dormant: "; cat /sys/class/net/${ifaceSanitized}/dormant 2>/dev/null; echo;
echo -n "duplex: "; cat /sys/class/net/${ifaceSanitized}/duplex 2>/dev/null; echo;
echo -n "flags: "; cat /sys/class/net/${ifaceSanitized}/flags 2>/dev/null; echo;
echo -n "gro_flush_timeout: "; cat /sys/class/net/${ifaceSanitized}/gro_flush_timeout 2>/dev/null; echo;
echo -n "ifalias: "; cat /sys/class/net/${ifaceSanitized}/ifalias 2>/dev/null; echo;
echo -n "ifindex: "; cat /sys/class/net/${ifaceSanitized}/ifindex 2>/dev/null; echo;
echo -n "iflink: "; cat /sys/class/net/${ifaceSanitized}/iflink 2>/dev/null; echo;
echo -n "link_mode: "; cat /sys/class/net/${ifaceSanitized}/link_mode 2>/dev/null; echo;
echo -n "mtu: "; cat /sys/class/net/${ifaceSanitized}/mtu 2>/dev/null; echo;
echo -n "netdev_group: "; cat /sys/class/net/${ifaceSanitized}/netdev_group 2>/dev/null; echo;
echo -n "operstate: "; cat /sys/class/net/${ifaceSanitized}/operstate 2>/dev/null; echo;
echo -n "proto_down: "; cat /sys/class/net/${ifaceSanitized}/proto_down 2>/dev/null; echo;
echo -n "speed: "; cat /sys/class/net/${ifaceSanitized}/speed 2>/dev/null; echo;
echo -n "tx_queue_len: "; cat /sys/class/net/${ifaceSanitized}/tx_queue_len 2>/dev/null; echo;
echo -n "type: "; cat /sys/class/net/${ifaceSanitized}/type 2>/dev/null; echo;
echo -n "wireless: "; cat /proc/net/wireless 2>/dev/null | grep ${ifaceSanitized}; echo;
echo -n "wirelessspeed: "; iw dev ${ifaceSanitized} link 2>&1 | grep bitrate; echo;`;
let lines = [];
try {
lines = execSync(cmd, util.execOptsLinux).toString().split('\n');
const connectionName = getLinuxIfaceConnectionName(ifaceSanitized);
dhcp = getLinuxIfaceDHCPstatus(ifaceSanitized, connectionName, _dhcpNics);
dnsSuffix = getLinuxIfaceDNSsuffix(connectionName);
ieee8021xAuth = getLinuxIfaceIEEE8021xAuth(connectionName);
ieee8021xState = getLinuxIfaceIEEE8021xState(ieee8021xAuth);
} catch {
util.noop();
}
duplex = util.getValue(lines, 'duplex');
duplex = duplex.startsWith('cat') ? '' : duplex;
mtu = parseInt(util.getValue(lines, 'mtu'), 10);
let myspeed = parseInt(util.getValue(lines, 'speed'), 10);
speed = isNaN(myspeed) ? null : myspeed;
const wirelessspeed = util.getValue(lines, 'tx bitrate');
if (speed === null && wirelessspeed) {
myspeed = parseFloat(wirelessspeed);
speed = isNaN(myspeed) ? null : myspeed;
}
carrierChanges = parseInt(util.getValue(lines, 'carrier_changes'), 10);
const operstate = util.getValue(lines, 'operstate');
type = operstate === 'up' ? (util.getValue(lines, 'wireless').trim() ? 'wireless' : 'wired') : 'unknown';
if (ifaceSanitized === 'lo' || ifaceSanitized.startsWith('bond')) {
type = 'virtual';
}
let internal = ifaces[dev] && ifaces[dev][0] ? ifaces[dev][0].internal : false;
if (dev.toLowerCase().indexOf('loopback') > -1 || ifaceName.toLowerCase().indexOf('loopback') > -1) {
internal = true;
}
const virtual = internal ? false : testVirtualNic(dev, ifaceName, mac);
result.push({
iface: ifaceSanitized,
ifaceName,
default: iface === defaultInterface,
ip4,
ip4subnet,
ip6,
ip6subnet,
mac,
internal,
virtual,
operstate,
type,
duplex,
mtu,
speed,
dhcp,
dnsSuffix,
ieee8021xAuth,
ieee8021xState,
carrierChanges
});
}
}
_networkInterfaces = result;
if (defaultString.toLowerCase().indexOf('default') >= 0) {
result = result.filter((item) => item.default);
if (result.length > 0) {
result = result[0];
} else {
result = [];
}
}
if (callback) {
callback(result);
}
resolve(result);
}
}
if (_windows) {
if (JSON.stringify(ifaces) === JSON.stringify(_ifaces) && !rescan) {
// no changes - just return object
result = _networkInterfaces;
if (callback) {
callback(result);
}
resolve(result);
} else {
_ifaces = JSON.parse(JSON.stringify(ifaces));
const defaultInterface = getDefaultNetworkInterface();
getWindowsNics().then((nics) => {
nics.forEach((nic) => {
let found = false;
Object.keys(ifaces).forEach((key) => {
if (!found) {
ifaces[key].forEach((value) => {
if (Object.keys(value).indexOf('mac') >= 0) {
found = value['mac'] === nic.mac;
}
});
}
});
if (!found) {
ifaces[nic.name] = [{ mac: nic.mac }];
}
});
nics8021xInfo = getWindowsWiredProfilesInformation();
dnsSuffixes = getWindowsDNSsuffixes();
for (let dev in ifaces) {
let ifaceSanitized = '';
const s = util.isPrototypePolluted() ? '---' : util.sanitizeShellString(dev);
const l = util.mathMin(s.length, 2000);
for (let i = 0; i <= l; i++) {
if (s[i] !== undefined) {
ifaceSanitized = ifaceSanitized + s[i];
}
}
let iface = dev;
let ip4 = '';
let ip4subnet = '';
let ip6 = '';
let ip6subnet = '';
let mac = '';
let duplex = '';
let mtu = '';
let speed = null;
let carrierChanges = 0;
let operstate = 'down';
let dhcp = false;
let dnsSuffix = '';
let ieee8021xAuth = '';
let ieee8021xState = '';
let type = '';
if ({}.hasOwnProperty.call(ifaces, dev)) {
let ifaceName = dev;
ifaces[dev].forEach((details) => {
if (details.family === 'IPv4' || details.family === 4) {
ip4 = details.address;
ip4subnet = details.netmask;
}
if (details.family === 'IPv6' || details.family === 6) {
if (!ip6 || ip6.match(/^fe80::/i)) {
ip6 = details.address;
ip6subnet = details.netmask;
}
}
mac = details.mac;
// fallback due to https://github.com/nodejs/node/issues/13581 (node 8.1 - node 8.2)
const nodeMainVersion = parseInt(process.versions.node.split('.'), 10);
if (mac.indexOf('00:00:0') > -1 && (_linux || _darwin) && !details.internal && nodeMainVersion >= 8 && nodeMainVersion <= 11) {
if (Object.keys(_mac).length === 0) {
_mac = getMacAddresses();
}
mac = _mac[dev] || '';
}
});
dnsSuffix = getWindowsIfaceDNSsuffix(dnsSuffixes.ifaces, ifaceSanitized);
let foundFirst = false;
nics.forEach((detail) => {
if (detail.mac === mac && !foundFirst) {
iface = detail.iface || iface;
ifaceName = detail.name;
dhcp = detail.dhcp;
operstate = detail.operstate;
speed = operstate === 'up' ? detail.speed : 0;
type = detail.type;
foundFirst = true;
}
});
if (
dev.toLowerCase().indexOf('wlan') >= 0 ||
ifaceName.toLowerCase().indexOf('wlan') >= 0 ||
ifaceName.toLowerCase().indexOf('802.11n') >= 0 ||
ifaceName.toLowerCase().indexOf('wireless') >= 0 ||
ifaceName.toLowerCase().indexOf('wi-fi') >= 0 ||
ifaceName.toLowerCase().indexOf('wifi') >= 0
) {
type = 'wireless';
}
const IEEE8021x = getWindowsIEEE8021x(type, ifaceSanitized, nics8021xInfo);
ieee8021xAuth = IEEE8021x.protocol;
ieee8021xState = IEEE8021x.state;
let internal = ifaces[dev] && ifaces[dev][0] ? ifaces[dev][0].internal : false;
if (dev.toLowerCase().indexOf('loopback') > -1 || ifaceName.toLowerCase().indexOf('loopback') > -1) {
internal = true;
}
const virtual = internal ? false : testVirtualNic(dev, ifaceName, mac);
result.push({
iface,
ifaceName,
default: iface === defaultInterface,
ip4,
ip4subnet,
ip6,
ip6subnet,
mac,
internal,
virtual,
operstate,
type,
duplex,
mtu,
speed,
dhcp,
dnsSuffix,
ieee8021xAuth,
ieee8021xState,
carrierChanges
});
}
}
_networkInterfaces = result;
if (defaultString.toLowerCase().indexOf('default') >= 0) {
result = result.filter((item) => item.default);
if (result.length > 0) {
result = result[0];
} else {
result = [];
}
}
if (callback) {
callback(result);
}
resolve(result);
});
}
}
});
});
}
exports.networkInterfaces = networkInterfaces;
// --------------------------
// NET - Speed
function calcNetworkSpeed(iface, rx_bytes, tx_bytes, operstate, rx_dropped, rx_errors, tx_dropped, tx_errors) {
const result = {
iface,
operstate,
rx_bytes,
rx_dropped,
rx_errors,
tx_bytes,
tx_dropped,
tx_errors,
rx_sec: null,
tx_sec: null,
ms: 0
};
if (_network[iface] && _network[iface].ms) {
result.ms = Date.now() - _network[iface].ms;
result.rx_sec = rx_bytes - _network[iface].rx_bytes >= 0 ? (rx_bytes - _network[iface].rx_bytes) / (result.ms / 1000) : 0;
result.tx_sec = tx_bytes - _network[iface].tx_bytes >= 0 ? (tx_bytes - _network[iface].tx_bytes) / (result.ms / 1000) : 0;
_network[iface].rx_bytes = rx_bytes;
_network[iface].tx_bytes = tx_bytes;
_network[iface].rx_sec = result.rx_sec;
_network[iface].tx_sec = result.tx_sec;
_network[iface].ms = Date.now();
_network[iface].last_ms = result.ms;
_network[iface].operstate = operstate;
} else {
if (!_network[iface]) {
_network[iface] = {};
}
_network[iface].rx_bytes = rx_bytes;
_network[iface].tx_bytes = tx_bytes;
_network[iface].rx_sec = null;
_network[iface].tx_sec = null;
_network[iface].ms = Date.now();
_network[iface].last_ms = 0;
_network[iface].operstate = operstate;
}
return result;
}
function networkStats(ifaces, callback) {
let ifacesArray = [];
return new Promise((resolve) => {
process.nextTick(() => {
// fallback - if only callback is given
if (util.isFunction(ifaces) && !callback) {
callback = ifaces;
ifacesArray = [getDefaultNetworkInterface()];
} else {
if (typeof ifaces !== 'string' && ifaces !== undefined) {
if (callback) {
callback([]);
}
return resolve([]);
}
ifaces = ifaces || getDefaultNetworkInterface();
try {
ifaces.__proto__.toLowerCase = util.stringToLower;
ifaces.__proto__.replace = util.stringReplace;
ifaces.__proto__.toString = util.stringToString;
ifaces.__proto__.substr = util.stringSubstr;
ifaces.__proto__.substring = util.stringSubstring;
ifaces.__proto__.trim = util.stringTrim;
ifaces.__proto__.startsWith = util.stringStartWith;
} catch {
Object.setPrototypeOf(ifaces, util.stringObj);
}
ifaces = ifaces.trim().toLowerCase().replace(/,+/g, '|');
ifacesArray = ifaces.split('|');
}
const result = [];
const workload = [];
if (ifacesArray.length && ifacesArray[0].trim() === '*') {
ifacesArray = [];
networkInterfaces(false).then((allIFaces) => {
for (let iface of allIFaces) {
ifacesArray.push(iface.iface);
}
networkStats(ifacesArray.join(',')).then((result) => {
if (callback) {
callback(result);
}
resolve(result);
});
});
} else {
for (let iface of ifacesArray) {
workload.push(networkStatsSingle(iface.trim()));
}
if (workload.length) {
Promise.all(workload).then((data) => {
if (callback) {
callback(data);
}
resolve(data);
});
} else {
if (callback) {
callback(result);
}
resolve(result);
}
}
});
});
}
function networkStatsSingle(iface) {
function parseLinesWindowsPerfData(sections) {
let perfData = [];
for (let i in sections) {
if ({}.hasOwnProperty.call(sections, i)) {
if (sections[i].trim() !== '') {
let lines = sections[i].trim().split('\r\n');
perfData.push({
name: util
.getValue(lines, 'Name', ':')
.replace(/[()[\] ]+/g, '')
.replace(/#|\//g, '_')
.toLowerCase(),
rx_bytes: parseInt(util.getValue(lines, 'BytesReceivedPersec', ':'), 10),
rx_errors: parseInt(util.getValue(lines, 'PacketsReceivedErrors', ':'), 10),
rx_dropped: parseInt(util.getValue(lines, 'PacketsReceivedDiscarded', ':'), 10),
tx_bytes: parseInt(util.getValue(lines, 'BytesSentPersec', ':'), 10),
tx_errors: parseInt(util.getValue(lines, 'PacketsOutboundErrors', ':'), 10),
tx_dropped: parseInt(util.getValue(lines, 'PacketsOutboundDiscarded', ':'), 10)
});
}
}
}
return perfData;
}
return new Promise((resolve) => {
process.nextTick(() => {
let ifaceSanitized = '';
const s = util.isPrototypePolluted() ? '---' : util.sanitizeShellString(iface);
const l = util.mathMin(s.length, 2000);
for (let i = 0; i <= l; i++) {
if (s[i] !== undefined) {
ifaceSanitized = ifaceSanitized + s[i];
}
}
let result = {
iface: ifaceSanitized,
operstate: 'unknown',
rx_bytes: 0,
rx_dropped: 0,
rx_errors: 0,
tx_bytes: 0,
tx_dropped: 0,
tx_errors: 0,
rx_sec: null,
tx_sec: null,
ms: 0
};
let operstate = 'unknown';
let rx_bytes = 0;
let tx_bytes = 0;
let rx_dropped = 0;
let rx_errors = 0;
let tx_dropped = 0;
let tx_errors = 0;
let cmd, lines, stats;
if (
!_network[ifaceSanitized] ||
(_network[ifaceSanitized] && !_network[ifaceSanitized].ms) ||
(_network[ifaceSanitized] && _network[ifaceSanitized].ms && Date.now() - _network[ifaceSanitized].ms >= 500)
) {
if (_linux) {
if (fs.existsSync('/sys/class/net/' + ifaceSanitized)) {
cmd =
'cat /sys/class/net/' +
ifaceSanitized +
'/operstate; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/rx_bytes; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/tx_bytes; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/rx_dropped; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/rx_errors; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/tx_dropped; ' +
'cat /sys/class/net/' +
ifaceSanitized +
'/statistics/tx_errors; ';
exec(cmd, (error, stdout) => {
if (!error) {
lines = stdout.toString().split('\n');
operstate = lines[0].trim();
rx_bytes = parseInt(lines[1], 10);
tx_bytes = parseInt(lines[2], 10);
rx_dropped = parseInt(lines[3], 10);
rx_errors = parseInt(lines[4], 10);
tx_dropped = parseInt(lines[5], 10);
tx_errors = parseInt(lines[6], 10);
result = calcNetworkSpeed(ifaceSanitized, rx_bytes, tx_bytes, operstate, rx_dropped, rx_errors, tx_dropped, tx_errors);
}
resolve(result);
});
} else {
resolve(result);
}
}
if (_freebsd || _openbsd || _netbsd) {
cmd = 'netstat -ibndI ' + ifaceSanitized; // lgtm [js/shell-command-constructed-from-input]
exec(cmd, (error, stdout) => {
if (!error) {
lines = stdout.toString().split('\n');
for (let i = 1; i < lines.length; i++) {
const line = lines[i].replace(/ +/g, ' ').split(' ');
if (line && line[0] && line[7] && line[10]) {
rx_bytes = rx_bytes + parseInt(line[7]);
if (line[6].trim() !== '-') {
rx_dropped = rx_dropped + parseInt(line[6]);
}
if (line[5].trim() !== '-') {
rx_errors = rx_errors + parseInt(line[5]);
}
tx_bytes = tx_bytes + parseInt(line[10]);
if (line[12].trim() !== '-') {
tx_dropped = tx_dropped + parseInt(line[12]);
}
if (line[9].trim() !== '-') {
tx_errors = tx_errors + parseInt(line[9]);
}