From 90e8691111889a7b5f3c812f5a41f15a8a058913 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Tue, 7 Nov 2017 00:14:39 +0100 Subject: New upstream version 1.9.90 --- docs/libnm/html/NMSettingWirelessSecurity.html | 352 ++++++++++++++++++++----- 1 file changed, 289 insertions(+), 63 deletions(-) (limited to 'docs/libnm/html/NMSettingWirelessSecurity.html') diff --git a/docs/libnm/html/NMSettingWirelessSecurity.html b/docs/libnm/html/NMSettingWirelessSecurity.html index 90399f70..70aa4a76 100644 --- a/docs/libnm/html/NMSettingWirelessSecurity.html +++ b/docs/libnm/html/NMSettingWirelessSecurity.html @@ -59,7 +59,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-guint32 +guint32 nm_setting_wireless_security_get_num_protos () @@ -74,7 +74,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_add_proto () @@ -90,7 +90,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_remove_proto_by_value () @@ -106,7 +106,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-guint32 +guint32 nm_setting_wireless_security_get_num_pairwise () @@ -121,7 +121,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_add_pairwise () @@ -137,7 +137,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_remove_pairwise_by_value () @@ -153,7 +153,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-guint32 +guint32 nm_setting_wireless_security_get_num_groups () @@ -168,7 +168,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_add_group () @@ -184,7 +184,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gboolean +gboolean nm_setting_wireless_security_remove_group_by_value () @@ -199,6 +199,14 @@ use WEP, LEAP, WPA or WPA2/RSN security

+ +NMSettingWirelessSecurityPmf + + +nm_setting_wireless_security_get_pmf () + + + const char * @@ -252,7 +260,7 @@ use WEP, LEAP, WPA or WPA2/RSN security

-guint32 +guint32 nm_setting_wireless_security_get_wep_tx_keyidx () @@ -281,6 +289,14 @@ use WEP, LEAP, WPA or WPA2/RSN security

nm_setting_wireless_security_get_wep_key_type () + + +NMSettingWirelessSecurityWpsMethod + + +nm_setting_wireless_security_get_wps_method () + + @@ -295,24 +311,24 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gchar * +gchar * auth-alg Read / Write -GStrv +GStrv group Read / Write -gchar * +gchar * key-mgmt Read / Write -gchar * +gchar * leap-password Read / Write @@ -323,23 +339,28 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gchar * +gchar * leap-username Read / Write -GStrv +GStrv pairwise Read / Write -GStrv +gint +pmf +Read / Write / Construct + + +GStrv proto Read / Write -gchar * +gchar * psk Read / Write @@ -360,33 +381,38 @@ use WEP, LEAP, WPA or WPA2/RSN security

-gchar * +gchar * wep-key0 Read / Write -gchar * +gchar * wep-key1 Read / Write -gchar * +gchar * wep-key2 Read / Write -gchar * +gchar * wep-key3 Read / Write -guint +guint wep-tx-keyidx Read / Write / Construct + +guint +wps-method +Read / Write / Construct + @@ -407,6 +433,14 @@ use WEP, LEAP, WPA or WPA2/RSN security

NMWepKeyType +enum +NMSettingWirelessSecurityPmf + + +enum +NMSettingWirelessSecurityWpsMethod + + #define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT @@ -432,6 +466,10 @@ use WEP, LEAP, WPA or WPA2/RSN security

#define +NM_SETTING_WIRELESS_SECURITY_PMF + + +#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME @@ -475,6 +513,10 @@ use WEP, LEAP, WPA or WPA2/RSN security

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS +#define +NM_SETTING_WIRELESS_SECURITY_WPS_METHOD + +   NMSettingWirelessSecurity @@ -483,9 +525,11 @@ use WEP, LEAP, WPA or WPA2/RSN security

Object Hierarchy

-
    GEnum
+
    GEnum
+    ├── NMSettingWirelessSecurityPmf
+    ├── NMSettingWirelessSecurityWpsMethod
     ╰── NMWepKeyType
-    GObject
+    GObject
     ╰── NMSetting
         ╰── NMSettingWirelessSecurity
 

@@ -547,7 +591,7 @@ nm_setting_wireless_security_get_key_mgmt
 

 

 
nm_setting_wireless_security_get_num_protos ()

-
guint32
+
guint32
 nm_setting_wireless_security_get_num_protos
                                (NMSettingWirelessSecurity *setting);

 

@@ -577,7 +621,7 @@ connecting to secure Wi-Fi networks

 
const char *
 nm_setting_wireless_security_get_proto
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);

 

 
Parameters

 

@@ -609,7 +653,7 @@ nm_setting_wireless_security_get_proto
 

 
nm_setting_wireless_security_add_proto ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_add_proto
                                (NMSettingWirelessSecurity *setting,
                                 const char *proto);

@@ -643,8 +687,8 @@ with the access point.

 

 
Returns

-
 TRUE if the protocol was new and was added to the allowed
-protocol list, or FALSE if it was already in the list

+
 TRUE if the protocol was new and was added to the allowed
+protocol list, or FALSE if it was already in the list

 

@@ -653,7 +697,7 @@ protocol list, or FALSE if it was already in the li
 
void
 nm_setting_wireless_security_remove_proto
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);
Removes a protocol from the allowed protocol list.

 
Parameters

@@ -681,7 +725,7 @@ nm_setting_wireless_security_remove_proto
 

 

 
nm_setting_wireless_security_remove_proto_by_value ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_remove_proto_by_value
                                (NMSettingWirelessSecurity *setting,
                                 const char *proto);

@@ -710,7 +754,7 @@ nm_setting_wireless_security_remove_proto_by_value
 

 

 
Returns

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

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

 

 

@@ -740,7 +784,7 @@ specified then all protocols are allowed.

 
nm_setting_wireless_security_get_num_pairwise ()

-
guint32
+
guint32
 nm_setting_wireless_security_get_num_pairwise
                                (NMSettingWirelessSecurity *setting);

 

@@ -769,7 +813,7 @@ nm_setting_wireless_security_get_num_pairwise
 
const char *
 nm_setting_wireless_security_get_pairwise
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);

 
Returns the allowed pairwise encryption algorithm from allowed algorithm
 list.

 

@@ -803,7 +847,7 @@ list.

 

 

 
nm_setting_wireless_security_add_pairwise ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_add_pairwise
                                (NMSettingWirelessSecurity *setting,
                                 const char *pairwise);

@@ -835,7 +879,7 @@ compatible with this connection.

 

 

 
Returns

-
 TRUE if the algorithm was added to the list, FALSE if it was
+
 TRUE if the algorithm was added to the list, FALSE if it was
 already in the list

 

 

@@ -845,7 +889,7 @@ already in the list

 
void
 nm_setting_wireless_security_remove_pairwise
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);
 
Removes an encryption algorithm from the allowed pairwise encryption
 algorithm list.

 

@@ -874,7 +918,7 @@ algorithm list.

 

 

 
nm_setting_wireless_security_remove_pairwise_by_value ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_remove_pairwise_by_value
                                (NMSettingWirelessSecurity *setting,
                                 const char *pairwise);

@@ -904,7 +948,7 @@ algorithm list.

 

 

 
Returns

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

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

 

 

 

@@ -934,7 +978,7 @@ specified then all pairwise encryption algorithms are allowed.

 

 

 
nm_setting_wireless_security_get_num_groups ()

-
guint32
+
guint32
 nm_setting_wireless_security_get_num_groups
                                (NMSettingWirelessSecurity *setting);

 

@@ -963,7 +1007,7 @@ nm_setting_wireless_security_get_num_groups
 
const char *
 nm_setting_wireless_security_get_group
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);

 
Returns the allowed groupwise encryption algorithm from allowed algorithm
 list.

 

@@ -997,7 +1041,7 @@ list.

 

 

 
nm_setting_wireless_security_add_group ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_add_group
                                (NMSettingWirelessSecurity *setting,
                                 const char *group);

@@ -1030,7 +1074,7 @@ compatible with this connection.

 

 

 
Returns

-
 TRUE if the algorithm was added to the list, FALSE if it was
+
 TRUE if the algorithm was added to the list, FALSE if it was
 already in the list

 

 

@@ -1040,7 +1084,7 @@ already in the list

 
void
 nm_setting_wireless_security_remove_group
                                (NMSettingWirelessSecurity *setting,
-                                guint32 i);

+                                guint32 i);
 
Removes an encryption algorithm from the allowed groupwise encryption
 algorithm list.

 

@@ -1069,7 +1113,7 @@ algorithm list.

 

 

 
nm_setting_wireless_security_remove_group_by_value ()

-
gboolean
+
gboolean
 nm_setting_wireless_security_remove_group_by_value
                                (NMSettingWirelessSecurity *setting,
                                 const char *group);

@@ -1100,7 +1144,7 @@ algorithm list.

 

 

 
Returns

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

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

 

 

 

@@ -1129,6 +1173,12 @@ specified then all groupwise encryption algorithms are allowed.

 

 

 

+
nm_setting_wireless_security_get_pmf ()

+
NMSettingWirelessSecurityPmf
+nm_setting_wireless_security_get_pmf (NMSettingWirelessSecurity *setting);

+

+

+

 
nm_setting_wireless_security_get_psk ()

 
const char *
 nm_setting_wireless_security_get_psk (NMSettingWirelessSecurity *setting);

@@ -1264,7 +1314,7 @@ nm_setting_wireless_security_get_leap_password_flags
 
const char *
 nm_setting_wireless_security_get_wep_key
                                (NMSettingWirelessSecurity *setting,
-                                guint32 idx);

+                                guint32 idx);
 

 
Parameters

 

 
 
 
 
 
 
 
 
 

@@ -1298,7 +1348,7 @@ nm_setting_wireless_security_get_wep_key
 
void
 nm_setting_wireless_security_set_wep_key
                                (NMSettingWirelessSecurity *setting,
-                                guint32 idx,
+                                guint32 idx,
                                 const char *key);
Sets a WEP key in the given index.

@@ -1334,7 +1384,7 @@ property.

 

 

 
nm_setting_wireless_security_get_wep_tx_keyidx ()

-
guint32
+
guint32
 nm_setting_wireless_security_get_wep_tx_keyidx
                                (NMSettingWirelessSecurity *setting);

 

@@ -1435,6 +1485,33 @@ nm_setting_wireless_security_get_wep_key_type
 
 the “wep-key-type” property of the setting

 

 

+

+

+
nm_setting_wireless_security_get_wps_method ()

+
NMSettingWirelessSecurityWpsMethod
+nm_setting_wireless_security_get_wps_method
+                               (NMSettingWirelessSecurity *setting);

+

+
Parameters

+

 
 

+++++
+
+
+
+
+
+





setting
the NMSettingWirelessSecurity
 

+

+

+
Returns

+
 the “wps-method” property of the setting

+

+
Since: 1.10

+

Types and Values

@@ -1504,6 +1581,114 @@ the actual WEP key using the MD5 hash algorithm.

+

enum NMSettingWirelessSecurityPmf

+

These flags indicate whether PMF must be enabled.

+
+

Members

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

NM_SETTING_WIRELESS_SECURITY_PMF_DEFAULT

 +

use the default value

+		 

NM_SETTING_WIRELESS_SECURITY_PMF_DISABLE

 +

disable PMF

+		 

NM_SETTING_WIRELESS_SECURITY_PMF_OPTIONAL

 +

enable PMF if the supplicant and the AP support it

+		 

NM_SETTING_WIRELESS_SECURITY_PMF_REQUIRED

 +

require PMF and fail if not available

+		 

_NM_SETTING_WIRELESS_SECURITY_PMF_NUM

  

NM_SETTING_WIRELESS_SECURITY_PMF_LAST

  
+
+
+
+
+

enum NMSettingWirelessSecurityWpsMethod

+

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

+
+

Members

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

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_DEFAULT

 +

Attempt whichever method AP supports

+		 

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_DISABLED

 +

WPS can not be used.

+		 

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_AUTO

 +

Use WPS, any method

+		 

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_PBC

 +

use WPS push-buthon method

+		 

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_PIN

 +

use PIN method

+		 
+
+

Since: 1.10

+
+
+

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
@@ -1540,6 +1725,12 @@ the actual WEP key using the MD5 hash algorithm.

+

NM_SETTING_WIRELESS_SECURITY_PMF

+
#define NM_SETTING_WIRELESS_SECURITY_PMF "pmf"
+
+
+
+

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
@@ -1606,6 +1797,12 @@ the actual WEP key using the MD5 hash algorithm.

+

NM_SETTING_WIRELESS_SECURITY_WPS_METHOD

+
#define NM_SETTING_WIRELESS_SECURITY_WPS_METHOD "wps-method"
+
+
+
+

NMSettingWirelessSecurity

typedef struct _NMSettingWirelessSecurity NMSettingWirelessSecurity;

Wi-Fi Security Settings

@@ -1615,7 +1812,7 @@ the actual WEP key using the MD5 hash algorithm.

Property Details

The “auth-alg” property

-
  “auth-alg”                 gchar *
+
  “auth-alg”                 gchar *

When WEP is used (ie, key-mgmt = "none" or "ieee8021x") indicate the 802.11 authentication algorithm required by the AP here. One of "open" for Open System, "shared" for Shared Key, or "leap" for Cisco LEAP. When @@ -1627,7 +1824,7 @@ using Cisco LEAP (ie, key-mgmt = "ieee8021x" and auth-alg = "leap") the

The “group” property

-
  “group”                    GStrv
+
  “group”                    GStrv

A list of group/broadcast encryption algorithms which prevents connections to Wi-Fi networks that do not utilize one of the algorithms in the list. For maximum compatibility leave this property empty. Each @@ -1637,7 +1834,7 @@ list element may be one of "wep40", "wep104", "tkip", or "ccmp".

The “key-mgmt” property

-
  “key-mgmt”                 gchar *
+
  “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 @@ -1648,7 +1845,7 @@ any Wi-Fi connection that uses security.

The “leap-password” property

-
  “leap-password”            gchar *
+
  “leap-password”            gchar *

The login password for legacy LEAP connections (ie, key-mgmt = "ieee8021x" and auth-alg = "leap").

Flags: Read / Write

@@ -1665,7 +1862,7 @@ any Wi-Fi connection that uses security.

The “leap-username” property

-
  “leap-username”            gchar *
+
  “leap-username”            gchar *

The login username for legacy LEAP connections (ie, key-mgmt = "ieee8021x" and auth-alg = "leap").

Flags: Read / Write

@@ -1674,7 +1871,7 @@ any Wi-Fi connection that uses security.

The “pairwise” property

-
  “pairwise”                 GStrv
+
  “pairwise”                 GStrv

A list of pairwise encryption algorithms which prevents connections to Wi-Fi networks that do not utilize one of the algorithms in the list. For maximum compatibility leave this property empty. Each list element @@ -1683,8 +1880,24 @@ may be one of "tkip" or "ccmp".

+

The “pmf” property

+
  “pmf”                      gint
+

Indicates whether Protected Management Frames (802.11w) must be enabled +for the connection. One of NM_SETTING_WIRELESS_SECURITY_PMF_DEFAULT +(use global default value), NM_SETTING_WIRELESS_SECURITY_PMF_DISABLE +(disable PMF), NM_SETTING_WIRELESS_SECURITY_PMF_OPTIONAL (enable PMF if +the supplicant and the access point support it) or +NM_SETTING_WIRELESS_SECURITY_PMF_REQUIRED (enable PMF and fail if not +supported). When set to NM_SETTING_WIRELESS_SECURITY_PMF_DEFAULT and no +global default is set, PMF will be optionally enabled.

+

Flags: Read / Write / Construct

+

Default value: 0

+

Since: 1.10

+
+
+

The “proto” property

-
  “proto”                    GStrv
+
  “proto”                    GStrv

List of strings specifying the allowed WPA protocol versions to use. Each element may be one "wpa" (allow WPA) or "rsn" (allow WPA2/RSN). If not specified, both WPA and RSN connections are allowed.

@@ -1693,7 +1906,7 @@ not specified, both WPA and RSN connections are allowed.

The “psk” property

-
  “psk”                      gchar *
+
  “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 @@ -1736,7 +1949,7 @@ the actual WEP key.

The “wep-key0” property

-
  “wep-key0”                 gchar *
+
  “wep-key0”                 gchar *

Index 0 WEP key. This is the WEP key used in most networks. See the "wep-key-type" property for a description of how this key is interpreted.

Flags: Read / Write

@@ -1745,7 +1958,7 @@ the actual WEP key.

The “wep-key1” property

-
  “wep-key1”                 gchar *
+
  “wep-key1”                 gchar *

Index 1 WEP key. This WEP index is not used by most networks. See the "wep-key-type" property for a description of how this key is interpreted.

Flags: Read / Write

@@ -1754,7 +1967,7 @@ the actual WEP key.

The “wep-key2” property

-
  “wep-key2”                 gchar *
+
  “wep-key2”                 gchar *

Index 2 WEP key. This WEP index is not used by most networks. See the "wep-key-type" property for a description of how this key is interpreted.

Flags: Read / Write

@@ -1763,7 +1976,7 @@ the actual WEP key.

The “wep-key3” property

-
  “wep-key3”                 gchar *
+
  “wep-key3”                 gchar *

Index 3 WEP key. This WEP index is not used by most networks. See the "wep-key-type" property for a description of how this key is interpreted.

Flags: Read / Write

@@ -1772,7 +1985,7 @@ the actual WEP key.

The “wep-tx-keyidx” property

-
  “wep-tx-keyidx”            guint
+
  “wep-tx-keyidx”            guint

When static WEP is used (ie, key-mgmt = "none") and a non-default WEP key index is used by the AP, put that WEP key index here. Valid values are 0 (default key) through 3. Note that some consumer access points (like the @@ -1781,6 +1994,19 @@ Linksys WRT54G) number the keys 1 - 4.

Allowed values: <= 3

Default value: 0

+
+
+

The “wps-method” property

+
  “wps-method”               guint
+

Flags indicating which mode of WPS is to be used if any.

+

There's little point in changing the default setting as NetworkManager will +automatically determine whether it's feasible to start WPS enrollment from +the Access Point capabilities.

+

WPS can be disabled by setting this property to a value of 1.

+

Flags: Read / Write / Construct

+

Default value: 0

+

Since: 1.10

+
-- cgit 1.3.0-6-gf8a5