mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-29 01:00:09 +01:00
d7056d13d0
As nm_settings_plugin_initialize() could not fail (it returned no value indicating failure), there is no reason to explicitly call this. Instead just initialize the plugin when needed. Also, we don't need the plugin to initialize early before nm_settings_plugin_get_connections().
127 lines
5.5 KiB
C
127 lines
5.5 KiB
C
/* NetworkManager system settings service
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Copyright (C) 2007 - 2018 Red Hat, Inc.
|
|
* Copyright (C) 2008 Novell, Inc.
|
|
*/
|
|
|
|
#ifndef __NM_SETTINGS_PLUGIN_H__
|
|
#define __NM_SETTINGS_PLUGIN_H__
|
|
|
|
#include "nm-connection.h"
|
|
|
|
#define NM_TYPE_SETTINGS_PLUGIN (nm_settings_plugin_get_type ())
|
|
#define NM_SETTINGS_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), NM_TYPE_SETTINGS_PLUGIN, NMSettingsPlugin))
|
|
#define NM_SETTINGS_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), NM_TYPE_SETTINGS_PLUGIN, NMSettingsPluginClass))
|
|
#define NM_IS_SETTINGS_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), NM_TYPE_SETTINGS_PLUGIN))
|
|
#define NM_IS_SETTINGS_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), NM_TYPE_SETTINGS_PLUGIN))
|
|
#define NM_SETTINGS_PLUGIN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), NM_TYPE_SETTINGS_PLUGIN, NMSettingsPluginClass))
|
|
|
|
#define NM_SETTINGS_PLUGIN_UNMANAGED_SPECS_CHANGED "unmanaged-specs-changed"
|
|
#define NM_SETTINGS_PLUGIN_UNRECOGNIZED_SPECS_CHANGED "unrecognized-specs-changed"
|
|
#define NM_SETTINGS_PLUGIN_CONNECTION_ADDED "connection-added"
|
|
|
|
typedef struct {
|
|
GObject parent;
|
|
} NMSettingsPlugin;
|
|
|
|
typedef struct {
|
|
GObjectClass parent;
|
|
|
|
/* Returns a GSList of NMSettingsConnection objects that represent
|
|
* connections the plugin knows about. The returned list is freed by the
|
|
* system settings service.
|
|
*/
|
|
GSList * (*get_connections) (NMSettingsPlugin *plugin);
|
|
|
|
/* Requests that the plugin load/reload a single connection, if it
|
|
* recognizes the filename. Returns success or failure.
|
|
*/
|
|
gboolean (*load_connection) (NMSettingsPlugin *plugin,
|
|
const char *filename);
|
|
|
|
/* Requests that the plugin reload all connection files from disk,
|
|
* and emit signals reflecting new, changed, and removed connections.
|
|
*/
|
|
void (*reload_connections) (NMSettingsPlugin *plugin);
|
|
|
|
/*
|
|
* Return a string list of specifications of devices which NetworkManager
|
|
* should not manage. Returned list will be freed by the system settings
|
|
* service, and each element must be allocated using g_malloc() or its
|
|
* variants (g_strdup, g_strdup_printf, etc).
|
|
*
|
|
* Each string in the list must be in one of the formats recognized by
|
|
* nm_device_spec_match_list().
|
|
*/
|
|
GSList * (*get_unmanaged_specs) (NMSettingsPlugin *plugin);
|
|
|
|
/*
|
|
* Return a string list of specifications of devices for which at least
|
|
* one non-NetworkManager-based configuration is defined. Returned list
|
|
* will be freed by the system settings service, and each element must be
|
|
* allocated using g_malloc() or its variants (g_strdup, g_strdup_printf,
|
|
* etc).
|
|
*
|
|
* Each string in the list must be in one of the formats recognized by
|
|
* nm_device_spec_match_list().
|
|
*/
|
|
GSList * (*get_unrecognized_specs) (NMSettingsPlugin *plugin);
|
|
|
|
/*
|
|
* Initialize the plugin-specific connection and return a new
|
|
* NMSettingsConnection subclass that contains the same settings as the
|
|
* original connection. The connection should only be saved to backing
|
|
* storage if @save_to_disk is TRUE. The returned object is owned by the
|
|
* plugin and must be referenced by the owner if necessary.
|
|
*/
|
|
NMSettingsConnection * (*add_connection) (NMSettingsPlugin *plugin,
|
|
NMConnection *connection,
|
|
gboolean save_to_disk,
|
|
GError **error);
|
|
} NMSettingsPluginClass;
|
|
|
|
GType nm_settings_plugin_get_type (void);
|
|
|
|
typedef NMSettingsPlugin *(*NMSettingsPluginFactoryFunc) (void);
|
|
|
|
/* Plugin's factory function that returns a #NMSettingsPlugin */
|
|
NMSettingsPlugin *nm_settings_plugin_factory (void);
|
|
|
|
GSList *nm_settings_plugin_get_connections (NMSettingsPlugin *plugin);
|
|
|
|
gboolean nm_settings_plugin_load_connection (NMSettingsPlugin *plugin,
|
|
const char *filename);
|
|
void nm_settings_plugin_reload_connections (NMSettingsPlugin *plugin);
|
|
|
|
GSList *nm_settings_plugin_get_unmanaged_specs (NMSettingsPlugin *plugin);
|
|
GSList *nm_settings_plugin_get_unrecognized_specs (NMSettingsPlugin *plugin);
|
|
|
|
NMSettingsConnection *nm_settings_plugin_add_connection (NMSettingsPlugin *plugin,
|
|
NMConnection *connection,
|
|
gboolean save_to_disk,
|
|
GError **error);
|
|
|
|
/* internal API */
|
|
|
|
void _nm_settings_plugin_emit_signal_connection_added (NMSettingsPlugin *plugin,
|
|
NMSettingsConnection *sett_conn);
|
|
|
|
void _nm_settings_plugin_emit_signal_unmanaged_specs_changed (NMSettingsPlugin *plugin);
|
|
|
|
void _nm_settings_plugin_emit_signal_unrecognized_specs_changed (NMSettingsPlugin *plugin);
|
|
|
|
#endif /* __NM_SETTINGS_PLUGIN_H__ */
|