NetworkManager/libnm/nm-libnm-utils.h

// SPDX-License-Identifier: LGPL-2.1+
/*
 * Copyright (C) 2017, 2018 Red Hat, Inc.
 */

#ifndef __NM_LIBNM_UTILS_H__
#define __NM_LIBNM_UTILS_H__

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

char *nm_utils_fixup_vendor_string (const char *desc);
char *nm_utils_fixup_product_string (const char *desc);

#endif /* __NM_LIBNM_UTILS_H__ */
all: SPDX header conversion $ find * -type f \|xargs perl contrib/scripts/spdx.pl $ git rm contrib/scripts/spdx.pl 2019-09-10 11:19:01 +02:00			`// SPDX-License-Identifier: LGPL-2.1+`
libnm: add testable libnm/nm-libnm-utils.c file Previously, internal parts of libnm were not testable. Instead, add "libnm/nm-libnm-utils.c" and "libnm/libnm-utils.la" to contain code that can be statically linked with a new test "libnm/tests/test-general". 2017-05-19 10:19:25 +02: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) 2017, 2018 Red Hat, Inc.`
libnm: add testable libnm/nm-libnm-utils.c file Previously, internal parts of libnm were not testable. Instead, add "libnm/nm-libnm-utils.c" and "libnm/libnm-utils.la" to contain code that can be statically linked with a new test "libnm/tests/test-general". 2017-05-19 10:19:25 +02:00			`*/`

			`#ifndef __NM_LIBNM_UTILS_H__`
			`#define __NM_LIBNM_UTILS_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_PRIVATE)`
			`#error Cannot use this header.`
			`#endif`

libnm/utils: split out vendor fixup The hwdb generally contains the strings of rather poor quality, especially when it comes to sensibly presenting them to the user and they need various cleanups. While the following patches add fixups, this one splits out vendor fixups, because it turns out that a different set of fixups is needed than for products. 2018-02-23 14:52:00 +01:00			`char nm_utils_fixup_vendor_string (const char desc);`
libnm/utils: extend the product fixup phrase list The product names are generally of rather poor quality. The product name is no place to enumerate product capabilities, the bus it's attached on and similar nonsense. 2018-02-23 14:52:05 +01:00			`char nm_utils_fixup_product_string (const char desc);`
libnm: add testable libnm/nm-libnm-utils.c file Previously, internal parts of libnm were not testable. Instead, add "libnm/nm-libnm-utils.c" and "libnm/libnm-utils.la" to contain code that can be statically linked with a new test "libnm/tests/test-general". 2017-05-19 10:19:25 +02:00
			`#endif /* __NM_LIBNM_UTILS_H__ */`