NetworkManager/src
Beniamino Galvani ebf25794d9 checkpoint: preserve in-memory state of connections
If a connection is in-memory (i.e. has flag "unsaved"), after a
checkpoint and rollback it can be wrongly persisted to disk:

 - if the connection was modified and written to disk after the
   rollback, during the rollback we update it again with persist mode
   "keep", which keeps it on disk;

 - if the connection was deleted after the rollback, during the
   rollback we add it again with persist mode "to-disk".

Instead, remember whether the connection had the "unsaved" flag set
and try to restore the previous state.

However, this is not straightforward as there are 4 different possible
states for the settings connection: persistent; in-memory only;
in-memory shadowing a persistent file; in-memory shadowing a detached
persistent file (i.e. the deletion of the connection doesn't delete
the persistent file). Handle all those cases.

Fixes: 3e09aed2a0 ('checkpoint: add create, rollback and destroy D-Bus API')
(cherry picked from commit c979bfeb8b)
2024-05-23 13:46:24 +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 all: use nm_strv_empty_new() helper 2023-11-30 15:53:21 +01:00
core checkpoint: preserve in-memory state of connections 2024-05-23 13:46:24 +02:00
libnm-base sriov: allow reading empty eswitch paramaters via Devlink 2024-02-21 11:27:36 +01:00
libnm-client-aux-extern all: use nm_random_*() instead of g_random_*() 2023-01-30 10:51:13 +01:00
libnm-client-impl libnm: add generic.device-handler property 2024-02-21 11:49:11 +01:00
libnm-client-public HSR: add support to HSR/PRP interface 2023-12-05 08:05:56 +01:00
libnm-client-test all: use G_SPAWN_CLOEXEC_PIPES with g_spawn_async_with_pipes() 2023-04-04 08:43:20 +02:00
libnm-core-aux-extern dispatcher: support device-handler actions 2024-02-21 11:49:16 +01:00
libnm-core-aux-intern libnm,nmcli: add ipvx.dhcp-dscp property 2024-02-06 17:02:30 +01:00
libnm-core-impl libnm-core: avoid compiler warnings in team settings 2024-05-15 12:11:52 +02:00
libnm-core-intern nm-setting: implement direct_enum as GObject property of type int 2024-02-21 11:20:52 +01:00
libnm-core-public checkpoint: Allow rollback on internal global DNS 2024-03-20 19:35:42 +01:00
libnm-crypto doc: replace all (allow-none) annotations by (optional) and/or (nullable) 2023-03-27 11:49:43 +02:00
libnm-glib-aux libnm-glib-aux: fix comments about UUID generation 2024-05-15 12:11:42 +02:00
libnm-lldp libnm-lldp: use ETH_P_ALL instead of NM_ETHERTYPE_LLDP for the socket 2024-04-05 11:52:18 +02:00
libnm-log-core log,dhcp: avoid deprecated GTimeVal API and use g_get_real_time() 2023-03-21 10:21:28 +01:00
libnm-log-null all: add some README.md files describing the purpose of our sources 2021-08-19 17:51:11 +02:00
libnm-platform platform: avoid routes resync for routes that we don't track 2024-05-13 13:33:06 +02:00
libnm-std-aux std-aux: workaround usage of _Pragma() inside nm_assert() 2024-02-09 12:53:54 +01:00
libnm-systemd-core build: use "-Wno-nonnull-compare" for building systemd 2024-02-26 12:09:09 +01:00
libnm-systemd-shared build: use "-Wno-nonnull-compare" for building systemd 2024-02-26 12:09:09 +01:00
libnm-udev-aux format: reformat source tree with clang-format 13.0 2021-11-29 09:31:09 +00:00
libnmc-base device: support creating generic devices via device-handler 2024-02-21 11:49:19 +01:00
libnmc-setting man: fix missing deprecation message 2024-04-18 15:31:54 +02:00
libnmt-newt nmtui: fix deletion confirmation with ESC key press 2024-01-18 10:16:45 +01: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: change the default DSCP value to 0 2024-02-06 17:02:31 +01:00
nm-cloud-setup cloud-setup: more sandboxing in service file 2024-01-16 08:59:07 +01: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 daemon-helper: use _nm_strerror_r() to avoid non-thread-safe strerror() 2023-09-12 12:39:43 +00:00
nm-dispatcher nm-dispatcher: fix crash when parsing output dictionary 2024-03-26 10:53:43 +01:00
nm-initrd-generator initrd: add support for rd.net.dhcp.dscp property 2024-02-06 17:02:31 +01:00
nm-online all: use NM_MAX() instead of MAX() 2023-11-15 09:32:21 +01:00
nm-priv-helper all: drop redundant includes 2022-05-09 19:20:18 +02:00
nmcli man: fix missing deprecation message 2024-04-18 15:31:54 +02:00
nmtui nmtui: Add bond for creating bridge port interface 2024-02-21 11:48:21 +01:00
tests libnm,nmcli: add ipvx.dhcp-dscp property 2024-02-06 17:02:30 +01:00
meson.build build: workaround -Wno-calloc-transposed-args warning in systemd code 2024-02-26 12:17:07 +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