nm_ip_address_new ()

NMIPAddress *
nm_ip_address_new (int family,
                   const char *addr,
                   guint prefix,
                   GError **error);

Creates a new NMIPAddress object.

nm_ip_address_new_binary ()

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 .

nm_ip_address_ref ()

void
nm_ip_address_ref (NMIPAddress *address);

Increases the reference count of the object.

nm_ip_address_unref ()

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.

nm_ip_address_equal ()

gboolean
nm_ip_address_equal (NMIPAddress *address,
                     NMIPAddress *other);

Determines if two NMIPAddress objects contain the same address and prefix (attributes are not compared).

nm_ip_address_cmp_full ()

int
nm_ip_address_cmp_full (const NMIPAddress *a,
                        const NMIPAddress *b,
                        NMIPAddressCmpFlags cmp_flags);

Note that with cmp_flags NM_IP_ADDRESS_CMP_FLAGS_WITH_ATTRS, there is no total order for comparing GVariant. That means, if the two addresses only differ by their attributes, the sort order is undefined and the return value only indicates equality.

nm_ip_address_dup ()

NMIPAddress *
nm_ip_address_dup (NMIPAddress *address);

Creates a copy of address

nm_ip_address_get_family ()

int
nm_ip_address_get_family (NMIPAddress *address);

Gets the IP address family (eg, AF_INET) property of this address object.

nm_ip_address_get_address ()

const char *
nm_ip_address_get_address (NMIPAddress *address);

Gets the IP address property of this address object.

nm_ip_address_set_address ()

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.

nm_ip_address_get_address_binary ()

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.

[skip]

nm_ip_address_set_address_binary ()

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.

[skip]

nm_ip_address_get_prefix ()

guint
nm_ip_address_get_prefix (NMIPAddress *address);

Gets the IP address prefix (ie "24" or "30" etc) property of this address object.

nm_ip_address_set_prefix ()

void
nm_ip_address_set_prefix (NMIPAddress *address,
                          guint prefix);

Sets the IP address prefix property of this address object.

nm_ip_address_get_attribute_names ()

char **
nm_ip_address_get_attribute_names (NMIPAddress *address);

Gets an array of attribute names defined on address .

nm_ip_address_get_attribute ()

GVariant *
nm_ip_address_get_attribute (NMIPAddress *address,
                             const char *name);

Gets the value of the attribute with name name on address

nm_ip_address_set_attribute ()

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.

nm_ip_route_new ()

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.

nm_ip_route_new_binary ()

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 .

nm_ip_route_ref ()

void
nm_ip_route_ref (NMIPRoute *route);

Increases the reference count of the object.

nm_ip_route_unref ()

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.

nm_ip_route_equal ()

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.)

nm_ip_route_equal_full ()

gboolean
nm_ip_route_equal_full (NMIPRoute *route,
                        NMIPRoute *other,
                        guint cmp_flags);

Determines if two NMIPRoute objects contain the same destination, prefix, next hop, and metric.

Since: 1.10

nm_ip_route_dup ()

NMIPRoute *
nm_ip_route_dup (NMIPRoute *route);

Creates a copy of route

nm_ip_route_get_family ()

int
nm_ip_route_get_family (NMIPRoute *route);

Gets the IP address family (eg, AF_INET) property of this route object.

nm_ip_route_get_dest ()

const char *
nm_ip_route_get_dest (NMIPRoute *route);

Gets the IP destination address property of this route object.

nm_ip_route_set_dest ()

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_is_valid() to check it.

nm_ip_route_get_dest_binary ()

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.

[skip]

nm_ip_route_set_dest_binary ()

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.

[skip]

nm_ip_route_get_prefix ()

guint
nm_ip_route_get_prefix (NMIPRoute *route);

Gets the IP prefix (ie "24" or "30" etc) of this route.

nm_ip_route_set_prefix ()

void
nm_ip_route_set_prefix (NMIPRoute *route,
                        guint prefix);

Sets the prefix property of this route object.

nm_ip_route_get_next_hop ()

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.

nm_ip_route_set_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.

nm_ip_route_get_next_hop_binary ()

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.

[skip]

nm_ip_route_set_next_hop_binary ()

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.

[skip]

nm_ip_route_get_metric ()

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).

nm_ip_route_set_metric ()

void
nm_ip_route_set_metric (NMIPRoute *route,
                        gint64 metric);

Sets the metric property of this route object.

nm_ip_route_get_attribute_names ()

char **
nm_ip_route_get_attribute_names (NMIPRoute *route);

Gets an array of attribute names defined on route .

nm_ip_route_get_attribute ()

GVariant *
nm_ip_route_get_attribute (NMIPRoute *route,
                           const char *name);

Gets the value of the attribute with name name on route

nm_ip_route_set_attribute ()

void
nm_ip_route_set_attribute (NMIPRoute *route,
                           const char *name,
                           GVariant *value);

Sets the named attribute on route to the given value.

nm_ip_route_get_variant_attribute_spec ()

const NMVariantAttributeSpec *const *
nm_ip_route_get_variant_attribute_spec
                               (void);

Since: 1.8

nm_ip_route_attribute_validate ()

gboolean
nm_ip_route_attribute_validate (const char *name,
                                GVariant *value,
                                int family,
                                gboolean *known,
                                GError **error);

Validates a route attribute, i.e. checks that the attribute is a known one and the value is of the correct type and well-formed.

Since: 1.8

nm_ip_routing_rule_new ()

NMIPRoutingRule *
nm_ip_routing_rule_new (int addr_family);

Since: 1.18

nm_ip_routing_rule_new_clone ()

NMIPRoutingRule *
nm_ip_routing_rule_new_clone (const NMIPRoutingRule *rule);

Since: 1.18

nm_ip_routing_rule_ref ()

NMIPRoutingRule *
nm_ip_routing_rule_ref (NMIPRoutingRule *self);

Increases the reference count of the instance. This is not thread-safe.

Since: 1.18

nm_ip_routing_rule_unref ()

void
nm_ip_routing_rule_unref (NMIPRoutingRule *self);

Decreases the reference count of the instance and destroys the instance if the reference count reaches zero. This is not thread-safe.

Since: 1.18

nm_ip_routing_rule_is_sealed ()

gboolean
nm_ip_routing_rule_is_sealed (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_seal ()

void
nm_ip_routing_rule_seal (NMIPRoutingRule *self);

Seals the routing rule. Afterwards, the instance can no longer be modified, and it is a bug to call any of the accessors that would modify the rule. If self was already sealed, this has no effect.

Since: 1.18

nm_ip_routing_rule_get_addr_family ()

int
nm_ip_routing_rule_get_addr_family (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_invert ()

gboolean
nm_ip_routing_rule_get_invert (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_invert ()

void
nm_ip_routing_rule_set_invert (NMIPRoutingRule *self,
                               gboolean invert);

Since: 1.18

nm_ip_routing_rule_get_priority ()

gint64
nm_ip_routing_rule_get_priority (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_priority ()

void
nm_ip_routing_rule_set_priority (NMIPRoutingRule *self,
                                 gint64 priority);

A valid priority ranges from 0 to G_MAXUINT32. "-1" is also allowed to reset the priority. It is a bug calling this function with any other value.

Since: 1.18

nm_ip_routing_rule_get_tos ()

guint8
nm_ip_routing_rule_get_tos (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_tos ()

void
nm_ip_routing_rule_set_tos (NMIPRoutingRule *self,
                            guint8 tos);

Since: 1.18

nm_ip_routing_rule_get_ipproto ()

guint8
nm_ip_routing_rule_get_ipproto (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_ipproto ()

void
nm_ip_routing_rule_set_ipproto (NMIPRoutingRule *self,
                                guint8 ipproto);

Since: 1.18

nm_ip_routing_rule_get_source_port_start ()

guint16
nm_ip_routing_rule_get_source_port_start
                               (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_source_port_end ()

guint16
nm_ip_routing_rule_get_source_port_end
                               (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_source_port ()

void
nm_ip_routing_rule_set_source_port (NMIPRoutingRule *self,
                                    guint16 start,
                                    guint16 end);

Since: 1.18

nm_ip_routing_rule_get_destination_port_start ()

guint16
nm_ip_routing_rule_get_destination_port_start
                               (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_destination_port_end ()

guint16
nm_ip_routing_rule_get_destination_port_end
                               (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_destination_port ()

void
nm_ip_routing_rule_set_destination_port
                               (NMIPRoutingRule *self,
                                guint16 start,
                                guint16 end);

Since: 1.18

nm_ip_routing_rule_get_fwmark ()

guint32
nm_ip_routing_rule_get_fwmark (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_fwmask ()

guint32
nm_ip_routing_rule_get_fwmask (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_fwmark ()

void
nm_ip_routing_rule_set_fwmark (NMIPRoutingRule *self,
                               guint32 fwmark,
                               guint32 fwmask);

Since: 1.18

nm_ip_routing_rule_get_from_len ()

guint8
nm_ip_routing_rule_get_from_len (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_from ()

const char *
nm_ip_routing_rule_get_from (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_from ()

void
nm_ip_routing_rule_set_from (NMIPRoutingRule *self,
                             const char *from,
                             guint8 len);

Setting invalid values is accepted, but will later fail during nm_ip_routing_rule_validate().

Since: 1.18

nm_ip_routing_rule_get_to_len ()

guint8
nm_ip_routing_rule_get_to_len (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_get_to ()

const char *
nm_ip_routing_rule_get_to (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_to ()

void
nm_ip_routing_rule_set_to (NMIPRoutingRule *self,
                           const char *to,
                           guint8 len);

Setting invalid values is accepted, but will later fail during nm_ip_routing_rule_validate().

Since: 1.18

nm_ip_routing_rule_get_iifname ()

const char *
nm_ip_routing_rule_get_iifname (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_iifname ()

void
nm_ip_routing_rule_set_iifname (NMIPRoutingRule *self,
                                const char *iifname);

The name supports C backslash escaping for non-UTF-8 characters. Note that nm_ip_routing_rule_from_string() too uses backslash escaping when tokenizing the words by whitespace. So, in string representation you'd get double backslashes.

Since: 1.18

nm_ip_routing_rule_get_oifname ()

const char *
nm_ip_routing_rule_get_oifname (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_oifname ()

void
nm_ip_routing_rule_set_oifname (NMIPRoutingRule *self,
                                const char *oifname);

The name supports C backslash escaping for non-UTF-8 characters. Note that nm_ip_routing_rule_from_string() too uses backslash escaping when tokenizing the words by whitespace. So, in string representation you'd get double backslashes.

Since: 1.18

nm_ip_routing_rule_get_action ()

guint8
nm_ip_routing_rule_get_action (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_action ()

void
nm_ip_routing_rule_set_action (NMIPRoutingRule *self,
                               guint8 action);

Note that currently only certain actions are allowed. nm_ip_routing_rule_validate() will reject unsupported actions as invalid.

Since: 1.18

nm_ip_routing_rule_get_table ()

guint32
nm_ip_routing_rule_get_table (const NMIPRoutingRule *self);

Since: 1.18

nm_ip_routing_rule_set_table ()

void
nm_ip_routing_rule_set_table (NMIPRoutingRule *self,
                              guint32 table);

Since: 1.18

nm_ip_routing_rule_get_suppress_prefixlength ()

gint32
nm_ip_routing_rule_get_suppress_prefixlength
                               (const NMIPRoutingRule *self);

Since: 1.20

nm_ip_routing_rule_set_suppress_prefixlength ()

void
nm_ip_routing_rule_set_suppress_prefixlength
                               (NMIPRoutingRule *self,
                                gint32 suppress_prefixlength);

Since: 1.20

nm_ip_routing_rule_cmp ()

int
nm_ip_routing_rule_cmp (const NMIPRoutingRule *rule,
                        const NMIPRoutingRule *other);

Since: 1.18

nm_ip_routing_rule_validate ()

gboolean
nm_ip_routing_rule_validate (const NMIPRoutingRule *self,
                             GError **error);

Since: 1.18

nm_ip_routing_rule_from_string ()

NMIPRoutingRule *
nm_ip_routing_rule_from_string (const char *str,
                                NMIPRoutingRuleAsStringFlags to_string_flags,
                                GHashTable *extra_args,
                                GError **error);

Since: 1.18

nm_ip_routing_rule_to_string ()

char *
nm_ip_routing_rule_to_string (const NMIPRoutingRule *self,
                              NMIPRoutingRuleAsStringFlags to_string_flags,
                              GHashTable *extra_args,
                              GError **error);

Since: 1.18

nm_setting_ip_config_get_method ()

const char *
nm_setting_ip_config_get_method (NMSettingIPConfig *setting);

nm_setting_ip_config_get_num_dns ()

guint
nm_setting_ip_config_get_num_dns (NMSettingIPConfig *setting);

nm_setting_ip_config_get_dns ()

const char *
nm_setting_ip_config_get_dns (NMSettingIPConfig *setting,
                              int idx);

nm_setting_ip_config_add_dns ()

gboolean
nm_setting_ip_config_add_dns (NMSettingIPConfig *setting,
                              const char *dns);

Adds a new DNS server to the setting.

nm_setting_ip_config_remove_dns ()

void
nm_setting_ip_config_remove_dns (NMSettingIPConfig *setting,
                                 int idx);

Removes the DNS server at index idx .

nm_setting_ip_config_remove_dns_by_value ()

gboolean
nm_setting_ip_config_remove_dns_by_value
                               (NMSettingIPConfig *setting,
                                const char *dns);

Removes the DNS server dns .

nm_setting_ip_config_clear_dns ()

void
nm_setting_ip_config_clear_dns (NMSettingIPConfig *setting);

Removes all configured DNS servers.

nm_setting_ip_config_get_num_dns_searches ()

guint
nm_setting_ip_config_get_num_dns_searches
                               (NMSettingIPConfig *setting);

nm_setting_ip_config_get_dns_search ()

const char *
nm_setting_ip_config_get_dns_search (NMSettingIPConfig *setting,
                                     int idx);

nm_setting_ip_config_add_dns_search ()

gboolean
nm_setting_ip_config_add_dns_search (NMSettingIPConfig *setting,
                                     const char *dns_search);

Adds a new DNS search domain to the setting.

nm_setting_ip_config_remove_dns_search ()

void
nm_setting_ip_config_remove_dns_search
                               (NMSettingIPConfig *setting,
                                int idx);

Removes the DNS search domain at index idx .

nm_setting_ip_config_remove_dns_search_by_value ()

gboolean
nm_setting_ip_config_remove_dns_search_by_value
                               (NMSettingIPConfig *setting,
                                const char *dns_search);

Removes the DNS search domain dns_search .

nm_setting_ip_config_clear_dns_searches ()

void
nm_setting_ip_config_clear_dns_searches
                               (NMSettingIPConfig *setting);

Removes all configured DNS search domains.

nm_setting_ip_config_get_num_dns_options ()

guint
nm_setting_ip_config_get_num_dns_options
                               (NMSettingIPConfig *setting);

Since: 1.2

nm_setting_ip_config_has_dns_options ()

gboolean
nm_setting_ip_config_has_dns_options (NMSettingIPConfig *setting);

NMSettingIPConfig can have a list of dns-options. If the list is empty, there are two similar (but differentiated) states. Either the options are explicitly set to have no values, or the options are left undefined. The latter means to use a default configuration, while the former explicitly means "no-options".

nm_setting_ip_config_get_dns_option ()

const char *
nm_setting_ip_config_get_dns_option (NMSettingIPConfig *setting,
                                     guint idx);

Since: 1.2

nm_setting_ip_config_add_dns_option ()

gboolean
nm_setting_ip_config_add_dns_option (NMSettingIPConfig *setting,
                                     const char *dns_option);

Adds a new DNS option to the setting.

Since: 1.2

nm_setting_ip_config_remove_dns_option ()

void
nm_setting_ip_config_remove_dns_option
                               (NMSettingIPConfig *setting,
                                int idx);

Removes the DNS option at index idx .

Since: 1.2

nm_setting_ip_config_remove_dns_option_by_value ()

gboolean
nm_setting_ip_config_remove_dns_option_by_value
                               (NMSettingIPConfig *setting,
                                const char *dns_option);

Removes the DNS option dns_option .

Since: 1.2

nm_setting_ip_config_clear_dns_options ()

void
nm_setting_ip_config_clear_dns_options
                               (NMSettingIPConfig *setting,
                                gboolean is_set);

Removes all configured DNS options.

Since: 1.2

nm_setting_ip_config_get_dns_priority ()

int
nm_setting_ip_config_get_dns_priority (NMSettingIPConfig *setting);

Since: 1.4

nm_setting_ip_config_get_num_addresses ()

guint
nm_setting_ip_config_get_num_addresses
                               (NMSettingIPConfig *setting);

nm_setting_ip_config_get_address ()

NMIPAddress *
nm_setting_ip_config_get_address (NMSettingIPConfig *setting,
                                  int idx);

nm_setting_ip_config_add_address ()

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.

nm_setting_ip_config_remove_address ()

void
nm_setting_ip_config_remove_address (NMSettingIPConfig *setting,
                                     int idx);

Removes the address at index idx .

nm_setting_ip_config_remove_address_by_value ()

gboolean
nm_setting_ip_config_remove_address_by_value
                               (NMSettingIPConfig *setting,
                                NMIPAddress *address);

Removes the address address .

nm_setting_ip_config_clear_addresses ()

void
nm_setting_ip_config_clear_addresses (NMSettingIPConfig *setting);

Removes all configured addresses.

nm_setting_ip_config_get_gateway ()

const char *
nm_setting_ip_config_get_gateway (NMSettingIPConfig *setting);

nm_setting_ip_config_get_num_routes ()

guint
nm_setting_ip_config_get_num_routes (NMSettingIPConfig *setting);

nm_setting_ip_config_get_route ()

NMIPRoute *
nm_setting_ip_config_get_route (NMSettingIPConfig *setting,
                                int idx);

nm_setting_ip_config_add_route ()

gboolean
nm_setting_ip_config_add_route (NMSettingIPConfig *setting,
                                NMIPRoute *route);

Appends a new route and associated information to the setting. The given route is duplicated internally and is not changed by this function. If an identical route (considering attributes as well) already exists, the route is not added and the function returns FALSE.

Note that before 1.10, this function would not consider route attributes and not add a route that has an existing route with same dest/prefix,next_hop,metric parameters.

nm_setting_ip_config_remove_route ()

void
nm_setting_ip_config_remove_route (NMSettingIPConfig *setting,
                                   int idx);

Removes the route at index idx .

nm_setting_ip_config_remove_route_by_value ()

gboolean
nm_setting_ip_config_remove_route_by_value
                               (NMSettingIPConfig *setting,
                                NMIPRoute *route);

Removes the first matching route that matches route . Note that before 1.10, this function would only compare dest/prefix,next_hop,metric and ignore route attributes. Now, route must match exactly.

nm_setting_ip_config_clear_routes ()

void
nm_setting_ip_config_clear_routes (NMSettingIPConfig *setting);

Removes all configured routes.

nm_setting_ip_config_get_route_metric ()

gint64
nm_setting_ip_config_get_route_metric (NMSettingIPConfig *setting);

Returns the value contained in the “route-metric” property.

nm_setting_ip_config_get_route_table ()

guint32
nm_setting_ip_config_get_route_table (NMSettingIPConfig *setting);

Returns the value contained in the “route-table” property.

Since: 1.10

nm_setting_ip_config_get_num_routing_rules ()

guint
nm_setting_ip_config_get_num_routing_rules
                               (NMSettingIPConfig *setting);

Since: 1.18

nm_setting_ip_config_get_routing_rule ()

NMIPRoutingRule *
nm_setting_ip_config_get_routing_rule (NMSettingIPConfig *setting,
                                       guint idx);

Since: 1.18

nm_setting_ip_config_add_routing_rule ()

void
nm_setting_ip_config_add_routing_rule (NMSettingIPConfig *setting,
                                       NMIPRoutingRule *routing_rule);

Appends a new routing-rule and associated information to the setting. The given routing rules gets sealed and the reference count is incremented. The function does not check whether an identical rule already exists and always appends the rule to the end of the list.

Since: 1.18

nm_setting_ip_config_remove_routing_rule ()

void
nm_setting_ip_config_remove_routing_rule
                               (NMSettingIPConfig *setting,
                                guint idx);

Removes the routing_rule at index idx .

Since: 1.18

nm_setting_ip_config_clear_routing_rules ()

void
nm_setting_ip_config_clear_routing_rules
                               (NMSettingIPConfig *setting);

Removes all configured routing rules.

Since: 1.18

nm_setting_ip_config_get_ignore_auto_routes ()

gboolean
nm_setting_ip_config_get_ignore_auto_routes
                               (NMSettingIPConfig *setting);

Returns the value contained in the “ignore-auto-routes” property.

nm_setting_ip_config_get_ignore_auto_dns ()

gboolean
nm_setting_ip_config_get_ignore_auto_dns
                               (NMSettingIPConfig *setting);

Returns the value contained in the “ignore-auto-dns” property.

nm_setting_ip_config_get_dhcp_hostname ()

const char *
nm_setting_ip_config_get_dhcp_hostname
                               (NMSettingIPConfig *setting);

Returns the value contained in the “dhcp-hostname” property.

nm_setting_ip_config_get_dhcp_send_hostname ()

gboolean
nm_setting_ip_config_get_dhcp_send_hostname
                               (NMSettingIPConfig *setting);

Returns the value contained in the “dhcp-send-hostname” property.

nm_setting_ip_config_get_never_default ()

gboolean
nm_setting_ip_config_get_never_default
                               (NMSettingIPConfig *setting);

Returns the value contained in the “never-default” property.

nm_setting_ip_config_get_may_fail ()

gboolean
nm_setting_ip_config_get_may_fail (NMSettingIPConfig *setting);

Returns the value contained in the “may-fail” property.

nm_setting_ip_config_get_dad_timeout ()

int
nm_setting_ip_config_get_dad_timeout (NMSettingIPConfig *setting);

Since: 1.2

nm_setting_ip_config_get_dhcp_timeout ()

int
nm_setting_ip_config_get_dhcp_timeout (NMSettingIPConfig *setting);

Returns the value contained in the “dhcp-timeout” property.

Since: 1.2

nm_setting_ip_config_get_dhcp_iaid ()

const char *
nm_setting_ip_config_get_dhcp_iaid (NMSettingIPConfig *setting);

Returns the value contained in the “dhcp-iaid” property.

Since: 1.22

nm_setting_ip_config_get_dhcp_hostname_flags ()

NMDhcpHostnameFlags
nm_setting_ip_config_get_dhcp_hostname_flags
                               (NMSettingIPConfig *setting);

Returns the value contained in the “dhcp-hostname-flags” property.

Since: 1.22

nm_setting_ip_config_get_dhcp_reject_servers ()

const char *const *
nm_setting_ip_config_get_dhcp_reject_servers
                               (NMSettingIPConfig *setting,
                                guint *out_len);

Since: 1.28

nm_setting_ip_config_add_dhcp_reject_server ()

void
nm_setting_ip_config_add_dhcp_reject_server
                               (NMSettingIPConfig *setting,
                                const char *server);

Adds a new DHCP reject server to the setting.

Since: 1.28

nm_setting_ip_config_remove_dhcp_reject_server ()

void
nm_setting_ip_config_remove_dhcp_reject_server
                               (NMSettingIPConfig *setting,
                                guint idx);

Removes the DHCP reject server at index idx .

Since: 1.28

nm_setting_ip_config_clear_dhcp_reject_servers ()

void
nm_setting_ip_config_clear_dhcp_reject_servers
                               (NMSettingIPConfig *setting);

Removes all configured DHCP reject servers.

Since: 1.28

NM_IP_ADDRESS_ATTRIBUTE_LABEL

#define NM_IP_ADDRESS_ATTRIBUTE_LABEL "label"

enum NMIPAddressCmpFlags

Compare flags for nm_ip_address_cmp_full().

Since: 1.22

NM_IP_ROUTE_ATTRIBUTE_CWND

#define NM_IP_ROUTE_ATTRIBUTE_CWND          "cwnd"

NM_IP_ROUTE_ATTRIBUTE_FROM

#define NM_IP_ROUTE_ATTRIBUTE_FROM          "from"

NM_IP_ROUTE_ATTRIBUTE_INITCWND

#define NM_IP_ROUTE_ATTRIBUTE_INITCWND      "initcwnd"

NM_IP_ROUTE_ATTRIBUTE_INITRWND

#define NM_IP_ROUTE_ATTRIBUTE_INITRWND      "initrwnd"

NM_IP_ROUTE_ATTRIBUTE_LOCK_CWND

#define NM_IP_ROUTE_ATTRIBUTE_LOCK_CWND     "lock-cwnd"

NM_IP_ROUTE_ATTRIBUTE_LOCK_INITCWND

#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITCWND "lock-initcwnd"

NM_IP_ROUTE_ATTRIBUTE_LOCK_INITRWND

#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITRWND "lock-initrwnd"

NM_IP_ROUTE_ATTRIBUTE_LOCK_MTU

#define NM_IP_ROUTE_ATTRIBUTE_LOCK_MTU      "lock-mtu"

NM_IP_ROUTE_ATTRIBUTE_LOCK_WINDOW

#define NM_IP_ROUTE_ATTRIBUTE_LOCK_WINDOW   "lock-window"

NM_IP_ROUTE_ATTRIBUTE_MTU

#define NM_IP_ROUTE_ATTRIBUTE_MTU           "mtu"

NM_IP_ROUTE_ATTRIBUTE_ONLINK

#define NM_IP_ROUTE_ATTRIBUTE_ONLINK        "onlink"

NM_IP_ROUTE_ATTRIBUTE_SCOPE

#define NM_IP_ROUTE_ATTRIBUTE_SCOPE         "scope"

NM_IP_ROUTE_ATTRIBUTE_SRC

#define NM_IP_ROUTE_ATTRIBUTE_SRC           "src"

NM_IP_ROUTE_ATTRIBUTE_TABLE

#define NM_IP_ROUTE_ATTRIBUTE_TABLE         "table"

NM_IP_ROUTE_ATTRIBUTE_TOS

#define NM_IP_ROUTE_ATTRIBUTE_TOS           "tos"

NM_IP_ROUTE_ATTRIBUTE_TYPE

#define NM_IP_ROUTE_ATTRIBUTE_TYPE          "type"

NM_IP_ROUTE_ATTRIBUTE_WINDOW

#define NM_IP_ROUTE_ATTRIBUTE_WINDOW        "window"

enum NMIPRoutingRuleAsStringFlags

Since: 1.18

NM_SETTING_IP_CONFIG_DAD_TIMEOUT_MAX

#define NM_SETTING_IP_CONFIG_DAD_TIMEOUT_MAX 30000

NM_SETTING_IP_CONFIG_METHOD

#define NM_SETTING_IP_CONFIG_METHOD              "method"

NM_SETTING_IP_CONFIG_DNS

#define NM_SETTING_IP_CONFIG_DNS                 "dns"

NM_SETTING_IP_CONFIG_DNS_SEARCH

#define NM_SETTING_IP_CONFIG_DNS_SEARCH          "dns-search"

NM_SETTING_IP_CONFIG_DNS_OPTIONS

#define NM_SETTING_IP_CONFIG_DNS_OPTIONS         "dns-options"

NM_SETTING_IP_CONFIG_DNS_PRIORITY

#define NM_SETTING_IP_CONFIG_DNS_PRIORITY        "dns-priority"

NM_SETTING_IP_CONFIG_ADDRESSES

#define NM_SETTING_IP_CONFIG_ADDRESSES           "addresses"

NM_SETTING_IP_CONFIG_GATEWAY

#define NM_SETTING_IP_CONFIG_GATEWAY             "gateway"

NM_SETTING_IP_CONFIG_ROUTES

#define NM_SETTING_IP_CONFIG_ROUTES              "routes"

NM_SETTING_IP_CONFIG_ROUTE_METRIC

#define NM_SETTING_IP_CONFIG_ROUTE_METRIC        "route-metric"

NM_SETTING_IP_CONFIG_ROUTE_TABLE

#define NM_SETTING_IP_CONFIG_ROUTE_TABLE         "route-table"

NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES

#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES  "ignore-auto-routes"

NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS

#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS     "ignore-auto-dns"

NM_SETTING_IP_CONFIG_DHCP_HOSTNAME

#define NM_SETTING_IP_CONFIG_DHCP_HOSTNAME       "dhcp-hostname"

NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME

#define NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME  "dhcp-send-hostname"

NM_SETTING_IP_CONFIG_DHCP_HOSTNAME_FLAGS

#define NM_SETTING_IP_CONFIG_DHCP_HOSTNAME_FLAGS "dhcp-hostname-flags"

NM_SETTING_IP_CONFIG_NEVER_DEFAULT

#define NM_SETTING_IP_CONFIG_NEVER_DEFAULT       "never-default"

NM_SETTING_IP_CONFIG_MAY_FAIL

#define NM_SETTING_IP_CONFIG_MAY_FAIL            "may-fail"

NM_SETTING_IP_CONFIG_DAD_TIMEOUT

#define NM_SETTING_IP_CONFIG_DAD_TIMEOUT         "dad-timeout"

NM_SETTING_IP_CONFIG_DHCP_TIMEOUT

#define NM_SETTING_IP_CONFIG_DHCP_TIMEOUT        "dhcp-timeout"

NM_SETTING_IP_CONFIG_DHCP_IAID

#define NM_SETTING_IP_CONFIG_DHCP_IAID           "dhcp-iaid"

NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS

#define NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS "dhcp-reject-servers"

NM_SETTING_IP_CONFIG_ROUTING_RULES

#define NM_SETTING_IP_CONFIG_ROUTING_RULES "routing-rules"

NM_SETTING_DNS_OPTION_DEBUG

#define NM_SETTING_DNS_OPTION_DEBUG                 "debug"

NM_SETTING_DNS_OPTION_NDOTS

#define NM_SETTING_DNS_OPTION_NDOTS                 "ndots"

NM_SETTING_DNS_OPTION_TIMEOUT

#define NM_SETTING_DNS_OPTION_TIMEOUT               "timeout"

NM_SETTING_DNS_OPTION_ATTEMPTS

#define NM_SETTING_DNS_OPTION_ATTEMPTS              "attempts"

NM_SETTING_DNS_OPTION_ROTATE

#define NM_SETTING_DNS_OPTION_ROTATE                "rotate"

NM_SETTING_DNS_OPTION_NO_CHECK_NAMES

#define NM_SETTING_DNS_OPTION_NO_CHECK_NAMES        "no-check-names"

NM_SETTING_DNS_OPTION_INET6

#define NM_SETTING_DNS_OPTION_INET6                 "inet6"

NM_SETTING_DNS_OPTION_IP6_BYTESTRING

#define NM_SETTING_DNS_OPTION_IP6_BYTESTRING        "ip6-bytestring"

NM_SETTING_DNS_OPTION_IP6_DOTINT

#define NM_SETTING_DNS_OPTION_IP6_DOTINT            "ip6-dotint"

NM_SETTING_DNS_OPTION_NO_IP6_DOTINT

#define NM_SETTING_DNS_OPTION_NO_IP6_DOTINT         "no-ip6-dotint"

NM_SETTING_DNS_OPTION_EDNS0

#define NM_SETTING_DNS_OPTION_EDNS0                 "edns0"

NM_SETTING_DNS_OPTION_SINGLE_REQUEST

#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST        "single-request"

NM_SETTING_DNS_OPTION_SINGLE_REQUEST_REOPEN

#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST_REOPEN "single-request-reopen"

NM_SETTING_DNS_OPTION_NO_TLD_QUERY

#define NM_SETTING_DNS_OPTION_NO_TLD_QUERY          "no-tld-query"

NM_SETTING_DNS_OPTION_USE_VC

#define NM_SETTING_DNS_OPTION_USE_VC                "use-vc"

NM_SETTING_DNS_OPTION_NO_RELOAD

#define NM_SETTING_DNS_OPTION_NO_RELOAD             "no-reload"

NM_SETTING_DNS_OPTION_TRUST_AD

#define NM_SETTING_DNS_OPTION_TRUST_AD              "trust-ad"

NMSettingIPConfig

typedef struct _NMSettingIPConfig NMSettingIPConfig;

enum NMDhcpHostnameFlags

NMDhcpHostnameFlags describe flags related to the DHCP hostname and FQDN.

Since: 1.22

The “addresses” property

  “addresses”                GPtrArray *

Array of IP addresses.

[type GPtrArray(NMIPAddress)]

Owner: NMSettingIPConfig

Flags: Read / Write

The “dad-timeout” property

  “dad-timeout”              int

Timeout in milliseconds used to check for the presence of duplicate IP addresses on the network. If an address conflict is detected, the activation will fail. A zero value means that no duplicate address detection is performed, -1 means the default value (either configuration ipvx.dad-timeout override or zero). A value greater than zero is a timeout in milliseconds.

The property is currently implemented only for IPv4.

Owner: NMSettingIPConfig

Flags: Read / Write

Allowed values: [-1,30000]

Default value: -1

Since: 1.2

The “dhcp-hostname” property

  “dhcp-hostname”            char *

If the “dhcp-send-hostname” property is TRUE, then the specified name will be sent to the DHCP server when acquiring a lease. This property and “dhcp-fqdn” are mutually exclusive and cannot be set at the same time.

Owner: NMSettingIPConfig

Flags: Read / Write

Default value: NULL

The “dhcp-hostname-flags” property

  “dhcp-hostname-flags”      guint

Flags for the DHCP hostname and FQDN.

Currently, this property only includes flags to control the FQDN flags set in the DHCP FQDN option. Supported FQDN flags are NM_DHCP_HOSTNAME_FLAG_FQDN_SERV_UPDATE, NM_DHCP_HOSTNAME_FLAG_FQDN_ENCODED and NM_DHCP_HOSTNAME_FLAG_FQDN_NO_UPDATE. When no FQDN flag is set and NM_DHCP_HOSTNAME_FLAG_FQDN_CLEAR_FLAGS is set, the DHCP FQDN option will contain no flag. Otherwise, if no FQDN flag is set and NM_DHCP_HOSTNAME_FLAG_FQDN_CLEAR_FLAGS is not set, the standard FQDN flags are set in the request: NM_DHCP_HOSTNAME_FLAG_FQDN_SERV_UPDATE, NM_DHCP_HOSTNAME_FLAG_FQDN_ENCODED for IPv4 and NM_DHCP_HOSTNAME_FLAG_FQDN_SERV_UPDATE for IPv6.

When this property is set to the default value NM_DHCP_HOSTNAME_FLAG_NONE, a global default is looked up in NetworkManager configuration. If that value is unset or also NM_DHCP_HOSTNAME_FLAG_NONE, then the standard FQDN flags described above are sent in the DHCP requests.

Owner: NMSettingIPConfig

Flags: Read / Write

Default value: 0

Since: 1.22

The “dhcp-iaid” property

  “dhcp-iaid”                char *

A string containing the "Identity Association Identifier" (IAID) used by the DHCP client. The property is a 32-bit decimal value or a special value among "mac", "perm-mac", "ifname" and "stable". When set to "mac" (or "perm-mac"), the last 4 bytes of the current (or permanent) MAC address are used as IAID. When set to "ifname", the IAID is computed by hashing the interface name. The special value "stable" can be used to generate an IAID based on the stable-id (see connection.stable-id), a per-host key and the interface name. When the property is unset, the value from global configuration is used; if no global default is set then the IAID is assumed to be "ifname". Note that at the moment this property is ignored for IPv6 by dhclient, which always derives the IAID from the MAC address.

Owner: NMSettingIPConfig

Flags: Read / Write

Default value: NULL

Since: 1.22

The “dhcp-reject-servers” property

  “dhcp-reject-servers”      GStrv

Array of servers from which DHCP offers must be rejected. This property is useful to avoid getting a lease from misconfigured or rogue servers.

For DHCPv4, each element must be an IPv4 address, optionally followed by a slash and a prefix length (e.g. "192.168.122.0/24").

This property is currently not implemented for DHCPv6.

Owner: NMSettingIPConfig

Flags: Read / Write

Since: 1.28