From 9a6dcbf895f9da01768e64b73cec88c16157d91e Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Tue, 26 Mar 2019 23:25:23 +0100 Subject: New upstream version 1.16.0 --- docs/libnm/Makefile.in | 1 + docs/libnm/html/NMAccessPoint.html | 4 +- docs/libnm/html/NMActiveConnection.html | 38 +- docs/libnm/html/NMCheckpoint.html | 2 +- docs/libnm/html/NMClient.html | 189 +- docs/libnm/html/NMConnection.html | 10 +- docs/libnm/html/NMDevice.html | 104 +- docs/libnm/html/NMDeviceVxlan.html | 6 +- docs/libnm/html/NMDeviceWifi.html | 8 +- docs/libnm/html/NMDeviceWifiP2P.html | 427 +++ docs/libnm/html/NMObject.html | 1 + docs/libnm/html/NMSetting.html | 19 +- docs/libnm/html/NMSetting8021x.html | 12 +- docs/libnm/html/NMSettingConnection.html | 6 +- docs/libnm/html/NMSettingGsm.html | 98 +- docs/libnm/html/NMSettingIPConfig.html | 5 +- docs/libnm/html/NMSettingOvsPort.html | 4 +- docs/libnm/html/NMSettingPpp.html | 8 +- docs/libnm/html/NMSettingPppoe.html | 8 +- docs/libnm/html/NMSettingProxy.html | 4 +- docs/libnm/html/NMSettingTeam.html | 119 +- docs/libnm/html/NMSettingTeamPort.html | 2 +- docs/libnm/html/NMSettingVpn.html | 8 +- docs/libnm/html/NMSettingVxlan.html | 4 +- docs/libnm/html/NMSettingWifiP2P.html | 233 ++ docs/libnm/html/NMSettingWimax.html | 4 +- docs/libnm/html/NMSettingWireGuard.html | 1743 ++++++++++ docs/libnm/html/NMSettingWired.html | 9 +- docs/libnm/html/NMSettingWireless.html | 12 +- docs/libnm/html/NMSettingWirelessSecurity.html | 30 +- docs/libnm/html/NMSettingWpan.html | 108 + docs/libnm/html/NMVpnEditorPlugin.html | 8 +- docs/libnm/html/NMWifiP2PPeer.html | 618 ++++ docs/libnm/html/NMWimaxNsp.html | 4 +- docs/libnm/html/api-index-full.html | 4112 ++++++++++++++---------- docs/libnm/html/ch03.html | 12 +- docs/libnm/html/ch04.html | 6 + docs/libnm/html/index.html | 20 +- docs/libnm/html/libnm-nm-dbus-interface.html | 312 +- docs/libnm/html/libnm-nm-errors.html | 7 + docs/libnm/html/libnm-nm-utils.html | 67 +- docs/libnm/html/libnm-nm-version.html | 32 + docs/libnm/html/libnm.devhelp2 | 230 +- docs/libnm/html/object-tree.html | 11 +- docs/libnm/html/ref-overview.html | 2 +- docs/libnm/html/usage.html | 2 +- docs/libnm/libnm-docs.xml | 8 +- docs/libnm/libnm-sections.txt | 234 +- docs/libnm/libnm.types | 5 + docs/libnm/meson.build | 10 +- docs/libnm/version.xml | 2 +- 51 files changed, 6750 insertions(+), 2178 deletions(-) create mode 100644 docs/libnm/html/NMDeviceWifiP2P.html create mode 100644 docs/libnm/html/NMSettingWifiP2P.html create mode 100644 docs/libnm/html/NMSettingWireGuard.html create mode 100644 docs/libnm/html/NMWifiP2PPeer.html (limited to 'docs/libnm') diff --git a/docs/libnm/Makefile.in b/docs/libnm/Makefile.in index eda49457..a3c2f6eb 100644 --- a/docs/libnm/Makefile.in +++ b/docs/libnm/Makefile.in @@ -161,6 +161,7 @@ DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ AMTAR = @AMTAR@ +AM_CFLAGS = @AM_CFLAGS@ AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AM_TESTS_FD_REDIRECT = @AM_TESTS_FD_REDIRECT@ AR = @AR@ diff --git a/docs/libnm/html/NMAccessPoint.html b/docs/libnm/html/NMAccessPoint.html index 22f76319..653501ad 100644 --- a/docs/libnm/html/NMAccessPoint.html +++ b/docs/libnm/html/NMAccessPoint.html @@ -7,7 +7,7 @@ - + @@ -23,7 +23,7 @@ Home Up Prev -Next +Next
diff --git a/docs/libnm/html/NMActiveConnection.html b/docs/libnm/html/NMActiveConnection.html index f13fe153..5689ae2f 100644 --- a/docs/libnm/html/NMActiveConnection.html +++ b/docs/libnm/html/NMActiveConnection.html @@ -1103,10 +1103,42 @@ nm_active_connection_get_vpn (

The “state-changed” signal

void
-user_function (NMActiveConnection *nmactiveconnection,
-               guint               arg1,
-               guint               arg2,
+user_function (NMActiveConnection *active_connection,
+               guint               state,
+               guint               reason,
                gpointer            user_data)
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +

active_connection

the source NMActiveConnection

 

state

the new state number (NMActiveConnectionState)

 

reason

the state change reason (NMActiveConnectionStateReason)

 

user_data

user data set when the signal handler was connected.

 
+

Flags: Run First

diff --git a/docs/libnm/html/NMCheckpoint.html b/docs/libnm/html/NMCheckpoint.html index 7d0ba4d3..dc70ac0c 100644 --- a/docs/libnm/html/NMCheckpoint.html +++ b/docs/libnm/html/NMCheckpoint.html @@ -154,7 +154,7 @@ comparing to this value.

nm_checkpoint_get_rollback_timeout ()

guint32
 nm_checkpoint_get_rollback_timeout (NMCheckpoint *checkpoint);
-

Gets the the timeout in seconds for automatic rollback.

+

Gets the timeout in seconds for automatic rollback.

Parameters

diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 7ccbd977..e6387588 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -430,6 +430,22 @@ + + + + + + + + + + + + + - +specific secret should be cleared or not. If NULL, all secrets are cleared.

+ @@ -1500,8 +1500,8 @@ nm_connection_get_settings (

out_length

-
- + +
+void + +nm_client_add_and_activate_connection2 () +
+NMActiveConnection * + +nm_client_add_and_activate_connection2_finish () +
gboolean @@ -2770,6 +2786,161 @@ will be set.


+

nm_client_add_and_activate_connection2 ()

+
void
+nm_client_add_and_activate_connection2
+                               (NMClient *client,
+                                NMConnection *partial,
+                                NMDevice *device,
+                                const char *specific_object,
+                                GVariant *options,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
+

Adds a new connection using the given details (if any) as a template, +automatically filling in missing settings with the capabilities of the given +device and specific object. The new connection is then asynchronously +activated as with nm_client_activate_connection_async(). Cannot be used for +VPN connections at this time.

+

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

+

This is identitcal to nm_client_add_and_activate_connection_async() but takes +a further options + parameter. Currently the following options are supported +by the daemon:

+
    +
  • "persist": A string describing how the connection should be stored. + The default is "disk", but it can be modified to "memory" (until + the daemon quits) or "volatile" (will be deleted on disconnect).

  • +
  • "bind-activation": Bind the connection lifetime to something. The default is "none", + meaning an explicit disconnect is needed. The value "dbus-client" + means the connection will automatically be deactivated when the calling + DBus client disappears from the system bus.

  • +
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

client

a NMClient

 

partial

an NMConnection to add; the connection may be +partially filled (or even NULL) and will be completed by NetworkManager +using the given device +and specific_object +before being added.

[allow-none]

device

the NMDevice

 

specific_object

the object path of a connection-type-specific +object this activation should use. This parameter is currently ignored for +wired and mobile broadband connections, and the value of NULL should be used +(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object +path of a NMAccessPoint or NMWimaxNsp owned by device +, which you can +get using nm_object_get_path(), and which will be used to complete the +details of the newly added connection.

[allow-none]

options

a GVariant containing a dictionary with options, or NULL

 

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the activation has started

 

user_data

caller-specific data passed to callback +

 
+
+

Since: 1.16

+
+
+
+

nm_client_add_and_activate_connection2_finish ()

+
NMActiveConnection *
+nm_client_add_and_activate_connection2_finish
+                               (NMClient *client,
+                                GAsyncResult *result,
+                                GVariant **out_result,
+                                GError **error);
+

Gets the result of a call to nm_client_add_and_activate_connection2().

+

You can call nm_active_connection_get_connection() on the returned +NMActiveConnection to find the path of the created NMConnection.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +

client

an NMClient

 

result

the result passed to the GAsyncReadyCallback

 

error

location for a GError, or NULL

 

out_result

the output result +of type "a{sv}" returned by D-Bus' AddAndActivate2 call. Currently no +output is implemented yet.

[allow-none][transfer full]
+
+
+

Returns

+

the new NMActiveConnection on success, NULL on +failure, in which case error +will be set.

+

[transfer full]

+
+
+
+

nm_client_deactivate_connection ()

gboolean
 nm_client_deactivate_connection (NMClient *client,
@@ -4339,6 +4510,13 @@ clients can obtain to perform certain tasks on behalf of the current user.

 

NM_CLIENT_PERMISSION_WIFI_SCAN

+

controls whether wifi scans can be performed

+
 

NM_CLIENT_PERMISSION_LAST

a reserved boundary value

@@ -4541,14 +4719,9 @@ permission to read the details of.)

The “dns-configuration” property

  “dns-configuration”        GPtrArray *
-

The current DNS configuration represented as an array of -dictionaries. Each dictionary has the "nameservers", -"priority" keys and, optionally, "interface" and "vpn". -"nameservers" is the list of DNS servers, "priority" their -relative priority, "interface" the interface on which these -servers are contacted, "vpn" a boolean telling whether the -configuration was obtained from a VPN connection.

-

[type GPtrArray(GVariant)]

+

The current DNS configuration, represented as an array +of NMDnsEntry objects.

+

[type GPtrArray(NMDnsEntry)]

Flags: Read

Since: 1.6

diff --git a/docs/libnm/html/NMConnection.html b/docs/libnm/html/NMConnection.html index 00d006d0..5421cf34 100644 --- a/docs/libnm/html/NMConnection.html +++ b/docs/libnm/html/NMConnection.html @@ -1239,8 +1239,8 @@ nm_connection_clear_secrets_with_flags

func

function to be called to determine whether a -specific secret should be cleared or not.

[scope call][scope call][allow-none]

user_data

(out): the length of the returned array.

[allow-none]

the length of the returned array.

[allow-none][out]
@@ -2781,7 +2781,7 @@ nm_connection_get_setting_vxlan (

GTypeInterface parent;

-

the parent interace struct

+

the parent interface struct

  diff --git a/docs/libnm/html/NMDevice.html b/docs/libnm/html/NMDevice.html index be147615..6f9f1ae6 100644 --- a/docs/libnm/html/NMDevice.html +++ b/docs/libnm/html/NMDevice.html @@ -197,6 +197,14 @@ +NMConnectivityState + + +nm_device_get_connectivity () + + + + NMDeviceState @@ -578,12 +586,22 @@ Read +NMConnectivityState +ip4-connectivity +Read + + NMIPConfig * ip6-config Read +NMConnectivityState +ip6-connectivity +Read + + GPtrArray * lldp-neighbors @@ -783,6 +801,14 @@ NM_DEVICE_LLDP_NEIGHBORS +#define +NM_DEVICE_IP4_CONNECTIVITY + + +#define +NM_DEVICE_IP6_CONNECTIVITY + +   NMDevice @@ -819,6 +845,7 @@ ├── NMDeviceVlan ├── NMDeviceVxlan ├── NMDeviceWifi + ├── NMDeviceWifiP2P ├── NMDeviceWimax ├── NMDeviceWireGuard ╰── NMDeviceWpan @@ -1396,6 +1423,43 @@ not activated or not using DHCPv6.


+

nm_device_get_connectivity ()

+
NMConnectivityState
+nm_device_get_connectivity (NMDevice *device,
+                            int addr_family);
+

The connectivity state of the device for given address family. +Supported address families are AF_INET for IPv4, AF_INET6 +for IPv6 or AF_UNSPEC for any.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

device

a NMDevice

 

addr_family

network address family

 
+
+
+

Returns

+

the current connectivity state

+
+

Since: 1.16

+
+
+

nm_device_get_state ()

NMDeviceState
 nm_device_get_state (NMDevice *device);
@@ -2004,9 +2068,9 @@ nm_device_get_applied_connection (

version_id

-

(allow-none): returns the current version id of +

returns the current version id of the applied connection.

-[out] +[out][allow-none]

cancellable

@@ -2113,9 +2177,9 @@ nm_device_get_applied_connection_finish

version_id

-

(allow-none): the current version id of the applied +

the current version id of the applied connection.

-[out] +[out][allow-none]

error

@@ -2313,7 +2377,7 @@ nm_device_delete_async (
GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); -

Asynchronously begins deleteing the software device. Hardware devices can't +

Asynchronously begins deleting the software device. Hardware devices can't be deleted.

Parameters

@@ -2943,6 +3007,18 @@ nm_lldp_neighbor_get_attr_type (
+

NM_DEVICE_IP4_CONNECTIVITY

+
#define NM_DEVICE_IP4_CONNECTIVITY "ip4-connectivity"
+
+
+
+
+

NM_DEVICE_IP6_CONNECTIVITY

+
#define NM_DEVICE_IP6_CONNECTIVITY "ip6-connectivity"
+
+
+
+

NMDevice

typedef struct _NMDevice NMDevice;
@@ -3059,6 +3135,15 @@ operations like addressing and routing.


+

The “ip4-connectivity” property

+
  “ip4-connectivity”         NMConnectivityState
+

The IPv4 connectivity state of the device.

+

Flags: Read

+

Default value: NM_CONNECTIVITY_UNKNOWN

+

Since: 1.16

+
+
+

The “ip6-config” property

  “ip6-config”               NMIPConfig *

The IPv6 NMIPConfig of the device.

@@ -3066,6 +3151,15 @@ operations like addressing and routing.


+

The “ip6-connectivity” property

+
  “ip6-connectivity”         NMConnectivityState
+

The IPv6 connectivity state of the device.

+

Flags: Read

+

Default value: NM_CONNECTIVITY_UNKNOWN

+

Since: 1.16

+
+
+

The “lldp-neighbors” property

  “lldp-neighbors”           GPtrArray *

The LLDP neighbors.

diff --git a/docs/libnm/html/NMDeviceVxlan.html b/docs/libnm/html/NMDeviceVxlan.html index 8b36a0e8..d672aa33 100644 --- a/docs/libnm/html/NMDeviceVxlan.html +++ b/docs/libnm/html/NMDeviceVxlan.html @@ -7,7 +7,7 @@ - + @@ -23,7 +23,7 @@ Home Up Prev -Next +Next
@@ -867,7 +867,7 @@ nm_device_vxlan_get_l3miss (

Returns

-

wether netlink IP ADDR miss notifications are generated

+

whether netlink IP ADDR miss notifications are generated

Since: 1.2

diff --git a/docs/libnm/html/NMDeviceWifi.html b/docs/libnm/html/NMDeviceWifi.html index 863bd4ad..352768d3 100644 --- a/docs/libnm/html/NMDeviceWifi.html +++ b/docs/libnm/html/NMDeviceWifi.html @@ -6,7 +6,7 @@ - + @@ -23,7 +23,7 @@ Home Up -Prev +Prev Next
@@ -615,7 +615,7 @@ This is the same as nm_device_wifi_request_scanoptions for the scanning. The argument is the dictionary passed to RequestScan() -D-Bus call. Valid otions inside the dictionary are: +D-Bus call. Valid options inside the dictionary are: 'ssids' => array of SSIDs (saay)

Parameters

@@ -723,7 +723,7 @@ This is the same as nm_device_wifi_request_scan_asyn except it accepts options for the scanning. The argument is the dictionary passed to RequestScan() -D-Bus call. Valid otions inside the dictionary are: +D-Bus call. Valid options inside the dictionary are: 'ssids' => array of SSIDs (saay)

Parameters

diff --git a/docs/libnm/html/NMDeviceWifiP2P.html b/docs/libnm/html/NMDeviceWifiP2P.html new file mode 100644 index 00000000..29d675a9 --- /dev/null +++ b/docs/libnm/html/NMDeviceWifiP2P.html @@ -0,0 +1,427 @@ + + + + +NMDeviceWifiP2P: libnm Reference Manual + + + + + + + + + + + + + + + + +
+
+
+ + +
+

NMDeviceWifiP2P

+

NMDeviceWifiP2P

+
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
const char * + +nm_device_wifi_p2p_get_hw_address () +
+NMWifiP2PPeer * + +nm_device_wifi_p2p_get_peer_by_path () +
const GPtrArray * + +nm_device_wifi_p2p_get_peers () +
+void + +nm_device_wifi_p2p_start_find () +
+gboolean + +nm_device_wifi_p2p_start_find_finish () +
+void + +nm_device_wifi_p2p_stop_find () +
+gboolean + +nm_device_wifi_p2p_stop_find_finish () +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_DEVICE_WIFI_P2P_HW_ADDRESS
#defineNM_DEVICE_WIFI_P2P_PEERS
#defineNM_DEVICE_WIFI_P2P_WFDIES
+
+
+

Description

+
+
+

Functions

+
+

nm_device_wifi_p2p_get_hw_address ()

+
const char *
+nm_device_wifi_p2p_get_hw_address (NMDeviceWifiP2P *device);
+

Gets the actual hardware (MAC) address of the NMDeviceWifiP2P

+
+

Parameters

+
+++++ + + + + + +

device

a NMDeviceWifiP2P

 
+
+
+

Returns

+

the actual hardware address. This is the internal string used by the +device, and must not be modified.

+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_get_peer_by_path ()

+
NMWifiP2PPeer *
+nm_device_wifi_p2p_get_peer_by_path (NMDeviceWifiP2P *device,
+                                     const char *path);
+

Gets a NMWifiP2PPeer by path.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

device

a NMDeviceWifiP2P

 

path

the object path of the peer

 
+
+
+

Returns

+

the peer or NULL if none is found.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_get_peers ()

+
const GPtrArray *
+nm_device_wifi_p2p_get_peers (NMDeviceWifiP2P *device);
+

Gets all the found peers of the NMDeviceWifiP2P.

+
+

Parameters

+
+++++ + + + + + +

device

a NMDeviceWifiP2P

 
+
+
+

Returns

+

a GPtrArray containing all the +found NMWifiP2PPeers. +The returned array is owned by the client and should not be modified.

+

[element-type NMWifiP2PPeer]

+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_start_find ()

+
void
+nm_device_wifi_p2p_start_find (NMDeviceWifiP2P *device,
+                               GVariant *options,
+                               GCancellable *cancellable,
+                               GAsyncReadyCallback callback,
+                               gpointer user_data);
+

Request NM to search for Wi-Fi P2P peers on device +. Note that the call +returns immediately after requesting the find, and it may take some time +after that for peers to be found.

+

The find operation will run for 30s by default. You can stop it earlier +using nm_device_p2p_wifi_stop_find().

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device

a NMDeviceWifiP2P

 

options

optional options passed to StartFind.

[allow-none]

cancellable

a GCancellable, or NULL

 

callback

a GAsyncReadyCallback, or NULL

 

user_data

user_data for callback +

 
+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_start_find_finish ()

+
gboolean
+nm_device_wifi_p2p_start_find_finish (NMDeviceWifiP2P *device,
+                                      GAsyncResult *result,
+                                      GError **error);
+

Finish an operation started by nm_device_wifi_p2p_start_find().

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

device

a NMDeviceWifiP2P

 

result

the GAsyncResult

 

error

GError return address

 
+
+
+

Returns

+

TRUE if the call was successful

+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_stop_find ()

+
void
+nm_device_wifi_p2p_stop_find (NMDeviceWifiP2P *device,
+                              GCancellable *cancellable,
+                              GAsyncReadyCallback callback,
+                              gpointer user_data);
+

Request NM to stop any ongoing find operation for Wi-Fi P2P peers on device +.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +

device

a NMDeviceWifiP2P

 

cancellable

a GCancellable, or NULL

 

callback

a GAsyncReadyCallback, or NULL

 

user_data

user_data for callback +

 
+
+

Since: 1.16

+
+
+
+

nm_device_wifi_p2p_stop_find_finish ()

+
gboolean
+nm_device_wifi_p2p_stop_find_finish (NMDeviceWifiP2P *device,
+                                     GAsyncResult *result,
+                                     GError **error);
+

Finish an operation started by nm_device_wifi_p2p_stop_find().

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

device

a NMDeviceWifiP2P

 

result

the GAsyncResult

 

error

GError return address

 
+
+
+

Returns

+

TRUE if the call was successful

+
+

Since: 1.16

+
+
+
+

Types and Values

+
+

NM_DEVICE_WIFI_P2P_HW_ADDRESS

+
#define NM_DEVICE_WIFI_P2P_HW_ADDRESS          "hw-address"
+
+
+
+
+

NM_DEVICE_WIFI_P2P_PEERS

+
#define NM_DEVICE_WIFI_P2P_PEERS               "peers"
+
+
+
+
+

NM_DEVICE_WIFI_P2P_WFDIES

+
#define NM_DEVICE_WIFI_P2P_WFDIES              "wfdies"
+
+
+
+
+ + + \ No newline at end of file diff --git a/docs/libnm/html/NMObject.html b/docs/libnm/html/NMObject.html index dacf1197..02e9e9da 100644 --- a/docs/libnm/html/NMObject.html +++ b/docs/libnm/html/NMObject.html @@ -124,6 +124,7 @@ ├── NMDhcpConfig ├── NMIPConfig ├── NMRemoteConnection + ├── NMWifiP2PPeer ╰── NMWimaxNsp
diff --git a/docs/libnm/html/NMSetting.html b/docs/libnm/html/NMSetting.html index 2340e37b..aaafa2c1 100644 --- a/docs/libnm/html/NMSetting.html +++ b/docs/libnm/html/NMSetting.html @@ -59,6 +59,14 @@ +gboolean + + +(*_NMConnectionForEachSecretFunc) () + + + + GType @@ -265,8 +273,10 @@ ├── NMSettingVlan ├── NMSettingVpn ├── NMSettingVxlan + ├── NMSettingWifiP2P ├── NMSettingWimax ├── NMSettingWired + ├── NMSettingWireGuard ├── NMSettingWireless ├── NMSettingWirelessSecurity ╰── NMSettingWpan @@ -377,6 +387,13 @@ of properties and allowed values.


+

_NMConnectionForEachSecretFunc ()

+
gboolean
+(*_NMConnectionForEachSecretFunc) (NMSettingSecretFlags flags,
+                                   gpointer user_data);
+
+
+

nm_setting_lookup_type ()

GType
 nm_setting_lookup_type (const char *name);
@@ -932,7 +949,7 @@ should be requested from the user each time it is needed

in situations where it cannot be automatically determined that the secret is required (some VPNs and PPP -providers dont require all secrets) this flag indicates that the specific +providers don't require all secrets) this flag indicates that the specific secret is not required

  diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index 21ac1234..d950232c 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -1182,10 +1182,9 @@

Object Hierarchy

    GEnum
+    ├── NMSetting8021xAuthFlags
     ├── NMSetting8021xCKFormat
     ╰── NMSetting8021xCKScheme
-    GFlags
-    ╰── NMSetting8021xAuthFlags
     GObject
     ╰── NMSetting
         ╰── NMSetting8021x
@@ -1255,8 +1254,8 @@ the blob must be not UNKNOWN (or NULL).

error

-

(out): validation reason.

-[allow-none] +

validation reason.

+[allow-none][out]
@@ -4210,11 +4209,6 @@ should be used.

  -

_NM_SETTING_802_1X_AUTH_FLAGS_LAST

-  -  - -

NM_SETTING_802_1X_AUTH_FLAGS_ALL

All supported flags

diff --git a/docs/libnm/html/NMSettingConnection.html b/docs/libnm/html/NMSettingConnection.html index 3eba2674..6d1aa6b3 100644 --- a/docs/libnm/html/NMSettingConnection.html +++ b/docs/libnm/html/NMSettingConnection.html @@ -972,7 +972,7 @@ of this setting.

out_pitem

-

on return, the permission item (formatted accoring to ptype +

on return, the permission item (formatted according to ptype , see “permissions” for more detail

  @@ -1374,7 +1374,7 @@ nm_setting_connection_get_secondary (gboolean nm_setting_connection_add_secondary (NMSettingConnection *setting, const char *sec_uuid); -

Adds a new secondary connetion UUID to the setting.

+

Adds a new secondary connection UUID to the setting.

Parameters

@@ -2217,7 +2217,7 @@ name is included, so that different interfaces yield different addresses.

at runtime. Currently supported are "${CONNECTION}", "${DEVICE}", "${MAC}", "${BOOT}", "${RANDOM}". These effectively create unique IDs per-connection, per-device, per-boot, -or every time. Note that "${DEVICE}" corresponds the the interface name of the +or every time. Note that "${DEVICE}" corresponds to the interface name of the device and "${MAC}" is the permanent MAC address of the device. Any unrecognized patterns following '$' are treated verbatim, however are reserved for future use. You are thus advised to avoid '$' or diff --git a/docs/libnm/html/NMSettingGsm.html b/docs/libnm/html/NMSettingGsm.html index c7ce6adf..9cf1103c 100644 --- a/docs/libnm/html/NMSettingGsm.html +++ b/docs/libnm/html/NMSettingGsm.html @@ -53,13 +53,6 @@ - - - - @@ -129,6 +122,13 @@ + + + + @@ -247,10 +247,6 @@ - - - - @@ -298,6 +294,10 @@ + + + + @@ -331,31 +331,6 @@ nm_setting_gsm_new (void
-

nm_setting_gsm_get_number ()

-
const char *
-nm_setting_gsm_get_number (NMSettingGsm *setting);
-
-

Parameters

-
const char * -nm_setting_gsm_get_number () -
const char * - nm_setting_gsm_get_username ()
const char * + +nm_setting_gsm_get_number () +
NMSettingSecretFlags
#defineNM_SETTING_GSM_NUMBER
#define NM_SETTING_GSM_USERNAME
NM_SETTING_GSM_MTU
#defineNM_SETTING_GSM_NUMBER
  NMSettingGsm
----- - - - - - -

setting

the NMSettingGsm

 
-
-
-

Returns

-

the “number” property of the setting

-
-
-
-

nm_setting_gsm_get_username ()

const char *
 nm_setting_gsm_get_username (NMSettingGsm *setting);
@@ -610,6 +585,35 @@ nm_setting_gsm_get_mtu ( +

nm_setting_gsm_get_number ()

+
const char *
+nm_setting_gsm_get_number (NMSettingGsm *setting);
+
+

nm_setting_gsm_get_number has been deprecated since version 1.16 and should not be used in newly-written code.

+

user-provided values for this setting are no longer used.

+
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “number” property of the setting

+
+
+
+

nm_setting_gsm_get_pin_flags ()

NMSettingSecretFlags
 nm_setting_gsm_get_pin_flags (NMSettingGsm *setting);
@@ -668,12 +672,6 @@ nm_setting_gsm_get_password_flags (
-

NM_SETTING_GSM_NUMBER

-
#define NM_SETTING_GSM_NUMBER          "number"
-
-
-
-

NM_SETTING_GSM_USERNAME

#define NM_SETTING_GSM_USERNAME        "username"
 
@@ -746,6 +744,12 @@ nm_setting_gsm_get_password_flags (
+

NM_SETTING_GSM_NUMBER

+
#define NM_SETTING_GSM_NUMBER          "number"
+
+
+
+

NMSettingGsm

typedef struct _NMSettingGsm NMSettingGsm;

GSM-based Mobile Broadband Settings

@@ -812,10 +816,12 @@ roaming control of the device is not otherwise possible.

The “number” property

  “number”                   gchar *
-

Number to dial when establishing a PPP data session with the GSM-based -mobile broadband network. Many modems do not require PPP for connections -to the mobile network and thus this property should be left blank, which -allows NetworkManager to select the appropriate settings automatically.

+

Legacy setting that used to help establishing PPP data sessions for +GSM-based modems.

+
+

NMSettingGsm:number has been deprecated since version 1.16 and should not be used in newly-written code.

+

user-provided values for this setting are no longer used.

+

Flags: Read / Write

Default value: NULL

diff --git a/docs/libnm/html/NMSettingIPConfig.html b/docs/libnm/html/NMSettingIPConfig.html index 23fbdcbe..873cdb84 100644 --- a/docs/libnm/html/NMSettingIPConfig.html +++ b/docs/libnm/html/NMSettingIPConfig.html @@ -4220,8 +4220,9 @@ distinct from an empty list of properties.

  “dns-priority”             gint

DNS servers priority.

The relative priority for DNS servers specified by this setting. A lower -value is better (higher priority). Zero selects the default value, which -is 50 for VPNs and 100 for other connections.

+value is better (higher priority). Zero selects a globally configured +default value. If the latter is missing or zero too, it defaults to +50 for VPNs and 100 for other connections.

Note that the priority is to order DNS settings for multiple active connections. It does not disambiguate multiple DNS servers within the same connection profile.

diff --git a/docs/libnm/html/NMSettingOvsPort.html b/docs/libnm/html/NMSettingOvsPort.html index 1c5e81dc..5d326bb3 100644 --- a/docs/libnm/html/NMSettingOvsPort.html +++ b/docs/libnm/html/NMSettingOvsPort.html @@ -7,7 +7,7 @@ - + @@ -20,7 +20,7 @@ Home Up Prev -Next +Next
diff --git a/docs/libnm/html/NMSettingPpp.html b/docs/libnm/html/NMSettingPpp.html index be86468b..c73d0bd7 100644 --- a/docs/libnm/html/NMSettingPpp.html +++ b/docs/libnm/html/NMSettingPpp.html @@ -6,8 +6,8 @@ - - + + @@ -21,8 +21,8 @@ Home Up -Prev -Next +Prev +Next
diff --git a/docs/libnm/html/NMSettingPppoe.html b/docs/libnm/html/NMSettingPppoe.html index 61858a6d..34f95831 100644 --- a/docs/libnm/html/NMSettingPppoe.html +++ b/docs/libnm/html/NMSettingPppoe.html @@ -6,8 +6,8 @@ - - + + @@ -21,8 +21,8 @@ Home Up -Prev -Next +Prev +Next
diff --git a/docs/libnm/html/NMSettingProxy.html b/docs/libnm/html/NMSettingProxy.html index 2870c41e..c1d4dc0d 100644 --- a/docs/libnm/html/NMSettingProxy.html +++ b/docs/libnm/html/NMSettingProxy.html @@ -6,7 +6,7 @@ - + @@ -21,7 +21,7 @@ Home Up -Prev +Prev Next
diff --git a/docs/libnm/html/NMSettingTeam.html b/docs/libnm/html/NMSettingTeam.html index 1d4beb4a..02a1f409 100644 --- a/docs/libnm/html/NMSettingTeam.html +++ b/docs/libnm/html/NMSettingTeam.html @@ -67,6 +67,14 @@ +NMTeamLinkWatcher * + + +nm_team_link_watcher_new_arp_ping2 () + + + + void @@ -168,6 +176,14 @@ +int + + +nm_team_link_watcher_get_vlanid () + + + + NMSetting * @@ -837,6 +853,80 @@ address in the arp request


+

nm_team_link_watcher_new_arp_ping2 ()

+
NMTeamLinkWatcher *
+nm_team_link_watcher_new_arp_ping2 (int init_wait,
+                                    int interval,
+                                    int missed_max,
+                                    int vlanid,
+                                    const char *target_host,
+                                    const char *source_host,
+                                    NMTeamLinkWatcherArpPingFlags flags,
+                                    GError **error);
+

Creates a new arp_ping NMTeamLinkWatcher object

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

init_wait

init_wait value

 

interval

interval value

 

missed_max

missed_max value

 

vlanid

vlanid value

 

target_host

the host name or the ip address that will be used as destination +address in the arp request

 

source_host

the host name or the ip address that will be used as source +address in the arp request

 

flags

the watcher NMTeamLinkWatcherArpPingFlags

 

error

location to store the error on failure.

[out][allow-none]
+
+
+

Returns

+

the new NMTeamLinkWatcher object, or NULL on error.

+

[transfer full]

+
+

Since: 1.16

+
+
+

nm_team_link_watcher_ref ()

void
 nm_team_link_watcher_ref (NMTeamLinkWatcher *watcher);
@@ -978,7 +1068,7 @@ nm_team_link_watcher_get_name (int nm_team_link_watcher_get_delay_up (NMTeamLinkWatcher *watcher);

Gets the delay_up interval (in milliseconds) that elapses between the link -coming up and the runner beeing notified about it.

+coming up and the runner being notified about it.

Parameters

@@ -1002,7 +1092,7 @@ coming up and the runner beeing notified about it.

int
 nm_team_link_watcher_get_delay_down (NMTeamLinkWatcher *watcher);

Gets the delay_down interval (in milliseconds) that elapses between the link -going down and the runner beeing notified about it.

+going down and the runner being notified about it.

Parameters

@@ -1163,6 +1253,29 @@ nm_team_link_watcher_get_flags (
+

nm_team_link_watcher_get_vlanid ()

+
int
+nm_team_link_watcher_get_vlanid (NMTeamLinkWatcher *watcher);
+

Gets the VLAN tag ID to be used to outgoing link probes

+
+

Parameters

+
+++++ + + + + + +

watcher

the NMTeamLinkWatcher

 
+
+

Since: 1.16

+
+
+

nm_setting_team_new ()

NMSetting *
 nm_setting_team_new (void);
@@ -2225,7 +2338,7 @@ watcher. Available link watchers are 'ethtool', 'nsna_ping' and Available keys are: ethtool: 'delay-up', 'delay-down', 'init-wait'; nsna_ping: 'init-wait', 'interval', 'missed-max', 'target-host'; arp_ping: all the ones in nsna_ping and 'source-host', 'validate-active', -'validate-incative', 'send-always'. See teamd.conf man for more details.

+'validate-inactive', 'send-always'. See teamd.conf man for more details.

[type GPtrArray(NMTeamLinkWatcher)]

Flags: Read / Write

Since: 1.12

diff --git a/docs/libnm/html/NMSettingTeamPort.html b/docs/libnm/html/NMSettingTeamPort.html index e1cc4098..403a0373 100644 --- a/docs/libnm/html/NMSettingTeamPort.html +++ b/docs/libnm/html/NMSettingTeamPort.html @@ -732,7 +732,7 @@ watcher. Available link watchers are 'ethtool', 'nsna_ping' and Available keys are: ethtool: 'delay-up', 'delay-down', 'init-wait'; nsna_ping: 'init-wait', 'interval', 'missed-max', 'target-host'; arp_ping: all the ones in nsna_ping and 'source-host', 'validate-active', -'validate-incative', 'send-always'. See teamd.conf man for more details.

+'validate-inactive', 'send-always'. See teamd.conf man for more details.

[type GPtrArray(NMTeamLinkWatcher)]

Flags: Read / Write

Since: 1.12

diff --git a/docs/libnm/html/NMSettingVpn.html b/docs/libnm/html/NMSettingVpn.html index 52119bb7..f5b6b1c3 100644 --- a/docs/libnm/html/NMSettingVpn.html +++ b/docs/libnm/html/NMSettingVpn.html @@ -617,8 +617,8 @@ nm_setting_vpn_get_data_keys (

out_length

-

(out): the length of the returned array.

-[allow-none] +

the length of the returned array.

+[allow-none][out]
@@ -834,8 +834,8 @@ nm_setting_vpn_get_secret_keys (

out_length

-

(out): the length of the returned array.

-[allow-none] +

the length of the returned array.

+[allow-none][out]
diff --git a/docs/libnm/html/NMSettingVxlan.html b/docs/libnm/html/NMSettingVxlan.html index 4634af0a..f0606610 100644 --- a/docs/libnm/html/NMSettingVxlan.html +++ b/docs/libnm/html/NMSettingVxlan.html @@ -7,7 +7,7 @@ - + @@ -22,7 +22,7 @@ Home Up Prev -Next +Next
diff --git a/docs/libnm/html/NMSettingWifiP2P.html b/docs/libnm/html/NMSettingWifiP2P.html new file mode 100644 index 00000000..b7cf9125 --- /dev/null +++ b/docs/libnm/html/NMSettingWifiP2P.html @@ -0,0 +1,233 @@ + + + + +NMSettingWifiP2P: libnm Reference Manual + + + + + + + + + + + + + + + + +
+
+
+ + +
+

NMSettingWifiP2P

+

NMSettingWifiP2P — Describes connection properties for 802.11 Wi-Fi P2P networks

+
+
+

Functions

+ +
+
+

Types and Values

+ +
+
+

Description

+

The NMSettingWifiP2P object is a NMSetting subclass that describes properties +necessary for connection to 802.11 Wi-Fi P2P networks (aka Wi-Fi Direct).

+
+
+

Functions

+
+

nm_setting_wifi_p2p_new ()

+
NMSetting *
+nm_setting_wifi_p2p_new (void);
+

Creates a new NMSettingWifiP2P object with default values.

+
+

Returns

+

the new empty NMSettingWifiP2P object.

+

[transfer full]

+
+

Since: 1.16

+
+
+
+

nm_setting_wifi_p2p_get_peer ()

+
const char *
+nm_setting_wifi_p2p_get_peer (NMSettingWifiP2P *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWifiP2P

 
+
+
+

Returns

+

the “peer” property of the setting

+
+

Since: 1.16

+
+
+
+

nm_setting_wifi_p2p_get_wps_method ()

+
NMSettingWirelessSecurityWpsMethod
+nm_setting_wifi_p2p_get_wps_method (NMSettingWifiP2P *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWifiP2P

 
+
+
+

Returns

+

the “wps-method” property of the setting

+
+

Since: 1.16

+
+
+
+

nm_setting_wifi_p2p_get_wfd_ies ()

+
GBytes *
+nm_setting_wifi_p2p_get_wfd_ies (NMSettingWifiP2P *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWiFiP2P

 
+
+
+

Returns

+

the “wfd-ies” property of the setting.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

Types and Values

+
+

NM_SETTING_WIFI_P2P_SETTING_NAME

+
#define NM_SETTING_WIFI_P2P_SETTING_NAME "wifi-p2p"
+
+
+
+
+

NM_SETTING_WIFI_P2P_PEER

+
#define NM_SETTING_WIFI_P2P_PEER        "peer"
+
+

The mac address of the peer to connect to.

+
+
+
+

NM_SETTING_WIFI_P2P_WPS_METHOD

+
#define NM_SETTING_WIFI_P2P_WPS_METHOD  "wps-method"
+
+
+
+
+

NM_SETTING_WIFI_P2P_WFD_IES

+
#define NM_SETTING_WIFI_P2P_WFD_IES     "wfd-ies"
+
+
+
+
+ + + \ No newline at end of file diff --git a/docs/libnm/html/NMSettingWimax.html b/docs/libnm/html/NMSettingWimax.html index 519d0a9c..d52a4119 100644 --- a/docs/libnm/html/NMSettingWimax.html +++ b/docs/libnm/html/NMSettingWimax.html @@ -6,7 +6,7 @@ - + @@ -21,7 +21,7 @@ Home Up -Prev +Prev Next
diff --git a/docs/libnm/html/NMSettingWireGuard.html b/docs/libnm/html/NMSettingWireGuard.html new file mode 100644 index 00000000..3efa9ed5 --- /dev/null +++ b/docs/libnm/html/NMSettingWireGuard.html @@ -0,0 +1,1743 @@ + + + + +NMSettingWireGuard: libnm Reference Manual + + + + + + + + + + + + + + + + +
+
+
+ + +
+

NMSettingWireGuard

+

NMSettingWireGuard — Describes connection properties for wireguard related options

+
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMWireGuardPeer * + +nm_wireguard_peer_new () +
+NMWireGuardPeer * + +nm_wireguard_peer_new_clone () +
+NMWireGuardPeer * + +nm_wireguard_peer_ref () +
+void + +nm_wireguard_peer_unref () +
+void + +nm_wireguard_peer_seal () +
+gboolean + +nm_wireguard_peer_is_sealed () +
const char * + +nm_wireguard_peer_get_public_key () +
+gboolean + +nm_wireguard_peer_set_public_key () +
const char * + +nm_wireguard_peer_get_preshared_key () +
+gboolean + +nm_wireguard_peer_set_preshared_key () +
+NMSettingSecretFlags + +nm_wireguard_peer_get_preshared_key_flags () +
+void + +nm_wireguard_peer_set_preshared_key_flags () +
+guint16 + +nm_wireguard_peer_get_persistent_keepalive () +
+void + +nm_wireguard_peer_set_persistent_keepalive () +
const char * + +nm_wireguard_peer_get_endpoint () +
+gboolean + +nm_wireguard_peer_set_endpoint () +
+guint + +nm_wireguard_peer_get_allowed_ips_len () +
const char * + +nm_wireguard_peer_get_allowed_ip () +
+void + +nm_wireguard_peer_clear_allowed_ips () +
+gboolean + +nm_wireguard_peer_append_allowed_ip () +
+gboolean + +nm_wireguard_peer_remove_allowed_ip () +
+gboolean + +nm_wireguard_peer_is_valid () +
+int + +nm_wireguard_peer_cmp () +
+NMSetting * + +nm_setting_wireguard_new () +
const char * + +nm_setting_wireguard_get_private_key () +
+NMSettingSecretFlags + +nm_setting_wireguard_get_private_key_flags () +
+guint16 + +nm_setting_wireguard_get_listen_port () +
+guint32 + +nm_setting_wireguard_get_fwmark () +
+guint + +nm_setting_wireguard_get_peers_len () +
+NMWireGuardPeer * + +nm_setting_wireguard_get_peer () +
+NMWireGuardPeer * + +nm_setting_wireguard_get_peer_by_public_key () +
+void + +nm_setting_wireguard_set_peer () +
+void + +nm_setting_wireguard_append_peer () +
+gboolean + +nm_setting_wireguard_remove_peer () +
+guint + +nm_setting_wireguard_clear_peers () +
+gboolean + +nm_setting_wireguard_get_peer_routes () +
+guint32 + +nm_setting_wireguard_get_mtu () +
+
+ +
+

Object Hierarchy

+
    GBoxed
+    ╰── NMWireGuardPeer
+
+
+
+

Description

+

The NMSettingWireGuard object is a NMSetting subclass that contains settings +for configuring WireGuard.

+
+
+

Functions

+
+

nm_wireguard_peer_new ()

+
NMWireGuardPeer *
+nm_wireguard_peer_new (void);
+
+

Returns

+

a new, default, unsealed NMWireGuardPeer instance.

+

[transfer full]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_new_clone ()

+
NMWireGuardPeer *
+nm_wireguard_peer_new_clone (const NMWireGuardPeer *self,
+                             gboolean with_secrets);
+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the NMWireGuardPeer instance to copy.

 

with_secrets

if TRUE, the preshared-key secrets are copied +as well. Otherwise, they will be removed.

 
+
+
+

Returns

+

a clone of self +. This instance +is always unsealed.

+

[transfer full]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_ref ()

+
NMWireGuardPeer *
+nm_wireguard_peer_ref (NMWireGuardPeer *self);
+

This is not thread-safe.

+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance.

[allow-none]
+
+
+

Returns

+

returns the input argument self +after incrementing +the reference count.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_unref ()

+
void
+nm_wireguard_peer_unref (NMWireGuardPeer *self);
+

Drop a reference to self +. If the last reference is dropped, +the instance is freed and all accociate data released.

+

This is not thread-safe.

+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance.

[allow-none]
+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_seal ()

+
void
+nm_wireguard_peer_seal (NMWireGuardPeer *self);
+

Seal the NMWireGuardPeer instance. Afterwards, it is a bug +to call all functions that modify the instance (except ref/unref). +A sealed instance cannot be unsealed again, but you can create +an unsealed copy with nm_wireguard_peer_new_clone().

+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_is_sealed ()

+
gboolean
+nm_wireguard_peer_is_sealed (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

whether self +is sealed or not.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_public_key ()

+
const char *
+nm_wireguard_peer_get_public_key (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

the public key or NULL if unset.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_set_public_key ()

+
gboolean
+nm_wireguard_peer_set_public_key (NMWireGuardPeer *self,
+                                  const char *public_key,
+                                  gboolean accept_invalid);
+

Reset the public key. Note that if the public key is valid, it +will be normalized (which may or may not modify the set value).

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

public_key

the new public +key or NULL to clear the public key.

[allow-none][transfer none]

accept_invalid

if TRUE and public_key +is not NULL and +invalid, then do not modify the instance.

 
+
+
+

Returns

+

TRUE if the key was valid or NULL. Returns +FALSE for invalid keys. Depending on accept_invalid +will an invalid key be set or not.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_preshared_key ()

+
const char *
+nm_wireguard_peer_get_preshared_key (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

the preshared key or NULL if unset.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_set_preshared_key ()

+
gboolean
+nm_wireguard_peer_set_preshared_key (NMWireGuardPeer *self,
+                                     const char *preshared_key,
+                                     gboolean accept_invalid);
+

Reset the preshared key. Note that if the preshared key is valid, it +will be normalized (which may or may not modify the set value).

+

Note that the preshared-key is a secret and consequently has corresponding +preshared-key-flags property. This is so that secrets can be optional +and requested on demand from a secret-agent. Also, an invalid preshared-key +may optionally cause nm_wireguard_peer_is_valid() to fail or it may +be accepted.

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

preshared_key

the new preshared +key or NULL to clear the preshared key.

[allow-none][transfer none]

accept_invalid

whether to allow setting the key to an invalid +value. If FALSE, self +is unchanged if the key is invalid +and if FALSE is returned.

 
+
+
+

Returns

+

TRUE if the preshared-key is valid, otherwise FALSE. +NULL is considered a valid value. +If the key is invalid, it depends on accept_invalid +whether the +previous value was reset.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_preshared_key_flags ()

+
NMSettingSecretFlags
+nm_wireguard_peer_get_preshared_key_flags
+                               (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

get the secret flags for the preshared-key.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_set_preshared_key_flags ()

+
void
+nm_wireguard_peer_set_preshared_key_flags
+                               (NMWireGuardPeer *self,
+                                NMSettingSecretFlags preshared_key_flags);
+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

preshared_key_flags

the secret flags to set.

 
+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_persistent_keepalive ()

+
guint16
+nm_wireguard_peer_get_persistent_keepalive
+                               (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

get the persistent-keepalive setting in seconds. Set to zero to disable +keep-alive.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_set_persistent_keepalive ()

+
void
+nm_wireguard_peer_set_persistent_keepalive
+                               (NMWireGuardPeer *self,
+                                guint16 persistent_keepalive);
+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

persistent_keepalive

the keep-alive value to set.

 
+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_endpoint ()

+
const char *
+nm_wireguard_peer_get_endpoint (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

the endpoint or NULL if none was set.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_set_endpoint ()

+
gboolean
+nm_wireguard_peer_set_endpoint (NMWireGuardPeer *self,
+                                const char *endpoint,
+                                gboolean allow_invalid);
+

Sets or clears the endpoint of self +.

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

endpoint

the socket address endpoint to set or NULL.

 

allow_invalid

if TRUE, also invalid values are set. +If FALSE, the function does nothing for invalid endpoint +arguments.

 
+
+
+

Returns

+

TRUE if the endpoint is NULL or valid. For an +invalid endpoint +argument, FALSE is returned. Depending +on allow_invalid +, the instance will be modified.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_allowed_ips_len ()

+
guint
+nm_wireguard_peer_get_allowed_ips_len (const NMWireGuardPeer *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMWireGuardPeer instance

 
+
+
+

Returns

+

the number of allowed-ips entries.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_get_allowed_ip ()

+
const char *
+nm_wireguard_peer_get_allowed_ip (const NMWireGuardPeer *self,
+                                  guint idx,
+                                  gboolean *out_is_valid);
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the NMWireGuardPeer instance

 

idx

the index from zero to (allowed-ips-len - 1) to +retrieve.

 

out_is_valid

TRUE if the returned value is a valid allowed-ip +setting.

[allow-none]
+
+
+

Returns

+

the allowed-ip setting at index idx +. +If idx +is out of range, NULL will be returned.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_clear_allowed_ips ()

+
void
+nm_wireguard_peer_clear_allowed_ips (NMWireGuardPeer *self);
+

Removes all allowed-ip entries.

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + +

self

the unsealed NMWireGuardPeer instance

 
+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_append_allowed_ip ()

+
gboolean
+nm_wireguard_peer_append_allowed_ip (NMWireGuardPeer *self,
+                                     const char *allowed_ip,
+                                     gboolean accept_invalid);
+

Appends allowed_ip + setting to the list. This does not check +for duplicates and always appends allowed_ip + to the end of the +list. If allowed_ip + is valid, it will be normalized and a modified +for might be appended. If allowed_ip + is invalid, it will still be +appended, but later verification will fail.

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

allowed_ip

the allowed-ip entry to set.

 

accept_invalid

if TRUE, also invalid allowed_ip +value +will be appended. Otherwise, the function does nothing +in face of invalid values and returns FALSE.

 
+
+
+

Returns

+

TRUE if the value is a valid allowed-ips value, FALSE otherwise. +Depending on accept_invalid +, also invalid values are added.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_remove_allowed_ip ()

+
gboolean
+nm_wireguard_peer_remove_allowed_ip (NMWireGuardPeer *self,
+                                     guint idx);
+

Removes the allowed-ip at the given idx +. This shifts all +following entries one index down.

+

It is a bug trying to modify a sealed NMWireGuardPeer instance.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the unsealed NMWireGuardPeer instance

 

idx

the index from zero to (allowed-ips-len - 1) to +retrieve. If the index is out of range, FALSE is returned +and nothing is done.

 
+
+
+

Returns

+

TRUE if idx +was valid and the allowed-ip was removed. +FALSE otherwise, and the peer will not be changed.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_is_valid ()

+
gboolean
+nm_wireguard_peer_is_valid (const NMWireGuardPeer *self,
+                            gboolean check_non_secrets,
+                            gboolean check_secrets,
+                            GError **error);
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +

self

the NMWireGuardPeer instance

 

check_secrets

if TRUE, non-secret properties are validated. +Otherwise they are ignored for this purpose.

 

check_non_secrets

if TRUE, secret properties are validated. +Otherwise they are ignored for this purpose.

 

error

the GError location for returning the failure reason.

 
+
+
+

Returns

+

TRUE if the peer is valid or fails with an error +reason.

+
+

Since: 1.16

+
+
+
+

nm_wireguard_peer_cmp ()

+
int
+nm_wireguard_peer_cmp (const NMWireGuardPeer *a,
+                       const NMWireGuardPeer *b,
+                       NMSettingCompareFlags compare_flags);
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

a

the NMWireGuardPeer to compare.

[allow-none]

b

the other NMWireGuardPeer to compare.

[allow-none]

compare_flags

NMSettingCompareFlags to affect the comparison.

 
+
+
+

Returns

+

zero of the two instances are equivalent or +a non-zero integer otherwise. This defines a total ordering +over the peers. Whether a peer is sealed or not, does not +affect the comparison.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_new ()

+
NMSetting *
+nm_setting_wireguard_new (void);
+

Creates a new NMSettingWireGuard object with default values.

+
+

Returns

+

the new empty NMSettingWireGuard object.

+

[transfer full]

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_private_key ()

+
const char *
+nm_setting_wireguard_get_private_key (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the set private-key or NULL.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_private_key_flags ()

+
NMSettingSecretFlags
+nm_setting_wireguard_get_private_key_flags
+                               (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the secret-flags for “private-key”.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_listen_port ()

+
guint16
+nm_setting_wireguard_get_listen_port (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the set UDP listen port.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_fwmark ()

+
guint32
+nm_setting_wireguard_get_fwmark (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the set firewall mark.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_peers_len ()

+
guint
+nm_setting_wireguard_get_peers_len (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the number of registered peers.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_peer ()

+
NMWireGuardPeer *
+nm_setting_wireguard_get_peer (NMSettingWireGuard *self,
+                               guint idx);
+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the NMSettingWireGuard instance

 

idx

the index to lookup.

 
+
+
+

Returns

+

the NMWireGuardPeer entry at +index idx +. If the index is out of range, NULL is returned.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_peer_by_public_key ()

+
NMWireGuardPeer *
+nm_setting_wireguard_get_peer_by_public_key
+                               (NMSettingWireGuard *self,
+                                const char *public_key,
+                                guint *out_idx);
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the NMSettingWireGuard instance

 

public_key

the public key for looking up the +peer.

 

out_idx

optional output argument +for the index of the found peer. If no index is found, +this is set to the nm_setting_wireguard_get_peers_len().

[out][allow-none]
+
+
+

Returns

+

the NMWireGuardPeer instance with a +matching public key. If no such peer exists, NULL is returned.

+

[transfer none]

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_set_peer ()

+
void
+nm_setting_wireguard_set_peer (NMSettingWireGuard *self,
+                               NMWireGuardPeer *peer,
+                               guint idx);
+

If idx + is one past the last peer, the behavior is the same +as nm_setting_wireguard_append_peer(). +Otherwise, the peer will be at idx + and replace the peer +instance at that index. Note that if a peer with the same +public-key exists on another index, then that peer will also +be replaced. In that case, the number of peers will shrink +by one (because the one at idx + got replace and then one +with the same public-key got removed). This also means, +that the resulting index afterwards may be one less than +idx + (if another peer with a lower index was dropped).

+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

self

the NMSettingWireGuard instance

 

peer

the NMWireGuardPeer instance to set. +This seals peer +and keeps a reference on the +instance.

 

idx

the index, in the range of 0 to the number of +peers (including). That means, if idx +is one past +the end of the number of peers, this is the same as +nm_setting_wireguard_append_peer(). Otherwise, the +peer at this index is replaced.

 
+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_append_peer ()

+
void
+nm_setting_wireguard_append_peer (NMSettingWireGuard *self,
+                                  NMWireGuardPeer *peer);
+

If a peer with the same public-key already exists, that +one is replaced by peer +. The new peer + is always appended +(or moved to) the end, so in case a peer is replaced, the +indexes are shifted and the number of peers stays unchanged.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the NMSettingWireGuard instance

 

peer

the NMWireGuardPeer instance to append. +This seals peer +and keeps a reference on the +instance.

 
+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_remove_peer ()

+
gboolean
+nm_setting_wireguard_remove_peer (NMSettingWireGuard *self,
+                                  guint idx);
+
+

Parameters

+
+++++ + + + + + + + + + + + + +

self

the NMSettingWireGuard instance

 

idx

the index to remove.

 
+
+
+

Returns

+

TRUE if idx +was in range and a peer +was removed. Otherwise, self +is unchanged.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_clear_peers ()

+
guint
+nm_setting_wireguard_clear_peers (NMSettingWireGuard *self);
+
+
+
+

nm_setting_wireguard_get_peer_routes ()

+
gboolean
+nm_setting_wireguard_get_peer_routes (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

whether automatically add peer routes.

+
+

Since: 1.16

+
+
+
+

nm_setting_wireguard_get_mtu ()

+
guint32
+nm_setting_wireguard_get_mtu (NMSettingWireGuard *self);
+
+

Parameters

+
+++++ + + + + + +

self

the NMSettingWireGuard instance

 
+
+
+

Returns

+

the MTU of the setting.

+
+

Since: 1.16

+
+
+
+

Types and Values

+
+

NM_WIREGUARD_PUBLIC_KEY_LEN

+
#define NM_WIREGUARD_PUBLIC_KEY_LEN     32
+
+
+
+
+

NM_WIREGUARD_SYMMETRIC_KEY_LEN

+
#define NM_WIREGUARD_SYMMETRIC_KEY_LEN  32
+
+
+
+
+

NM_SETTING_WIREGUARD_SETTING_NAME

+
#define NM_SETTING_WIREGUARD_SETTING_NAME "wireguard"
+
+
+
+
+

NM_SETTING_WIREGUARD_FWMARK

+
#define NM_SETTING_WIREGUARD_FWMARK            "fwmark"
+
+
+
+
+

NM_SETTING_WIREGUARD_LISTEN_PORT

+
#define NM_SETTING_WIREGUARD_LISTEN_PORT       "listen-port"
+
+
+
+
+

NM_SETTING_WIREGUARD_PRIVATE_KEY

+
#define NM_SETTING_WIREGUARD_PRIVATE_KEY       "private-key"
+
+
+
+
+

NM_SETTING_WIREGUARD_PRIVATE_KEY_FLAGS

+
#define NM_SETTING_WIREGUARD_PRIVATE_KEY_FLAGS "private-key-flags"
+
+
+
+
+

NM_SETTING_WIREGUARD_PEERS

+
#define NM_SETTING_WIREGUARD_PEERS             "peers"
+
+
+
+
+

NM_SETTING_WIREGUARD_MTU

+
#define NM_SETTING_WIREGUARD_MTU               "mtu"
+
+
+
+
+

NM_SETTING_WIREGUARD_PEER_ROUTES

+
#define NM_SETTING_WIREGUARD_PEER_ROUTES       "peer-routes"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_ALLOWED_IPS

+
#define NM_WIREGUARD_PEER_ATTR_ALLOWED_IPS          "allowed-ips"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_ENDPOINT

+
#define NM_WIREGUARD_PEER_ATTR_ENDPOINT             "endpoint"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_PERSISTENT_KEEPALIVE

+
#define NM_WIREGUARD_PEER_ATTR_PERSISTENT_KEEPALIVE "persistent-keepalive"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY

+
#define NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY        "preshared-key"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY_FLAGS

+
#define NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY_FLAGS  "preshared-key-flags"
+
+
+
+
+

NM_WIREGUARD_PEER_ATTR_PUBLIC_KEY

+
#define NM_WIREGUARD_PEER_ATTR_PUBLIC_KEY           "public-key"
+
+
+
+
+ + + \ No newline at end of file diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index 8850803b..fe475926 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -7,7 +7,7 @@ - + @@ -22,7 +22,7 @@ Home Up Prev -Next +Next
@@ -1273,11 +1273,6 @@ are supported by all devices.

  -

_NM_SETTING_WIRED_WAKE_ON_LAN_LAST_OPT

-  -  - -

NM_SETTING_WIRED_WAKE_ON_LAN_ALL

Wake on all events. This does not diff --git a/docs/libnm/html/NMSettingWireless.html b/docs/libnm/html/NMSettingWireless.html index 64488bdc..2f4a8f36 100644 --- a/docs/libnm/html/NMSettingWireless.html +++ b/docs/libnm/html/NMSettingWireless.html @@ -1324,7 +1324,7 @@ are supported by all devices.

NM_SETTING_WIRELESS_WAKE_ON_WLAN_4WAY_HANDSHAKE

-

Wake on 4way hanshake

+

Wake on 4way handshake

  @@ -1341,16 +1341,6 @@ are supported by all devices.

  -

_NM_SETTING_WIRELESS_WAKE_ON_WLAN_NUM

-  -  - - -

NM_SETTING_WIRELESS_WAKE_ON_WLAN_LAST

-  -  - -

NM_SETTING_WIRELESS_WAKE_ON_WLAN_ALL

Wake on all events. This does not diff --git a/docs/libnm/html/NMSettingWirelessSecurity.html b/docs/libnm/html/NMSettingWirelessSecurity.html index 515dabd0..90c77e7c 100644 --- a/docs/libnm/html/NMSettingWirelessSecurity.html +++ b/docs/libnm/html/NMSettingWirelessSecurity.html @@ -6,7 +6,7 @@ - + @@ -21,7 +21,7 @@ Home Up -Prev +Prev Next

@@ -549,8 +549,9 @@ use WEP, LEAP, WPA or WPA2/RSN security

    GEnum
     ├── NMSettingWirelessSecurityFils
     ├── NMSettingWirelessSecurityPmf
-    ├── NMSettingWirelessSecurityWpsMethod
     ╰── NMWepKeyType
+    GFlags
+    ╰── NMSettingWirelessSecurityWpsMethod
     GObject
     ╰── NMSetting
         ╰── NMSettingWirelessSecurity
@@ -970,7 +971,7 @@ algorithm list.

Returns

-

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

+

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


@@ -1552,9 +1553,9 @@ nm_setting_wireless_security_get_fils (

enum NMWepKeyType

The NMWepKeyType values specify how any WEP keys present in the setting -are intepreted. There are no standards governing how to hash the various WEP +are interpreted. There are no standards governing how to hash the various WEP key/passphrase formats into the actual WEP key. Unfortunately some WEP keys -can be interpreted in multiple ways, requring the setting to specify how to +can be interpreted in multiple ways, requiring the setting to specify how to interpret the any WEP keys. For example, the key "732f2d712e4a394a375d366931" is both a valid Hexadecimal WEP key and a WEP passphrase. Further, many ASCII keys are also valid WEP passphrases, but since passphrases and ASCII @@ -1666,6 +1667,8 @@ the actual WEP key using the MD5 hash algorithm.

enum NMSettingWirelessSecurityWpsMethod

Configure the use of WPS by a connection while it activates.

+

Note: prior to 1.16, this was a GEnum type instead of a GFlags type +although, with the same numeric values.

Members

@@ -1947,8 +1950,8 @@ list element may be one of "wep40", "wep104", "tkip", or "ccmp".

  “key-mgmt”                 gchar *

Key management used for the connection. One of "none" (WEP), "ieee8021x" (Dynamic WEP), "wpa-none" (Ad-Hoc WPA-PSK), "wpa-psk" (infrastructure -WPA-PSK), or "wpa-eap" (WPA-Enterprise). This property must be set for -any Wi-Fi connection that uses security.

+WPA-PSK), "sae" (SAE) or "wpa-eap" (WPA-Enterprise). +This property must be set for any Wi-Fi connection that uses security.

Flags: Read / Write

Default value: NULL

@@ -2017,12 +2020,11 @@ not specified, both WPA and RSN connections are allowed.

The “psk” property

  “psk”                      gchar *
-

Pre-Shared-Key for WPA networks. If the key is 64-characters long, it -must contain only hexadecimal characters and is interpreted as a -hexadecimal WPA key. Otherwise, the key must be between 8 and 63 ASCII -characters (as specified in the 802.11i standard) and is interpreted as a -WPA passphrase, and is hashed to derive the actual WPA-PSK used when -connecting to the Wi-Fi network.

+

Pre-Shared-Key for WPA networks. For WPA-PSK, it's either an ASCII +passphrase of 8 to 63 characters that is (as specified in the 802.11i +standard) hashed to derive the actual key, or the key in form of 64 +hexadecimal character. The WPA3-Personal networks use a passphrase +of any length for SAE authentication.

Flags: Read / Write

Default value: NULL

diff --git a/docs/libnm/html/NMSettingWpan.html b/docs/libnm/html/NMSettingWpan.html index 1ceb07c3..777bc6f6 100644 --- a/docs/libnm/html/NMSettingWpan.html +++ b/docs/libnm/html/NMSettingWpan.html @@ -70,6 +70,22 @@ nm_setting_wpan_get_short_address () + + + + + + + +
+gint16 + +nm_setting_wpan_get_page () +
+gint16 + +nm_setting_wpan_get_channel () +
@@ -97,6 +113,22 @@ #define NM_SETTING_WPAN_SHORT_ADDRESS + +#define +NM_SETTING_WPAN_PAGE + + +#define +NM_SETTING_WPAN_CHANNEL + + +#define +NM_SETTING_WPAN_PAGE_DEFAULT + + +#define +NM_SETTING_WPAN_CHANNEL_DEFAULT +
@@ -197,6 +229,58 @@ nm_setting_wpan_get_short_address (

Since: 1.14

+
+
+

nm_setting_wpan_get_page ()

+
gint16
+nm_setting_wpan_get_page (NMSettingWpan *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWpan

 
+
+
+

Returns

+

the “page” property of the setting

+
+

Since: 1.16

+
+
+
+

nm_setting_wpan_get_channel ()

+
gint16
+nm_setting_wpan_get_channel (NMSettingWpan *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWpan

 
+
+
+

Returns

+

the “channel” property of the setting

+
+

Since: 1.16

+

Types and Values

@@ -223,6 +307,30 @@ nm_setting_wpan_get_short_address (#define NM_SETTING_WPAN_SHORT_ADDRESS "short-address"
+
+
+

NM_SETTING_WPAN_PAGE

+
#define NM_SETTING_WPAN_PAGE               "page"
+
+
+
+
+

NM_SETTING_WPAN_CHANNEL

+
#define NM_SETTING_WPAN_CHANNEL            "channel"
+
+
+
+
+

NM_SETTING_WPAN_PAGE_DEFAULT

+
#define NM_SETTING_WPAN_PAGE_DEFAULT    -1
+
+
+
+
+

NM_SETTING_WPAN_CHANNEL_DEFAULT

+
#define NM_SETTING_WPAN_CHANNEL_DEFAULT -1
+
+

-

NM_DBUS_INTERFACE_DEVICE_OLPC_MESH

-
#define NM_DBUS_INTERFACE_DEVICE_OLPC_MESH     NM_DBUS_INTERFACE_DEVICE ".OlpcMesh"
+

NM_DBUS_INTERFACE_DEVICE_BOND

+
#define NM_DBUS_INTERFACE_DEVICE_BOND          NM_DBUS_INTERFACE_DEVICE ".Bond"
 

-

NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE

-
#define NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE NM_DBUS_INTERFACE_DEVICE ".OvsInterface"
+

NM_DBUS_INTERFACE_DEVICE_BRIDGE

+
#define NM_DBUS_INTERFACE_DEVICE_BRIDGE        NM_DBUS_INTERFACE_DEVICE ".Bridge"
 

-

NM_DBUS_INTERFACE_DEVICE_OVS_PORT

-
#define NM_DBUS_INTERFACE_DEVICE_OVS_PORT      NM_DBUS_INTERFACE_DEVICE ".OvsPort"
+

NM_DBUS_INTERFACE_DEVICE_DUMMY

+
#define NM_DBUS_INTERFACE_DEVICE_DUMMY         NM_DBUS_INTERFACE_DEVICE ".Dummy"
 

-

NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE

-
#define NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE    NM_DBUS_INTERFACE_DEVICE ".OvsBridge"
+

NM_DBUS_INTERFACE_DEVICE_GENERIC

+
#define NM_DBUS_INTERFACE_DEVICE_GENERIC       NM_DBUS_INTERFACE_DEVICE ".Generic"
 

-

NM_DBUS_PATH_ACCESS_POINT

-
#define NM_DBUS_PATH_ACCESS_POINT              NM_DBUS_PATH "/AccessPoint"
+

NM_DBUS_INTERFACE_DEVICE_GRE

+
#define NM_DBUS_INTERFACE_DEVICE_GRE           NM_DBUS_INTERFACE_DEVICE ".Gre"
 

-

NM_DBUS_INTERFACE_ACCESS_POINT

-
#define NM_DBUS_INTERFACE_ACCESS_POINT         NM_DBUS_INTERFACE ".AccessPoint"
+

NM_DBUS_INTERFACE_DEVICE_INFINIBAND

+
#define NM_DBUS_INTERFACE_DEVICE_INFINIBAND    NM_DBUS_INTERFACE_DEVICE ".Infiniband"
 

-

NM_DBUS_INTERFACE_DEVICE_MODEM

-
#define NM_DBUS_INTERFACE_DEVICE_MODEM         NM_DBUS_INTERFACE_DEVICE ".Modem"
+

NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL

+
#define NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL     NM_DBUS_INTERFACE_DEVICE ".IPTunnel"
 

-

NM_DBUS_INTERFACE_DEVICE_WIMAX

-
#define NM_DBUS_INTERFACE_DEVICE_WIMAX         NM_DBUS_INTERFACE_DEVICE ".WiMax"
+

NM_DBUS_INTERFACE_DEVICE_MACSEC

+
#define NM_DBUS_INTERFACE_DEVICE_MACSEC        NM_DBUS_INTERFACE_DEVICE ".Macsec"
 

-

NM_DBUS_INTERFACE_WIMAX_NSP

-
#define NM_DBUS_INTERFACE_WIMAX_NSP            NM_DBUS_INTERFACE ".WiMax.Nsp"
+

NM_DBUS_INTERFACE_DEVICE_MACVLAN

+
#define NM_DBUS_INTERFACE_DEVICE_MACVLAN       NM_DBUS_INTERFACE_DEVICE ".Macvlan"
 

-

NM_DBUS_PATH_WIMAX_NSP

-
#define NM_DBUS_PATH_WIMAX_NSP                 NM_DBUS_PATH "/Nsp"
+

NM_DBUS_INTERFACE_DEVICE_MODEM

+
#define NM_DBUS_INTERFACE_DEVICE_MODEM         NM_DBUS_INTERFACE_DEVICE ".Modem"
 

-

NM_DBUS_INTERFACE_ACTIVE_CONNECTION

-
#define NM_DBUS_INTERFACE_ACTIVE_CONNECTION    NM_DBUS_INTERFACE ".Connection.Active"
+

NM_DBUS_INTERFACE_DEVICE_OLPC_MESH

+
#define NM_DBUS_INTERFACE_DEVICE_OLPC_MESH     NM_DBUS_INTERFACE_DEVICE ".OlpcMesh"
 

-

NM_DBUS_INTERFACE_IP4_CONFIG

-
#define NM_DBUS_INTERFACE_IP4_CONFIG           NM_DBUS_INTERFACE ".IP4Config"
+

NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE

+
#define NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE    NM_DBUS_INTERFACE_DEVICE ".OvsBridge"
 

-

NM_DBUS_INTERFACE_DHCP4_CONFIG

-
#define NM_DBUS_INTERFACE_DHCP4_CONFIG         NM_DBUS_INTERFACE ".DHCP4Config"
+

NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE

+
#define NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE NM_DBUS_INTERFACE_DEVICE ".OvsInterface"
 

-

NM_DBUS_INTERFACE_IP6_CONFIG

-
#define NM_DBUS_INTERFACE_IP6_CONFIG           NM_DBUS_INTERFACE ".IP6Config"
+

NM_DBUS_INTERFACE_DEVICE_OVS_PORT

+
#define NM_DBUS_INTERFACE_DEVICE_OVS_PORT      NM_DBUS_INTERFACE_DEVICE ".OvsPort"
 

-

NM_DBUS_INTERFACE_DHCP6_CONFIG

-
#define NM_DBUS_INTERFACE_DHCP6_CONFIG         NM_DBUS_INTERFACE ".DHCP6Config"
+

NM_DBUS_INTERFACE_DEVICE_PPP

+
#define NM_DBUS_INTERFACE_DEVICE_PPP           NM_DBUS_INTERFACE_DEVICE ".Ppp"
 

-

NM_DBUS_INTERFACE_DEVICE_INFINIBAND

-
#define NM_DBUS_INTERFACE_DEVICE_INFINIBAND    NM_DBUS_INTERFACE_DEVICE ".Infiniband"
+

NM_DBUS_INTERFACE_DEVICE_STATISTICS

+
#define NM_DBUS_INTERFACE_DEVICE_STATISTICS    NM_DBUS_INTERFACE_DEVICE ".Statistics"
 

-

NM_DBUS_INTERFACE_DEVICE_BOND

-
#define NM_DBUS_INTERFACE_DEVICE_BOND          NM_DBUS_INTERFACE_DEVICE ".Bond"
+

NM_DBUS_INTERFACE_DEVICE_TEAM

+
#define NM_DBUS_INTERFACE_DEVICE_TEAM          NM_DBUS_INTERFACE_DEVICE ".Team"
 

-

NM_DBUS_INTERFACE_DEVICE_DUMMY

-
#define NM_DBUS_INTERFACE_DEVICE_DUMMY         NM_DBUS_INTERFACE_DEVICE ".Dummy"
+

NM_DBUS_INTERFACE_DEVICE_TUN

+
#define NM_DBUS_INTERFACE_DEVICE_TUN           NM_DBUS_INTERFACE_DEVICE ".Tun"
 

-

NM_DBUS_INTERFACE_DEVICE_TEAM

-
#define NM_DBUS_INTERFACE_DEVICE_TEAM          NM_DBUS_INTERFACE_DEVICE ".Team"
+

NM_DBUS_INTERFACE_DEVICE_VETH

+
#define NM_DBUS_INTERFACE_DEVICE_VETH          NM_DBUS_INTERFACE_DEVICE ".Veth"
 

@@ -663,92 +681,104 @@

-

NM_DBUS_INTERFACE_DEVICE_BRIDGE

-
#define NM_DBUS_INTERFACE_DEVICE_BRIDGE        NM_DBUS_INTERFACE_DEVICE ".Bridge"
+

NM_DBUS_INTERFACE_DEVICE_VXLAN

+
#define NM_DBUS_INTERFACE_DEVICE_VXLAN         NM_DBUS_INTERFACE_DEVICE ".Vxlan"
 

-

NM_DBUS_INTERFACE_DEVICE_GENERIC

-
#define NM_DBUS_INTERFACE_DEVICE_GENERIC       NM_DBUS_INTERFACE_DEVICE ".Generic"
+

NM_DBUS_INTERFACE_DEVICE_WIFI_P2P

+
#define NM_DBUS_INTERFACE_DEVICE_WIFI_P2P      NM_DBUS_INTERFACE_DEVICE ".WifiP2P"
 

-

NM_DBUS_INTERFACE_DEVICE_VETH

-
#define NM_DBUS_INTERFACE_DEVICE_VETH          NM_DBUS_INTERFACE_DEVICE ".Veth"
+

NM_DBUS_INTERFACE_DEVICE_WIMAX

+
#define NM_DBUS_INTERFACE_DEVICE_WIMAX         NM_DBUS_INTERFACE_DEVICE ".WiMax"
 

-

NM_DBUS_INTERFACE_DEVICE_TUN

-
#define NM_DBUS_INTERFACE_DEVICE_TUN           NM_DBUS_INTERFACE_DEVICE ".Tun"
+

NM_DBUS_INTERFACE_DEVICE_WIRED

+
#define NM_DBUS_INTERFACE_DEVICE_WIRED         NM_DBUS_INTERFACE_DEVICE ".Wired"
 

-

NM_DBUS_INTERFACE_DEVICE_MACSEC

-
#define NM_DBUS_INTERFACE_DEVICE_MACSEC        NM_DBUS_INTERFACE_DEVICE ".Macsec"
+

NM_DBUS_INTERFACE_DEVICE_WIREGUARD

+
#define NM_DBUS_INTERFACE_DEVICE_WIREGUARD     NM_DBUS_INTERFACE_DEVICE ".WireGuard"
 

-

NM_DBUS_INTERFACE_DEVICE_MACVLAN

-
#define NM_DBUS_INTERFACE_DEVICE_MACVLAN       NM_DBUS_INTERFACE_DEVICE ".Macvlan"
+

NM_DBUS_INTERFACE_DEVICE_WIRELESS

+
#define NM_DBUS_INTERFACE_DEVICE_WIRELESS      NM_DBUS_INTERFACE_DEVICE ".Wireless"
 

-

NM_DBUS_INTERFACE_DEVICE_PPP

-
#define NM_DBUS_INTERFACE_DEVICE_PPP           NM_DBUS_INTERFACE_DEVICE ".Ppp"
+

NM_DBUS_INTERFACE_DEVICE_WPAN

+
#define NM_DBUS_INTERFACE_DEVICE_WPAN          NM_DBUS_INTERFACE_DEVICE ".Wpan"
 

-

NM_DBUS_INTERFACE_DEVICE_VXLAN

-
#define NM_DBUS_INTERFACE_DEVICE_VXLAN         NM_DBUS_INTERFACE_DEVICE ".Vxlan"
+

NM_DBUS_INTERFACE_DHCP4_CONFIG

+
#define NM_DBUS_INTERFACE_DHCP4_CONFIG         NM_DBUS_INTERFACE ".DHCP4Config"
 

-

NM_DBUS_INTERFACE_DEVICE_WIREGUARD

-
#define NM_DBUS_INTERFACE_DEVICE_WIREGUARD     NM_DBUS_INTERFACE_DEVICE ".WireGuard"
+

NM_DBUS_INTERFACE_DHCP6_CONFIG

+
#define NM_DBUS_INTERFACE_DHCP6_CONFIG         NM_DBUS_INTERFACE ".DHCP6Config"
 

-

NM_DBUS_INTERFACE_DEVICE_GRE

-
#define NM_DBUS_INTERFACE_DEVICE_GRE           NM_DBUS_INTERFACE_DEVICE ".Gre"
+

NM_DBUS_INTERFACE_IP4_CONFIG

+
#define NM_DBUS_INTERFACE_IP4_CONFIG           NM_DBUS_INTERFACE ".IP4Config"
 

-

NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL

-
#define NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL     NM_DBUS_INTERFACE_DEVICE ".IPTunnel"
+

NM_DBUS_INTERFACE_IP6_CONFIG

+
#define NM_DBUS_INTERFACE_IP6_CONFIG           NM_DBUS_INTERFACE ".IP6Config"
 

-

NM_DBUS_INTERFACE_DEVICE_WPAN

-
#define NM_DBUS_INTERFACE_DEVICE_WPAN          NM_DBUS_INTERFACE_DEVICE ".Wpan"
+

NM_DBUS_INTERFACE_WIFI_P2P_PEER

+
#define NM_DBUS_INTERFACE_WIFI_P2P_PEER        NM_DBUS_INTERFACE ".WifiP2PPeer"
 

-

NM_DBUS_INTERFACE_DEVICE_6LOWPAN

-
#define NM_DBUS_INTERFACE_DEVICE_6LOWPAN       NM_DBUS_INTERFACE_DEVICE ".Lowpan"
+

NM_DBUS_INTERFACE_WIMAX_NSP

+
#define NM_DBUS_INTERFACE_WIMAX_NSP            NM_DBUS_INTERFACE ".WiMax.Nsp"
 

-

NM_DBUS_INTERFACE_DEVICE_STATISTICS

-
#define NM_DBUS_INTERFACE_DEVICE_STATISTICS    NM_DBUS_INTERFACE_DEVICE ".Statistics"
+

NM_DBUS_PATH

+
#define NM_DBUS_PATH                           "/org/freedesktop/NetworkManager"
 

-

NM_DBUS_INTERFACE_CHECKPOINT

-
#define NM_DBUS_INTERFACE_CHECKPOINT           NM_DBUS_INTERFACE ".Checkpoint"
+

NM_DBUS_PATH_ACCESS_POINT

+
#define NM_DBUS_PATH_ACCESS_POINT              NM_DBUS_PATH "/AccessPoint"
+
+
+
+
+

NM_DBUS_PATH_WIFI_P2P_PEER

+
#define NM_DBUS_PATH_WIFI_P2P_PEER             NM_DBUS_PATH "/WifiP2PPeer"
+
+
+
+
+

NM_DBUS_PATH_WIMAX_NSP

+
#define NM_DBUS_PATH_WIMAX_NSP                 NM_DBUS_PATH "/Nsp"
 

@@ -973,7 +1003,7 @@ extensions.

The Internet connection is hijacked by a captive portal gateway. The graphical shell may open a sandboxed web browser window (because the captive portals typically attempt a man-in-the-middle attacks - agains the https connections) for the purpose of authenticating to a gateway + against the https connections) for the purpose of authenticating to a gateway and retrigger the connectivity check with CheckConnectivity() when the browser window is dismissed.

@@ -1031,7 +1061,7 @@ device object.

NM_DEVICE_TYPE_WIFI

-

an 802.11 WiFi device

+

an 802.11 Wi-Fi device

  @@ -1225,6 +1255,13 @@ GSM/UMTS, or LTE network access protocols

  + +

NM_DEVICE_TYPE_WIFI_P2P

+ +

an 802.11 Wi-Fi P2P device (Since: 1.16)

+ +  +
@@ -1534,6 +1571,14 @@ is supported

  + +

NM_802_11_AP_SEC_KEY_MGMT_SAE

+ +

WPA/RSN Simultaneous Authentication of Equals is +supported

+ +  +
@@ -1790,7 +1835,7 @@ GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability

NM_DEVICE_STATE_CONFIG

the device is connecting to the requested network. - This may include operations like associating with the WiFi AP, dialing + This may include operations like associating with the Wi-Fi AP, dialing the modem, connecting to the remote Bluetooth device, etc.

  @@ -2247,7 +2292,7 @@ GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability

NM_DEVICE_STATE_REASON_SSID_NOT_FOUND

-

The WiFi network could not be found

+

The Wi-Fi network could not be found

  @@ -2342,6 +2387,13 @@ GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability

  + +

NM_DEVICE_STATE_REASON_PEER_NOT_FOUND

+ +

The Wi-Fi P2P peer could not be found

+ +  + @@ -3201,6 +3253,16 @@ VPN plugin authentication dialogs.

  + +

NM_ACTIVATION_STATE_FLAG_LIFETIME_BOUND_TO_PROFILE_VISIBILITY

+ +

the lifetime + of the activation is bound to the visilibity of the connection profile, + which in turn depends on "connection.permissions" and whether a session + for the user exists. Since: 1.16

+ +  + @@ -3285,7 +3347,7 @@ VPN plugin authentication dialogs.

NM_SETTINGS_UPDATE2_FLAG_BLOCK_AUTOCONNECT

usually, when the connection - has autoconnect enabled and is modified, it becomes elegible to autoconnect + has autoconnect enabled and is modified, it becomes eligible to autoconnect right away. Setting this flag, disables autoconnect until the connection is manually activated.

diff --git a/docs/libnm/html/libnm-nm-errors.html b/docs/libnm/html/libnm-nm-errors.html index 9e2f2d03..cd91f295 100644 --- a/docs/libnm/html/libnm-nm-errors.html +++ b/docs/libnm/html/libnm-nm-errors.html @@ -582,6 +582,13 @@ returned from D-Bus operations (where they correspond to errors in the   + +

NM_DEVICE_ERROR_INVALID_ARGUMENT

+ +

invalid argument. Since: 1.16

+ +  + diff --git a/docs/libnm/html/libnm-nm-utils.html b/docs/libnm/html/libnm-nm-utils.html index 70a83944..3528aac9 100644 --- a/docs/libnm/html/libnm-nm-utils.html +++ b/docs/libnm/html/libnm-nm-utils.html @@ -631,6 +631,14 @@ nm_utils_get_timestamp_msec () + + +gboolean + + +nm_utils_base64secret_decode () + + @@ -895,7 +903,7 @@ use

type

-

the security type to check AP flags and device capabilties against, +

the security type to check AP flags and device capabilities against, e.g. NMU_SEC_STATIC_WEP

  @@ -925,13 +933,13 @@ arguments are valid

ap_wpa

-

bitfield of AP capabilties derived from the AP's WPA beacon, +

bitfield of AP capabilities derived from the AP's WPA beacon, e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK)

 

ap_rsn

-

bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, +

bitfield of AP capabilities derived from the AP's RSN/WPA2 beacon, e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP)

  @@ -940,7 +948,7 @@ e.g. (

Returns

-

TRUE if the device capabilities and AP capabilties intersect and are +

TRUE if the device capabilities and AP capabilities intersect and are compatible with the desired type , FALSE if they are not

@@ -965,7 +973,7 @@ desired security type are valid for AP/Hotspot connections.

type

-

the security type to check device capabilties against, +

the security type to check device capabilities against, e.g. NMU_SEC_STATIC_WEP

  @@ -1888,9 +1896,9 @@ and predicate

user_data

-

(allow-none): user data for predicate +

user data for predicate function.

-[closure] +[closure][allow-none]

error

@@ -3356,6 +3364,51 @@ nm_utils_sriov_vf_from_str (const gint64 nm_utils_get_timestamp_msec (void); +
+
+

nm_utils_base64secret_decode ()

+
gboolean
+nm_utils_base64secret_decode (const char *base64_key,
+                              gsize required_key_len,
+                              guint8 *out_key);
+
+

Parameters

+
+++++ + + + + + + + + + + + + + + + + + +

base64_key

the (possibly invalid) base64 encode key.

 

required_key_len

the expected (binary) length of the key after +decoding. If the length does not match, the validation fails.

 

out_key

(out): an optional output buffer for the binary +key. If given, it will be filled with exactly required_key_len +bytes.

[allow-none]
+
+
+

Returns

+

TRUE if the input key is a valid base64 encoded key +with required_key_len +bytes.

+
+

Since: 1.16

+

Types and Values

diff --git a/docs/libnm/html/libnm-nm-version.html b/docs/libnm/html/libnm-nm-version.html index bfeff4b5..596c4ea0 100644 --- a/docs/libnm/html/libnm-nm-version.html +++ b/docs/libnm/html/libnm-nm-version.html @@ -93,6 +93,12 @@ NM_DEPRECATED_IN_1_14_FOR() + +#define + +NM_DEPRECATED_IN_1_16_FOR() + +
@@ -184,6 +190,14 @@ #define NM_AVAILABLE_IN_1_14 + +#define +NM_DEPRECATED_IN_1_16 + + +#define +NM_AVAILABLE_IN_1_16 + @@ -244,6 +258,12 @@
# define NM_DEPRECATED_IN_1_14_FOR(f)    G_DEPRECATED_FOR(f)
 
+
+
+

NM_DEPRECATED_IN_1_16_FOR()

+
# define NM_DEPRECATED_IN_1_16_FOR(f)    G_DEPRECATED_FOR(f)
+
+

Types and Values

@@ -364,6 +384,18 @@
# define NM_AVAILABLE_IN_1_14            G_UNAVAILABLE(1,14)
 
+
+
+

NM_DEPRECATED_IN_1_16

+
# define NM_DEPRECATED_IN_1_16           G_DEPRECATED
+
+
+
+
+

NM_AVAILABLE_IN_1_16

+
# define NM_AVAILABLE_IN_1_16            G_UNAVAILABLE(1,16)
+
+