From a4256940da049f91bbbea5e53e469a59ea9c10f7 Mon Sep 17 00:00:00 2001
From: Sjoerd Simons
#include <nm-setting-wireless-security.h> - NMSettingWirelessSecurity; - NMSettingWirelessSecurityClass; +#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME enum NMSettingWirelessSecurityError; +#define NM_SETTING_WIRELESS_SECURITY_ERROR +GQuark nm_setting_wireless_security_error_quark + (void); enum NMWepKeyType; +#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT +#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX #define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG -#define NM_SETTING_WIRELESS_SECURITY_ERROR +#define NM_SETTING_WIRELESS_SECURITY_PROTO +#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE #define NM_SETTING_WIRELESS_SECURITY_GROUP -#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT -#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD -#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS #define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME -#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE -#define NM_SETTING_WIRELESS_SECURITY_PROTO -#define NM_SETTING_WIRELESS_SECURITY_PSK -#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS -#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS #define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE -#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX -gboolean nm_setting_wireless_security_add_group - (NMSettingWirelessSecurity *setting, -const char *group); -gboolean nm_setting_wireless_security_add_pairwise +#define NM_SETTING_WIRELESS_SECURITY_PSK +#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS +#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD +#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS + NMSettingWirelessSecurity; + NMSettingWirelessSecurityClass; +NMSetting * nm_setting_wireless_security_new (void); +const char * nm_setting_wireless_security_get_key_mgmt + (NMSettingWirelessSecurity *setting); +guint32 nm_setting_wireless_security_get_num_protos + (NMSettingWirelessSecurity *setting); +const char * nm_setting_wireless_security_get_proto (NMSettingWirelessSecurity *setting, -const char *pairwise); +guint32 i); gboolean nm_setting_wireless_security_add_proto (NMSettingWirelessSecurity *setting,const char *proto); -void nm_setting_wireless_security_clear_groups - (NMSettingWirelessSecurity *setting); -void nm_setting_wireless_security_clear_pairwise - (NMSettingWirelessSecurity *setting); +void nm_setting_wireless_security_remove_proto + (NMSettingWirelessSecurity *setting, +guint32 i); void nm_setting_wireless_security_clear_protos (NMSettingWirelessSecurity *setting); -GQuark nm_setting_wireless_security_error_quark - (void); -const char * nm_setting_wireless_security_get_auth_alg +guint32 nm_setting_wireless_security_get_num_pairwise (NMSettingWirelessSecurity *setting); -const char * nm_setting_wireless_security_get_group +const char * nm_setting_wireless_security_get_pairwise (NMSettingWirelessSecurity *setting,guint32 i); -const char * nm_setting_wireless_security_get_key_mgmt - (NMSettingWirelessSecurity *setting); -const char * nm_setting_wireless_security_get_leap_password - (NMSettingWirelessSecurity *setting); -NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags - (NMSettingWirelessSecurity *setting); -const char * nm_setting_wireless_security_get_leap_username +gboolean nm_setting_wireless_security_add_pairwise + (NMSettingWirelessSecurity *setting, +const char *pairwise); +void nm_setting_wireless_security_remove_pairwise + (NMSettingWirelessSecurity *setting, +guint32 i); +void nm_setting_wireless_security_clear_pairwise (NMSettingWirelessSecurity *setting); guint32 nm_setting_wireless_security_get_num_groups (NMSettingWirelessSecurity *setting); -guint32 nm_setting_wireless_security_get_num_pairwise - (NMSettingWirelessSecurity *setting); -guint32 nm_setting_wireless_security_get_num_protos - (NMSettingWirelessSecurity *setting); -const char * nm_setting_wireless_security_get_pairwise +const char * nm_setting_wireless_security_get_group (NMSettingWirelessSecurity *setting,guint32 i); -const char * nm_setting_wireless_security_get_proto +gboolean nm_setting_wireless_security_add_group + (NMSettingWirelessSecurity *setting, +const char *group); +void nm_setting_wireless_security_remove_group (NMSettingWirelessSecurity *setting,guint32 i); +void nm_setting_wireless_security_clear_groups + (NMSettingWirelessSecurity *setting); const char * nm_setting_wireless_security_get_psk (NMSettingWirelessSecurity *setting); NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags (NMSettingWirelessSecurity *setting); -const char * nm_setting_wireless_security_get_wep_key - (NMSettingWirelessSecurity *setting, -guint32 idx); -NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags +const char * nm_setting_wireless_security_get_leap_username (NMSettingWirelessSecurity *setting); -NMWepKeyType nm_setting_wireless_security_get_wep_key_type +const char * nm_setting_wireless_security_get_leap_password (NMSettingWirelessSecurity *setting); -guint32 nm_setting_wireless_security_get_wep_tx_keyidx +NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags (NMSettingWirelessSecurity *setting); -NMSetting * nm_setting_wireless_security_new (void); -void nm_setting_wireless_security_remove_group - (NMSettingWirelessSecurity *setting, -guint32 i); -void nm_setting_wireless_security_remove_pairwise - (NMSettingWirelessSecurity *setting, -guint32 i); -void nm_setting_wireless_security_remove_proto +const char * nm_setting_wireless_security_get_wep_key (NMSettingWirelessSecurity *setting, -guint32 i); +guint32 idx); void nm_setting_wireless_security_set_wep_key (NMSettingWirelessSecurity *setting,guint32 idx,const char *key); +guint32 nm_setting_wireless_security_get_wep_tx_keyidx + (NMSettingWirelessSecurity *setting); +const char * nm_setting_wireless_security_get_auth_alg + (NMSettingWirelessSecurity *setting); +NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags + (NMSettingWirelessSecurity *setting); +NMWepKeyType nm_setting_wireless_security_get_wep_key_type + (NMSettingWirelessSecurity *setting);
- GObject - +----NMSetting - +----NMSettingWirelessSecurity -
GEnum
+----NMSettingWirelessSecurityError
@@ -154,6 +149,11 @@ const char *
+ GObject
+ +----NMSetting
+ +----NMSettingWirelessSecurity
+
typedef struct _NMSettingWirelessSecurity NMSettingWirelessSecurity;-
-
-typedef struct {
- NMSettingClass parent;
-
- /* Padding for future expansion */
- void (*_reserved1) (void);
- void (*_reserved2) (void);
- void (*_reserved3) (void);
- void (*_reserved4) (void);
-} NMSettingWirelessSecurityClass;
+NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
+#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
@@ -237,8 +222,11 @@ of how WiFi security works, you may want to get copies of the following books.
NM_SETTING_WIRELESS_SECURITY_ERROR_SHARED_KEY_REQUIRES_WEP /*< nick=SharedKeyRequiresWEP >*/
} NMSettingWirelessSecurityError;
-| @@ -286,6 +274,33 @@ encryption protocol |
Returns : |
+the error quark used for NMSettingWired errors. | +
typedef enum {
NM_WEP_KEY_TYPE_UNKNOWN = 0,
@@ -306,8 +321,11 @@ ASCII keys are also valid WEP passphrases, but since passphrases and ASCII
keys are hashed differently to determine the actual WEP key the type must be
specified.
-
+
+
+
+
@@ -340,48 +358,48 @@ the actual WEP key using the MD5 hash algorithm.
-NM_SETTING_WIRELESS_SECURITY_AUTH_ALG
-#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
+NM_SETTING_WIRELESS_SECURITY_KEY_MGMT
+#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
-NM_SETTING_WIRELESS_SECURITY_ERROR
-#define NM_SETTING_WIRELESS_SECURITY_ERROR nm_setting_wireless_security_error_quark ()
+NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX
+#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
-NM_SETTING_WIRELESS_SECURITY_GROUP
-#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
+NM_SETTING_WIRELESS_SECURITY_AUTH_ALG
+#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
-NM_SETTING_WIRELESS_SECURITY_KEY_MGMT
-#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
+NM_SETTING_WIRELESS_SECURITY_PROTO
+#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
-NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
-#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
+NM_SETTING_WIRELESS_SECURITY_PAIRWISE
+#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
-NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS
-#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
+NM_SETTING_WIRELESS_SECURITY_GROUP
+#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
@@ -396,148 +414,184 @@ the actual WEP key using the MD5 hash algorithm.
-NM_SETTING_WIRELESS_SECURITY_PAIRWISE
-#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY0
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
-NM_SETTING_WIRELESS_SECURITY_PROTO
-#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY1
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
-NM_SETTING_WIRELESS_SECURITY_PSK
-#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY2
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
-NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
-#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY3
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
-NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
-#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY0
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
+NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE
+#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY1
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
+NM_SETTING_WIRELESS_SECURITY_PSK
+#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY2
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
+NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
+#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY3
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
+NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
+#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
+NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS
+#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
-NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE
-#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
-
+NMSettingWirelessSecurity
+typedef struct _NMSettingWirelessSecurity NMSettingWirelessSecurity;
-NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX
-#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
+NMSettingWirelessSecurityClass
+typedef struct {
+ NMSettingClass parent;
+
+ /* Padding for future expansion */
+ void (*_reserved1) (void);
+ void (*_reserved2) (void);
+ void (*_reserved3) (void);
+ void (*_reserved4) (void);
+} NMSettingWirelessSecurityClass;
-nm_setting_wireless_security_add_group ()
-gboolean nm_setting_wireless_security_add_group
- (NMSettingWirelessSecurity *setting,
- const char *group);
+nm_setting_wireless_security_new ()
+NMSetting * nm_setting_wireless_security_new (void);
-Adds an encryption algorithm to the list of allowed groupwise encryption
-algorithms. If the list is not empty, then only access points that support
-one or more of the encryption algorithms in the list will be considered
-compatible with this connection.
+Creates a new NMSettingWirelessSecurity object with default values.
-
+
+
-
-
-setting :
-the NMSettingWirelessSecurity
-
-
+
+
+
+Returns :
+the new empty NMSettingWirelessSecurity object. [transfer full]
+
+
+
+
+
+
+nm_setting_wireless_security_get_key_mgmt ()
+const char * nm_setting_wireless_security_get_key_mgmt
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
+
+
-group :
-the encryption algorithm to add, one of "wep40", "wep104",
-"tkip", or "ccmp"
+setting :
+the NMSettingWirelessSecurity
+
Returns :
-
-TRUE if the algorithm was added to the list, FALSE if it was
-already in the list
+the "key-mgmt" property of the setting
-nm_setting_wireless_security_add_pairwise ()
-gboolean nm_setting_wireless_security_add_pairwise
+nm_setting_wireless_security_get_num_protos ()
+guint32 nm_setting_wireless_security_get_num_protos
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
+
+
+
+setting :
+the NMSettingWirelessSecurity
+
+
+
+Returns :
+the number of security protocols this connection allows when
+connecting to secure WiFi networks
+
+
+
+
+
+
+nm_setting_wireless_security_get_proto ()
+const char * nm_setting_wireless_security_get_proto
(NMSettingWirelessSecurity *setting,
- const char *pairwise);
-
-Adds an encryption algorithm to the list of allowed pairwise encryption
-algorithms. If the list is not empty, then only access points that support
-one or more of the encryption algorithms in the list will be considered
-compatible with this connection.
-
-
+ guint32 i);
+
+
+
+
setting :
@@ -545,15 +599,13 @@ compatible with this connection.
-pairwise :
-the encryption algorithm to add, one of "wep40", "wep104",
-"tkip", or "ccmp"
+i :
+an index into the protocol list
Returns :
-
-TRUE if the algorithm was added to the list, FALSE if it was
-already in the list
+the protocol at index i
+
@@ -572,8 +624,11 @@ protocol list contains only "wpa" but the access point for the SSID specified
by this connection only supports WPA2/RSN, the connection cannot be used
with the access point.
-
+
+
+
+
setting :
@@ -595,38 +650,29 @@ protocol list, or
-nm_setting_wireless_security_clear_groups ()
-void nm_setting_wireless_security_clear_groups
- (NMSettingWirelessSecurity *setting);
-
-Removes all algorithms from the allowed list. If there are no algorithms
-specified then all groupwise encryption algorithms are allowed.
-
-
-
-
-setting :
-the NMSettingWirelessSecurity
-
-
-
-
-
-
-nm_setting_wireless_security_clear_pairwise ()
-void nm_setting_wireless_security_clear_pairwise
- (NMSettingWirelessSecurity *setting);
+nm_setting_wireless_security_remove_proto ()
+void nm_setting_wireless_security_remove_proto
+ (NMSettingWirelessSecurity *setting,
+ guint32 i);
-Removes all algorithms from the allowed list. If there are no algorithms
-specified then all pairwise encryption algorithms are allowed.
+Removes a protocol from the allowed protocol list.
-
+
+
-
+
+
+
+
setting :
the NMSettingWirelessSecurity
-
+
+
+i :
+index of the protocol to remove
+
+
@@ -638,8 +684,11 @@ specified then all pairwise encryption algorithms are allowed.
Removes all protocols from the allowed list. If there are no protocols
specified then all protocols are allowed.
-
+
+
+
+
setting :
the NMSettingWirelessSecurity
@@ -649,27 +698,14 @@ specified then all protocols are allowed.
-nm_setting_wireless_security_error_quark ()
-GQuark nm_setting_wireless_security_error_quark
- (void);
-
-Registers an error quark for NMSettingWired if necessary.
-
-
-
-
-Returns :
-the error quark used for NMSettingWired errors.
-
-
-
-
-
-nm_setting_wireless_security_get_auth_alg ()
-const char * nm_setting_wireless_security_get_auth_alg
+nm_setting_wireless_security_get_num_pairwise ()
+guint32 nm_setting_wireless_security_get_num_pairwise
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -678,23 +714,26 @@ Registers an error quark for Returns :
-the "auth-alg" property of the setting
+the number of pairwise encryption algorithms in the allowed list
-nm_setting_wireless_security_get_group ()
-const char * nm_setting_wireless_security_get_group
+nm_setting_wireless_security_get_pairwise ()
+const char * nm_setting_wireless_security_get_pairwise
(NMSettingWirelessSecurity *setting,
guint32 i);
-Returns the allowed groupwise encryption algorithm from allowed algorithm
+Returns the allowed pairwise encryption algorithm from allowed algorithm
list.
-
+
+
+
+
setting :
@@ -703,11 +742,11 @@ list.
i :
-index of an item in the allowed groupwise encryption algorithm list
+index of an item in the allowed pairwise encryption algorithm list
Returns :
-the groupwise encryption algorithm at index i
+ the pairwise encryption algorithm at index i
@@ -715,11 +754,21 @@ list.
-nm_setting_wireless_security_get_key_mgmt ()
-const char * nm_setting_wireless_security_get_key_mgmt
- (NMSettingWirelessSecurity *setting);
-
+nm_setting_wireless_security_add_pairwise ()
+gboolean nm_setting_wireless_security_add_pairwise
+ (NMSettingWirelessSecurity *setting,
+ const char *pairwise);
+
+Adds an encryption algorithm to the list of allowed pairwise encryption
+algorithms. If the list is not empty, then only access points that support
+one or more of the encryption algorithms in the list will be considered
+compatible with this connection.
+
+
+
+
+
setting :
@@ -727,39 +776,34 @@ list.
-Returns :
-the "key-mgmt" property of the setting
-
-
-
-
-
-
-nm_setting_wireless_security_get_leap_password ()
-const char * nm_setting_wireless_security_get_leap_password
- (NMSettingWirelessSecurity *setting);
-
-
-
-
-setting :
-the NMSettingWirelessSecurity
-
+pairwise :
+the encryption algorithm to add, one of "wep40", "wep104",
+"tkip", or "ccmp"
Returns :
-the "leap-password" property of the setting
+
+TRUE if the algorithm was added to the list, FALSE if it was
+already in the list
-nm_setting_wireless_security_get_leap_password_flags ()
-NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
- (NMSettingWirelessSecurity *setting);
-
+nm_setting_wireless_security_remove_pairwise ()
+void nm_setting_wireless_security_remove_pairwise
+ (NMSettingWirelessSecurity *setting,
+ guint32 i);
+
+Removes an encryption algorithm from the allowed pairwise encryption
+algorithm list.
+
+
+
+
+
setting :
@@ -767,32 +811,31 @@ list.
-Returns :
-the NMSettingSecretFlags pertaining to the
-"leap-password"
-
+i :
+the index of an item in the allowed pairwise encryption algorithm list
-nm_setting_wireless_security_get_leap_username ()
-const char * nm_setting_wireless_security_get_leap_username
+nm_setting_wireless_security_clear_pairwise ()
+void nm_setting_wireless_security_clear_pairwise
(NMSettingWirelessSecurity *setting);
-
+
+Removes all algorithms from the allowed list. If there are no algorithms
+specified then all pairwise encryption algorithms are allowed.
+
+
+
-
-
+
+
+
setting :
the NMSettingWirelessSecurity
-
-
-Returns :
-the "leap-username" property of the setting
-
-
+
@@ -800,8 +843,11 @@ list.
nm_setting_wireless_security_get_num_groups ()
guint32 nm_setting_wireless_security_get_num_groups
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -817,11 +863,19 @@ list.
-nm_setting_wireless_security_get_num_pairwise ()
-guint32 nm_setting_wireless_security_get_num_pairwise
- (NMSettingWirelessSecurity *setting);
-
+nm_setting_wireless_security_get_group ()
+const char * nm_setting_wireless_security_get_group
+ (NMSettingWirelessSecurity *setting,
+ guint32 i);
+
+Returns the allowed groupwise encryption algorithm from allowed algorithm
+list.
+
+
+
+
+
setting :
@@ -829,19 +883,34 @@ list.
+i :
+index of an item in the allowed groupwise encryption algorithm list
+
+
Returns :
-the number of pairwise encryption algorithms in the allowed list
+the groupwise encryption algorithm at index i
+
-nm_setting_wireless_security_get_num_protos ()
-guint32 nm_setting_wireless_security_get_num_protos
- (NMSettingWirelessSecurity *setting);
-
+nm_setting_wireless_security_add_group ()
+gboolean nm_setting_wireless_security_add_group
+ (NMSettingWirelessSecurity *setting,
+ const char *group);
+
+Adds an encryption algorithm to the list of allowed groupwise encryption
+algorithms. If the list is not empty, then only access points that support
+one or more of the encryption algorithms in the list will be considered
+compatible with this connection.
+
+
+
+
+
setting :
@@ -849,25 +918,34 @@ list.
+group :
+the encryption algorithm to add, one of "wep40", "wep104",
+"tkip", or "ccmp"
+
+
Returns :
-the number of security protocols this connection allows when
-connecting to secure WiFi networks
+
+TRUE if the algorithm was added to the list, FALSE if it was
+already in the list
-nm_setting_wireless_security_get_pairwise ()
-const char * nm_setting_wireless_security_get_pairwise
+nm_setting_wireless_security_remove_group ()
+void nm_setting_wireless_security_remove_group
(NMSettingWirelessSecurity *setting,
guint32 i);
-Returns the allowed pairwise encryption algorithm from allowed algorithm
-list.
+Removes an encryption algorithm from the allowed groupwise encryption
+algorithm list.
-
+
+
+
+
setting :
@@ -876,40 +954,30 @@ list.
i :
-index of an item in the allowed pairwise encryption algorithm list
-
-
-Returns :
-the pairwise encryption algorithm at index i
-
+the index of an item in the allowed groupwise encryption algorithm list
-nm_setting_wireless_security_get_proto ()
-const char * nm_setting_wireless_security_get_proto
- (NMSettingWirelessSecurity *setting,
- guint32 i);
-
+nm_setting_wireless_security_clear_groups ()
+void nm_setting_wireless_security_clear_groups
+ (NMSettingWirelessSecurity *setting);
+
+Removes all algorithms from the allowed list. If there are no algorithms
+specified then all groupwise encryption algorithms are allowed.
+
+
+
-
-
+
+
+
setting :
the NMSettingWirelessSecurity
-
-
-i :
-an index into the protocol list
-
-
-Returns :
-the protocol at index i
-
-
-
+
@@ -917,8 +985,11 @@ list.
nm_setting_wireless_security_get_psk ()
const char * nm_setting_wireless_security_get_psk
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -937,8 +1008,11 @@ list.
nm_setting_wireless_security_get_psk_flags ()
NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -956,12 +1030,14 @@ list.
-nm_setting_wireless_security_get_wep_key ()
-const char * nm_setting_wireless_security_get_wep_key
- (NMSettingWirelessSecurity *setting,
- guint32 idx);
-
+nm_setting_wireless_security_get_leap_username ()
+const char * nm_setting_wireless_security_get_leap_username
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
setting :
@@ -969,23 +1045,22 @@ list.
-idx :
-the WEP key index (0..3 inclusive)
-
-
Returns :
-the WEP key at the given index
+the "leap-username" property of the setting
-nm_setting_wireless_security_get_wep_key_flags ()
-NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
+nm_setting_wireless_security_get_leap_password ()
+const char * nm_setting_wireless_security_get_leap_password
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -994,18 +1069,21 @@ list.
Returns :
-the NMSettingSecretFlags pertaining to the all WEP keys
+the "leap-password" property of the setting
-nm_setting_wireless_security_get_wep_key_type ()
-NMWepKeyType nm_setting_wireless_security_get_wep_key_type
+nm_setting_wireless_security_get_leap_password_flags ()
+NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
(NMSettingWirelessSecurity *setting);
-
+
+
+
+
setting :
@@ -1014,18 +1092,24 @@ list.
Returns :
-the "wep-key-type" property of the setting
+the NMSettingSecretFlags pertaining to the
+"leap-password"
+
-nm_setting_wireless_security_get_wep_tx_keyidx ()
-guint32 nm_setting_wireless_security_get_wep_tx_keyidx
- (NMSettingWirelessSecurity *setting);
-
+nm_setting_wireless_security_get_wep_key ()
+const char * nm_setting_wireless_security_get_wep_key
+ (NMSettingWirelessSecurity *setting,
+ guint32 idx);
+
+
+
+
setting :
@@ -1033,40 +1117,60 @@ list.
+idx :
+the WEP key index (0..3 inclusive)
+
+
Returns :
-the "wep-tx-keyidx" property of the setting
+the WEP key at the given index
-nm_setting_wireless_security_new ()
-NMSetting * nm_setting_wireless_security_new (void);
+nm_setting_wireless_security_set_wep_key ()
+void nm_setting_wireless_security_set_wep_key
+ (NMSettingWirelessSecurity *setting,
+ guint32 idx,
+ const char *key);
-Creates a new NMSettingWirelessSecurity object with default values.
+Sets a WEP key in the given index.
-
+
+
-
-Returns :
-the new empty NMSettingWirelessSecurity object. [transfer full]
+
+
+
+
+setting :
+the NMSettingWirelessSecurity
-
+
+
+idx :
+the index of the key (0..3 inclusive)
+
+
+key :
+the WEP key as a string, in either hexadecimal, ASCII, or passphrase
+form as determiend by the value of the "wep-key-type"
+property.
+
+
-nm_setting_wireless_security_remove_group ()
-void nm_setting_wireless_security_remove_group
- (NMSettingWirelessSecurity *setting,
- guint32 i);
-
-Removes an encryption algorithm from the allowed groupwise encryption
-algorithm list.
-
-
+nm_setting_wireless_security_get_wep_tx_keyidx ()
+guint32 nm_setting_wireless_security_get_wep_tx_keyidx
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
setting :
@@ -1074,24 +1178,22 @@ algorithm list.
-i :
-the index of an item in the allowed groupwise encryption algorithm list
+Returns :
+the "wep-tx-keyidx" property of the setting
-nm_setting_wireless_security_remove_pairwise ()
-void nm_setting_wireless_security_remove_pairwise
- (NMSettingWirelessSecurity *setting,
- guint32 i);
-
-Removes an encryption algorithm from the allowed pairwise encryption
-algorithm list.
-
-
+nm_setting_wireless_security_get_auth_alg ()
+const char * nm_setting_wireless_security_get_auth_alg
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
setting :
@@ -1099,23 +1201,22 @@ algorithm list.
-i :
-the index of an item in the allowed pairwise encryption algorithm list
+Returns :
+the "auth-alg" property of the setting
-nm_setting_wireless_security_remove_proto ()
-void nm_setting_wireless_security_remove_proto
- (NMSettingWirelessSecurity *setting,
- guint32 i);
-
-Removes a protocol from the allowed protocol list.
-
-
+nm_setting_wireless_security_get_wep_key_flags ()
+NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
setting :
@@ -1123,24 +1224,22 @@ Removes a protocol from the allowed protocol list.
-i :
-index of the protocol to remove
+Returns :
+the NMSettingSecretFlags pertaining to the all WEP keys
-nm_setting_wireless_security_set_wep_key ()
-void nm_setting_wireless_security_set_wep_key
- (NMSettingWirelessSecurity *setting,
- guint32 idx,
- const char *key);
-
-Sets a WEP key in the given index.
-
-
+nm_setting_wireless_security_get_wep_key_type ()
+NMWepKeyType nm_setting_wireless_security_get_wep_key_type
+ (NMSettingWirelessSecurity *setting);
+
+
+
+
setting :
@@ -1148,14 +1247,8 @@ Sets a WEP key in the given index.
-idx :
-the index of the key (0..3 inclusive)
-
-
-key :
-the WEP key as a string, in either hexadecimal, ASCII, or passphrase
-form as determiend by the value of the "wep-key-type"
-property.
+Returns :
+the "wep-key-type" property of the setting
@@ -1180,9 +1273,10 @@ the 'leap-username' and 'leap-password' properties must be specified.
The "group" property
"group" GSList_gchararray_* : Read / Write
-If specified, will only connect to WPA networks that provide the
-specified group/multicast encryption capabilities. Each element may be
-one of 'wep40', 'wep104', 'tkip', or 'ccmp'.
+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
+list element may be one of 'wep40', 'wep104', 'tkip', or 'ccmp'.
@@ -1232,9 +1326,10 @@ The login username for legacy LEAP connections (ie, key-mgmt =
The "pairwise" property
"pairwise" GSList_gchararray_* : Read / Write
-If specified, will only connect to WPA networks that provide the
-specified pairwise encryption capabilities. Each element may be one of
-'wep40', 'wep104', 'tkip', or 'ccmp'.
+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 may
+be one of 'wep40', 'wep104', 'tkip', or 'ccmp'.
@@ -1353,6 +1448,6 @@ Linksys WRT54G) number the keys 1 - 4.
+ Generated by GTK-Doc V1.19