mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-25 03:40:07 +01:00
9fd98ef91b
Implement GInitable and GAsyncInitable in NMObject, with implementations that synchronously or asynchonously load all properties, and change _nm_object_ensure_inited() to run g_initable_init(). Update the object/object-array property handling to initialize the objects after creating them (synchronously or asynchronously, according to the situation), so that they will have all of their properties preloaded before they are ever visible to the caller. Move the non-blocking/non-failable parts of various objects' constructor() methods to constructed(), and move the blocking/failable parts to init(), and implement init_async() methods with non-blocking versions of the blocking methods. Make nm_device_new() and nm_client_new() call _nm_object_ensure_inited(), to preserve the behaviour formerly enforced by their construct() methods, that properties are guaranteed to be initialized before any signals involving them are emitted.
97 lines
3.7 KiB
C
97 lines
3.7 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
/*
|
|
* libnm_glib -- Access network status & information from glib applications
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
* Copyright (C) 2008 - 2011 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef NM_OBJECT_PRIVATE_H
|
|
#define NM_OBJECT_PRIVATE_H
|
|
|
|
#include <gio/gio.h>
|
|
#include "nm-object.h"
|
|
|
|
void _nm_object_ensure_inited (NMObject *object);
|
|
|
|
typedef gboolean (*PropertyMarshalFunc) (NMObject *, GParamSpec *, GValue *, gpointer);
|
|
|
|
typedef GObject * (*NMObjectCreatorFunc) (DBusGConnection *, const char *);
|
|
|
|
typedef struct {
|
|
const char *name;
|
|
gpointer field;
|
|
PropertyMarshalFunc func;
|
|
GType object_type;
|
|
} NMPropertiesInfo;
|
|
|
|
|
|
void _nm_object_register_properties (NMObject *object,
|
|
DBusGProxy *proxy,
|
|
const NMPropertiesInfo *info);
|
|
|
|
gboolean _nm_object_reload_properties (NMObject *object, GError **error);
|
|
|
|
void _nm_object_reload_properties_async (NMObject *object,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean _nm_object_reload_properties_finish (NMObject *object,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
typedef void (*NMPseudoPropertyChangedFunc) (NMObject *self, NMObject *changed);
|
|
void _nm_object_register_pseudo_property (NMObject *object,
|
|
DBusGProxy *proxy,
|
|
const char *name,
|
|
gpointer field,
|
|
GType object_type,
|
|
NMPseudoPropertyChangedFunc added_func,
|
|
NMPseudoPropertyChangedFunc removed_func);
|
|
void _nm_object_reload_pseudo_property (NMObject *object,
|
|
const char *name);
|
|
|
|
void _nm_object_queue_notify (NMObject *object, const char *property);
|
|
|
|
/* DBus property accessors */
|
|
|
|
void _nm_object_reload_property (NMObject *object,
|
|
const char *interface,
|
|
const char *prop_name);
|
|
|
|
void _nm_object_set_property (NMObject *object,
|
|
const char *interface,
|
|
const char *prop_name,
|
|
GValue *value);
|
|
|
|
static inline const GPtrArray *
|
|
handle_ptr_array_return (GPtrArray *array)
|
|
{
|
|
/* zero-length is special-case; return NULL */
|
|
if (!array || !array->len)
|
|
return NULL;
|
|
return array;
|
|
}
|
|
|
|
/* object demarshalling support */
|
|
typedef GType (*NMObjectTypeFunc) (DBusGConnection *, const char *);
|
|
typedef void (*NMObjectTypeCallbackFunc) (GType, gpointer);
|
|
typedef void (*NMObjectTypeAsyncFunc) (DBusGConnection *, const char *, NMObjectTypeCallbackFunc, gpointer);
|
|
|
|
void _nm_object_register_type_func (GType base_type, NMObjectTypeFunc type_func,
|
|
NMObjectTypeAsyncFunc type_async_func);
|
|
|
|
#endif /* NM_OBJECT_PRIVATE_H */
|