NetworkManager

Classes
class	AccessPoint

class	ActiveConnection

class	AdslDevice

class	AdslSetting

class	BluetoothDevice

class	BluetoothSetting

class	BondDevice

class	BondSetting

class	BridgeDevice

class	BridgePortSetting

class	BridgeSetting

class	CdmaSetting

class	Connection

class	ConnectionSettings

class	DcbSetting

class	Device

class	DeviceStatistics

class	Dhcp4Config

class	Dhcp6Config

class	DnsConfiguration

class	DnsDomain

class	GenericDevice

class	GenericSetting

class	GreDevice

class	GsmSetting

class	InfinibandDevice

class	InfinibandSetting

class	IpAddress

class	IpConfig

class	IpRoute

class	IpTunnelDevice

class	IpTunnelSetting

class	Ipv4Setting

class	Ipv6Setting

class	MacsecSetting

class	MacVlanDevice

class	MatchSetting

class	ModemDevice

class	OlpcMeshDevice

class	OlpcMeshSetting

class	OvsBridgeSetting

class	OvsInterfaceSetting

class	OvsPatchSetting

class	OvsPortSetting

class	PppoeSetting

class	PppSetting

class	ProxySetting

class	SecretAgent

class	Security8021xSetting

class	SerialSetting

class	Setting

class	SettingsNotifier

class	TcSetting

class	TeamDevice

class	TeamPortSetting

class	TeamSetting

class	TemplateSetting

class	TunDevice

class	TunSetting

class	UserSetting

class	VethDevice

class	VlanDevice

class	VlanSetting

class	VpnConnection

class	VpnSetting

class	VxlanSetting

class	WimaxDevice

class	WimaxNsp

class	WimaxSetting

class	WiredDevice

class	WiredSetting

class	WireGuardDevice

class	WireGuardSetting

class	WirelessDevice

class	WirelessNetwork

class	WirelessSecuritySetting

class	WirelessSetting

Typedefs
typedef QList< IpAddress >	IpAddresses

typedef QList< IpRoute >	IpRoutes

typedef QFlags< LogDomain >	LogDomains

Enumerations
enum	Connectivity { UnknownConnectivity = 0, NoConnectivity = 1, Portal = 2, Limited = 3, Full = 4 }

enum	LogDomain { NoChange, None, Hardware, RFKill, Ethernet, WiFi, Bluetooth, MobileBroadBand, DHCP4, DHCP6, PPP, WiFiScan, IPv4, IPv6, AutoIPv4, DNS, VPN, Sharing, Supplicant, UserSet, SysSet, Suspend, Core, Devices, OLPC, Wimax, Infiniband, Firewall, Adsl, Bond, Vlan, Agents, Settings, Bridge, DbusProps, Team, ConCheck, Dcb, Dispatch }

enum	LogLevel { Error, Warning, Info, Debug, Trace }

enum	Status { Unknown, Asleep, Disconnected, Disconnecting, Connecting, ConnectedLinkLocal, ConnectedSiteOnly, Connected }

enum	WirelessSecurityType { UnknownSecurity = -1, NoneSecurity, StaticWep, DynamicWep, Leap, WpaPsk, WpaEap, Wpa2Psk, Wpa2Eap, SAE, Wpa3SuiteB192 }

Functions
NETWORKMANAGERQT_EXPORT QDBusPendingReply< QDBusObjectPath >	activateConnection (const QString &connectionUni, const QString &interfaceUni, const QString &connectionParameter)

NETWORKMANAGERQT_EXPORT ActiveConnection::Ptr	activatingConnection ()

NETWORKMANAGERQT_EXPORT ActiveConnection::List	activeConnections ()

NETWORKMANAGERQT_EXPORT QStringList	activeConnectionsPaths ()

NETWORKMANAGERQT_EXPORT QDBusPendingReply< QDBusObjectPath, QDBusObjectPath >	addAndActivateConnection (const NMVariantMapMap &connection, const QString &interfaceUni, const QString &connectionParameter)

NETWORKMANAGERQT_EXPORT QDBusPendingReply< QDBusObjectPath, QDBusObjectPath, QVariantMap >	addAndActivateConnection2 (const NMVariantMapMap &connection, const QString &interfaceUni, const QString &connectionParameter, const QVariantMap &options)

NETWORKMANAGERQT_EXPORT QDBusPendingReply< QDBusObjectPath >	addConnection (const NMVariantMapMap &settings)

NETWORKMANAGERQT_EXPORT QDBusPendingReply< QDBusObjectPath >	addConnectionUnsaved (const NMVariantMapMap &settings)

NETWORKMANAGERQT_EXPORT bool	canModify ()

NETWORKMANAGERQT_EXPORT QDBusPendingReply< uint >	checkConnectivity ()

NETWORKMANAGERQT_EXPORT bool	checkVersion (const int x, const int y, const int z)

NETWORKMANAGERQT_EXPORT QDateTime	clockBootTimeToDateTime (qlonglong clockBootime)

NETWORKMANAGERQT_EXPORT int	compareVersion (const int x, const int y, const int z)

NETWORKMANAGERQT_EXPORT int	compareVersion (const QString &version)

NETWORKMANAGERQT_EXPORT Connectivity	connectivity ()

NetworkManager::WimaxNsp::NetworkType	convertNetworkType (uint type)

NETWORKMANAGERQT_EXPORT QDBusPendingReply	deactivateConnection (const QString &activeConnection)

NETWORKMANAGERQT_EXPORT bool	deviceSupportsApCiphers (NetworkManager::WirelessDevice::Capabilities, NetworkManager::AccessPoint::WpaFlags ciphers, WirelessSecurityType type)

NETWORKMANAGERQT_EXPORT ActiveConnection::Ptr	findActiveConnection (const QString &uni)

NETWORKMANAGERQT_EXPORT WirelessSecurityType	findBestWirelessSecurity (NetworkManager::WirelessDevice::Capabilities, bool haveAp, bool adHoc, NetworkManager::AccessPoint::Capabilities apCaps, NetworkManager::AccessPoint::WpaFlags apWpa, NetworkManager::AccessPoint::WpaFlags apRsn)

NETWORKMANAGERQT_EXPORT int	findChannel (int freq)

NETWORKMANAGERQT_EXPORT NetworkManager::Connection::Ptr	findConnection (const QString &path)

NETWORKMANAGERQT_EXPORT NetworkManager::Connection::Ptr	findConnectionByUuid (const QString &uuid)

NETWORKMANAGERQT_EXPORT Device::Ptr	findDeviceByIpFace (const QString &iface)

NETWORKMANAGERQT_EXPORT NetworkManager::WirelessSetting::FrequencyBand	findFrequencyBand (int freq)

NETWORKMANAGERQT_EXPORT Device::Ptr	findNetworkInterface (const QString &uni)

NETWORKMANAGERQT_EXPORT QList< QPair< int, int > >	getAFreqs ()

NETWORKMANAGERQT_EXPORT QList< QPair< int, int > >	getBFreqs ()

NETWORKMANAGERQT_EXPORT QDBusPendingReply< QString, QString >	getLogging ()

NETWORKMANAGERQT_EXPORT NetworkManager::DnsConfiguration	globalDnsConfiguration ()

NETWORKMANAGERQT_EXPORT QString	hostname ()

NETWORKMANAGERQT_EXPORT QHostAddress	ipv6AddressAsHostAddress (const QByteArray &address)

NETWORKMANAGERQT_EXPORT QByteArray	ipv6AddressFromHostAddress (const QHostAddress &address)

NETWORKMANAGERQT_EXPORT bool	isNetworkingEnabled ()

NETWORKMANAGERQT_EXPORT bool	isStartingUp ()

NETWORKMANAGERQT_EXPORT bool	isWimaxEnabled ()

NETWORKMANAGERQT_EXPORT bool	isWimaxHardwareEnabled ()

NETWORKMANAGERQT_EXPORT bool	isWirelessEnabled ()

NETWORKMANAGERQT_EXPORT bool	isWirelessHardwareEnabled ()

NETWORKMANAGERQT_EXPORT bool	isWwanEnabled ()

NETWORKMANAGERQT_EXPORT bool	isWwanHardwareEnabled ()

NETWORKMANAGERQT_EXPORT NetworkManager::Connection::List	listConnections ()

NETWORKMANAGERQT_EXPORT QDBusPendingReply< bool, QStringList >	loadConnections (const QStringList &filenames)

NETWORKMANAGERQT_EXPORT QString	macAddressAsString (const QByteArray &ba)

NETWORKMANAGERQT_EXPORT QByteArray	macAddressFromString (const QString &s)

NETWORKMANAGERQT_EXPORT bool	macAddressIsValid (const QByteArray &macAddress)

NETWORKMANAGERQT_EXPORT bool	macAddressIsValid (const QString &macAddress)

NETWORKMANAGERQT_EXPORT NetworkManager::Device::MeteredStatus	metered ()

NETWORKMANAGERQT_EXPORT Device::List	networkInterfaces ()

NETWORKMANAGERQT_EXPORT Notifier *	notifier ()

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const AdslSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const BluetoothSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const BondSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const BridgePortSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const BridgeSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const CdmaSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const ConnectionSettings &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const DcbSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const GenericSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const GsmSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const InfinibandSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const IpTunnelSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const Ipv4Setting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const Ipv6Setting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const MacsecSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const MatchSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const OlpcMeshSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const OvsBridgeSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const OvsInterfaceSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const OvsPatchSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const OvsPortSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const PppoeSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const PppSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const ProxySetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const Security8021xSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const SerialSetting &setting)

QDebug	operator<< (QDebug dbg, const Setting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const TcSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const TeamPortSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const TeamSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const TemplateSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const TunSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const UserSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const VlanSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const VpnSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const VxlanSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const WimaxSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const WiredSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const WireGuardSetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const WirelessSecuritySetting &setting)

NETWORKMANAGERQT_EXPORT QDebug	operator<< (QDebug dbg, const WirelessSetting &setting)

NETWORKMANAGERQT_EXPORT NMStringMap	permissions ()

NETWORKMANAGERQT_EXPORT ActiveConnection::Ptr	primaryConnection ()

NETWORKMANAGERQT_EXPORT NetworkManager::ConnectionSettings::ConnectionType	primaryConnectionType ()

NETWORKMANAGERQT_EXPORT QDBusPendingReply< bool >	reloadConnections ()

NETWORKMANAGERQT_EXPORT void	saveHostname (const QString &hostname)

NETWORKMANAGERQT_EXPORT bool	securityIsValid (WirelessSecurityType type, NetworkManager::WirelessDevice::Capabilities interfaceCaps, bool haveAp, bool adHoc, NetworkManager::AccessPoint::Capabilities apCaps, NetworkManager::AccessPoint::WpaFlags apWpa, NetworkManager::AccessPoint::WpaFlags apRsn)

NETWORKMANAGERQT_EXPORT WirelessSecurityType	securityTypeFromConnectionSetting (const NetworkManager::ConnectionSettings::Ptr &settings)

NETWORKMANAGERQT_EXPORT void	setGlobalDnsConfiguration (const NetworkManager::DnsConfiguration &configuration)

NETWORKMANAGERQT_EXPORT void	setLogging (LogLevel, LogDomains)

NETWORKMANAGERQT_EXPORT void	setNetworkingEnabled (bool enabled)

NETWORKMANAGERQT_EXPORT SettingsNotifier *	settingsNotifier ()

NETWORKMANAGERQT_EXPORT void	setWimaxEnabled (bool enabled)

NETWORKMANAGERQT_EXPORT void	setWirelessEnabled (bool enabled)

NETWORKMANAGERQT_EXPORT void	setWwanEnabled (bool enabled)

NETWORKMANAGERQT_EXPORT void	sleep (bool sleep)

NETWORKMANAGERQT_EXPORT NetworkManager::Status	status ()

NETWORKMANAGERQT_EXPORT Device::Types	supportedInterfaceTypes ()

NETWORKMANAGERQT_EXPORT QString	version ()

NETWORKMANAGERQT_EXPORT bool	wepKeyIsValid (const QString &key, NetworkManager::WirelessSecuritySetting::WepKeyType type)

NETWORKMANAGERQT_EXPORT bool	wpaPskIsValid (const QString &psk)

Detailed Description

This class allows querying the underlying system to discover the available network interfaces and reachable networks.

It has also the responsibility to notify when a network interface appears or disappears.

It is the unique entry point for network management. Applications should use it to find network interfaces, or to be notified about network related changes.

Note that it is implemented as a singleton

Enumeration Type Documentation

◆ Connectivity

enum NetworkManager::Connectivity

Describes the network connectivity state.

Since: 0.9.9.0

Enumerator
UnknownConnectivity	Network connectivity is unknown.
NoConnectivity	The host is not connected to any network.
Portal	The host is behind a captive portal and cannot reach the full Internet.
Limited	The host is connected to a network, but does not appear to be able to reach the full Internet.
Full	The host is connected to a network, and appears to be able to reach the full Internet.

Definition at line 100 of file manager.h.

◆ LogLevel

enum NetworkManager::LogLevel

Enumerator
Trace	= Debug in runtime NM < 0.9.10

Definition at line 44 of file manager.h.

◆ Status

enum NetworkManager::Status

Enumerator
Unknown	the networking system is not active or unable to report its status - proceed with caution
Asleep	networking is inactive and all devices are disabled
Disconnected	the system is not connected to any network
Disconnecting	the system is breaking the connection
Connecting	the system is not connected to any network
ConnectedLinkLocal	a network device is connected, but there is only link-local connectivity
ConnectedSiteOnly	a network device is connected, but there is only site-local connectivity
Connected	the system is currently connected to a network

Definition at line 32 of file manager.h.

Function Documentation

◆ activateConnection()

QDBusPendingReply< QDBusObjectPath > NetworkManager::activateConnection	(	const QString &	connectionUni,
		const QString &	interfaceUni,
		const QString &	connectionParameter
	)

Activate a connection using the supplied device.

Parameters

connectionUni	unique identifier for the connection to be activated
interfaceUni	unique identifier of the network interface to be activated
connectionParameter	can be used to specify extra parameters not specific to the NetworkInterface or the connection, eg which AP to use when several present with same ESSID in range (because ESSID does not guarantee that the AP is part of the network you want to join!)

Definition at line 434 of file manager.cpp.

◆ activatingConnection()

NetworkManager::ActiveConnection::Ptr NetworkManager::activatingConnection ( )

Returns: an active connection that is currently being activated and which is expected to become the new primaryConnection() when it finishes activating.

Since: 0.9.9.0

Definition at line 1130 of file manager.cpp.

◆ activeConnections()

NetworkManager::ActiveConnection::List NetworkManager::activeConnections ( )

Access the list of any active connections.

Returns: a list of valid ActiveConnection objects

Definition at line 976 of file manager.cpp.

◆ activeConnectionsPaths()

QStringList NetworkManager::activeConnectionsPaths ( )

Access the list of any active connections paths.

Returns: a list of valid ActiveConnection paths

Definition at line 941 of file manager.cpp.

◆ addAndActivateConnection()

QDBusPendingReply< QDBusObjectPath, QDBusObjectPath > NetworkManager::addAndActivateConnection	(	const NMVariantMapMap &	connection,
		const QString &	interfaceUni,
		const QString &	connectionParameter
	)

Adds a new connection using the given details (if any) as a template (automatically filling in missing settings with the capabilities of the given device and specific object), then activate the new connection.

Cannot be used for VPN connections at this time.

Parameters

connection	connection definition to be added and activated
interfaceUni	unique identifier of the network interface to be activated
connectionParameter	can be used to specify extra parameters not specific to the NetworkInterface or the connection, eg which AP to use when several present with same ESSID in range (because ESSID does not guarantee that the AP is part of the network you want to join!)

Definition at line 451 of file manager.cpp.

◆ addAndActivateConnection2()

QDBusPendingReply< QDBusObjectPath, QDBusObjectPath, QVariantMap > NetworkManager::addAndActivateConnection2	(	const NMVariantMapMap &	connection,
		const QString &	interfaceUni,
		const QString &	connectionParameter,
		const QVariantMap &	options
	)

Cannot be used for VPN connections at this time.

Parameters

connection	connection definition to be added and activated
interfaceUni	unique identifier of the network interface to be activated
connectionParameter	can be used to specify extra parameters not specific to the NetworkInterface or the connection, eg which AP to use when several present with same ESSID in range (because ESSID does not guarantee that the AP is part of the network you want to join!)
options	further options for the method call.

This method extends AddAndActivateConnection to allow passing further parameters. At this time the following options are supported:

   * persist: A string value of either "disk" (default), "memory" or "volatile". If "memory" is passed, the connection will not be saved to disk. If

"volatile" is passed, the connection will not be saved to disk and will be destroyed when disconnected.

bind-activation: Bind the activation lifetime. Set to "dbus-name" to automatically disconnect when the requesting process disappears from the bus. The default of "none" means the connection is kept activated normally.

NOTE: will call AddAndActivateConnection(connection, interfaceUni, connectionParameter) instead when NetworkManager is older than 1.16, which means that the options property is ignored

Definition at line 465 of file manager.cpp.

◆ addConnection()

QDBusPendingReply< QDBusObjectPath > NetworkManager::addConnection ( const NMVariantMapMap & settings )

Add new connection and save it to disk.

This operation does not start the network connection unless (1) device is idle and able to connect to the network described by the new connection, and (2) the connection is allowed to be started automatically. Once the connection has been added, you will get a notification through SettingsNotifier::connectionAddComplete()

Returns: Uuid of the new connection that was just added.

Since: 0.9.9.0

Definition at line 108 of file settings.cpp.

◆ addConnectionUnsaved()

QDBusPendingReply< QDBusObjectPath > NetworkManager::addConnectionUnsaved ( const NMVariantMapMap & settings )

Add new connection but do not save it to disk immediately.

Use the 'Save' method on the connection to save these changes to disk. Note that unsaved changes will be lost if the connection is reloaded from disk (either automatically on file change or due to an explicit ReloadConnections call).

Once the connection has been added, you will get a notification through SettingsNotifier::connectionAddComplete()

Returns: Uuid of the new connection that was just added.

Since: 0.9.9.0

Definition at line 113 of file settings.cpp.

◆ canModify()

bool NetworkManager::canModify ( )

Returns true if the user can modify the settings.

Definition at line 254 of file settings.cpp.

◆ checkConnectivity()

QDBusPendingReply< uint > NetworkManager::checkConnectivity ( )

Re-check the network connectivity state.

See also: connectivity()

Since: 0.9.9.0

Definition at line 658 of file manager.cpp.

◆ checkVersion()

bool NetworkManager::checkVersion	(	const int	x,
		const int	y,
		const int	z
	)

Checks if NetworkManager version is at least x.y.z.

Returns: true if NetworkManager's version is greater or equal, false otherwise

Definition at line 235 of file manager.cpp.

◆ compareVersion() [1/2]

int NetworkManager::compareVersion	(	const int	x,
		const int	y,
		const int	z
	)

Compares NetworkManager version to x.y.z.

returns 1, -1 or 0 if NetworkManager's version is greater, less or equal to x.y.z.

Definition at line 217 of file manager.cpp.

◆ compareVersion() [2/2]

int NetworkManager::compareVersion ( const QString & version )

Compares NetworkManager's version to the parameter version.

returns 1, -1 or 0 if NetworkManager's version is greater, less or equal to parameter.

Definition at line 194 of file manager.cpp.

◆ connectivity()

NetworkManager::Connectivity NetworkManager::connectivity ( )

Returns: the network connectivity state

Since: 0.9.9.0

Definition at line 1115 of file manager.cpp.

◆ deactivateConnection()

QDBusPendingReply NetworkManager::deactivateConnection ( const QString & activeConnection )

Deactivate this network interface, if active.

Parameters

activeConnection identifier of the connection to deactivate

Definition at line 479 of file manager.cpp.

◆ findActiveConnection()

NetworkManager::ActiveConnection::Ptr NetworkManager::findActiveConnection ( const QString & uni )

Find an ActiveConnection object for an active connection id.

Parameters

uni	the id of the ActiveConnection

Returns: a valid ActiveConnection object

Definition at line 986 of file manager.cpp.

◆ findChannel()

int NetworkManager::findChannel ( int freq )

Parameters

freq	frequency of a wireless network

Returns: The frequency channel.

Definition at line 78 of file utils.cpp.

◆ findConnection()

NetworkManager::Connection::Ptr NetworkManager::findConnection ( const QString & path )

Retrieves the connection for the given path, returns null if not found.

Definition at line 224 of file settings.cpp.

◆ findConnectionByUuid()

NetworkManager::Connection::Ptr NetworkManager::findConnectionByUuid ( const QString & uuid )

Retrieves the connection for the given uuid, returns null if not found.

Definition at line 84 of file settings.cpp.

◆ findDeviceByIpFace()

NetworkManager::Device::Ptr NetworkManager::findDeviceByIpFace ( const QString & iface )

Return the network device referenced by its IP interface name.

This is not system independent so programs that will use this method will not be portable.

Definition at line 1016 of file manager.cpp.

◆ findNetworkInterface()

NetworkManager::Device::Ptr NetworkManager::findNetworkInterface ( const QString & uni )

Find a new NetworkInterface object given its UNI.

This pointer is owned by the Solid infrastructure.

Parameters

uni	the identifier of the network interface to find

Returns: a valid NetworkInterface object if there's a device having the given UNI, an invalid one otherwise

Definition at line 1011 of file manager.cpp.

◆ getLogging()

QDBusPendingReply< QString, QString > NetworkManager::getLogging ( )

Get current logging verbosity level and operations domains.

Definition at line 946 of file manager.cpp.

◆ globalDnsConfiguration()

NetworkManager::DnsConfiguration NetworkManager::globalDnsConfiguration ( )

Returns: Gets the global DNS configuration.

Since: 5.45.0

Definition at line 1150 of file manager.cpp.

◆ hostname()

QString NetworkManager::hostname ( )

Returns hostname of the machine.

Definition at line 259 of file settings.cpp.

◆ ipv6AddressAsHostAddress()

QHostAddress NetworkManager::ipv6AddressAsHostAddress ( const QByteArray & address )

Returns: QHostAddress representation of an ipv6 address

Parameters

address byte array containing the binary representation of the address

Definition at line 13 of file utils.cpp.

◆ ipv6AddressFromHostAddress()

QByteArray NetworkManager::ipv6AddressFromHostAddress ( const QHostAddress & address )

Returns: binary representation of an ipv6 address

Parameters

address qhostaddress containing the address

Definition at line 26 of file utils.cpp.

◆ isNetworkingEnabled()

bool NetworkManager::isNetworkingEnabled ( )

Retrieves the status of networking (as a whole) in the system.

This is distinct from whether the system's networking is online or offline. To check that, see status().

Returns: true if this networking is enabled, false otherwise

Definition at line 398 of file manager.cpp.

◆ isStartingUp()

bool NetworkManager::isStartingUp ( )

Indicates whether NM is still starting up; this becomes false when NM has finished attempting to activate every connection that it might be able to activate at startup.

Since: 0.9.9.0

Definition at line 678 of file manager.cpp.

◆ isWimaxEnabled()

bool NetworkManager::isWimaxEnabled ( )

Retrieves the activation status of wimax networking in the system.

Returns: true if this wimax networking is enabled, false otherwise

Deprecated:: Wimax support was removed from NetworkManager 1.2 (always returns false in runtime NM >= 1.2.0).

Definition at line 423 of file manager.cpp.

◆ isWimaxHardwareEnabled()

bool NetworkManager::isWimaxHardwareEnabled ( )

Retrieves the status of wimax hardware in the system.

This is typically controlled by a physical switch so there is no way to set this in software.

Returns: true if wimax HW networking is enabled, false otherwise

Deprecated:: Wimax support was removed from NetworkManager 1.2 (always returns false in runtime NM >= 1.2.0).

Definition at line 428 of file manager.cpp.

◆ isWirelessEnabled()

bool NetworkManager::isWirelessEnabled ( )

Retrieves the activation status of wireless networking in the system.

Returns: true if this wireless networking is enabled, false otherwise

Definition at line 403 of file manager.cpp.

◆ isWirelessHardwareEnabled()

bool NetworkManager::isWirelessHardwareEnabled ( )

Retrieves the status of wireless hardware in the system.

This is typically controlled by a physical switch so there is no way to set this in software.

Returns: true if this wireless networking is enabled, false otherwise

Definition at line 408 of file manager.cpp.

◆ isWwanEnabled()

bool NetworkManager::isWwanEnabled ( )

Retrieves the status of wireless broadband (Wireless WAN) in the system.

Returns: true if this type of wireless networking is enabled, false otherwise

Definition at line 413 of file manager.cpp.

◆ isWwanHardwareEnabled()

bool NetworkManager::isWwanHardwareEnabled ( )

Retrieves the status of wireless broadband (Wireless WAN) hardware in the system.

This is typically controlled by a physical switch so there is no way to set this in software.

Returns: true if this broddband hardware is enabled, false otherwise

Definition at line 418 of file manager.cpp.

◆ listConnections()

NetworkManager::Connection::List NetworkManager::listConnections ( )

Retrieves the list of connections.

Definition at line 70 of file settings.cpp.

◆ loadConnections()

QDBusPendingReply< bool, QStringList > NetworkManager::loadConnections ( const QStringList & filenames )

Loads or reloads the indicated connections from disk.

You should call this after making changes directly to an on-disk connection file to make sure that NetworkManager sees the changes. (If "monitor-connection-files" in NetworkManager.conf is "true", then this will have no real effect, but is harmless.) As with AddConnection(), this operation does not necessarily start the network connection.

Returns: Success or failure of the operation as a whole. True if NetworkManager at least tried to load the indicated connections, even if it did not succeed. False if an error occurred before trying to load the connections (eg, permission denied).; Paths of connection files that could not be loaded.

Since: 0.9.9.0

Definition at line 118 of file settings.cpp.

◆ macAddressAsString()

QString NetworkManager::macAddressAsString ( const QByteArray & ba )

Returns: String representation of a mac address.

Parameters

ba	byte array containing the binary repesentation of the address

Definition at line 39 of file utils.cpp.

◆ macAddressFromString()

QByteArray NetworkManager::macAddressFromString ( const QString & s )

Returns: binary repesentation of a mac address.

Parameters

s	string representation of the address

Definition at line 50 of file utils.cpp.

◆ metered()

NetworkManager::Device::MeteredStatus NetworkManager::metered ( )

Returns: Indicates whether the connectivity is metered.

Since: 5.14.0

Definition at line 1145 of file manager.cpp.

◆ networkInterfaces()

NetworkManager::Device::List NetworkManager::networkInterfaces ( )

Retrieves the list of all the network interfaces in the system.

It includes both hardware and virtual devices.

Returns: the list of network interfaces available in this system

Definition at line 368 of file manager.cpp.

◆ primaryConnection()

NetworkManager::ActiveConnection::Ptr NetworkManager::primaryConnection ( )

Returns: the "primary" active connection being used to access the network. In particular, if there is no VPN active, or the VPN does not have the default route, then this indicates the connection that has the default route. If there is a VPN active with the default route, then this indicates the connection that contains the route to the VPN endpoint.

Since: 0.9.9.0

Definition at line 1125 of file manager.cpp.

◆ primaryConnectionType()

NetworkManager::ConnectionSettings::ConnectionType NetworkManager::primaryConnectionType ( )

Returns: The connection type of the "primary" active connection being used to access the network. This is the same as the Type property on the object indicated by PrimaryConnection.

Since: 5.8.0

Definition at line 1135 of file manager.cpp.

◆ reloadConnections()

QDBusPendingReply< bool > NetworkManager::reloadConnections ( )

Tells NetworkManager to reload all connection files from disk, including noticing any added or deleted connection files.

By default, connections are re-read automatically any time they change, so you only need to use this command if you have set "monitor-connection-files=false" in NetworkManager.conf.

Returns: Success or failure.

Since: 0.9.9.0

Definition at line 123 of file settings.cpp.

◆ saveHostname()

void NetworkManager::saveHostname ( const QString & hostname )

Configure the following hostname.

Definition at line 133 of file settings.cpp.

◆ setGlobalDnsConfiguration()

void NetworkManager::setGlobalDnsConfiguration ( const NetworkManager::DnsConfiguration & configuration )

Returns: Sets the global DNS configuration.

Since: 5.45.0

Definition at line 1155 of file manager.cpp.

◆ settingsNotifier()

NetworkManager::SettingsNotifier * NetworkManager::settingsNotifier ( )

Notifier object for connecting signals.

Definition at line 264 of file settings.cpp.

◆ setWimaxEnabled()

void NetworkManager::setWimaxEnabled ( bool enabled )

Deprecated:: Wimax support was removed from NetworkManager 1.2 (it is a noop in runtime NM >= 1.2.0).

Definition at line 1090 of file manager.cpp.

◆ supportedInterfaceTypes()

NetworkManager::Device::Types NetworkManager::supportedInterfaceTypes ( )

Retrieves the interface types supported by this network manager.

Returns: the interface types supported by the network manager

Definition at line 240 of file manager.cpp.

◆ version()

QString NetworkManager::version ( )

Get the NetworkManager version.

Definition at line 951 of file manager.cpp.

KDE's Doxygen guidelines are available online.

Class Picker

Quick Links

About NetworkManagerQt

NetworkManager

Classes

Typedefs

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ Connectivity

◆ LogLevel

◆ Status

Function Documentation

◆ activateConnection()

◆ activatingConnection()

◆ activeConnections()

◆ activeConnectionsPaths()

◆ addAndActivateConnection()

◆ addAndActivateConnection2()

◆ addConnection()

◆ addConnectionUnsaved()

◆ canModify()

◆ checkConnectivity()

◆ checkVersion()

◆ compareVersion() [1/2]

◆ compareVersion() [2/2]

◆ connectivity()

◆ deactivateConnection()

◆ findActiveConnection()

◆ findChannel()

◆ findConnection()

◆ findConnectionByUuid()

◆ findDeviceByIpFace()

◆ findNetworkInterface()

◆ getLogging()

◆ globalDnsConfiguration()

◆ hostname()

◆ ipv6AddressAsHostAddress()

◆ ipv6AddressFromHostAddress()

◆ isNetworkingEnabled()

◆ isStartingUp()

◆ isWimaxEnabled()

◆ isWimaxHardwareEnabled()

◆ isWirelessEnabled()

◆ isWirelessHardwareEnabled()

◆ isWwanEnabled()

◆ isWwanHardwareEnabled()

◆ listConnections()

◆ loadConnections()

◆ macAddressAsString()

◆ macAddressFromString()

◆ metered()

◆ networkInterfaces()

◆ primaryConnection()

◆ primaryConnectionType()

◆ reloadConnections()

◆ saveHostname()

◆ setGlobalDnsConfiguration()

◆ settingsNotifier()

◆ setWimaxEnabled()

◆ supportedInterfaceTypes()

◆ version()