NetworkManager/src
Beniamino Galvani dd0ca122e3 ovs: set the tun interface up before stage3
When using the netdev datapath, we wait that the tun link appears, we
call nm_device_set_ip_ifindex() (which also brings the link up) and
then we check that the link is ready, i.e. that udev has announced the
link and the MAC address is correct. After that, we schedule stage3
(ip-config).

In this, there is a race condition that occurs sometimes in NMCI test
ovs_datapath_type_netdev_with_cloned_mac. In rare conditions,
nm_device_set_ip_ifindex() bring the interface up but then ovs-vswitch
changes again the flags of the interface without IFF_UP. The result is
that the interface stays down, breaking communications.

To fix this, we need to always call nm_device_bring_up() after the tun
device is ready. The problem is that we can't do it in
_netdev_tun_link_cb() because that function is already invoked
synchronously from platform code.

Instead, simplify the handling of the netdev datapath. Every
"link-changed" event from platform is handled by
_netdev_tun_link_cb(), which always schedule a delayed function
_netdev_tun_link_cb_in_idle(). This function just assigns the
ip-ifindex to the device if missing, and starts stage3 if the link is
ready. While doing so, it also bring the interface up.

Fixes: 99a6c6eda6 ('ovs, dpdk: fix creating ovs-interface when the ovs-bridge is netdev')

https://issues.redhat.com/browse/RHEL-17358

https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/merge_requests/2218
(cherry picked from commit 46e0d2b4e4)
2025-06-19 15:12:42 +02:00
..
c-list c-list: re-import git-subtree for 'src/c-list' 2022-07-19 09:02:36 +02:00
c-rbtree c-rbtree: re-import git-subtree for 'src/c-rbtree' 2022-11-23 18:00:31 +01:00
c-siphash c-siphash: re-import git-subtree for 'src/c-siphash' 2022-11-23 18:00:33 +01:00
c-stdaux c-stdaux: re-import git-subtree for 'src/c-stdaux' 2023-03-03 13:40:38 +01:00
contrib Rephrase certain expressions to avoid the usage of the term "allows to" 2025-03-27 09:44:07 +01:00
core ovs: set the tun interface up before stage3 2025-06-19 15:12:42 +02:00
libnm-base dns: Add resolve-mode and certification-authority keys to global-dns 2025-01-29 14:41:47 +01:00
libnm-client-aux-extern libnmc: fix bug checking VersionInfo's capabilities 2024-12-11 15:52:09 +00:00
libnm-client-impl all: code format 2025-05-13 11:43:33 +02:00
libnm-client-public libnm, nmcli: introduce new "prefix-delegation" setting 2025-04-02 11:21:59 +02:00
libnm-client-test typo fix: allows to -> allows one to 2025-03-26 19:22:01 +01:00
libnm-core-aux-extern dispatcher: support device-handler actions 2024-02-21 11:16:04 +01:00
libnm-core-aux-intern dns: Fix port handling in Dnsconfd plugin 2025-05-27 08:24:22 +00:00
libnm-core-impl ipv4: remove the forwarding=ignore value 2025-06-19 14:28:36 +02:00
libnm-core-intern libnm, nmcli: introduce new "prefix-delegation" setting 2025-04-02 11:21:59 +02:00
libnm-core-public ipv4: remove the forwarding=ignore value 2025-06-19 14:28:36 +02:00
libnm-crypto Updated code format 2024-04-08 06:35:20 +00:00
libnm-glib-aux all: code format 2025-05-13 11:43:33 +02:00
libnm-lldp format: run nm-code-format 2024-10-04 11:07:35 +02:00
libnm-log-core all: code format 2025-05-13 11:43:33 +02:00
libnm-log-null
libnm-platform all: code format 2025-05-13 11:43:33 +02:00
libnm-std-aux typo fix: allow to -> allow one to 2025-03-26 19:22:56 +01:00
libnm-systemd-core merge: branch 'systemd' into main 2025-02-04 15:28:11 +01:00
libnm-systemd-shared systemd: accept encoded domain names without terminating zero label 2025-02-04 15:31:45 +01:00
libnm-udev-aux format: reformat source tree with clang-format 13.0 2021-11-29 09:31:09 +00:00
libnmc-base libnmc/client-utils: typo fix, add closing parenthesis 2024-10-30 11:05:50 +01:00
libnmc-setting ipv4: remove the forwarding=ignore value 2025-06-19 14:28:36 +02:00
libnmt-newt nmtui: handle write() errors correctly in nmt_newt_edit_string 2024-06-28 10:58:11 +00:00
linux-headers platform: remove CSME related code 2023-09-25 11:46:24 +00:00
n-acd n-acd: use separate seed state for each probe of the same acd 2023-10-05 09:02:57 +02:00
n-dhcp4 n-dhcp4: fix resource leaks 2025-04-07 14:15:09 +00:00
nm-cloud-setup cloud-setup: configure disconnected wired devices on OCI 2025-04-11 11:44:05 +02:00
nm-compat-headers all: add src/nm-compat-headers for patching included system headers 2022-09-23 11:43:33 +02:00
nm-daemon-helper nm-daemon-helper: add "service" argument 2024-07-04 15:39:03 +02:00
nm-dispatcher all: code format 2025-05-13 11:43:33 +02:00
nm-initrd-generator nm-initrd-generator: fix ignored prefix for IPv6 address with brackets 2025-05-14 07:35:31 +02:00
nm-online all: use NM_MAX() instead of MAX() 2023-11-15 09:32:21 +01:00
nm-priv-helper format: run nm-code-format 2024-10-04 11:07:35 +02:00
nmcli ipv4: remove the forwarding=ignore value 2025-06-19 14:28:36 +02:00
nmtui nmtui/editor: hide "device" field for loopback connections 2025-04-15 11:43:06 +00:00
tests po: add test to check potfiles list contents 2025-04-24 10:27:36 +02:00
meson.build ip: configurable address pool and lease time of DHCP server in shared mode 2024-12-11 09:20:15 +01:00
README.md nm-sudo: rename to nm-priv-helper 2022-01-11 21:46:55 +01:00

src/

Most of the subdirectories are static helper libraries, which get linked into one of the final build artifacts (like libnm, nmcli or NetworkManager). Static libraries are internal API.

The only public API is libnm, which is a shared library provided client implementations.

Our own clients (like nmcli and nmtui) also use libnm, the shared library. But they also use additional static helper libraries.

The daemon statically links against a part of libnm, the part that provides connection profiles. That is libnm-core. libnm-core is thus statically linked with libnm and the daemon. It does not get linked by clients that already link with libnm (like nmtui).

Read the individual README.md files in the subdirectories for details:

Directory Description
core/ the NetworkManager daemon
nmcli/ nmcli application, a command line client for NetworkManager
nmtui/ nmtui application, a text UI client for NetworkManager
nm-cloud-setup/ service to automatically configure NetworkManager in cloud environment
nm-initrd-generator/ generates NetworkManager configuration by parsing kernel command line options for dracut/initrd
nm-dispatcher/ NetworkManager-dispatcher service to run user scripts
nm-online/ application which checks whether NetworkManager is done, for implementing NetworkManager-wait-online.service
nm-priv-helper/ internal service for privileged operations
nm-daemon-helper/ internal helper binary spawned by NetworkManager
libnm-std-aux/ internal helper library for standard C
libnm-glib-aux/ internal helper library for glib
libnm-log-null/ internal helper library with dummy (null) logging backend
libnm-log-core/ internal helper library with logging backend (syslog) used by daemon
libnm-base/ internal helper library with base definitions
libnm-platform/ internal helper library for netlink and other platform/kernel API
libnm-udev-aux/ internal helper library for libudev
libnm-core-public/ public API of libnm (libnm-core part)
libnm-core-intern/ internal API of libnm-core, used by libnm and daemon
libnm-core-impl/ implementation of libnm-core
libnm-core-aux-intern/ internal helper library on top of libnm-core (used by libnm-core itself)
libnm-core-aux-extern/ internal helper library on top of libnm-core (not used by libnm-core)
libnm-client-public/ public API of libnm (NMClient part)
libnm-client-impl/ implementation of libnm (NMClient)
libnm-client-aux-extern/ internal helper library on top of libnm (not used by libnm itself)
libnmc-base/ internal helper library for libnm clients
libnmc-setting/ internal helper library for setting connection profiles (used by nmcli)
libnmt-newt/ internal helper library for libnewt for nmtui
linux-headers/ extra Linux kernel UAPI headers
contrib/ sources that are not used by NetworkManager itself
tests/ unit tests that are not specific to one of the other directories
libnm-client-test/ internal helper library with test utils for libnm
c-list/ fork of c-util helper library for intrusive, doubly linked list
c-rbtree/ fork of c-util helper library for intrusive Red-Black Tree
c-siphash/ fork of c-util helper library for SIPHash24
c-stdaux/ fork of c-util general purpose helpers for standard C
n-acd/ fork of nettools IPv4 ACD library
n-dhcp4/ fork of nettools DHCPv4 library
libnm-systemd-core/ fork of systemd code as network library
libnm-systemd-shared/ fork of systemd code as general purpose library