NetworkManager/src
Thomas Haller 0df8bf56ad libnm: avoid "-Wnonnull-compare warnings with "static" array declarator
With a static array, we indicate that the argument must not be NULL.
Gcc-14.0.1-0.2.fc40 now warns against that:

    CC       src/libnm-base/libnm_base_la-nm-base.lo
  In file included from ../src/libnm-std-aux/nm-default-std.h:102,
                   from ../src/libnm-glib-aux/nm-default-glib.h:11,
                   from ../src/libnm-glib-aux/nm-default-glib-i18n-lib.h:13,
                   from ../src/libnm-base/nm-base.c:3:
  ../src/libnm-base/nm-base.c: In function 'nm_net_devname_infiniband':
  ../src/libnm-std-aux/nm-std-aux.h:191:12: error: 'nonnull' argument 'name' compared to NULL [-Werror=nonnull-compare]
    191 |         if (expr)                      \
        |            ^
  ../src/libnm-std-aux/nm-std-aux.h:202:27: note: in expansion of macro '_NM_BOOLEAN_EXPR_IMPL'
    202 |                           _NM_BOOLEAN_EXPR_IMPL(NM_UNIQ, expr))
        |                           ^~~~~~~~~~~~~~~~~~~~~
  ../src/libnm-glib-aux/nm-macros-internal.h:1693:31: note: in expansion of macro 'NM_BOOLEAN_EXPR'
   1693 | #define _G_BOOLEAN_EXPR(expr) NM_BOOLEAN_EXPR(expr)
        |                               ^~~~~~~~~~~~~~~
  /usr/include/glib-2.0/glib/gmacros.h:1244:43: note: in expansion of macro '_G_BOOLEAN_EXPR'
   1244 | #define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 1))
        |                                           ^~~~~~~~~~~~~~~
  /usr/include/glib-2.0/glib/gmessages.h:656:9: note: in expansion of macro 'G_LIKELY'
    656 |     if (G_LIKELY (expr)) \
        |         ^~~~~~~~
  ../src/libnm-base/nm-base.c:57:5: note: in expansion of macro 'g_return_val_if_fail'
     57 |     g_return_val_if_fail(name, NULL);
        |     ^~~~~~~~~~~~~~~~~~~~

  ../src/libnm-core-impl/nm-setting-wireguard.c: In function '_nm_wireguard_peer_set_public_key_bin':
  ../src/libnm-core-impl/nm-setting-wireguard.c:316:8: error: 'nonnull' argument 'public_key' compared to NULL [-Werror=nonnull-compare]
    316 |     if (!public_key)
        |        ^

Convert these checks to an nm_assert() to suppress the warning.

(cherry picked from commit 7a031eef5d)
(cherry picked from commit aeaba8a2a1)
2024-09-26 10:04:40 +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: adjust glib-mkenums annotations for automated formatting 2022-02-08 11:14:01 +01:00
core policy: retry hostname resolution when it fails 2024-08-30 13:41:22 +02:00
libnm-base libnm: avoid "-Wnonnull-compare warnings with "static" array declarator 2024-09-26 10:04:40 +02: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: mark missing "FwMark" for NMDeviceIPTunnel as ignored 2024-03-14 08:52:40 +01:00
libnm-client-public libnm: sort setting headers in NetworkManager.h 2023-06-29 10:15:48 +02: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 dispatch dns-change dispatcher event 2023-10-18 14:24:34 +08:00
libnm-core-aux-intern libnm-core: add internal _nm_ip_route_ref() helper 2023-05-12 12:42:49 +02:00
libnm-core-impl libnm: avoid "-Wnonnull-compare warnings with "static" array declarator 2024-09-26 10:04:40 +02:00
libnm-core-intern libnm: use nm_net_devname_infiniband() for virtual interface-name of infiniband 2023-05-30 08:52:34 +02:00
libnm-core-public checkpoint: Allow rollback on internal global DNS 2024-03-20 20:03:24 +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 std-aux: move NM_PRAGMA_WARNING_DISABLE() macro from libnm-glib-aux to libnm-std-aux 2024-08-28 09:23:08 +02:00
libnm-lldp lldp: fix multiple access to argument in logging macro 2024-08-19 15:39:24 +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: fix handling "weight" for IPv4 routes 2024-03-14 09:00:58 +01:00
libnm-std-aux std-aux: add NM_STRINGIFY() macro 2024-08-28 09:51:15 +02:00
libnm-systemd-core build: use "-Wno-nonnull-compare" for building systemd 2024-09-26 10:00:57 +02:00
libnm-systemd-shared build: use "-Wno-nonnull-compare" for building systemd 2024-09-26 10:00:57 +02:00
libnm-udev-aux format: reformat source tree with clang-format 13.0 2021-11-29 09:31:09 +00:00
libnmc-base libnmc-base/utils: Improve qr code bottom border 2023-10-03 14:53:25 +02:00
libnmc-setting libnm: better document IPv4 DAD property 2023-11-21 09:11:56 +01:00
libnmt-newt doc: use "Returns:" annotation instead of deprecated aliases 2023-03-29 11:46:48 +02:00
linux-headers all: add src/nm-compat-headers for patching included system headers 2022-09-23 11:43:33 +02:00
n-acd n-acd: use separate seed state for each probe of the same acd 2023-11-21 09:10:58 +01:00
n-dhcp4 n-dhcp4: re-import git-subtree for 'src/n-dhcp4' 2023-06-12 14:10:08 +02:00
nm-cloud-setup cloud-setup: log a warning when no provider is detected 2023-06-14 16:24:21 +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 daemon-helper: remove unused variables 2024-08-28 10:08:45 +02:00
nm-dispatcher dispatch dns-change dispatcher event 2023-10-18 14:24:34 +08:00
nm-initrd-generator initrd: unset dhcp options for static profiles 2023-07-24 11:17:27 +02:00
nm-online clang-format: reformat code with clang-format 15.0.4-1.fc37 2022-11-23 09:17:21 +01:00
nm-priv-helper all: drop redundant includes 2022-05-09 19:20:18 +02:00
nmcli nmcli: fix crash in nmc_connection_check_deprecated() 2024-03-14 09:03:21 +01:00
nmtui nmtui: replace occurrences of master/slave with controller/port in internal code 2023-07-25 14:22:25 +02:00
tests test-client: fix warnings about invalid escape sequences 2023-11-21 09:38:23 +01:00
meson.build build: workaround -Wno-calloc-transposed-args warning in systemd code 2024-09-26 10:02:08 +02: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