NetworkManager/libnm-core/nm-property-compare.h

/* SPDX-License-Identifier: LGPL-2.1+ */
/*
 * Copyright (C) 2007 - 2014 Red Hat, Inc.
 * Copyright (C) 2007 - 2008 Novell, Inc.
 */

#ifndef __NM_PROPERTY_COMPARE_H__
#define __NM_PROPERTY_COMPARE_H__

#if !((NETWORKMANAGER_COMPILATION) &NM_NETWORKMANAGER_COMPILATION_WITH_LIBNM_CORE_PRIVATE)
    #error Cannot use this header.
#endif

int nm_property_compare(GVariant *value1, GVariant *value2);

#endif /* __NM_PROPERTY_COMPARE_H__ */
all: unify comment style for SPDX-License-Identifier tag Our coding style recommends C style comments (/* /) instead of C++ (//). Also, systemd (which we partly fork) uses C style comments for the SPDX-License-Identifier. Unify the style. $ sed -i '1 s#// SPDX-License-Identifier: \([^ ]\+\)$#/ SPDX-License-Identifier: \1 /#' -- $(git ls-files -- '.[hc]' '*.[hc]pp') 2020-09-29 16:42:22 +02:00			`/* SPDX-License-Identifier: LGPL-2.1+ */`
libnm-core: drop NMParamSpecSpecialized, add nm_property_compare() NMParamSpecSpecialized existed basically to provide a version of GParamSpecBoxed that could compare dbus-glib-valued properties correctly. However, g_param_values_cmp() was only used by NM directly in one place (NMSetting's compare_property()), and we don't actually need to indirect through GParamSpec there; we could just call NMParamSpecSpecialized's value-comparison function directly. So, change all NMParamSpecSpecialized properties to GParamSpecBoxed, rename the _gvalues_compare() function it used to "nm_property_compare()", and use that from NMSetting. (g_param_values_cmp() also gets used internally by g_param_value_defaults(), but all NMParamSpecSpecialized properties have a default value of NULL, so GParamSpecBoxed's pointer-equality check will do the job just fine there.) 2014-07-29 09:22:07 -04:00			`/*`
all: unify format of our Copyright source code comments ```bash readarray -d '' FILES < <( git ls-files -z \ ':(exclude)po' \ ':(exclude)shared/c-rbtree' \ ':(exclude)shared/c-list' \ ':(exclude)shared/c-siphash' \ ':(exclude)shared/c-stdaux' \ ':(exclude)shared/n-acd' \ ':(exclude)shared/n-dhcp4' \ ':(exclude)src/systemd/src' \ ':(exclude)shared/systemd/src' \ ':(exclude)m4' \ ':(exclude)COPYING' ) sed \ -e 's/^\(--\\|#\\| \\) \(([cC]) \)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\\|19\)[0-9][0-9]\) [-–] \(\(20\\|19\)[0-9][0-9]\) \+\([^ ].\)$/\1 C1pyright#\5 - \7#\9/' \ -e 's/^\(--\\|#\\| \\) \(([cC]) \)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\\|19\)[0-9][0-9]\) [,] \(\(20\\|19\)[0-9][0-9]\) \+\([^ ].\)$/\1 C2pyright#\5, \7#\9/' \ -e 's/^\(--\\|#\\| \\) \(([cC]) \)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\\|19\)[0-9][0-9]\) \+\([^ ].\)$/\1 C3pyright#\5#\7/' \ -e 's/^Copyright \(\(20\\|19\)[0-9][0-9]\) \+\([^ ].\)$/C4pyright#\1#\3/' \ -i \ "${FILES[@]}" echo ">>> untouched Copyright lines" git grep Copyright "${FILES[@]}" echo ">>> Copyright lines with unusual extra" git grep '\<C[0-9]pyright#' "${FILES[@]}" \| grep -i reserved sed \ -e 's/\<C[0-9]pyright#\([^#]\)#\(.\)$/Copyright (C) \1 \2/' \ -i \ "${FILES[@]}" ``` https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/298 2019-10-01 09:20:35 +02:00			`* Copyright (C) 2007 - 2014 Red Hat, Inc.`
			`* Copyright (C) 2007 - 2008 Novell, Inc.`
libnm-core: drop NMParamSpecSpecialized, add nm_property_compare() NMParamSpecSpecialized existed basically to provide a version of GParamSpecBoxed that could compare dbus-glib-valued properties correctly. However, g_param_values_cmp() was only used by NM directly in one place (NMSetting's compare_property()), and we don't actually need to indirect through GParamSpec there; we could just call NMParamSpecSpecialized's value-comparison function directly. So, change all NMParamSpecSpecialized properties to GParamSpecBoxed, rename the _gvalues_compare() function it used to "nm_property_compare()", and use that from NMSetting. (g_param_values_cmp() also gets used internally by g_param_value_defaults(), but all NMParamSpecSpecialized properties have a default value of NULL, so GParamSpecBoxed's pointer-equality check will do the job just fine there.) 2014-07-29 09:22:07 -04:00			`*/`

			`#ifndef __NM_PROPERTY_COMPARE_H__`
			`#define __NM_PROPERTY_COMPARE_H__`

build: refine the NETWORKMANAGER_COMPILATION define Note that: - we compile some source files multiple times. Most notably those under "shared/". - we include a default header "shared/nm-default.h" in every source file. This header is supposed to setup a common environment by defining and including parts that are commonly used. As we always include the same header, the header must behave differently depending one whether the compilation is for libnm-core, NetworkManager or libnm-glib. E.g. it must include <glib/gi18n.h> or <glib/gi18n-lib.h> depending on whether we compile a library or an application. For that, the source files need the NETWORKMANAGER_COMPILATION #define to behave accordingly. Extend the define to be composed of flags. These flags are all named NM_NETWORKMANAGER_COMPILATION_WITH_*, they indicate which part of the build are available. E.g. when building libnm-core.la itself, then WITH_LIBNM_CORE, WITH_LIBNM_CORE_INTERNAL, and WITH_LIBNM_CORE_PRIVATE are available. When building NetworkManager, WITH_LIBNM_CORE_PRIVATE is not available but the internal parts are still accessible. When building nmcli, only WITH_LIBNM_CORE (the public part) is available. This granularily controls the build. 2018-01-02 13:37:06 +01:00			`#if !((NETWORKMANAGER_COMPILATION) &NM_NETWORKMANAGER_COMPILATION_WITH_LIBNM_CORE_PRIVATE)`
			`#error Cannot use this header.`
			`#endif`

libnm-core: change connection hash tables to variants in API In preparation for porting to GDBus, make nm_connection_to_dbus(), etc, represent connections as GVariants of type 'a{sa{sv}}' rather than as GHashTables-of-GHashTables-of-GValues. This means we're constantly converting back and forth internally, but this is just a stepping stone on the way to the full GDBus port, and all of that code will go away again later. 2014-08-16 10:09:48 -04:00			`int nm_property_compare(GVariant value1, GVariant value2);`
libnm-core: drop NMParamSpecSpecialized, add nm_property_compare() NMParamSpecSpecialized existed basically to provide a version of GParamSpecBoxed that could compare dbus-glib-valued properties correctly. However, g_param_values_cmp() was only used by NM directly in one place (NMSetting's compare_property()), and we don't actually need to indirect through GParamSpec there; we could just call NMParamSpecSpecialized's value-comparison function directly. So, change all NMParamSpecSpecialized properties to GParamSpecBoxed, rename the _gvalues_compare() function it used to "nm_property_compare()", and use that from NMSetting. (g_param_values_cmp() also gets used internally by g_param_value_defaults(), but all NMParamSpecSpecialized properties have a default value of NULL, so GParamSpecBoxed's pointer-equality check will do the job just fine there.) 2014-07-29 09:22:07 -04:00
			`#endif /* __NM_PROPERTY_COMPARE_H__ */`