Top | ![]() |
![]() |
![]() |
![]() |
NMSettingIPConfigNMSettingIPConfig — Abstract base class for IPv4 and IPv6 addressing, routing, and name service properties |
GPtrArray * | addresses | Read / Write |
gchar * | dhcp-hostname | Read / Write |
gboolean | dhcp-send-hostname | Read / Write / Construct |
GStrv | dns | Read / Write |
GStrv | dns-search | Read / Write |
gchar * | gateway | Read / Write |
gboolean | ignore-auto-dns | Read / Write / Construct |
gboolean | ignore-auto-routes | Read / Write / Construct |
gboolean | may-fail | Read / Write / Construct |
gchar * | method | Read / Write |
gboolean | never-default | Read / Write / Construct |
gint64 | route-metric | Read / Write / Construct |
GPtrArray * | routes | Read / Write |
#define | NM_SETTING_IP_CONFIG_METHOD |
#define | NM_SETTING_IP_CONFIG_DNS |
#define | NM_SETTING_IP_CONFIG_DNS_SEARCH |
#define | NM_SETTING_IP_CONFIG_ADDRESSES |
#define | NM_SETTING_IP_CONFIG_GATEWAY |
#define | NM_SETTING_IP_CONFIG_ROUTES |
#define | NM_SETTING_IP_CONFIG_ROUTE_METRIC |
#define | NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES |
#define | NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS |
#define | NM_SETTING_IP_CONFIG_DHCP_HOSTNAME |
#define | NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME |
#define | NM_SETTING_IP_CONFIG_NEVER_DEFAULT |
#define | NM_SETTING_IP_CONFIG_MAY_FAIL |
GBoxed ├── NMIPAddress ╰── NMIPRoute GObject ╰── NMSetting ╰── NMSettingIPConfig ├── NMSettingIP4Config ╰── NMSettingIP6Config
NMSettingIPConfig is the abstract base class of NMSettingIP4Config and NMSettingIP6Config, providing properties related to IP addressing, routing, and Domain Name Service.
NMIPAddress * nm_ip_address_new (int family
,const char *addr
,guint prefix
,GError **error
);
Creates a new NMIPAddress object.
NMIPAddress * nm_ip_address_new_binary (int family
,gconstpointer addr
,guint prefix
,GError **error
);
Creates a new NMIPAddress object. addr
must point to a buffer of the
correct size for family
.
void
nm_ip_address_ref (NMIPAddress *address
);
Increases the reference count of the object.
void
nm_ip_address_unref (NMIPAddress *address
);
Decreases the reference count of the object. If the reference count reaches zero, the object will be destroyed.
gboolean nm_ip_address_equal (NMIPAddress *address
,NMIPAddress *other
);
Determines if two NMIPAddress objects contain the same address and prefix (attributes are not compared).
NMIPAddress *
nm_ip_address_dup (NMIPAddress *address
);
Creates a copy of address
int
nm_ip_address_get_family (NMIPAddress *address
);
Gets the IP address family (eg, AF_INET) property of this address object.
const char *
nm_ip_address_get_address (NMIPAddress *address
);
Gets the IP address property of this address object.
void nm_ip_address_set_address (NMIPAddress *address
,const char *addr
);
Sets the IP address property of this address object.
addr
must be a valid address of address
's family. If you aren't sure you
have a valid address, use nm_utils_ipaddr_valid()
to check it.
void nm_ip_address_get_address_binary (NMIPAddress *address
,gpointer addr
);
Gets the IP address property of this address object.
addr
must point to a buffer that is the correct size for address
's family.
void nm_ip_address_set_address_binary (NMIPAddress *address
,gconstpointer addr
);
Sets the IP address property of this address object.
addr
must point to a buffer that is the correct size for address
's family.
guint
nm_ip_address_get_prefix (NMIPAddress *address
);
Gets the IP address prefix (ie "24" or "30" etc) property of this address object.
void nm_ip_address_set_prefix (NMIPAddress *address
,guint prefix
);
Sets the IP address prefix property of this address object.
char **
nm_ip_address_get_attribute_names (NMIPAddress *address
);
Gets an array of attribute names defined on address
.
GVariant * nm_ip_address_get_attribute (NMIPAddress *address
,const char *name
);
Gets the value of the attribute with name name
on address
void nm_ip_address_set_attribute (NMIPAddress *address
,const char *name
,GVariant *value
);
Sets or clears the named attribute on address
to the given value.
address |
the NMIPAddress |
|
name |
the name of an address attribute |
|
value |
the value. |
[transfer none][allow-none] |
NMIPRoute * nm_ip_route_new (int family
,const char *dest
,guint prefix
,const char *next_hop
,gint64 metric
,GError **error
);
Creates a new NMIPRoute object.
NMIPRoute * nm_ip_route_new_binary (int family
,gconstpointer dest
,guint prefix
,gconstpointer next_hop
,gint64 metric
,GError **error
);
Creates a new NMIPRoute object. dest
and next_hop
(if non-NULL
) must
point to buffers of the correct size for family
.
void
nm_ip_route_ref (NMIPRoute *route
);
Increases the reference count of the object.
void
nm_ip_route_unref (NMIPRoute *route
);
Decreases the reference count of the object. If the reference count reaches zero, the object will be destroyed.
gboolean nm_ip_route_equal (NMIPRoute *route
,NMIPRoute *other
);
Determines if two NMIPRoute objects contain the same destination, prefix, next hop, and metric. (Attributes are not compared.)
int
nm_ip_route_get_family (NMIPRoute *route
);
Gets the IP address family (eg, AF_INET) property of this route object.
const char *
nm_ip_route_get_dest (NMIPRoute *route
);
Gets the IP destination address property of this route object.
void nm_ip_route_set_dest (NMIPRoute *route
,const char *dest
);
Sets the destination property of this route object.
dest
must be a valid address of route
's family. If you aren't sure you
have a valid address, use nm_utils_ipaddr_valid()
to check it.
void nm_ip_route_get_dest_binary (NMIPRoute *route
,gpointer dest
);
Gets the destination property of this route object.
dest
must point to a buffer that is the correct size for route
's family.
void nm_ip_route_set_dest_binary (NMIPRoute *route
,gconstpointer dest
);
Sets the destination property of this route object.
dest
must point to a buffer that is the correct size for route
's family.
guint
nm_ip_route_get_prefix (NMIPRoute *route
);
Gets the IP prefix (ie "24" or "30" etc) of this route.
void nm_ip_route_set_prefix (NMIPRoute *route
,guint prefix
);
Sets the prefix property of this route object.
const char *
nm_ip_route_get_next_hop (NMIPRoute *route
);
Gets the IP address of the next hop of this route; this will be NULL
if the
route has no next hop.
void nm_ip_route_set_next_hop (NMIPRoute *route
,const char *next_hop
);
Sets the next-hop property of this route object.
next_hop
(if non-NULL
) must be a valid address of route
's family. If you
aren't sure you have a valid address, use nm_utils_ipaddr_valid()
to check
it.
gboolean nm_ip_route_get_next_hop_binary (NMIPRoute *route
,gpointer next_hop
);
Gets the next hop property of this route object.
next_hop
must point to a buffer that is the correct size for route
's family.
void nm_ip_route_set_next_hop_binary (NMIPRoute *route
,gconstpointer next_hop
);
Sets the destination property of this route object.
next_hop
(if non-NULL
) must point to a buffer that is the correct size for
route
's family.
gint64
nm_ip_route_get_metric (NMIPRoute *route
);
Gets the route metric property of this route object; lower values indicate "better" or more preferred routes; -1 indicates "default" (meaning NetworkManager will set it appropriately).
void nm_ip_route_set_metric (NMIPRoute *route
,gint64 metric
);
Sets the metric property of this route object.
char **
nm_ip_route_get_attribute_names (NMIPRoute *route
);
Gets an array of attribute names defined on route
.
GVariant * nm_ip_route_get_attribute (NMIPRoute *route
,const char *name
);
Gets the value of the attribute with name name
on route
void nm_ip_route_set_attribute (NMIPRoute *route
,const char *name
,GVariant *value
);
Sets the named attribute on route
to the given value.
route |
the NMIPRoute |
|
name |
the name of a route attribute |
|
value |
the value. |
[transfer none][allow-none] |
const char *
nm_setting_ip_config_get_method (NMSettingIPConfig *setting
);
the “method” property of the setting; see NMSettingIP4Config and NMSettingIP6Config for details of the methods available with each type.
guint
nm_setting_ip_config_get_num_dns (NMSettingIPConfig *setting
);
const char * nm_setting_ip_config_get_dns (NMSettingIPConfig *setting
,int i
);
gboolean nm_setting_ip_config_add_dns (NMSettingIPConfig *setting
,const char *dns
);
Adds a new DNS server to the setting.
void nm_setting_ip_config_remove_dns (NMSettingIPConfig *setting
,int i
);
Removes the DNS server at index i
.
gboolean nm_setting_ip_config_remove_dns_by_value (NMSettingIPConfig *setting
,const char *dns
);
Removes the DNS server dns
.
void
nm_setting_ip_config_clear_dns (NMSettingIPConfig *setting
);
Removes all configured DNS servers.
guint
nm_setting_ip_config_get_num_dns_searches
(NMSettingIPConfig *setting
);
const char * nm_setting_ip_config_get_dns_search (NMSettingIPConfig *setting
,int i
);
gboolean nm_setting_ip_config_add_dns_search (NMSettingIPConfig *setting
,const char *dns_search
);
Adds a new DNS search domain to the setting.
void nm_setting_ip_config_remove_dns_search (NMSettingIPConfig *setting
,int i
);
Removes the DNS search domain at index i
.
gboolean nm_setting_ip_config_remove_dns_search_by_value (NMSettingIPConfig *setting
,const char *dns_search
);
Removes the DNS search domain dns_search
.
void
nm_setting_ip_config_clear_dns_searches
(NMSettingIPConfig *setting
);
Removes all configured DNS search domains.
guint
nm_setting_ip_config_get_num_addresses
(NMSettingIPConfig *setting
);
NMIPAddress * nm_setting_ip_config_get_address (NMSettingIPConfig *setting
,int i
);
gboolean nm_setting_ip_config_add_address (NMSettingIPConfig *setting
,NMIPAddress *address
);
Adds a new IP address and associated information to the setting. The given address is duplicated internally and is not changed by this function.
void nm_setting_ip_config_remove_address (NMSettingIPConfig *setting
,int i
);
Removes the address at index i
.
gboolean nm_setting_ip_config_remove_address_by_value (NMSettingIPConfig *setting
,NMIPAddress *address
);
Removes the address address
.
void
nm_setting_ip_config_clear_addresses (NMSettingIPConfig *setting
);
Removes all configured addresses.
const char *
nm_setting_ip_config_get_gateway (NMSettingIPConfig *setting
);
guint
nm_setting_ip_config_get_num_routes (NMSettingIPConfig *setting
);
NMIPRoute * nm_setting_ip_config_get_route (NMSettingIPConfig *setting
,int i
);
gboolean nm_setting_ip_config_add_route (NMSettingIPConfig *setting
,NMIPRoute *route
);
Adds a new route and associated information to the setting. The given route is duplicated internally and is not changed by this function.
void nm_setting_ip_config_remove_route (NMSettingIPConfig *setting
,int i
);
Removes the route at index i
.
gboolean nm_setting_ip_config_remove_route_by_value (NMSettingIPConfig *setting
,NMIPRoute *route
);
Removes the route route
.
void
nm_setting_ip_config_clear_routes (NMSettingIPConfig *setting
);
Removes all configured routes.
gint64
nm_setting_ip_config_get_route_metric (NMSettingIPConfig *setting
);
Returns the value contained in the “route-metric” property.
the route metric that is used for routes that don't explicitly specify a metric. See “route-metric” for more details.
gboolean
nm_setting_ip_config_get_ignore_auto_routes
(NMSettingIPConfig *setting
);
Returns the value contained in the “ignore-auto-routes” property.
gboolean
nm_setting_ip_config_get_ignore_auto_dns
(NMSettingIPConfig *setting
);
Returns the value contained in the “ignore-auto-dns” property.
const char *
nm_setting_ip_config_get_dhcp_hostname
(NMSettingIPConfig *setting
);
Returns the value contained in the “dhcp-hostname” property.
gboolean
nm_setting_ip_config_get_dhcp_send_hostname
(NMSettingIPConfig *setting
);
Returns the value contained in the “dhcp-send-hostname” property.
gboolean
nm_setting_ip_config_get_never_default
(NMSettingIPConfig *setting
);
Returns the value contained in the “never-default” property.
gboolean
nm_setting_ip_config_get_may_fail (NMSettingIPConfig *setting
);
Returns the value contained in the “may-fail” property.
#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
#define NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME "dhcp-send-hostname"
“dhcp-send-hostname”
property “dhcp-send-hostname” gboolean
Flags: Read / Write / Construct
Default value: TRUE
“ignore-auto-dns”
property “ignore-auto-dns” gboolean
Flags: Read / Write / Construct
Default value: FALSE
“ignore-auto-routes”
property “ignore-auto-routes” gboolean
Flags: Read / Write / Construct
Default value: FALSE
“never-default”
property “never-default” gboolean
Flags: Read / Write / Construct
Default value: FALSE
“route-metric”
property “route-metric” gint64
Flags: Read / Write / Construct
Allowed values: [-1,4294967295]
Default value: -1