Top |
NMSettingIP6ConfigNMSettingIP6Config — Describes IPv6 addressing, routing, and name service properties |
Functions
Properties
GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___* | addresses | Read / Write |
gchar * | dhcp-hostname | Read / Write |
GPtrArray_GArray_guchar__ * | dns | Read / Write |
GSList_gchararray_ * | dns-search | Read / Write |
gboolean | ignore-auto-dns | Read / Write / Construct |
gboolean | ignore-auto-routes | Read / Write / Construct |
gint | ip6-privacy | 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_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__* | routes | Read / Write |
Types and Values
#define | NM_SETTING_IP6_CONFIG_SETTING_NAME |
enum | NMSettingIP6ConfigError |
#define | NM_SETTING_IP6_CONFIG_ERROR |
#define | NM_SETTING_IP6_CONFIG_METHOD |
#define | NM_SETTING_IP6_CONFIG_DNS |
#define | NM_SETTING_IP6_CONFIG_DNS_SEARCH |
#define | NM_SETTING_IP6_CONFIG_ADDRESSES |
#define | NM_SETTING_IP6_CONFIG_ROUTES |
#define | NM_SETTING_IP6_CONFIG_ROUTE_METRIC |
#define | NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES |
#define | NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS |
#define | NM_SETTING_IP6_CONFIG_NEVER_DEFAULT |
#define | NM_SETTING_IP6_CONFIG_MAY_FAIL |
#define | NM_SETTING_IP6_CONFIG_IP6_PRIVACY |
#define | NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME |
#define | NM_SETTING_IP6_CONFIG_METHOD_IGNORE |
#define | NM_SETTING_IP6_CONFIG_METHOD_AUTO |
#define | NM_SETTING_IP6_CONFIG_METHOD_DHCP |
#define | NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL |
#define | NM_SETTING_IP6_CONFIG_METHOD_MANUAL |
#define | NM_SETTING_IP6_CONFIG_METHOD_SHARED |
enum | NMSettingIP6ConfigPrivacy |
Object Hierarchy
GBoxed ├── NMIP6Address ╰── NMIP6Route GEnum ├── NMSettingIP6ConfigError ╰── NMSettingIP6ConfigPrivacy GObject ╰── NMSetting ╰── NMSettingIP6Config
Description
The NMSettingIP6Config object is a NMSetting subclass that describes properties related to IPv6 addressing, routing, and Domain Name Service
Functions
nm_setting_ip6_config_error_quark ()
GQuark
nm_setting_ip6_config_error_quark (void
);
Registers an error quark for NMSettingIP6Config if necessary.
nm_ip6_address_new ()
NMIP6Address *
nm_ip6_address_new (void
);
Creates and returns a new NMIP6Address object.
nm_ip6_address_dup ()
NMIP6Address *
nm_ip6_address_dup (NMIP6Address *source
);
Copies a given NMIP6Address object and returns the copy.
nm_ip6_address_ref ()
void
nm_ip6_address_ref (NMIP6Address *address
);
Increases the reference count of the object.
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.
nm_ip6_address_compare ()
gboolean nm_ip6_address_compare (NMIP6Address *address
,NMIP6Address *other
);
Determines if two NMIP6Address objects contain the same values.
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.
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.
nm_ip6_address_get_prefix ()
guint32
nm_ip6_address_get_prefix (NMIP6Address *address
);
Gets the IPv6 address prefix property of this address object.
nm_ip6_address_set_prefix ()
void nm_ip6_address_set_prefix (NMIP6Address *address
,guint32 prefix
);
Sets the IPv6 address prefix.
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.
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.
nm_ip6_route_new ()
NMIP6Route *
nm_ip6_route_new (void
);
Creates and returns a new NMIP6Route object.
nm_ip6_route_dup ()
NMIP6Route *
nm_ip6_route_dup (NMIP6Route *source
);
Copies a given NMIP6Route object and returns the copy.
nm_ip6_route_ref ()
void
nm_ip6_route_ref (NMIP6Route *route
);
Increases the reference count of the object.
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.
nm_ip6_route_compare ()
gboolean nm_ip6_route_compare (NMIP6Route *route
,NMIP6Route *other
);
Determines if two NMIP6Route objects contain the same values.
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.
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.
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.
nm_ip6_route_set_prefix ()
void nm_ip6_route_set_prefix (NMIP6Route *route
,guint32 prefix
);
Sets the IPv6 prefix of this route.
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.
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.
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.
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.
nm_setting_ip6_config_new ()
NMSetting *
nm_setting_ip6_config_new (void
);
Creates a new NMSettingIP6Config object with default values.
nm_setting_ip6_config_get_method ()
const char *
nm_setting_ip6_config_get_method (NMSettingIP6Config *setting
);
nm_setting_ip6_config_get_num_dns ()
guint32
nm_setting_ip6_config_get_num_dns (NMSettingIP6Config *setting
);
nm_setting_ip6_config_get_dns ()
const struct in6_addr * nm_setting_ip6_config_get_dns (NMSettingIP6Config *setting
,guint32 i
);
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.
nm_setting_ip6_config_remove_dns ()
void nm_setting_ip6_config_remove_dns (NMSettingIP6Config *setting
,guint32 i
);
Removes the DNS server at index i
.
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
.
Since 0.9.10
nm_setting_ip6_config_clear_dns ()
void
nm_setting_ip6_config_clear_dns (NMSettingIP6Config *setting
);
Removes all configured DNS servers.
nm_setting_ip6_config_get_num_dns_searches ()
guint32
nm_setting_ip6_config_get_num_dns_searches
(NMSettingIP6Config *setting
);
nm_setting_ip6_config_get_dns_search ()
const char * nm_setting_ip6_config_get_dns_search (NMSettingIP6Config *setting
,guint32 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.
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
.
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
.
nm_setting_ip6_config_clear_dns_searches ()
void
nm_setting_ip6_config_clear_dns_searches
(NMSettingIP6Config *setting
);
Removes all configured DNS search domains.
nm_setting_ip6_config_get_num_addresses ()
guint32
nm_setting_ip6_config_get_num_addresses
(NMSettingIP6Config *setting
);
nm_setting_ip6_config_get_address ()
NMIP6Address * nm_setting_ip6_config_get_address (NMSettingIP6Config *setting
,guint32 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.
nm_setting_ip6_config_remove_address ()
void nm_setting_ip6_config_remove_address (NMSettingIP6Config *setting
,guint32 i
);
Removes the address at index i
.
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
.
Since 0.9.10
nm_setting_ip6_config_clear_addresses ()
void
nm_setting_ip6_config_clear_addresses (NMSettingIP6Config *setting
);
Removes all configured addresses.
nm_setting_ip6_config_get_num_routes ()
guint32
nm_setting_ip6_config_get_num_routes (NMSettingIP6Config *setting
);
nm_setting_ip6_config_get_route ()
NMIP6Route * nm_setting_ip6_config_get_route (NMSettingIP6Config *setting
,guint32 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.
nm_setting_ip6_config_remove_route ()
void nm_setting_ip6_config_remove_route (NMSettingIP6Config *setting
,guint32 i
);
Removes the route at index i
.
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
.
Since 0.9.10
nm_setting_ip6_config_clear_routes ()
void
nm_setting_ip6_config_clear_routes (NMSettingIP6Config *setting
);
Removes all configured routes.
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.
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.
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.
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.
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.
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.
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.
Types and Values
enum NMSettingIP6ConfigError
NM_SETTING_IP6_CONFIG_ERROR
#define NM_SETTING_IP6_CONFIG_ERROR nm_setting_ip6_config_error_quark ()
NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS "ignore-auto-dns"
NM_SETTING_IP6_CONFIG_METHOD_IGNORE
#define NM_SETTING_IP6_CONFIG_METHOD_IGNORE "ignore"
IPv6 is not required or is handled by some other mechanism, and NetworkManager should not configure IPv6 for this connection.
NM_SETTING_IP6_CONFIG_METHOD_AUTO
#define NM_SETTING_IP6_CONFIG_METHOD_AUTO "auto"
IPv6 configuration should be automatically determined via a method appropriate for the hardware interface, ie router advertisements, DHCP, or PPP or some other device-specific manner.
NM_SETTING_IP6_CONFIG_METHOD_DHCP
#define NM_SETTING_IP6_CONFIG_METHOD_DHCP "dhcp"
IPv6 configuration should be automatically determined via DHCPv6 only and router advertisements should be ignored.
NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL
#define NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL "link-local"
IPv6 configuration should be automatically configured for link-local-only operation.
NM_SETTING_IP6_CONFIG_METHOD_MANUAL
#define NM_SETTING_IP6_CONFIG_METHOD_MANUAL "manual"
All necessary IPv6 configuration (addresses, prefix, DNS, etc) is specified in the setting's properties.
NM_SETTING_IP6_CONFIG_METHOD_SHARED
#define NM_SETTING_IP6_CONFIG_METHOD_SHARED "shared"
This connection specifies configuration that allows other computers to connect through it to the default network (usually the Internet). The connection's interface will be assigned a private address, and router advertisements, a caching DNS server, and Network Address Translation (NAT) functionality will be started on this connection's interface to allow other devices to connect through that interface to the default network. (not yet supported for IPv6)
enum NMSettingIP6ConfigPrivacy
NMSettingIP6ConfigPrivacy values indicate if and how IPv6 Privacy Extensions are used (RFC4941).
Property Details
The “addresses”
property
“addresses” GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___*
Flags: Read / Write
The “dhcp-hostname”
property
“dhcp-hostname” gchar *
Flags: Read / Write
Default value: NULL
Since 0.9.8
The “ignore-auto-dns”
property
“ignore-auto-dns” gboolean
Flags: Read / Write / Construct
Default value: FALSE
The “ignore-auto-routes”
property
“ignore-auto-routes” gboolean
Flags: Read / Write / Construct
Default value: FALSE
The “ip6-privacy”
property
“ip6-privacy” gint
Flags: Read / Write / Construct
Allowed values: [-1,2]
Default value: -1
The “never-default”
property
“never-default” gboolean
Flags: Read / Write / Construct
Default value: FALSE
The “route-metric”
property
“route-metric” gint64
Flags: Read / Write / Construct
Allowed values: [-1,4294967295]
Default value: -1
Since 1.0