orgfreedesktopNetworkManager

org.freedesktop.NetworkManager is the D-Bus service interface exposed by the NetworkManager project to manage networking on Linux and other Unix-like systems. The interface is implemented by the NetworkManager daemon and is used by client applications to query device state, manage connections, and control network behavior. The standard top-level object is located at /org/freedesktop/NetworkManager, and the primary D-Bus interface for that object is org.freedesktop.NetworkManager.

Through this interface, clients can enumerate network devices with GetDevices, inspect their properties, and request actions such as activating a connection or creating a new connection profile. It supports enabling and disabling devices, switching between wireless networks, handling VPN connections, and coordinating with the kernel and device drivers. The API is designed to work with various device types, including Wi‑Fi, Ethernet, mobile broadband, and Bluetooth PAN.

Key properties include State, Connectivity, and WirelessEnabled, among others. The interface emits signals when the system state changes, devices are added or removed, or properties are updated, enabling user interfaces to keep in sync with the current network status. Additional interfaces such as org.freedesktop.NetworkManager.Device provide per-device details and controls.

Usage and ecosystem: The D-Bus interface is consumed by command-line tools like nmcli and by desktop network panels and policy tools to provide a user-friendly experience. It is widely implemented in Linux distributions that ship NetworkManager and is compatible with the FreeDesktop D-Bus specifications. Developers interact with it through D-Bus bindings in languages such as C, Python, and JavaScript.