network

The sos.management.network API groups together networking methods. For Wi-Fi setup, use the Wi-Fi API.

Network Management Capabilities

Capability	Description
NETWORK_INFO	If device supports returning network information

If you want to check if the device supports this capability, use sos.management.supports().

Methods

disableInterface()

The disableInterface() turns off a selected network interface.

warning

Don't use this method to disable Wi-Fi. Use Wi-Fi API to turn Wi-Fi on/off.

disableInterface(interfaceName: string): Promise<void>;

Params

Name	Type	Required	Description
interfaceName	string	Yes	The interface name which can be retrieved from the list of interfaces returned by listInterfaces()

Return value

A promise that resolves when the network interface is disabled.

Possible errors

• If the interface name is invalid.
• If the device does not support network management.

Example

await sos.management.network.disableInterface('eth0');

listInterfaces()

The listInterface() method returns a list of all network interfaces, and their information like MAC address, IP address, etc. Wi-Fi connection strength is described as a percentage in the range from 0 to 100, linearly converted from dBm -90 to -30, respectively, based on the platform.

listInterfaces(): Promise<INetworkInterface[]>;

Return value

Resolves to an array of network interfaces with their information.

Example

const interfaces = await sos.management.network.listInterfaces();
interfaces.forEach((iface) => {
   console.log(`Interface: ${iface.name}, IP: ${iface.ipAddress}, MAC: ${iface.macAddress}`);
});

GitHub Example

• Applet Example with Network Interfaces

setDHCP(interfaceName)

The setDHCP() method configures a selected network interface to use DHCP.

warning

Wi-Fi interface can be configured with this method, but it has to be first enabled via the Wi-Fi API.

setDHCP(interfaceName: string): Promise<void>;

Params

Name	Type	Required	Description
interfaceName	string	Yes	The interface name which can be retrieved from the list of interfaces returned by listInterfaces()

Return value

A promise that resolves when the network interface is set to use DHCP.

Example

await sos.management.network.setDHCP('eth0');

setManual(interfaceName, options)

The setManual() method manually configures a network interface.

warning

Wi-Fi interface can be configured with this method, but it has to be first enabled via the Wi-Fi API.

setManual(interfaceName: string, options: INetworkOptions): Promise<void>;

Params

Name	Type	Required	Description
interfaceName	string	Yes	The interface name which can be retrieved from the list of interfaces returned by listInterfaces()
options	INetworkOptions	Yes	The network configuration options.
options.localAddress	string	Yes	The local IP address to be set.
options.gateway	string	Yes	The gateway IP address to be set.
options.netmask	string	Yes	The netmask to be set.
options.dns	string[]	Yes	The DNS server array of IP addresses to be set.

Return value

A promise that resolves when the network is set.

Possible errors

• If the network options are invalid.
• If the device does not support network management.

getActiveInfo()

Deprecated

This method was deprecated. Use sos.management.network.listInterfaces() instead.

getActiveInfo(): Promise<INetworkInfo>;

setDHCP(networkInterface)

Deprecated

This method was deprecated. Use sos.management.network.setDHCP(interfaceName) instead.

setDHCP(networkInterface: NetworkInterface): Promise<void>;

setManual(options)

Deprecated

This method was deprecated. Use sos.management.network.setManual(interfaceName, options) instead.

setManual(options: INetworkOptionsLegacy): Promise<void>;