mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2026-05-22 05:28:12 +02:00
On D-Bus level, string (s) or object paths (o) cannot be NULL. Thus, whenver server exposes such an object, it gets automatically coerced to "" or "/", respectively. On client side, libnm should coerce certain properties back, for which "" is just not a sensible value. For example, an empty NM_DEVICE_ETHERNET_HW_ADDRESS should be instead exposed as NULL. Technically, this is an API change. However, all users were well advised to expect both NULL and "" as possible return values and handle them accordingly.
258 lines
7.1 KiB
C
258 lines
7.1 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
/*
|
|
* 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 2012 Red Hat, Inc.
|
|
*/
|
|
|
|
#include "nm-default.h"
|
|
|
|
#include <string.h>
|
|
|
|
#include "nm-setting-connection.h"
|
|
#include "nm-setting-olpc-mesh.h"
|
|
|
|
#include "nm-device-olpc-mesh.h"
|
|
#include "nm-device-private.h"
|
|
#include "nm-object-private.h"
|
|
#include "nm-device-wifi.h"
|
|
|
|
G_DEFINE_TYPE (NMDeviceOlpcMesh, nm_device_olpc_mesh, NM_TYPE_DEVICE)
|
|
|
|
#define NM_DEVICE_OLPC_MESH_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), NM_TYPE_DEVICE_OLPC_MESH, NMDeviceOlpcMeshPrivate))
|
|
|
|
typedef struct {
|
|
char *hw_address;
|
|
NMDeviceWifi *companion;
|
|
guint32 active_channel;
|
|
} NMDeviceOlpcMeshPrivate;
|
|
|
|
enum {
|
|
PROP_0,
|
|
PROP_HW_ADDRESS,
|
|
PROP_COMPANION,
|
|
PROP_ACTIVE_CHANNEL,
|
|
|
|
LAST_PROP
|
|
};
|
|
|
|
/**
|
|
* nm_device_olpc_mesh_get_hw_address:
|
|
* @device: a #NMDeviceOlpcMesh
|
|
*
|
|
* Gets the hardware (MAC) address of the #NMDeviceOlpcMesh
|
|
*
|
|
* Returns: the hardware address. This is the internal string used by the
|
|
* device, and must not be modified.
|
|
**/
|
|
const char *
|
|
nm_device_olpc_mesh_get_hw_address (NMDeviceOlpcMesh *device)
|
|
{
|
|
g_return_val_if_fail (NM_IS_DEVICE_OLPC_MESH (device), NULL);
|
|
|
|
return nm_str_not_empty (NM_DEVICE_OLPC_MESH_GET_PRIVATE (device)->hw_address);
|
|
}
|
|
|
|
/**
|
|
* nm_device_olpc_mesh_get_companion:
|
|
* @device: a #NMDeviceOlpcMesh
|
|
*
|
|
* Gets the companion device of the #NMDeviceOlpcMesh.
|
|
*
|
|
* Returns: (transfer none): the companion of the device of %NULL
|
|
**/
|
|
NMDeviceWifi *
|
|
nm_device_olpc_mesh_get_companion (NMDeviceOlpcMesh *device)
|
|
{
|
|
g_return_val_if_fail (NM_IS_DEVICE_OLPC_MESH (device), NULL);
|
|
|
|
return NM_DEVICE_OLPC_MESH_GET_PRIVATE (device)->companion;
|
|
}
|
|
|
|
/**
|
|
* nm_device_olpc_mesh_get_active_channel:
|
|
* @device: a #NMDeviceOlpcMesh
|
|
*
|
|
* Returns the active channel of the #NMDeviceOlpcMesh device.
|
|
*
|
|
* Returns: active channel of the device
|
|
**/
|
|
guint32
|
|
nm_device_olpc_mesh_get_active_channel (NMDeviceOlpcMesh *device)
|
|
{
|
|
g_return_val_if_fail (NM_IS_DEVICE_OLPC_MESH (device), 0);
|
|
|
|
return NM_DEVICE_OLPC_MESH_GET_PRIVATE (device)->active_channel;
|
|
}
|
|
|
|
static const char *
|
|
get_hw_address (NMDevice *device)
|
|
{
|
|
return nm_device_olpc_mesh_get_hw_address (NM_DEVICE_OLPC_MESH (device));
|
|
}
|
|
|
|
static gboolean
|
|
connection_compatible (NMDevice *device, NMConnection *connection, GError **error)
|
|
{
|
|
if (!NM_DEVICE_CLASS (nm_device_olpc_mesh_parent_class)->connection_compatible (device, connection, error))
|
|
return FALSE;
|
|
|
|
if (!nm_connection_is_type (connection, NM_SETTING_OLPC_MESH_SETTING_NAME)) {
|
|
g_set_error_literal (error, NM_DEVICE_ERROR, NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION,
|
|
_("The connection was not an OLPC Mesh connection."));
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
static GType
|
|
get_setting_type (NMDevice *device)
|
|
{
|
|
return NM_TYPE_SETTING_OLPC_MESH;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
nm_device_olpc_mesh_init (NMDeviceOlpcMesh *device)
|
|
{
|
|
_nm_device_set_device_type (NM_DEVICE (device), NM_DEVICE_TYPE_OLPC_MESH);
|
|
}
|
|
|
|
static void
|
|
init_dbus (NMObject *object)
|
|
{
|
|
NMDeviceOlpcMeshPrivate *priv = NM_DEVICE_OLPC_MESH_GET_PRIVATE (object);
|
|
const NMPropertiesInfo property_info[] = {
|
|
{ NM_DEVICE_OLPC_MESH_HW_ADDRESS, &priv->hw_address },
|
|
{ NM_DEVICE_OLPC_MESH_COMPANION, &priv->companion, NULL, NM_TYPE_DEVICE_WIFI },
|
|
{ NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL, &priv->active_channel },
|
|
{ NULL },
|
|
};
|
|
|
|
NM_OBJECT_CLASS (nm_device_olpc_mesh_parent_class)->init_dbus (object);
|
|
|
|
_nm_object_register_properties (object,
|
|
NM_DBUS_INTERFACE_DEVICE_OLPC_MESH,
|
|
property_info);
|
|
}
|
|
|
|
static void
|
|
dispose (GObject *object)
|
|
{
|
|
NMDeviceOlpcMeshPrivate *priv = NM_DEVICE_OLPC_MESH_GET_PRIVATE (object);
|
|
|
|
g_clear_object (&priv->companion);
|
|
|
|
G_OBJECT_CLASS (nm_device_olpc_mesh_parent_class)->dispose (object);
|
|
}
|
|
|
|
static void
|
|
finalize (GObject *object)
|
|
{
|
|
NMDeviceOlpcMeshPrivate *priv = NM_DEVICE_OLPC_MESH_GET_PRIVATE (object);
|
|
|
|
g_free (priv->hw_address);
|
|
|
|
G_OBJECT_CLASS (nm_device_olpc_mesh_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
NMDeviceOlpcMesh *device = NM_DEVICE_OLPC_MESH (object);
|
|
|
|
switch (prop_id) {
|
|
case PROP_HW_ADDRESS:
|
|
g_value_set_string (value, nm_device_olpc_mesh_get_hw_address (device));
|
|
break;
|
|
case PROP_COMPANION:
|
|
g_value_set_object (value, nm_device_olpc_mesh_get_companion (device));
|
|
break;
|
|
case PROP_ACTIVE_CHANNEL:
|
|
g_value_set_uint (value, nm_device_olpc_mesh_get_active_channel (device));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
nm_device_olpc_mesh_class_init (NMDeviceOlpcMeshClass *olpc_mesh_class)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (olpc_mesh_class);
|
|
NMObjectClass *nm_object_class = NM_OBJECT_CLASS (olpc_mesh_class);
|
|
NMDeviceClass *device_class = NM_DEVICE_CLASS (olpc_mesh_class);
|
|
|
|
g_type_class_add_private (olpc_mesh_class, sizeof (NMDeviceOlpcMeshPrivate));
|
|
|
|
_nm_object_class_add_interface (nm_object_class, NM_DBUS_INTERFACE_DEVICE_OLPC_MESH);
|
|
|
|
/* virtual methods */
|
|
object_class->dispose = dispose;
|
|
object_class->finalize = finalize;
|
|
object_class->get_property = get_property;
|
|
|
|
nm_object_class->init_dbus = init_dbus;
|
|
|
|
device_class->connection_compatible = connection_compatible;
|
|
device_class->get_setting_type = get_setting_type;
|
|
device_class->get_hw_address = get_hw_address;
|
|
|
|
/* properties */
|
|
|
|
/**
|
|
* NMDeviceOlpcMesh:hw-address:
|
|
*
|
|
* The hardware (MAC) address of the device.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_HW_ADDRESS,
|
|
g_param_spec_string (NM_DEVICE_OLPC_MESH_HW_ADDRESS, "", "",
|
|
NULL,
|
|
G_PARAM_READABLE |
|
|
G_PARAM_STATIC_STRINGS));
|
|
|
|
/**
|
|
* NMDeviceOlpcMesh:companion:
|
|
*
|
|
* The companion device.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_COMPANION,
|
|
g_param_spec_object (NM_DEVICE_OLPC_MESH_COMPANION, "", "",
|
|
NM_TYPE_DEVICE_WIFI,
|
|
G_PARAM_READABLE |
|
|
G_PARAM_STATIC_STRINGS));
|
|
|
|
/**
|
|
* NMDeviceOlpcMesh:active-channel:
|
|
*
|
|
* The device's active channel.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_ACTIVE_CHANNEL,
|
|
g_param_spec_uint (NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL, "", "",
|
|
0, G_MAXUINT32, 0,
|
|
G_PARAM_READABLE |
|
|
G_PARAM_STATIC_STRINGS));
|
|
|
|
}
|