the route metric that is used for routes that don't explicitly
specify a metric. See “route-metric” for more details.
-
@@ -3182,14 +3126,16 @@ addressing to complete for the connection to succeed.
The “addresses” property
“addresses” GPtrArray *
-
+
Array of IP addresses.
+
Element-Type: NMIPAddress
Flags: Read / Write
The “dhcp-hostname” property
“dhcp-hostname” gchar *
-
+
If the “dhcp-send-hostname” property is TRUE, then the
+specified name will be sent to the DHCP server when acquiring a lease.
Flags: Read / Write
Default value: NULL
@@ -3197,7 +3143,11 @@ addressing to complete for the connection to succeed.
The “dhcp-send-hostname” property
“dhcp-send-hostname” gboolean
-
+
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 NULL and this property is
+TRUE, the current persistent hostname of the computer is sent.
Flags: Read / Write / Construct
Default value: TRUE
@@ -3205,21 +3155,22 @@ addressing to complete for the connection to succeed.
The “dns” property
“dns” GStrv
-
+
Array of IP addresses of DNS servers.
Flags: Read / Write
The “dns-search” property
“dns-search” GStrv
-
+
Array of DNS search domains.
Flags: Read / Write
The “gateway” property
“gateway” gchar *
-
+
The gateway associated with this configuration. This is only meaningful
+if “addresses” is also set.
Flags: Read / Write
Default value: NULL
@@ -3227,7 +3178,11 @@ addressing to complete for the connection to succeed.
The “ignore-auto-dns” property
“ignore-auto-dns” gboolean
-
+
When “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.
Flags: Read / Write / Construct
Default value: FALSE
@@ -3235,7 +3190,9 @@ addressing to complete for the connection to succeed.
The “ignore-auto-routes” property
“ignore-auto-routes” gboolean
-
+
When “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.
Flags: Read / Write / Construct
Default value: FALSE
@@ -3243,7 +3200,13 @@ addressing to complete for the connection to succeed.
The “may-fail” property
“may-fail” gboolean
-
+
If TRUE, allow overall network configuration to proceed even if the
+configuration specified by this property 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 on the NMSettingIP4Config allows the overall network configuration
+to succeed if IPv4 configuration fails but IPv6 configuration completes
+successfully.
Flags: Read / Write / Construct
Default value: TRUE
@@ -3251,7 +3214,17 @@ addressing to complete for the connection to succeed.
The “method” property
“method” gchar *
-
+
IP configuration method.
+
NMSettingIP4Config and NMSettingIP6Config both support "auto",
+"manual", and "link-local". See the subclass-specific documentation for
+other values.
+
In general, for the "auto" method, properties such as
+“dns” and “routes” specify information
+that is added on to the information returned from automatic
+configuration. The “ignore-auto-routes” and
+“ignore-auto-dns” properties modify this behavior.
+
For methods that imply no upstream network, such as "shared" or
+"link-local", these properties must be empty.
Flags: Read / Write
Default value: NULL
@@ -3259,7 +3232,9 @@ addressing to complete for the connection to succeed.
The “never-default” property
“never-default” gboolean
-
+
If TRUE, this connection will never be the default connection for this
+IP type, meaning it will never be assigned the default route by
+NetworkManager.
Flags: Read / Write / Construct
Default value: FALSE
@@ -3267,7 +3242,16 @@ addressing to complete for the connection to succeed.
The “route-metric” property
“route-metric” gint64
-
+
The default metric for routes that don't explicitly specify a metric.
+The default value -1 means that the metric is choosen automatically
+based on the device type.
+The metric applies to dynamic routes, manual (static) routes that
+don't have an explicit metric setting, address prefix routes, and
+the default route.
+Note that for IPv6, the kernel accepts zero (0) but coerces it to
+1024 (user default). Hence, setting this property to zero effectively
+mean setting it to 1024.
+For IPv4, zero is a regular value for the metric.
Flags: Read / Write / Construct
Allowed values: [-1,4294967295]
Default value: -1
@@ -3276,7 +3260,8 @@ addressing to complete for the connection to succeed.
The “routes” property
“routes” GPtrArray *
-
+
Array of IP routes.
+
Element-Type: NMIPRoute
Flags: Read / Write
@@ -3286,7 +3271,6 @@ addressing to complete for the connection to succeed.
+