NMSettingIP6Config: libnm-util Reference Manual

nm_ip6_address_unref ()

void
-nm_ip6_address_unref (NMIP6Address *address);

Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed.

Parameters

----- - - - - - -

address

nm_ip6_address_compare ()

gboolean
-nm_ip6_address_compare (NMIP6Address *address,
-                        NMIP6Address *other);

Determines if two NMIP6Address objects contain the same values.

Parameters

----- - - - - - - - - - - - - -

address	the NMIP6Address
other	the NMIP6Address to compare `address` -to.

Returns

TRUE if the objects contain the same values, FALSE if they do not.

nm_ip6_address_get_address ()

const struct in6_addr *
-nm_ip6_address_get_address (NMIP6Address *address);

Gets the IPv6 address property of this address object.

Parameters

----- - - - - - -

address

Returns

the IPv6 address.

[array fixed-size=16][element-type guint8][transfer none]

nm_ip6_address_set_address ()

void
-nm_ip6_address_set_address (NMIP6Address *address,
-                            const struct in6_addr *addr);

Sets the IPv6 address property of this object.

Parameters

----- - - - - - - - - - - - - -

address	the NMIP6Address
addr	the IPv6 address

nm_ip6_address_get_prefix ()

guint32
-nm_ip6_address_get_prefix (NMIP6Address *address);

Gets the IPv6 address prefix property of this address object.

Parameters

----- - - - - - -

address

Returns

the IPv6 address prefix

nm_ip6_address_set_prefix ()

void
-nm_ip6_address_set_prefix (NMIP6Address *address,
-                           guint32 prefix);

Sets the IPv6 address prefix.

Parameters

----- - - - - - - - - - - - - -

address	the NMIP6Address
prefix	the address prefix, a number between 0 and 128 inclusive

nm_ip6_address_get_gateway ()

const struct in6_addr *
-nm_ip6_address_get_gateway (NMIP6Address *address);

Gets the IPv6 default gateway property of this address object.

Parameters

----- - - - - - -

address

Returns

the IPv6 gateway address.

[array fixed-size=16][element-type guint8][transfer none]

nm_ip6_address_set_gateway ()

void
-nm_ip6_address_set_gateway (NMIP6Address *address,
-                            const struct in6_addr *gateway);

Sets the IPv6 default gateway property of this address object.

Parameters

----- - - - - - - - - - - - - -

address	the NMIP6Address
gateway	the IPv6 default gateway

nm_ip6_route_new ()

NMIP6Route *
-nm_ip6_route_new (void);

Creates and returns a new NMIP6Route object.

Returns

the new empty NMIP6Route object.

[transfer full]

nm_ip6_route_dup ()

NMIP6Route *
-nm_ip6_route_dup (NMIP6Route *source);

Copies a given NMIP6Route object and returns the copy.

Parameters

----- - - - - - -

source

the NMIP6Route object to copy

Returns

the copy of the given NMIP6Route copy.

[transfer full]

nm_ip6_route_ref ()

void
-nm_ip6_route_ref (NMIP6Route *route);

Increases the reference count of the object.

Parameters

----- - - - - - -

route

nm_ip6_route_unref ()

void
-nm_ip6_route_unref (NMIP6Route *route);

Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed.

Parameters

----- - - - - - -

route

nm_ip6_route_compare ()

gboolean
-nm_ip6_route_compare (NMIP6Route *route,
-                      NMIP6Route *other);

Determines if two NMIP6Route objects contain the same values.

Parameters

----- - - - - - - - - - - - - -

route	the NMIP6Route
other	the NMIP6Route to compare `route` -to.

Returns

TRUE if the objects contain the same values, FALSE if they do not.

nm_ip6_route_get_dest ()

const struct in6_addr *
-nm_ip6_route_get_dest (NMIP6Route *route);

Gets the IPv6 destination address property of this route object.

Parameters

----- - - - - - -

route

Returns

the IPv6 address of destination.

[array fixed-size=16][element-type guint8][transfer none]

nm_ip6_route_set_dest ()

void
-nm_ip6_route_set_dest (NMIP6Route *route,
-                       const struct in6_addr *dest);

Sets the IPv6 destination address property of this route object.

Parameters

----- - - - - - - - - - - - - -

route	the NMIP6Route
dest	the destination address

nm_ip6_route_get_prefix ()

guint32
-nm_ip6_route_get_prefix (NMIP6Route *route);

Gets the IPv6 prefix (ie "32" or "64" etc) of this route.

Parameters

----- - - - - - -

route

Returns

the IPv6 prefix

nm_ip6_route_set_prefix ()

void
-nm_ip6_route_set_prefix (NMIP6Route *route,
-                         guint32 prefix);

Sets the IPv6 prefix of this route.

Parameters

----- - - - - - - - - - - - - -

route	the NMIP6Route
prefix	the prefix, a number between 1 and 128 inclusive

nm_ip6_route_get_next_hop ()

const struct in6_addr *
-nm_ip6_route_get_next_hop (NMIP6Route *route);

Gets the IPv6 address of the next hop of this route.

Parameters

----- - - - - - -

route

Returns

the IPv6 address of next hop.

[array fixed-size=16][element-type guint8][transfer none]

nm_ip6_route_set_next_hop ()

void
-nm_ip6_route_set_next_hop (NMIP6Route *route,
-                           const struct in6_addr *next_hop);

Sets the IPv6 address of the next hop of this route.

Parameters

----- - - - - - - - - - - - - -

route	the NMIP6Route
next_hop	the IPv6 address of the next hop

nm_ip6_route_get_metric ()

guint32
-nm_ip6_route_get_metric (NMIP6Route *route);

Gets the route metric property of this route object; lower values indicate -"better" or more preferred routes.

Parameters

----- - - - - - -

route

Returns

the route metric

nm_ip6_route_set_metric ()

void
-nm_ip6_route_set_metric (NMIP6Route *route,
-                         guint32 metric);

Sets the route metric property of this route object; lower values indicate -"better" or more preferred routes.

Parameters

----- - - - - - - - - - - - - -

route	the NMIP6Route
metric	the route metric

nm_setting_ip6_config_new ()

NMSetting *
-nm_setting_ip6_config_new (void);

Creates a new NMSettingIP6Config object with default values.

Returns

the new empty NMSettingIP6Config object.

[transfer full]

nm_setting_ip6_config_get_method ()

const char *
-nm_setting_ip6_config_get_method (NMSettingIP6Config *setting);

Parameters

----- - - - - - -

setting

Returns

the “method” property of the setting

nm_setting_ip6_config_get_num_dns ()

guint32
-nm_setting_ip6_config_get_num_dns (NMSettingIP6Config *setting);

Parameters

----- - - - - - -

setting

Returns

the number of configured DNS servers

nm_setting_ip6_config_get_dns ()

const struct in6_addr *
-nm_setting_ip6_config_get_dns (NMSettingIP6Config *setting,
-                               guint32 i);

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the DNS server to return

Returns

the IPv6 address of the DNS server at index i -.

[transfer none]

nm_setting_ip6_config_add_dns ()

gboolean
-nm_setting_ip6_config_add_dns (NMSettingIP6Config *setting,
-                               const struct in6_addr *dns);

Adds a new DNS server to the setting.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
dns	the IPv6 address of the DNS server to add

Returns

TRUE if the DNS server was added; FALSE if the server was already -known

nm_setting_ip6_config_remove_dns ()

void
-nm_setting_ip6_config_remove_dns (NMSettingIP6Config *setting,
-                                  guint32 i);

Removes the DNS server at index i -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the DNS server to remove

nm_setting_ip6_config_remove_dns_by_value ()

gboolean
-nm_setting_ip6_config_remove_dns_by_value
-                               (NMSettingIP6Config *setting,
-                                const struct in6_addr *dns);

Removes the DNS server at index i -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
dns	the IPv6 address of the DNS server to remove

Returns

TRUE if the DNS server was found and removed; FALSE if it was not.

Since: 0.9.10

nm_setting_ip6_config_clear_dns ()

void
-nm_setting_ip6_config_clear_dns (NMSettingIP6Config *setting);

Removes all configured DNS servers.

Parameters

----- - - - - - -

setting

nm_setting_ip6_config_get_num_dns_searches ()

guint32
-nm_setting_ip6_config_get_num_dns_searches
-                               (NMSettingIP6Config *setting);

Parameters

----- - - - - - -

setting

Returns

the number of configured DNS search domains

nm_setting_ip6_config_get_dns_search ()

const char *
-nm_setting_ip6_config_get_dns_search (NMSettingIP6Config *setting,
-                                      guint32 i);

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the DNS search domain to return

Returns

the DNS search domain at index i -

nm_setting_ip6_config_add_dns_search ()

gboolean
-nm_setting_ip6_config_add_dns_search (NMSettingIP6Config *setting,
-                                      const char *dns_search);

Adds a new DNS search domain to the setting.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
dns_search	the search domain to add

Returns

TRUE if the DNS search domain was added; FALSE if the search -domain was already known

nm_setting_ip6_config_remove_dns_search ()

void
-nm_setting_ip6_config_remove_dns_search
-                               (NMSettingIP6Config *setting,
-                                guint32 i);

Removes the DNS search domain at index i -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the DNS search domain

nm_setting_ip6_config_remove_dns_search_by_value ()

gboolean
-nm_setting_ip6_config_remove_dns_search_by_value
-                               (NMSettingIP6Config *setting,
-                                const char *dns_search);

Removes the DNS search domain dns_search -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
dns_search	the search domain to remove

Returns

TRUE if the DNS search domain was found and removed; FALSE if it was not.

Since 0.9.10

nm_setting_ip6_config_clear_dns_searches ()

void
-nm_setting_ip6_config_clear_dns_searches
-                               (NMSettingIP6Config *setting);

Removes all configured DNS search domains.

Parameters

----- - - - - - -

setting

nm_setting_ip6_config_get_num_addresses ()

guint32
-nm_setting_ip6_config_get_num_addresses
-                               (NMSettingIP6Config *setting);

Parameters

----- - - - - - -

setting

Returns

the number of configured addresses

nm_setting_ip6_config_get_address ()

NMIP6Address *
-nm_setting_ip6_config_get_address (NMSettingIP6Config *setting,
-                                   guint32 i);

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the address to return

Returns

the address at index i -

nm_setting_ip6_config_add_address ()

gboolean
-nm_setting_ip6_config_add_address (NMSettingIP6Config *setting,
-                                   NMIP6Address *address);

Adds a new IPv6 address and associated information to the setting. The -given address is duplicated internally and is not changed by this function.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
address	the new address to add

Returns

TRUE if the address was added; FALSE if the address was already -known.

nm_setting_ip6_config_remove_address ()

void
-nm_setting_ip6_config_remove_address (NMSettingIP6Config *setting,
-                                      guint32 i);

Removes the address at index i -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the address to remove

nm_setting_ip6_config_remove_address_by_value ()

gboolean
-nm_setting_ip6_config_remove_address_by_value
-                               (NMSettingIP6Config *setting,
-                                NMIP6Address *address);

Removes the address address -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
address	the address to remove

Returns

TRUE if the address was found and removed; FALSE if it was not.

Since: 0.9.10

nm_setting_ip6_config_clear_addresses ()

void
-nm_setting_ip6_config_clear_addresses (NMSettingIP6Config *setting);

Removes all configured addresses.

Parameters

----- - - - - - -

setting

nm_setting_ip6_config_get_num_routes ()

guint32
-nm_setting_ip6_config_get_num_routes (NMSettingIP6Config *setting);

Parameters

----- - - - - - -

setting

Returns

the number of configured routes

nm_setting_ip6_config_get_route ()

NMIP6Route *
-nm_setting_ip6_config_get_route (NMSettingIP6Config *setting,
-                                 guint32 i);

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the route to return

Returns

the route at index i -

nm_setting_ip6_config_add_route ()

gboolean
-nm_setting_ip6_config_add_route (NMSettingIP6Config *setting,
-                                 NMIP6Route *route);

Adds a new IPv6 route and associated information to the setting. The -given route is duplicated internally and is not changed by this function.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
route	the route to add

Returns

TRUE if the route was added; FALSE if the route was already known.

nm_setting_ip6_config_remove_route ()

void
-nm_setting_ip6_config_remove_route (NMSettingIP6Config *setting,
-                                    guint32 i);

Removes the route at index i -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
i	index number of the route

nm_setting_ip6_config_remove_route_by_value ()

gboolean
-nm_setting_ip6_config_remove_route_by_value
-                               (NMSettingIP6Config *setting,
-                                NMIP6Route *route);

Removes the route route -.

Parameters

----- - - - - - - - - - - - - -

setting	the NMSettingIP6Config
route	the route to remove

Returns

TRUE if the route was found and removed; FALSE if it was not.

Since: 0.9.10

nm_setting_ip6_config_clear_routes ()

void
-nm_setting_ip6_config_clear_routes (NMSettingIP6Config *setting);

Removes all configured routes.

Parameters

----- - - - - - -

setting

nm_setting_ip6_config_get_ignore_auto_routes ()

gboolean
-nm_setting_ip6_config_get_ignore_auto_routes
-                               (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

TRUE if automatically configured (ie via DHCP) routes should be -ignored.

nm_setting_ip6_config_get_route_metric ()

gint64
-nm_setting_ip6_config_get_route_metric
-                               (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

the route metric that is used for IPv6 routes that don't explicitly -specify a metric. See “route-metric” for more details.

Since: 1.0

nm_setting_ip6_config_get_ignore_auto_dns ()

gboolean
-nm_setting_ip6_config_get_ignore_auto_dns
-                               (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

TRUE if automatically configured (ie via DHCP or router -advertisements) DNS information should be ignored.

nm_setting_ip6_config_get_dhcp_hostname ()

const char *
-nm_setting_ip6_config_get_dhcp_hostname
-                               (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

the configured hostname to send to the DHCP server

Since: 0.9.8

nm_setting_ip6_config_get_never_default ()

gboolean
-nm_setting_ip6_config_get_never_default
-                               (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

TRUE if this connection should never be the default connection -for IPv6 addressing

nm_setting_ip6_config_get_may_fail ()

gboolean
-nm_setting_ip6_config_get_may_fail (NMSettingIP6Config *setting);

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

Parameters

----- - - - - - -

setting

Returns

TRUE if this connection doesn't require IPv6 addressing to complete -for the connection to succeed.

nm_setting_ip6_config_get_ip6_privacy ()

NMSettingIP6ConfigPrivacy
-nm_setting_ip6_config_get_ip6_privacy (NMSettingIP6Config *setting);

Returns the value contained in the “ip6-privacy” -property.

Parameters

----- - - - - - -

setting