Resources for developers

D-Bus API

NetworkManager provides a D-Bus interface on the system bus. You can use this interface to query network state and the details of network interfaces like current IP addresses or DHCP options, and to activate, deactivate, created, edit, and delete saved network connections.

Check the D-Bus API reference: STABLE DEVEL

libnm API

libnm wraps the D-Bus API in easy-to-use GObjects and is often much simpler for glib-based applications to use.

Check the libnm API reference: STABLE DEVEL

This is a simple example on how to print existing connections in Python using GObject introspection:

#!/usr/bin/python3

# GObject-introspection is needed to call libnm from python
import gi
gi.require_version("NM", "1.0")
from gi.repository import NM

def print_values(setting, key, value, flags, data):
    print("     {}.{}: {}".format(setting.get_name(), key, value))

# Create the client object. This automatically loads all the D-Bus
# tree and creates in-memory objects for connections, devices, access
# points, etc.
client = NM.Client.new(None)

# Obtain a list of connection profiles ...
connections = client.get_connections()

# ... and print their properties
for c in connections:
    print("{}:".format(c.get_id()))
    c.for_each_setting_value(print_values, None)
    print("\n")

More examples in Python and other languages are available in the NetworkManager git tree.

Release numbering

Major NetworkManager releases are numbered 1.y.0, with y being an even number. For example, 1.0.0, 1.2.0, …, 1.18.0.

Minor stable releases are numbered 1.y.z, with y and z being even numbers. For example 1.4.2, 1.18.2.