mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager
synced 2024-10-15 12:34:55 +00:00
4abb300c96
(comments by dcbw) This allows out-of-the-box connectivity on IPv6-only networks. Once caveat is that connections where the user currently expects no IPv4 connectivity to terminate the connection and retry will no longer do so until IPv6 also times out, and if that network where IPv4 is expected to fail also has an IPv6 router sending advertisements, the connection will succeed instead of failing. That can be resolved by setting the right bit in the connection's config file; and it's expected that the number of users who expect IPv4 failure on a network with usable IPv6 connectivity is quite small compared to the benefit of OOB IPv6 connectivity.
1698 lines
50 KiB
C
1698 lines
50 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
|
|
/*
|
|
* Dan Williams <dcbw@redhat.com>
|
|
* Tambet Ingo <tambet@gmail.com>
|
|
*
|
|
* 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.
|
|
*
|
|
* (C) Copyright 2007 - 2010 Red Hat, Inc.
|
|
* (C) Copyright 2007 - 2008 Novell, Inc.
|
|
*/
|
|
|
|
#include <string.h>
|
|
|
|
#include <dbus/dbus-glib.h>
|
|
#include "nm-setting-ip4-config.h"
|
|
#include "nm-param-spec-specialized.h"
|
|
#include "nm-utils.h"
|
|
#include "nm-dbus-glib-types.h"
|
|
|
|
/**
|
|
* SECTION:nm-setting-ip4-config
|
|
* @short_description: Describes IPv4 addressing, routing, and name service properties
|
|
* @include: nm-setting-ip4-config.h
|
|
*
|
|
* The #NMSettingIP4Config object is a #NMSetting subclass that describes
|
|
* properties related to IPv4 addressing, routing, and Domain Name Service
|
|
**/
|
|
|
|
/**
|
|
* nm_setting_ip4_config_error_quark:
|
|
*
|
|
* Registers an error quark for #NMSettingIP4Config if necessary.
|
|
*
|
|
* Returns: the error quark used for #NMSettingIP4Config errors.
|
|
**/
|
|
GQuark
|
|
nm_setting_ip4_config_error_quark (void)
|
|
{
|
|
static GQuark quark;
|
|
|
|
if (G_UNLIKELY (!quark))
|
|
quark = g_quark_from_static_string ("nm-setting-ip4-config-error-quark");
|
|
return quark;
|
|
}
|
|
|
|
#if GLIB_CHECK_VERSION(2,26,0)
|
|
G_DEFINE_BOXED_TYPE (NMIP4Address, nm_ip4_address, nm_ip4_address_dup, nm_ip4_address_unref)
|
|
G_DEFINE_BOXED_TYPE (NMIP4Route, nm_ip4_route, nm_ip4_route_dup, nm_ip4_route_unref)
|
|
#endif
|
|
|
|
G_DEFINE_TYPE (NMSettingIP4Config, nm_setting_ip4_config, NM_TYPE_SETTING)
|
|
|
|
#define NM_SETTING_IP4_CONFIG_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), NM_TYPE_SETTING_IP4_CONFIG, NMSettingIP4ConfigPrivate))
|
|
|
|
typedef struct {
|
|
char *method;
|
|
GArray *dns; /* array of guint32; elements in network byte order */
|
|
GSList *dns_search; /* list of strings */
|
|
GSList *addresses; /* array of NMIP4Address */
|
|
GSList *routes; /* array of NMIP4Route */
|
|
gboolean ignore_auto_routes;
|
|
gboolean ignore_auto_dns;
|
|
char *dhcp_client_id;
|
|
gboolean dhcp_send_hostname;
|
|
char *dhcp_hostname;
|
|
gboolean never_default;
|
|
gboolean may_fail;
|
|
} NMSettingIP4ConfigPrivate;
|
|
|
|
enum {
|
|
PROP_0,
|
|
PROP_METHOD,
|
|
PROP_DNS,
|
|
PROP_DNS_SEARCH,
|
|
PROP_ADDRESSES,
|
|
PROP_ROUTES,
|
|
PROP_IGNORE_AUTO_ROUTES,
|
|
PROP_IGNORE_AUTO_DNS,
|
|
PROP_DHCP_CLIENT_ID,
|
|
PROP_DHCP_SEND_HOSTNAME,
|
|
PROP_DHCP_HOSTNAME,
|
|
PROP_NEVER_DEFAULT,
|
|
PROP_MAY_FAIL,
|
|
|
|
LAST_PROP
|
|
};
|
|
|
|
/**
|
|
* nm_setting_ip4_config_new:
|
|
*
|
|
* Creates a new #NMSettingIP4Config object with default values.
|
|
*
|
|
* Returns: (transfer full): the new empty #NMSettingIP4Config object
|
|
**/
|
|
NMSetting *
|
|
nm_setting_ip4_config_new (void)
|
|
{
|
|
return (NMSetting *) g_object_new (NM_TYPE_SETTING_IP4_CONFIG, NULL);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_method:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns: the #NMSettingIP4Config:method property of the setting
|
|
**/
|
|
const char *
|
|
nm_setting_ip4_config_get_method (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->method;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_num_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns: the number of configured DNS servers
|
|
**/
|
|
guint32
|
|
nm_setting_ip4_config_get_num_dns (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), 0);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dns->len;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the DNS server to return
|
|
*
|
|
* Returns: the IPv4 address (network byte order) of the DNS server at index
|
|
* @i
|
|
**/
|
|
guint32
|
|
nm_setting_ip4_config_get_dns (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), 0);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_return_val_if_fail (i <= priv->dns->len, 0);
|
|
|
|
return g_array_index (priv->dns, guint32, i);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_add_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @dns: the IPv4 address (network byte order) of the DNS server to add
|
|
*
|
|
* Adds a new DNS server to the setting.
|
|
*
|
|
* Returns: %TRUE if the DNS server was added; %FALSE if the server was already
|
|
* known
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_add_dns (NMSettingIP4Config *setting, guint32 dns)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
int i;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
for (i = 0; i < priv->dns->len; i++) {
|
|
if (dns == g_array_index (priv->dns, guint32, i))
|
|
return FALSE;
|
|
}
|
|
|
|
g_array_append_val (priv->dns, dns);
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_remove_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the DNS server to remove
|
|
*
|
|
* Removes the DNS server at index @i.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_remove_dns (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_return_if_fail (i <= priv->dns->len);
|
|
|
|
g_array_remove_index (priv->dns, i);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_clear_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Removes all configured DNS servers.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_clear_dns (NMSettingIP4Config *setting)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_array_remove_range (priv->dns, 0, priv->dns->len);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_num_dns_searches:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns: the number of configured DNS search domains
|
|
**/
|
|
guint32
|
|
nm_setting_ip4_config_get_num_dns_searches (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), 0);
|
|
|
|
return g_slist_length (NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dns_search);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_dns_search:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the DNS search domain to return
|
|
*
|
|
* Returns: the DNS search domain at index @i
|
|
**/
|
|
const char *
|
|
nm_setting_ip4_config_get_dns_search (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_return_val_if_fail (i <= g_slist_length (priv->dns_search), NULL);
|
|
|
|
return (const char *) g_slist_nth_data (priv->dns_search, i);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_add_dns_search:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @dns_search: the search domain to add
|
|
*
|
|
* Adds a new DNS search domain to the setting.
|
|
*
|
|
* Returns: %TRUE if the DNS search domain was added; %FALSE if the search
|
|
* domain was already known
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_add_dns_search (NMSettingIP4Config *setting,
|
|
const char *dns_search)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
GSList *iter;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
g_return_val_if_fail (dns_search != NULL, FALSE);
|
|
g_return_val_if_fail (dns_search[0] != '\0', FALSE);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
for (iter = priv->dns_search; iter; iter = g_slist_next (iter)) {
|
|
if (!strcmp (dns_search, (char *) iter->data))
|
|
return FALSE;
|
|
}
|
|
|
|
priv->dns_search = g_slist_append (priv->dns_search, g_strdup (dns_search));
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_remove_dns_search:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the DNS search domain
|
|
*
|
|
* Removes the DNS search domain at index @i.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_remove_dns_search (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
GSList *elt;
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
elt = g_slist_nth (priv->dns_search, i);
|
|
g_return_if_fail (elt != NULL);
|
|
|
|
g_free (elt->data);
|
|
priv->dns_search = g_slist_delete_link (priv->dns_search, elt);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_clear_dns_searches:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Removes all configured DNS search domains.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_clear_dns_searches (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
nm_utils_slist_free (NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dns_search, g_free);
|
|
NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dns_search = NULL;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_num_addresses:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns: the number of configured addresses
|
|
**/
|
|
guint32
|
|
nm_setting_ip4_config_get_num_addresses (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), 0);
|
|
|
|
return g_slist_length (NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->addresses);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_address:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the address to return
|
|
*
|
|
* Returns: the address at index @i
|
|
**/
|
|
NMIP4Address *
|
|
nm_setting_ip4_config_get_address (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_return_val_if_fail (i <= g_slist_length (priv->addresses), NULL);
|
|
|
|
return (NMIP4Address *) g_slist_nth_data (priv->addresses, i);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_add_address:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @address: the new address to add
|
|
*
|
|
* Adds a new IPv4 address and associated information to the setting. The
|
|
* given address is duplicated internally and is not changed by this function.
|
|
*
|
|
* Returns: %TRUE if the address was added; %FALSE if the address was already
|
|
* known.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_add_address (NMSettingIP4Config *setting,
|
|
NMIP4Address *address)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
NMIP4Address *copy;
|
|
GSList *iter;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
g_return_val_if_fail (address != NULL, FALSE);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
for (iter = priv->addresses; iter; iter = g_slist_next (iter)) {
|
|
if (nm_ip4_address_compare ((NMIP4Address *) iter->data, address))
|
|
return FALSE;
|
|
}
|
|
|
|
copy = nm_ip4_address_dup (address);
|
|
g_return_val_if_fail (copy != NULL, FALSE);
|
|
|
|
priv->addresses = g_slist_append (priv->addresses, copy);
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_remove_address:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the address to remove
|
|
*
|
|
* Removes the address at index @i.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_remove_address (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
GSList *elt;
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
elt = g_slist_nth (priv->addresses, i);
|
|
g_return_if_fail (elt != NULL);
|
|
|
|
nm_ip4_address_unref ((NMIP4Address *) elt->data);
|
|
priv->addresses = g_slist_delete_link (priv->addresses, elt);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_clear_addresses:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Removes all configured addresses.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_clear_addresses (NMSettingIP4Config *setting)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
nm_utils_slist_free (priv->addresses, (GDestroyNotify) nm_ip4_address_unref);
|
|
priv->addresses = NULL;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_num_routes:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns: the number of configured routes
|
|
**/
|
|
guint32
|
|
nm_setting_ip4_config_get_num_routes (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), 0);
|
|
|
|
return g_slist_length (NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->routes);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_route:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the route to return
|
|
*
|
|
* Returns: the route at index @i
|
|
**/
|
|
NMIP4Route *
|
|
nm_setting_ip4_config_get_route (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
g_return_val_if_fail (i <= g_slist_length (priv->routes), NULL);
|
|
|
|
return (NMIP4Route *) g_slist_nth_data (priv->routes, i);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_add_route:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @route: the route to add
|
|
*
|
|
* Adds a new IPv4 route and associated information to the setting. The
|
|
* given route is duplicated internally and is not changed by this function.
|
|
*
|
|
* Returns: %TRUE if the route was added; %FALSE if the route was already known.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_add_route (NMSettingIP4Config *setting,
|
|
NMIP4Route *route)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
NMIP4Route *copy;
|
|
GSList *iter;
|
|
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
g_return_val_if_fail (route != NULL, FALSE);
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
for (iter = priv->routes; iter; iter = g_slist_next (iter)) {
|
|
if (nm_ip4_route_compare ((NMIP4Route *) iter->data, route))
|
|
return FALSE;
|
|
}
|
|
|
|
copy = nm_ip4_route_dup (route);
|
|
g_return_val_if_fail (copy != NULL, FALSE);
|
|
|
|
priv->routes = g_slist_append (priv->routes, copy);
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_remove_route:
|
|
* @setting: the #NMSettingIP4Config
|
|
* @i: index number of the route
|
|
*
|
|
* Removes the route at index @i.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_remove_route (NMSettingIP4Config *setting, guint32 i)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv;
|
|
GSList *elt;
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
elt = g_slist_nth (priv->routes, i);
|
|
g_return_if_fail (elt != NULL);
|
|
|
|
nm_ip4_route_unref ((NMIP4Route *) elt->data);
|
|
priv->routes = g_slist_delete_link (priv->routes, elt);
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_clear_routes:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Removes all configured routes.
|
|
**/
|
|
void
|
|
nm_setting_ip4_config_clear_routes (NMSettingIP4Config *setting)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
|
|
g_return_if_fail (NM_IS_SETTING_IP4_CONFIG (setting));
|
|
|
|
nm_utils_slist_free (priv->routes, (GDestroyNotify) nm_ip4_route_unref);
|
|
priv->routes = NULL;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_ignore_auto_routes:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:ignore-auto-routes
|
|
* property.
|
|
*
|
|
* Returns: %TRUE if automatically configured (ie via DHCP) routes should be
|
|
* ignored.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_get_ignore_auto_routes (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->ignore_auto_routes;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_ignore_auto_dns:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:ignore-auto-dns
|
|
* property.
|
|
*
|
|
* Returns: %TRUE if automatically configured (ie via DHCP) DNS information
|
|
* should be ignored.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_get_ignore_auto_dns (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->ignore_auto_dns;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_dhcp_client_id:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:dhcp-client-id
|
|
* property.
|
|
*
|
|
* Returns: the configured Client ID to send to the DHCP server when requesting
|
|
* addresses via DHCP.
|
|
**/
|
|
const char *
|
|
nm_setting_ip4_config_get_dhcp_client_id (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dhcp_client_id;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_dhcp_send_hostname:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:dhcp-send-hostname
|
|
* property.
|
|
*
|
|
* Returns: %TRUE if NetworkManager should send the machine hostname to the
|
|
* DHCP server when requesting addresses to allow the server to automatically
|
|
* update DNS information for this machine.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_get_dhcp_send_hostname (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dhcp_send_hostname;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_dhcp_hostname:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:dhcp-hostname
|
|
* property.
|
|
*
|
|
* Returns: the configured hostname to send to the DHCP server
|
|
**/
|
|
const char *
|
|
nm_setting_ip4_config_get_dhcp_hostname (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), NULL);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->dhcp_hostname;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_never_default:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:never-default
|
|
* property.
|
|
*
|
|
* Returns: %TRUE if this connection should never be the default connection
|
|
* for IPv4 addressing
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_get_never_default (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->never_default;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_ip4_config_get_may_fail:
|
|
* @setting: the #NMSettingIP4Config
|
|
*
|
|
* Returns the value contained in the #NMSettingIP4Config:may-fail
|
|
* property.
|
|
*
|
|
* Returns: %TRUE if this connection doesn't require IPv4 addressing to complete
|
|
* for the connection to succeed.
|
|
**/
|
|
gboolean
|
|
nm_setting_ip4_config_get_may_fail (NMSettingIP4Config *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_IP4_CONFIG (setting), FALSE);
|
|
|
|
return NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting)->may_fail;
|
|
}
|
|
|
|
static gboolean
|
|
verify (NMSetting *setting, GSList *all_settings, GError **error)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
GSList *iter;
|
|
int i;
|
|
|
|
if (!priv->method) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_MISSING_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_METHOD);
|
|
return FALSE;
|
|
}
|
|
|
|
if (!strcmp (priv->method, NM_SETTING_IP4_CONFIG_METHOD_MANUAL)) {
|
|
if (!priv->addresses) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_MISSING_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_ADDRESSES);
|
|
return FALSE;
|
|
}
|
|
} else if ( !strcmp (priv->method, NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL)
|
|
|| !strcmp (priv->method, NM_SETTING_IP4_CONFIG_METHOD_SHARED)
|
|
|| !strcmp (priv->method, NM_SETTING_IP4_CONFIG_METHOD_DISABLED)) {
|
|
if (priv->dns && priv->dns->len) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD,
|
|
NM_SETTING_IP4_CONFIG_DNS);
|
|
return FALSE;
|
|
}
|
|
|
|
if (g_slist_length (priv->dns_search)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD,
|
|
NM_SETTING_IP4_CONFIG_DNS_SEARCH);
|
|
return FALSE;
|
|
}
|
|
|
|
if (g_slist_length (priv->addresses)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD,
|
|
NM_SETTING_IP4_CONFIG_ADDRESSES);
|
|
return FALSE;
|
|
}
|
|
} else if (!strcmp (priv->method, NM_SETTING_IP4_CONFIG_METHOD_AUTO)) {
|
|
/* nothing to do */
|
|
} else {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_METHOD);
|
|
return FALSE;
|
|
}
|
|
|
|
if (priv->dhcp_client_id && !strlen (priv->dhcp_client_id)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID);
|
|
return FALSE;
|
|
}
|
|
|
|
if (priv->dhcp_hostname && !strlen (priv->dhcp_hostname)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME);
|
|
return FALSE;
|
|
}
|
|
|
|
/* Validate addresses */
|
|
for (iter = priv->addresses, i = 0; iter; iter = g_slist_next (iter), i++) {
|
|
NMIP4Address *addr = (NMIP4Address *) iter->data;
|
|
guint32 prefix = nm_ip4_address_get_prefix (addr);
|
|
|
|
if (!nm_ip4_address_get_address (addr)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_ADDRESSES);
|
|
return FALSE;
|
|
}
|
|
|
|
if (!prefix || prefix > 32) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_ADDRESSES);
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/* Validate routes */
|
|
for (iter = priv->routes, i = 0; iter; iter = g_slist_next (iter), i++) {
|
|
NMIP4Route *route = (NMIP4Route *) iter->data;
|
|
guint32 prefix = nm_ip4_route_get_prefix (route);
|
|
|
|
if (!nm_ip4_route_get_dest (route)) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_ROUTES);
|
|
return FALSE;
|
|
}
|
|
|
|
if (!prefix || prefix > 32) {
|
|
g_set_error (error,
|
|
NM_SETTING_IP4_CONFIG_ERROR,
|
|
NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,
|
|
NM_SETTING_IP4_CONFIG_ROUTES);
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
|
|
static void
|
|
nm_setting_ip4_config_init (NMSettingIP4Config *setting)
|
|
{
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
|
|
g_object_set (setting, NM_SETTING_NAME, NM_SETTING_IP4_CONFIG_SETTING_NAME, NULL);
|
|
|
|
priv->dns = g_array_sized_new (FALSE, TRUE, sizeof (guint32), 3);
|
|
}
|
|
|
|
static void
|
|
finalize (GObject *object)
|
|
{
|
|
NMSettingIP4Config *self = NM_SETTING_IP4_CONFIG (object);
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (self);
|
|
|
|
g_free (priv->method);
|
|
|
|
g_array_free (priv->dns, TRUE);
|
|
|
|
nm_utils_slist_free (priv->dns_search, g_free);
|
|
nm_utils_slist_free (priv->addresses, (GDestroyNotify) nm_ip4_address_unref);
|
|
nm_utils_slist_free (priv->routes, (GDestroyNotify) nm_ip4_route_unref);
|
|
|
|
G_OBJECT_CLASS (nm_setting_ip4_config_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
set_property (GObject *object, guint prop_id,
|
|
const GValue *value, GParamSpec *pspec)
|
|
{
|
|
NMSettingIP4Config *setting = NM_SETTING_IP4_CONFIG (object);
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
|
|
switch (prop_id) {
|
|
case PROP_METHOD:
|
|
g_free (priv->method);
|
|
priv->method = g_value_dup_string (value);
|
|
break;
|
|
case PROP_DNS:
|
|
g_array_free (priv->dns, TRUE);
|
|
priv->dns = g_value_dup_boxed (value);
|
|
if (!priv->dns)
|
|
priv->dns = g_array_sized_new (FALSE, TRUE, sizeof (guint32), 3);
|
|
break;
|
|
case PROP_DNS_SEARCH:
|
|
nm_utils_slist_free (priv->dns_search, g_free);
|
|
priv->dns_search = g_value_dup_boxed (value);
|
|
break;
|
|
case PROP_ADDRESSES:
|
|
nm_utils_slist_free (priv->addresses, (GDestroyNotify) nm_ip4_address_unref);
|
|
priv->addresses = nm_utils_ip4_addresses_from_gvalue (value);
|
|
break;
|
|
case PROP_ROUTES:
|
|
nm_utils_slist_free (priv->routes, (GDestroyNotify) nm_ip4_route_unref);
|
|
priv->routes = nm_utils_ip4_routes_from_gvalue (value);
|
|
break;
|
|
case PROP_IGNORE_AUTO_ROUTES:
|
|
priv->ignore_auto_routes = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_IGNORE_AUTO_DNS:
|
|
priv->ignore_auto_dns = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_DHCP_CLIENT_ID:
|
|
g_free (priv->dhcp_client_id);
|
|
priv->dhcp_client_id = g_value_dup_string (value);
|
|
break;
|
|
case PROP_DHCP_SEND_HOSTNAME:
|
|
priv->dhcp_send_hostname = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_DHCP_HOSTNAME:
|
|
g_free (priv->dhcp_hostname);
|
|
priv->dhcp_hostname = g_value_dup_string (value);
|
|
/* FIXME: Is this a good idea? */
|
|
if (priv->dhcp_hostname)
|
|
priv->dhcp_send_hostname = TRUE;
|
|
break;
|
|
case PROP_NEVER_DEFAULT:
|
|
priv->never_default = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_MAY_FAIL:
|
|
priv->may_fail = g_value_get_boolean (value);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
get_property (GObject *object, guint prop_id,
|
|
GValue *value, GParamSpec *pspec)
|
|
{
|
|
NMSettingIP4Config *setting = NM_SETTING_IP4_CONFIG (object);
|
|
NMSettingIP4ConfigPrivate *priv = NM_SETTING_IP4_CONFIG_GET_PRIVATE (setting);
|
|
|
|
switch (prop_id) {
|
|
case PROP_METHOD:
|
|
g_value_set_string (value, nm_setting_ip4_config_get_method (setting));
|
|
break;
|
|
case PROP_DNS:
|
|
g_value_set_boxed (value, priv->dns);
|
|
break;
|
|
case PROP_DNS_SEARCH:
|
|
g_value_set_boxed (value, priv->dns_search);
|
|
break;
|
|
case PROP_ADDRESSES:
|
|
nm_utils_ip4_addresses_to_gvalue (priv->addresses, value);
|
|
break;
|
|
case PROP_ROUTES:
|
|
nm_utils_ip4_routes_to_gvalue (priv->routes, value);
|
|
break;
|
|
case PROP_IGNORE_AUTO_ROUTES:
|
|
g_value_set_boolean (value, nm_setting_ip4_config_get_ignore_auto_routes (setting));
|
|
break;
|
|
case PROP_IGNORE_AUTO_DNS:
|
|
g_value_set_boolean (value, nm_setting_ip4_config_get_ignore_auto_dns (setting));
|
|
break;
|
|
case PROP_DHCP_CLIENT_ID:
|
|
g_value_set_string (value, nm_setting_ip4_config_get_dhcp_client_id (setting));
|
|
break;
|
|
case PROP_DHCP_SEND_HOSTNAME:
|
|
g_value_set_boolean (value, nm_setting_ip4_config_get_dhcp_send_hostname (setting));
|
|
break;
|
|
case PROP_DHCP_HOSTNAME:
|
|
g_value_set_string (value, nm_setting_ip4_config_get_dhcp_hostname (setting));
|
|
break;
|
|
case PROP_NEVER_DEFAULT:
|
|
g_value_set_boolean (value, priv->never_default);
|
|
break;
|
|
case PROP_MAY_FAIL:
|
|
g_value_set_boolean (value, priv->may_fail);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
nm_setting_ip4_config_class_init (NMSettingIP4ConfigClass *setting_class)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (setting_class);
|
|
NMSettingClass *parent_class = NM_SETTING_CLASS (setting_class);
|
|
|
|
g_type_class_add_private (setting_class, sizeof (NMSettingIP4ConfigPrivate));
|
|
|
|
/* virtual methods */
|
|
object_class->set_property = set_property;
|
|
object_class->get_property = get_property;
|
|
object_class->finalize = finalize;
|
|
parent_class->verify = verify;
|
|
|
|
/* Properties */
|
|
/**
|
|
* NMSettingIP4Config:method:
|
|
*
|
|
* IPv4 configuration method. If 'auto' is specified then the appropriate
|
|
* automatic method (DHCP, PPP, etc) is used for the interface and most
|
|
* other properties can be left unset. If 'link-local' is specified, then a
|
|
* link-local address in the 169.254/16 range will be assigned to the
|
|
* interface. If 'manual' is specified, static IP addressing is used and at
|
|
* least one IP address must be given in the 'addresses' property. If
|
|
* 'shared' is specified (indicating that this connection will provide
|
|
* network access to other computers) then the interface is assigned an
|
|
* address in the 10.42.x.1/24 range and a DHCP and forwarding DNS server
|
|
* are started, and the interface is NAT-ed to the current default network
|
|
* connection. 'disabled' means IPv4 will not be used on this connection.
|
|
* This property must be set.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_METHOD,
|
|
g_param_spec_string (NM_SETTING_IP4_CONFIG_METHOD,
|
|
"Method",
|
|
"IPv4 configuration method. If 'auto' is specified "
|
|
"then the appropriate automatic method (DHCP, PPP, "
|
|
"etc) is used for the interface and most other "
|
|
"properties can be left unset. If 'link-local' "
|
|
"is specified, then a link-local address in the "
|
|
"169.254/16 range will be assigned to the "
|
|
"interface. If 'manual' is specified, static IP "
|
|
"addressing is used and at least one IP address "
|
|
"must be given in the 'addresses' property. If "
|
|
"'shared' is specified (indicating that this "
|
|
"connection will provide network access to other "
|
|
"computers) then the interface is assigned an "
|
|
"address in the 10.42.x.1/24 range and a DHCP and "
|
|
"forwarding DNS server are started, and the "
|
|
"interface is NAT-ed to the current default network "
|
|
"connection. 'disabled' means IPv4 will not be "
|
|
"used on this connection. This property must be set.",
|
|
NULL,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:dns:
|
|
*
|
|
* List of DNS servers (network byte order). For the 'auto' method, these
|
|
* DNS servers are appended to those (if any) returned by automatic
|
|
* configuration. DNS servers cannot be used with the 'shared', 'link-local',
|
|
* or 'disabled' methods as there is no usptream network. In all other
|
|
* methods, these DNS servers are used as the only DNS servers for this
|
|
* connection.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_DNS,
|
|
_nm_param_spec_specialized (NM_SETTING_IP4_CONFIG_DNS,
|
|
"DNS",
|
|
"List of DNS servers (network byte order). For "
|
|
"the 'auto' method, these DNS servers are "
|
|
"appended to those (if any) returned by automatic "
|
|
"configuration. DNS servers cannot be used with "
|
|
"the 'shared', 'link-local', or 'disabled' "
|
|
"methods as there is no usptream network. In all "
|
|
"other methods, these DNS servers are used as the "
|
|
"only DNS servers for this connection.",
|
|
DBUS_TYPE_G_UINT_ARRAY,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:dns-search:
|
|
*
|
|
* List of DNS search domains. For the 'auto' method, these search domains
|
|
* are appended to those returned by automatic configuration. Search domains
|
|
* cannot be used with the 'shared', 'link-local', or 'disabled' methods as
|
|
* there is no upstream network. In all other methods, these search domains
|
|
* are used as the only search domains for this connection.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_DNS_SEARCH,
|
|
_nm_param_spec_specialized (NM_SETTING_IP4_CONFIG_DNS_SEARCH,
|
|
"DNS search",
|
|
"List of DNS search domains. For the 'auto' "
|
|
"method, these search domains are appended to "
|
|
"those returned by automatic configuration. "
|
|
"Search domains cannot be used with the 'shared', "
|
|
"'link-local', or 'disabled' methods as there is "
|
|
"no upstream network. In all other methods, these "
|
|
"search domains are used as the only search domains "
|
|
"for this connection.",
|
|
DBUS_TYPE_G_LIST_OF_STRING,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:addresses:
|
|
*
|
|
* Array of IPv4 address structures. Each IPv4 address structure is
|
|
* composed of 3 32-bit values; the first being the IPv4 address (network
|
|
* byte order), the second the prefix (1 - 32), and last the IPv4 gateway
|
|
* (network byte order). The gateway may be left as 0 if no gateway exists
|
|
* for that subnet. For the 'auto' method, given IP addresses are appended
|
|
* to those returned by automatic configuration. Addresses cannot be used
|
|
* with the 'shared', 'link-local', or 'disabled' methods as addressing is
|
|
* either automatic or disabled with these methods.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_ADDRESSES,
|
|
_nm_param_spec_specialized (NM_SETTING_IP4_CONFIG_ADDRESSES,
|
|
"Addresses",
|
|
"Array of IPv4 address structures. Each IPv4 "
|
|
"address structure is composed of 3 32-bit values; "
|
|
"the first being the IPv4 address (network byte "
|
|
"order), the second the prefix (1 - 32), and "
|
|
"last the IPv4 gateway (network byte order). The "
|
|
"gateway may be left as 0 if no gateway exists "
|
|
"for that subnet. For the 'auto' method, given "
|
|
"IP addresses are appended to those returned by "
|
|
"automatic configuration. Addresses cannot be "
|
|
"used with the 'shared', 'link-local', or "
|
|
"'disabled' methods as addressing is either "
|
|
"automatic or disabled with these methods.",
|
|
DBUS_TYPE_G_ARRAY_OF_ARRAY_OF_UINT,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:routes:
|
|
*
|
|
* Array of IPv4 route structures. Each IPv4 route structure is composed
|
|
* of 4 32-bit values; the first being the destination IPv4 network or
|
|
* address (network byte order), the second the destination network or
|
|
* address prefix (1 - 32), the third being the next-hop (network byte
|
|
* order) if any, and the fourth being the route metric. For the 'auto'
|
|
* method, given IP routes are appended to those returned by automatic
|
|
* configuration. Routes cannot be used with the 'shared', 'link-local',
|
|
* or 'disabled' methods because there is no upstream network.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_ROUTES,
|
|
_nm_param_spec_specialized (NM_SETTING_IP4_CONFIG_ROUTES,
|
|
"Routes",
|
|
"Array of IPv4 route structures. Each IPv4 route "
|
|
"structure is composed of 4 32-bit values; the "
|
|
"first being the destination IPv4 network or "
|
|
"address (network byte order), the second the "
|
|
"destination network or address prefix (1 - 32), "
|
|
"the third being the next-hop (network byte order) "
|
|
"if any, and the fourth being the route metric. "
|
|
"For the 'auto' method, given IP routes are "
|
|
"appended to those returned by automatic "
|
|
"configuration. Routes cannot be used with the "
|
|
"'shared', 'link-local', or 'disabled', methods "
|
|
"as there is no upstream network.",
|
|
DBUS_TYPE_G_ARRAY_OF_ARRAY_OF_UINT,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:ignore-auto-routes:
|
|
*
|
|
* When the method is set to 'auto' and this property to TRUE, automatically
|
|
* configured routes are ignored and only routes specified in
|
|
* #NMSettingIP4Config:routes, if any, are used.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_IGNORE_AUTO_ROUTES,
|
|
g_param_spec_boolean (NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES,
|
|
"Ignore automatic routes",
|
|
"When the method is set to 'auto' and this property "
|
|
"to TRUE, automatically configured routes are "
|
|
"ignored and only routes specified in the 'routes' "
|
|
"property, if any, are used.",
|
|
FALSE,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:ignore-auto-dns:
|
|
*
|
|
* When the method is set to 'auto' and this property to TRUE, automatically
|
|
* configured nameservers and search domains are ignored and only nameservers
|
|
* and search domains specified in #NMSettingIP4Config:dns and
|
|
* #NMSettingIP4Config:dns-search, if any, are used.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_IGNORE_AUTO_DNS,
|
|
g_param_spec_boolean (NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS,
|
|
"Ignore automatic DNS",
|
|
"When the method is set to 'auto' and this property "
|
|
"to TRUE, automatically configured nameservers and "
|
|
"search domains are ignored and only nameservers and "
|
|
"search domains specified in the 'dns' and 'dns-search' "
|
|
"properties, if any, are used.",
|
|
FALSE,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:dhcp-client-id:
|
|
*
|
|
* A string sent to the DHCP server to identify the local machine which the
|
|
* DHCP server may use to cusomize the DHCP lease and options.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_DHCP_CLIENT_ID,
|
|
g_param_spec_string (NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID,
|
|
"DHCP Client ID",
|
|
"A string sent to the DHCP server to identify the "
|
|
"local machine which the DHCP server may use to "
|
|
"cusomize the DHCP lease and options.",
|
|
NULL,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:dhcp-send-hostname:
|
|
*
|
|
* If TRUE, a hostname is sent to the DHCP server when acquiring a lease.
|
|
* Some DHCP servers use this hostname to update DNS databases, essentially
|
|
* providing a static hostname for the computer. If
|
|
* #NMSettingIP4Config:dhcp-hostname is empty and this property is TRUE,
|
|
* the current persistent hostname of the computer is sent.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_DHCP_SEND_HOSTNAME,
|
|
g_param_spec_boolean (NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME,
|
|
"Send DHCP hostname",
|
|
"If TRUE, a hostname is sent to the DHCP server when "
|
|
"acquiring a lease. Some DHCP servers use this "
|
|
"hostname to update DNS databases, essentially "
|
|
"providing a static hostname for the computer. If "
|
|
"the 'dhcp-hostname' property is empty and this "
|
|
"property is TRUE, the current persistent hostname "
|
|
"of the computer is sent.",
|
|
TRUE,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:dhcp-hostname:
|
|
*
|
|
* If the #NMSettingIP4Config:dhcp-send-hostname property is TRUE, then the
|
|
* specified name will be sent to the DHCP server when acquiring a lease.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_DHCP_HOSTNAME,
|
|
g_param_spec_string (NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME,
|
|
"DHCP Hostname",
|
|
"If the 'dhcp-send-hostname' property is TRUE, then "
|
|
"the specified name will be sent to the DHCP server "
|
|
"when acquiring a lease.",
|
|
NULL,
|
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:never-default:
|
|
*
|
|
* If TRUE, this connection will never be the default IPv4 connection,
|
|
* meaning it will never be assigned the default route by NetworkManager.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_NEVER_DEFAULT,
|
|
g_param_spec_boolean (NM_SETTING_IP4_CONFIG_NEVER_DEFAULT,
|
|
"Never default",
|
|
"If TRUE, this connection will never be the default "
|
|
"IPv4 connection, meaning it will never be assigned "
|
|
"the default route by NetworkManager.",
|
|
FALSE,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_SERIALIZE));
|
|
|
|
/**
|
|
* NMSettingIP4Config:may-fail:
|
|
*
|
|
* If TRUE, allow overall network configuration to proceed even if IPv4
|
|
* configuration times out. Note that at least one IP configuration
|
|
* must succeed or overall network configuration will still fail. For
|
|
* example, in IPv6-only networks, setting this property to TRUE allows
|
|
* the overall network configuration to succeed if IPv4 configuration fails
|
|
* but IPv6 configuration completes successfully.
|
|
**/
|
|
g_object_class_install_property
|
|
(object_class, PROP_MAY_FAIL,
|
|
g_param_spec_boolean (NM_SETTING_IP4_CONFIG_MAY_FAIL,
|
|
"May Fail",
|
|
"If TRUE, allow overall network configuration to "
|
|
"proceed even if IPv4 configuration times out. "
|
|
"Note that at least one IP configuration must "
|
|
"succeed or overall network configuration will still "
|
|
"fail. For example, in IPv6-only networks, setting "
|
|
"this property to TRUE allows the overall network "
|
|
"configuration to succeed if IPv4 configuration "
|
|
"fails but IPv6 configuration completes successfully.",
|
|
TRUE,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_SERIALIZE));
|
|
}
|
|
|
|
|
|
struct NMIP4Address {
|
|
guint32 refcount;
|
|
guint32 address; /* network byte order */
|
|
guint32 prefix;
|
|
guint32 gateway; /* network byte order */
|
|
};
|
|
|
|
/**
|
|
* nm_ip4_address_new:
|
|
*
|
|
* Creates and returns a new #NMIP4Address object.
|
|
*
|
|
* Returns: (transfer full): the new empty #NMIP4Address object
|
|
**/
|
|
NMIP4Address *
|
|
nm_ip4_address_new (void)
|
|
{
|
|
NMIP4Address *address;
|
|
|
|
address = g_malloc0 (sizeof (NMIP4Address));
|
|
address->refcount = 1;
|
|
return address;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_dup:
|
|
* @source: the #NMIP4Address object to copy
|
|
*
|
|
* Copies a given #NMIP4Address object and returns the copy.
|
|
*
|
|
* Returns: (transfer full): the copy of the given #NMIP4Address copy
|
|
**/
|
|
NMIP4Address *
|
|
nm_ip4_address_dup (NMIP4Address *source)
|
|
{
|
|
NMIP4Address *address;
|
|
|
|
g_return_val_if_fail (source != NULL, NULL);
|
|
g_return_val_if_fail (source->refcount > 0, NULL);
|
|
|
|
address = nm_ip4_address_new ();
|
|
address->address = source->address;
|
|
address->prefix = source->prefix;
|
|
address->gateway = source->gateway;
|
|
|
|
return address;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_ref:
|
|
* @address: the #NMIP4Address
|
|
*
|
|
* Increases the reference count of the object.
|
|
**/
|
|
void
|
|
nm_ip4_address_ref (NMIP4Address *address)
|
|
{
|
|
g_return_if_fail (address != NULL);
|
|
g_return_if_fail (address->refcount > 0);
|
|
|
|
address->refcount++;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_unref:
|
|
* @address: the #NMIP4Address
|
|
*
|
|
* Decreases the reference count of the object. If the reference count
|
|
* reaches zero, the object will be destroyed.
|
|
**/
|
|
void
|
|
nm_ip4_address_unref (NMIP4Address *address)
|
|
{
|
|
g_return_if_fail (address != NULL);
|
|
g_return_if_fail (address->refcount > 0);
|
|
|
|
address->refcount--;
|
|
if (address->refcount == 0) {
|
|
memset (address, 0, sizeof (NMIP4Address));
|
|
g_free (address);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_compare:
|
|
* @address: the #NMIP4Address
|
|
* @other: the #NMIP4Address to compare @address to.
|
|
*
|
|
* Determines if two #NMIP4Address objects contain the same values.
|
|
*
|
|
* Returns: %TRUE if the objects contain the same values, %FALSE if they do not.
|
|
**/
|
|
gboolean
|
|
nm_ip4_address_compare (NMIP4Address *address, NMIP4Address *other)
|
|
{
|
|
g_return_val_if_fail (address != NULL, FALSE);
|
|
g_return_val_if_fail (address->refcount > 0, FALSE);
|
|
|
|
g_return_val_if_fail (other != NULL, FALSE);
|
|
g_return_val_if_fail (other->refcount > 0, FALSE);
|
|
|
|
if ( address->address != other->address
|
|
|| address->prefix != other->prefix
|
|
|| address->gateway != other->gateway)
|
|
return FALSE;
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_get_address:
|
|
* @address: the #NMIP4Address
|
|
*
|
|
* Gets the IPv4 address property of this address object.
|
|
*
|
|
* Returns: the IPv4 address in network byte order
|
|
**/
|
|
guint32
|
|
nm_ip4_address_get_address (NMIP4Address *address)
|
|
{
|
|
g_return_val_if_fail (address != NULL, 0);
|
|
g_return_val_if_fail (address->refcount > 0, 0);
|
|
|
|
return address->address;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_set_address:
|
|
* @address: the #NMIP4Address
|
|
* @addr: the IPv4 address in network byte order
|
|
*
|
|
* Sets the IPv4 address property of this object.
|
|
**/
|
|
void
|
|
nm_ip4_address_set_address (NMIP4Address *address, guint32 addr)
|
|
{
|
|
g_return_if_fail (address != NULL);
|
|
g_return_if_fail (address->refcount > 0);
|
|
|
|
address->address = addr;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_get_prefix:
|
|
* @address: the #NMIP4Address
|
|
*
|
|
* Gets the IPv4 address prefix (ie "24" or "30" etc) property of this address
|
|
* object.
|
|
*
|
|
* Returns: the IPv4 address prefix
|
|
**/
|
|
guint32
|
|
nm_ip4_address_get_prefix (NMIP4Address *address)
|
|
{
|
|
g_return_val_if_fail (address != NULL, 0);
|
|
g_return_val_if_fail (address->refcount > 0, 0);
|
|
|
|
return address->prefix;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_set_prefix:
|
|
* @address: the #NMIP4Address
|
|
* @prefix: the address prefix, a number between 1 and 32 inclusive
|
|
*
|
|
* Sets the IPv4 address prefix.
|
|
**/
|
|
void
|
|
nm_ip4_address_set_prefix (NMIP4Address *address, guint32 prefix)
|
|
{
|
|
g_return_if_fail (address != NULL);
|
|
g_return_if_fail (address->refcount > 0);
|
|
g_return_if_fail (prefix <= 32);
|
|
g_return_if_fail (prefix > 0);
|
|
|
|
address->prefix = prefix;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_get_gateway:
|
|
* @address: the #NMIP4Address
|
|
*
|
|
* Gets the IPv4 default gateway property of this address object.
|
|
*
|
|
* Returns: the IPv4 gateway address in network byte order
|
|
**/
|
|
guint32
|
|
nm_ip4_address_get_gateway (NMIP4Address *address)
|
|
{
|
|
g_return_val_if_fail (address != NULL, 0);
|
|
g_return_val_if_fail (address->refcount > 0, 0);
|
|
|
|
return address->gateway;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_address_set_gateway:
|
|
* @address: the #NMIP4Address
|
|
* @gateway: the IPv4 default gateway in network byte order
|
|
*
|
|
* Sets the IPv4 default gateway property of this address object.
|
|
**/
|
|
void
|
|
nm_ip4_address_set_gateway (NMIP4Address *address, guint32 gateway)
|
|
{
|
|
g_return_if_fail (address != NULL);
|
|
g_return_if_fail (address->refcount > 0);
|
|
|
|
address->gateway = gateway;
|
|
}
|
|
|
|
|
|
struct NMIP4Route {
|
|
guint32 refcount;
|
|
|
|
guint32 dest; /* network byte order */
|
|
guint32 prefix;
|
|
guint32 next_hop; /* network byte order */
|
|
guint32 metric; /* lower metric == more preferred */
|
|
};
|
|
|
|
/**
|
|
* nm_ip4_route_new:
|
|
*
|
|
* Creates and returns a new #NMIP4Route object.
|
|
*
|
|
* Returns: (transfer full): the new empty #NMIP4Route object
|
|
**/
|
|
NMIP4Route *
|
|
nm_ip4_route_new (void)
|
|
{
|
|
NMIP4Route *route;
|
|
|
|
route = g_malloc0 (sizeof (NMIP4Route));
|
|
route->refcount = 1;
|
|
return route;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_dup:
|
|
* @source: the #NMIP4Route object to copy
|
|
*
|
|
* Copies a given #NMIP4Route object and returns the copy.
|
|
*
|
|
* Returns: (transfer full): the copy of the given #NMIP4Route copy
|
|
**/
|
|
NMIP4Route *
|
|
nm_ip4_route_dup (NMIP4Route *source)
|
|
{
|
|
NMIP4Route *route;
|
|
|
|
g_return_val_if_fail (source != NULL, NULL);
|
|
g_return_val_if_fail (source->refcount > 0, NULL);
|
|
|
|
route = nm_ip4_route_new ();
|
|
route->dest = source->dest;
|
|
route->prefix = source->prefix;
|
|
route->next_hop = source->next_hop;
|
|
route->metric = source->metric;
|
|
|
|
return route;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_ref:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Increases the reference count of the object.
|
|
**/
|
|
void
|
|
nm_ip4_route_ref (NMIP4Route *route)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
|
|
route->refcount++;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_unref:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Decreases the reference count of the object. If the reference count
|
|
* reaches zero, the object will be destroyed.
|
|
**/
|
|
void
|
|
nm_ip4_route_unref (NMIP4Route *route)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
|
|
route->refcount--;
|
|
if (route->refcount == 0) {
|
|
memset (route, 0, sizeof (NMIP4Route));
|
|
g_free (route);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_compare:
|
|
* @route: the #NMIP4Route
|
|
* @other: the #NMIP4Route to compare @route to.
|
|
*
|
|
* Determines if two #NMIP4Route objects contain the same values.
|
|
*
|
|
* Returns: %TRUE if the objects contain the same values, %FALSE if they do not.
|
|
**/
|
|
gboolean
|
|
nm_ip4_route_compare (NMIP4Route *route, NMIP4Route *other)
|
|
{
|
|
g_return_val_if_fail (route != NULL, FALSE);
|
|
g_return_val_if_fail (route->refcount > 0, FALSE);
|
|
|
|
g_return_val_if_fail (other != NULL, FALSE);
|
|
g_return_val_if_fail (other->refcount > 0, FALSE);
|
|
|
|
if ( route->dest != other->dest
|
|
|| route->prefix != other->prefix
|
|
|| route->next_hop != other->next_hop
|
|
|| route->metric != other->metric)
|
|
return FALSE;
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_get_dest:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Gets the IPv4 destination address property of this route object.
|
|
*
|
|
* Returns: the IPv4 address in network byte order
|
|
**/
|
|
guint32
|
|
nm_ip4_route_get_dest (NMIP4Route *route)
|
|
{
|
|
g_return_val_if_fail (route != NULL, 0);
|
|
g_return_val_if_fail (route->refcount > 0, 0);
|
|
|
|
return route->dest;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_set_dest:
|
|
* @route: the #NMIP4Route
|
|
* @dest: the destination address in network byte order
|
|
*
|
|
* Sets the IPv4 destination address property of this route object.
|
|
**/
|
|
void
|
|
nm_ip4_route_set_dest (NMIP4Route *route, guint32 dest)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
|
|
route->dest = dest;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_get_prefix:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Gets the IPv4 prefix (ie "24" or "30" etc) of this route.
|
|
*
|
|
* Returns: the IPv4 prefix
|
|
**/
|
|
guint32
|
|
nm_ip4_route_get_prefix (NMIP4Route *route)
|
|
{
|
|
g_return_val_if_fail (route != NULL, 0);
|
|
g_return_val_if_fail (route->refcount > 0, 0);
|
|
|
|
return route->prefix;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_set_prefix:
|
|
* @route: the #NMIP4Route
|
|
* @prefix: the prefix, a number between 1 and 32 inclusive
|
|
*
|
|
* Sets the IPv4 prefix of this route.
|
|
**/
|
|
void
|
|
nm_ip4_route_set_prefix (NMIP4Route *route, guint32 prefix)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
g_return_if_fail (prefix <= 32);
|
|
g_return_if_fail (prefix > 0);
|
|
|
|
route->prefix = prefix;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_get_next_hop:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Gets the IPv4 address of the next hop of this route.
|
|
*
|
|
* Returns: the IPv4 address in network byte order
|
|
**/
|
|
guint32
|
|
nm_ip4_route_get_next_hop (NMIP4Route *route)
|
|
{
|
|
g_return_val_if_fail (route != NULL, 0);
|
|
g_return_val_if_fail (route->refcount > 0, 0);
|
|
|
|
return route->next_hop;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_set_next_hop:
|
|
* @route: the #NMIP4Route
|
|
* @next_hop: the IPv4 address of the next hop in network byte order
|
|
*
|
|
* Sets the IPv4 address of the next hop of this route.
|
|
**/
|
|
void
|
|
nm_ip4_route_set_next_hop (NMIP4Route *route, guint32 next_hop)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
|
|
route->next_hop = next_hop;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_get_metric:
|
|
* @route: the #NMIP4Route
|
|
*
|
|
* Gets the route metric property of this route object; lower values indicate
|
|
* "better" or more preferred routes.
|
|
*
|
|
* Returns: the route metric
|
|
**/
|
|
guint32
|
|
nm_ip4_route_get_metric (NMIP4Route *route)
|
|
{
|
|
g_return_val_if_fail (route != NULL, 0);
|
|
g_return_val_if_fail (route->refcount > 0, 0);
|
|
|
|
return route->metric;
|
|
}
|
|
|
|
/**
|
|
* nm_ip4_route_set_metric:
|
|
* @route: the #NMIP4Route
|
|
* @metric: the route metric
|
|
*
|
|
* Sets the route metric property of this route object; lower values indicate
|
|
* "better" or more preferred routes.
|
|
**/
|
|
void
|
|
nm_ip4_route_set_metric (NMIP4Route *route, guint32 metric)
|
|
{
|
|
g_return_if_fail (route != NULL);
|
|
g_return_if_fail (route->refcount > 0);
|
|
|
|
route->metric = metric;
|
|
}
|
|
|