keyfile: relicense the code under LGPL-2.1+
Historically, keyfile read/write code was part of core, and thus
GPL-2.0+ licensed. Keyfile is the native file format for NetworkManager
connection profiles, and code to handle that should be part of libnm.
This would unlock many interesting features, like tools being able
to import/export connection profiles in the native file format.
However, libnm is LGPL-2.1+ licensed, so this is a problem.
The alternative would be to add a separate, GPL licensed library
(libnm-keyfile.so or libnm-gpl.so). However that also requires a larger
rework, because the current keyfile implementation uses internal API
from libnm-core and it would need to be reworked to only use public
API of libnm.
Relicense the code instead. According to research and "keyfile-history.sh"
script, the following individuals and companies possibly hold copyright
on the code:
<bgalvani(at)redhat.com>
<blueowl(at)centrum.cz>
<daniel(at)gnoutcheff.name>
<danw(at)redhat.com>
<dcantrell(at)redhat.com>
<dcbw(at)redhat.com>
<evan(at)ebroder.net>
<fgiudici(at)redhat.com>
<floe(at)butterbrot.org>
<j(at)bootlab.org>
<kmaraas(at)gnome.org>
<lkundrak(at)v3.sk>
<luzpaz(at)users.noreply.github.com>
<martinpitt(at)gnome.org>
<michael.i.doherty(at)intel.com>
<pavlix(at)pavlix.net>
<pmarti(at)warp.es>
<rafaelff(at)gnome.org>
<rstrode(at)redhat.com>
<tambet(at)gmail.com>
<tgraf(at)redhat.com>
<thaller(at)redhat.com>
<walters(at)verbum.org>
<yurchor(at)ukr.net>
Intel Corporation
Novell, Inc.
Red Hat, Inc.
Ximian, Inc.
Most contributors on this list agreed to relicensing according to RELICENSE.md.
The following copyright holders did not answer the request for agreeing
to relicensing:
- <j(at)bootlab.org>: no contributions were made that are related to
keyfile implementation. The script just gives a false positive.
- <pmarti(at)warp.es>: the contribution is a fix of a spelling error
(commit 6029288ffb18435ca7d2cde645be53cd414ae5fa).
- <tgraf(at)redhat.com>: the contribution to keyfile code are small
(I only identified commit 5b7503e95eb9d84935efea708b9dc326ef14d8ce).
Also, Thomas worked for Red Hat at the time.
After research, I think it's fair to conclude that everybody who holds
non-trivial copyright on the keyfile code agreed to the relicensing.
2020-05-16 14:18:23 +02:00
|
|
|
/* SPDX-License-Identifier: LGPL-2.1+ */
|
2019-09-25 13:13:40 +02:00
|
|
|
/*
|
2019-10-01 09:20:35 +02:00
|
|
|
* Copyright (C) 2010 - 2015 Red Hat, Inc.
|
2015-02-18 19:59:28 +01:00
|
|
|
*/
|
|
|
|
|
|
2015-02-18 18:59:35 +01:00
|
|
|
#ifndef __NM_KEYFILE_UTILS_H__
|
|
|
|
|
#define __NM_KEYFILE_UTILS_H__
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-01-02 07:37:59 +01:00
|
|
|
#if !((NETWORKMANAGER_COMPILATION) &NM_NETWORKMANAGER_COMPILATION_WITH_LIBNM_CORE_INTERNAL)
|
2018-01-02 13:37:06 +01:00
|
|
|
#error Cannot use this header.
|
|
|
|
|
#endif
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-05-05 08:23:16 +02:00
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
#include "nm-glib-aux/nm-shared-utils.h"
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2019-01-30 12:36:13 +01:00
|
|
|
#define NM_KEYFILE_GROUP_VPN_SECRETS "vpn-secrets"
|
|
|
|
|
#define NM_KEYFILE_GROUPPREFIX_WIREGUARD_PEER "wireguard-peer."
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-05-05 08:23:16 +02:00
|
|
|
#define nm_keyfile_error_is_not_found(error) \
|
|
|
|
|
nm_g_error_matches(error, \
|
|
|
|
|
G_KEY_FILE_ERROR, \
|
|
|
|
|
G_KEY_FILE_ERROR_GROUP_NOT_FOUND, \
|
|
|
|
|
G_KEY_FILE_ERROR_KEY_NOT_FOUND)
|
|
|
|
|
|
2015-02-18 19:59:28 +01:00
|
|
|
const char *nm_keyfile_plugin_get_alias_for_setting_name(const char *setting_name);
|
|
|
|
|
|
|
|
|
|
const char *nm_keyfile_plugin_get_setting_name_for_alias(const char *alias);
|
|
|
|
|
|
2016-10-02 18:22:50 +02:00
|
|
|
/*****************************************************************************/
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-04-28 18:10:55 +02:00
|
|
|
guint *nm_keyfile_plugin_kf_get_integer_list_uint(GKeyFile * kf,
|
|
|
|
|
const char *group,
|
|
|
|
|
const char *key,
|
|
|
|
|
gsize * out_length,
|
|
|
|
|
GError ** error);
|
|
|
|
|
char **nm_keyfile_plugin_kf_get_string_list(GKeyFile * kf,
|
|
|
|
|
const char *group,
|
|
|
|
|
const char *key,
|
|
|
|
|
gsize * out_length,
|
|
|
|
|
GError ** error);
|
|
|
|
|
char *
|
|
|
|
|
nm_keyfile_plugin_kf_get_string(GKeyFile *kf, const char *group, const char *key, GError **error);
|
|
|
|
|
gboolean
|
|
|
|
|
nm_keyfile_plugin_kf_get_boolean(GKeyFile *kf, const char *group, const char *key, GError **error);
|
|
|
|
|
char *
|
|
|
|
|
nm_keyfile_plugin_kf_get_value(GKeyFile *kf, const char *group, const char *key, GError **error);
|
2020-09-28 16:03:33 +02:00
|
|
|
|
2020-04-28 17:29:37 +02:00
|
|
|
void nm_keyfile_plugin_kf_set_integer_list_uint8(GKeyFile * kf,
|
|
|
|
|
const char * group,
|
|
|
|
|
const char * key,
|
|
|
|
|
const guint8 *list,
|
2020-04-28 17:31:33 +02:00
|
|
|
gsize length);
|
|
|
|
|
void nm_keyfile_plugin_kf_set_integer_list_uint(GKeyFile * kf,
|
|
|
|
|
const char * group,
|
|
|
|
|
const char * key,
|
|
|
|
|
const guint *list,
|
2020-04-28 17:29:37 +02:00
|
|
|
gsize length);
|
|
|
|
|
void nm_keyfile_plugin_kf_set_string_list(GKeyFile * kf,
|
|
|
|
|
const char * group,
|
|
|
|
|
const char * key,
|
|
|
|
|
const char *const *list,
|
2020-04-28 16:53:01 +02:00
|
|
|
gsize length);
|
2020-09-28 16:03:33 +02:00
|
|
|
|
2020-04-28 16:53:01 +02:00
|
|
|
void nm_keyfile_plugin_kf_set_string(GKeyFile * kf,
|
|
|
|
|
const char *group,
|
|
|
|
|
const char *key,
|
|
|
|
|
const char *value);
|
|
|
|
|
void
|
|
|
|
|
nm_keyfile_plugin_kf_set_boolean(GKeyFile *kf, const char *group, const char *key, gboolean value);
|
|
|
|
|
void
|
|
|
|
|
nm_keyfile_plugin_kf_set_value(GKeyFile *kf, const char *group, const char *key, const char *value);
|
2020-09-28 16:03:33 +02:00
|
|
|
|
2018-12-30 15:05:14 +01:00
|
|
|
gint64 nm_keyfile_plugin_kf_get_int64(GKeyFile * kf,
|
2020-04-28 16:53:01 +02:00
|
|
|
const char *group,
|
|
|
|
|
const char *key,
|
|
|
|
|
guint base,
|
2018-12-30 15:05:14 +01:00
|
|
|
gint64 min,
|
|
|
|
|
gint64 max,
|
|
|
|
|
gint64 fallback,
|
2020-04-28 16:53:01 +02:00
|
|
|
GError ** error);
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-09-28 16:03:33 +02:00
|
|
|
char **
|
2020-04-28 16:53:01 +02:00
|
|
|
nm_keyfile_plugin_kf_get_keys(GKeyFile *kf, const char *group, gsize *out_length, GError **error);
|
2015-02-18 19:59:28 +01:00
|
|
|
|
2020-09-28 16:03:33 +02:00
|
|
|
gboolean
|
2017-05-05 12:01:17 +02:00
|
|
|
nm_keyfile_plugin_kf_has_key(GKeyFile *kf, const char *group, const char *key, GError **error);
|
|
|
|
|
|
|
|
|
|
const char *nm_keyfile_key_encode(const char *name, char **out_to_free);
|
|
|
|
|
|
2020-04-28 18:10:55 +02:00
|
|
|
const char *nm_keyfile_key_decode(const char *key, char **out_to_free);
|
2020-09-28 16:03:33 +02:00
|
|
|
|
2015-02-18 18:59:35 +01:00
|
|
|
#endif /* __NM_KEYFILE_UTILS_H__ */
|
