From 9a6dcbf895f9da01768e64b73cec88c16157d91e Mon Sep 17 00:00:00 2001
From: Michael Biebl 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![]()
![]()
-![]()
+![]()
![]()
The
“state-changed” signalvoid
-user_function (NMActiveConnection *nmactiveconnection,
- guint arg1,
- guint arg2,
+user_function (NMActiveConnection *active_connection,
+ guint state,
+ guint reason,
gpointer user_data)
+Parameters
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
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.
| +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 + (+ 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 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
+
+Parameters+
Since: 1.16 ++
+
+nm_client_add_and_activate_connection2_finish ()+NMActiveConnection * +nm_client_add_and_activate_connection2_finish + (+ Gets the result of a call to You can call
+
+Parameters+
+
+Returns+the new NMActiveConnection on success, [transfer full] ++ | ||||||||||||||||||||||||||||||||||||
| + |
+ controls whether wifi scans can be performed + |
++ | |||||||||||||||||||||||||||||||||||
|
a reserved boundary value @@ -4541,14 +4719,9 @@ permission to read the details of.)The
| |||||||||||||||||||||||||||||||||||||
func |
function to be called to determine whether a -specific secret should be cleared or not. |
-[scope call] | +specific secret should be cleared or not. If[scope call][allow-none] | ||||||||||||||||||||||||||||||||||
user_data |
@@ -1500,8 +1500,8 @@ nm_connection_get_settings ((out): the length of the returned array. |
-[allow-none] | +the length of the returned array. |
+[allow-none][out] |
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.
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.
device |
+a NMDevice |
++ |
addr_family |
+network address family |
++ |
Since: 1.16
+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 (
+
+
+
+
@@ -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 @@



-
+
@@ -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
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)
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
+
+
+
+
+
+
+
+
+
+
+
+Top
+
+
+
+
+
+
+
+
+
+
+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
+
+
+
+
+
+
+
+#define
+NM_DEVICE_WIFI_P2P_HW_ADDRESS
+
+
+#define
+NM_DEVICE_WIFI_P2P_PEERS
+
+
+#define
+NM_DEVICE_WIFI_P2P_WFDIES
+
+
+
+
+
+
+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
+
+
+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.
+
+
+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.
+
+
+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
+
+
+
+
+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
+
+
+
+
+result
+the GAsyncResult
+
+
+
+error
+GError return address
+
+
+
+
+
+
+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
+
+
+
+
+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
+
+
+
+
+result
+the GAsyncResult
+
+
+
+error
+GError return address
+
+
+
+
+
+
+Since: 1.16
+
+
+
+
+
+
+
\ 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 @@
error
-(out): validation reason.
-[allow-none]
+validation reason.
+[allow-none][out]
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
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
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
+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] | +
Since: 1.16
+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
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 @@



-
+
| +Top + | +
+NMSettingWifiP2P+NMSettingWifiP2P — Describes connection properties for 802.11 Wi-Fi P2P networks + |
++ |
| +NMSetting * + | ++nm_setting_wifi_p2p_new () + | +
| const char * + | ++nm_setting_wifi_p2p_get_peer () + | +
| +NMSettingWirelessSecurityWpsMethod + | ++nm_setting_wifi_p2p_get_wps_method () + | +
| +GBytes * + | ++nm_setting_wifi_p2p_get_wfd_ies () + | +
| #define | +NM_SETTING_WIFI_P2P_SETTING_NAME | +
| #define | +NM_SETTING_WIFI_P2P_PEER | +
| #define | +NM_SETTING_WIFI_P2P_WPS_METHOD | +
| #define | +NM_SETTING_WIFI_P2P_WFD_IES | +
The NMSettingWifiP2P object is a NMSetting subclass that describes properties +necessary for connection to 802.11 Wi-Fi P2P networks (aka Wi-Fi Direct).
+NMSetting *
+nm_setting_wifi_p2p_new (void);
+Creates a new NMSettingWifiP2P object with default values.
+ +Since: 1.16
+const char *
+nm_setting_wifi_p2p_get_peer (NMSettingWifiP2P *setting);
+
+
+Since: 1.16
+NMSettingWirelessSecurityWpsMethod
+nm_setting_wifi_p2p_get_wps_method (NMSettingWifiP2P *setting);
+
+
+Since: 1.16
+GBytes *
+nm_setting_wifi_p2p_get_wfd_ies (NMSettingWifiP2P *setting);
+
+
+Since: 1.16
+| +Top + | +
+NMSettingWireGuard+NMSettingWireGuard — Describes connection properties for wireguard related options + |
++ |
| +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 () + | +
| #define | +NM_WIREGUARD_PUBLIC_KEY_LEN | +
| #define | +NM_WIREGUARD_SYMMETRIC_KEY_LEN | +
| #define | +NM_SETTING_WIREGUARD_SETTING_NAME | +
| #define | +NM_SETTING_WIREGUARD_FWMARK | +
| #define | +NM_SETTING_WIREGUARD_LISTEN_PORT | +
| #define | +NM_SETTING_WIREGUARD_PRIVATE_KEY | +
| #define | +NM_SETTING_WIREGUARD_PRIVATE_KEY_FLAGS | +
| #define | +NM_SETTING_WIREGUARD_PEERS | +
| #define | +NM_SETTING_WIREGUARD_MTU | +
| #define | +NM_SETTING_WIREGUARD_PEER_ROUTES | +
| #define | +NM_WIREGUARD_PEER_ATTR_ALLOWED_IPS | +
| #define | +NM_WIREGUARD_PEER_ATTR_ENDPOINT | +
| #define | +NM_WIREGUARD_PEER_ATTR_PERSISTENT_KEEPALIVE | +
| #define | +NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY | +
| #define | +NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY_FLAGS | +
| #define | +NM_WIREGUARD_PEER_ATTR_PUBLIC_KEY | +
The NMSettingWireGuard object is a NMSetting subclass that contains settings +for configuring WireGuard.
+NMWireGuardPeer * +nm_wireguard_peer_new_clone (+const NMWireGuardPeer *self, +gboolean with_secrets);
self |
+the NMWireGuardPeer instance to copy. |
++ |
with_secrets |
+if |
++ |
Since: 1.16
+NMWireGuardPeer *
+nm_wireguard_peer_ref (NMWireGuardPeer *self);
+This is not thread-safe.
+ + +Since: 1.16
+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.
+ +Since: 1.16
+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().
Since: 1.16
+gboolean
+nm_wireguard_peer_is_sealed (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+const char *
+nm_wireguard_peer_get_public_key (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
public_key |
+the new public
+key or |
+[allow-none][transfer none] | +
accept_invalid |
+if |
++ |
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
+const char *
+nm_wireguard_peer_get_preshared_key (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
preshared_key |
+the new preshared
+key or |
+[allow-none][transfer none] | +
accept_invalid |
+whether to allow setting the key to an invalid
+value. If |
++ |
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
+NMSettingSecretFlags
+nm_wireguard_peer_get_preshared_key_flags
+ (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
preshared_key_flags |
+the secret flags to set. |
++ |
Since: 1.16
+guint16
+nm_wireguard_peer_get_persistent_keepalive
+ (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+void +nm_wireguard_peer_set_persistent_keepalive + (+NMWireGuardPeer *self, +guint16 persistent_keepalive);
It is a bug trying to modify a sealed NMWireGuardPeer instance.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
persistent_keepalive |
+the keep-alive value to set. |
++ |
Since: 1.16
+const char *
+nm_wireguard_peer_get_endpoint (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
endpoint |
+the socket address endpoint to set or |
++ |
allow_invalid |
+if |
++ |
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
+guint
+nm_wireguard_peer_get_allowed_ips_len (const NMWireGuardPeer *self);
+
+
+Since: 1.16
+const char * +nm_wireguard_peer_get_allowed_ip (+const NMWireGuardPeer *self, +guint idx, +gboolean *out_is_valid);
self |
+the NMWireGuardPeer instance |
++ |
idx |
+the index from zero to (allowed-ips-len - 1) to +retrieve. |
++ |
out_is_valid |
+
|
+[allow-none] | +
the allowed-ip setting at index idx
+.
+If idx
+is out of range, NULL will be returned.
[transfer none]
+Since: 1.16
+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.
+ +Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
allowed_ip |
+the allowed-ip entry to set. |
++ |
accept_invalid |
+if |
++ |
TRUE if the value is a valid allowed-ips value, FALSE otherwise.
+Depending on accept_invalid
+, also invalid values are added.
Since: 1.16
+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.
+self |
+the unsealed NMWireGuardPeer instance |
++ |
idx |
+the index from zero to (allowed-ips-len - 1) to
+retrieve. If the index is out of range, |
++ |
TRUE if idx
+was valid and the allowed-ip was removed.
+FALSE otherwise, and the peer will not be changed.
Since: 1.16
+gboolean +nm_wireguard_peer_is_valid (+const NMWireGuardPeer *self, +gboolean check_non_secrets, +gboolean check_secrets, +GError **error);
self |
+the NMWireGuardPeer instance |
++ |
check_secrets |
+if |
++ |
check_non_secrets |
+if |
++ |
error |
+the GError location for returning the failure reason. |
++ |
Since: 1.16
+int +nm_wireguard_peer_cmp (+const NMWireGuardPeer *a, +const NMWireGuardPeer *b, +NMSettingCompareFlags compare_flags);
a |
+the NMWireGuardPeer to compare. |
+[allow-none] | +
b |
+the other NMWireGuardPeer to compare. |
+[allow-none] | +
compare_flags |
+NMSettingCompareFlags to affect the comparison. |
++ |
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
+NMSetting *
+nm_setting_wireguard_new (void);
+Creates a new NMSettingWireGuard object with default values.
+ +Since: 1.16
+const char *
+nm_setting_wireguard_get_private_key (NMSettingWireGuard *self);
+
+
+Since: 1.16
+NMSettingSecretFlags
+nm_setting_wireguard_get_private_key_flags
+ (NMSettingWireGuard *self);
+
+
+Since: 1.16
+guint16
+nm_setting_wireguard_get_listen_port (NMSettingWireGuard *self);
+
+
+Since: 1.16
+guint32
+nm_setting_wireguard_get_fwmark (NMSettingWireGuard *self);
+
+
+Since: 1.16
+guint
+nm_setting_wireguard_get_peers_len (NMSettingWireGuard *self);
+
+
+Since: 1.16
+NMWireGuardPeer * +nm_setting_wireguard_get_peer (+NMSettingWireGuard *self, +guint idx);
self |
+the NMSettingWireGuard instance |
++ |
idx |
+the index to lookup. |
++ |
the NMWireGuardPeer entry at
+index idx
+. If the index is out of range, NULL is returned.
[transfer none]
+Since: 1.16
+NMWireGuardPeer * +nm_setting_wireguard_get_peer_by_public_key + (+NMSettingWireGuard *self, +const char *public_key, +guint *out_idx);
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 |
+[out][allow-none] | +
the NMWireGuardPeer instance with a
+matching public key. If no such peer exists, NULL is returned.
[transfer none]
+Since: 1.16
+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).
self |
+the NMSettingWireGuard instance |
++ |
peer |
+the NMWireGuardPeer instance to set.
+This seals |
++ |
idx |
+the index, in the range of 0 to the number of
+peers (including). That means, if |
++ |
Since: 1.16
+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.
self |
+the NMSettingWireGuard instance |
++ |
peer |
+the NMWireGuardPeer instance to append.
+This seals |
++ |
Since: 1.16
+gboolean +nm_setting_wireguard_remove_peer (+NMSettingWireGuard *self, +guint idx);
self |
+the NMSettingWireGuard instance |
++ |
idx |
+the index to remove. |
++ |
Since: 1.16
+guint
+nm_setting_wireguard_clear_peers (NMSettingWireGuard *self);
+gboolean
+nm_setting_wireguard_get_peer_routes (NMSettingWireGuard *self);
+
+
+Since: 1.16
+guint32
+nm_setting_wireguard_get_mtu (NMSettingWireGuard *self);
+
+
+Since: 1.16
+#define NM_SETTING_WIREGUARD_PRIVATE_KEY_FLAGS "private-key-flags" ++
#define NM_WIREGUARD_PEER_ATTR_PERSISTENT_KEEPALIVE "persistent-keepalive" ++
#define NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY "preshared-key" ++
#define NM_WIREGUARD_PEER_ATTR_PRESHARED_KEY_FLAGS "preshared-key-flags" ++
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.
Wake on 4way hanshake
+Wake on 4way handshake
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 @@
GEnum ├── NMSettingWirelessSecurityFils ├── NMSettingWirelessSecurityPmf - ├── NMSettingWirelessSecurityWpsMethod ╰── NMWepKeyType + GFlags + ╰── NMSettingWirelessSecurityWpsMethod GObject ╰── NMSetting ╰── NMSettingWirelessSecurity @@ -970,7 +971,7 @@ algorithm list.
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
+
Since: 1.14
gint16
+nm_setting_wpan_get_page (NMSettingWpan *setting);
+
+
+Since: 1.16
+gint16
+nm_setting_wpan_get_channel (NMSettingWpan *setting);
+
+
+Since: 1.16
+#define NM_SETTING_WPAN_SHORT_ADDRESS "short-address"
WPA/RSN Simultaneous Authentication of Equals is +supported
+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.
The WiFi network could not be found
+The Wi-Fi network could not be found
The Wi-Fi P2P peer could not be found
+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
+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.
invalid argument. Since: 1.16
+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
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)
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
type
the security type to check device capabilties against, +
the security type to check device capabilities against, e.g. NMU_SEC_STATIC_WEP
predicate
user_data
(allow-none): user data for predicate
+
user data for predicate
function.
error
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]
+
+
+
+
+
+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_14_FOR(f) G_DEPRECATED_FOR(f)+