NMSettingWirelessSecurity

@@ -38,1406 +32,1763 @@

NMSettingWirelessSecurity — Describes connection properties for Wi-Fi networks that use WEP, LEAP, WPA or WPA2/RSN security

- +

Synopsis

#define             NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
-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_PROTO
-#define             NM_SETTING_WIRELESS_SECURITY_PAIRWISE
-#define             NM_SETTING_WIRELESS_SECURITY_GROUP
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME
-#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_PSK
-#define             NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS
-struct              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,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_remove_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_proto_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_clear_protos
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_remove_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_pairwise_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_clear_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_groups
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-void                nm_setting_wireless_security_remove_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_group_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-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_leap_username
-                                                        (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_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         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);
-

Object Hierarchy

-  GEnum
-   +----NMWepKeyType
-

-  GObject
-   +----NMSetting
-         +----NMSettingWirelessSecurity
-

Properties

-  "auth-alg"                 gchar*                : Read / Write
-  "group"                    GStrv                 : Read / Write
-  "key-mgmt"                 gchar*                : Read / Write
-  "leap-password"            gchar*                : Read / Write
-  "leap-password-flags"      NMSettingSecretFlags  : Read / Write
-  "leap-username"            gchar*                : Read / Write
-  "pairwise"                 GStrv                 : Read / Write
-  "proto"                    GStrv                 : Read / Write
-  "psk"                      gchar*                : Read / Write
-  "psk-flags"                NMSettingSecretFlags  : Read / Write
-  "wep-key-flags"            NMSettingSecretFlags  : Read / Write
-  "wep-key-type"             NMWepKeyType          : Read / Write / Construct
-  "wep-key0"                 gchar*                : Read / Write
-  "wep-key1"                 gchar*                : Read / Write
-  "wep-key2"                 gchar*                : Read / Write
-  "wep-key3"                 gchar*                : Read / Write
-  "wep-tx-keyidx"            guint                 : Read / Write / Construct
-

Description

-The NMSettingWirelessSecurity object is a NMSetting subclass that describes -properties necessary for connection to encrypted Wi-Fi networks. -

-It's a good idea to read up on wpa_supplicant configuration before using this -setting extensively, since most of the options here correspond closely with -the relevant wpa_supplicant configuration options. To get a better overview -of how Wi-Fi security works, you may want to get copies of the following books. -

- 802.11 Wireless Networks: The Definitive Guide, Second Edition - Author: Matthew Gast - ISBN: 978-0596100520 -

- Cisco Wireless LAN Security - Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky - ISBN: 978-1587051548 -

Details

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
-

enum NMWepKeyType

typedef enum {
-	NM_WEP_KEY_TYPE_UNKNOWN = 0,
-	NM_WEP_KEY_TYPE_KEY = 1,          /* Hex or ASCII */
-	NM_WEP_KEY_TYPE_PASSPHRASE = 2,   /* 104/128-bit Passphrase */
-
-	NM_WEP_KEY_TYPE_LAST = NM_WEP_KEY_TYPE_PASSPHRASE
-} 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 -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 -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 -keys are hashed differently to determine the actual WEP key the type must be -specified. -

Functions

--++ - - + - - + - - + - - + - -

`NM_WEP_KEY_TYPE_UNKNOWN`	unknown WEP key type +	+NMSetting * +	+nm_setting_wireless_security_new ()
`NM_WEP_KEY_TYPE_KEY`	indicates a hexadecimal or ASCII formatted WEP key. -Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or -"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII -characters (ie "abcde" or "blahblah99$*1"). +	const char * +	+nm_setting_wireless_security_get_key_mgmt ()
`NM_WEP_KEY_TYPE_PASSPHRASE`	indicates a WEP passphrase (ex "I bought a duck -on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII -key. Passphrases are between 8 and 64 characters inclusive and are hashed -the actual WEP key using the MD5 hash algorithm. +	+guint32 +	+nm_setting_wireless_security_get_num_protos ()
`NM_WEP_KEY_TYPE_LAST`	placeholder value for bounds-checking +	const char * +	+nm_setting_wireless_security_get_proto ()

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
-

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
-

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
-

NM_SETTING_WIRELESS_SECURITY_PROTO

#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
-

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
-

NM_SETTING_WIRELESS_SECURITY_GROUP

#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
-

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
-

NM_SETTING_WIRELESS_SECURITY_PSK

#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
-

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
-

struct NMSettingWirelessSecurity

struct NMSettingWirelessSecurity;

NMSettingWirelessSecurityClass

typedef struct {
-	NMSettingClass parent;
-} NMSettingWirelessSecurityClass;
-

nm_setting_wireless_security_new ()

NMSetting *         nm_setting_wireless_security_new    (void);

-Creates a new NMSettingWirelessSecurity object with default values. -

---- - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + +

Returns :	the new empty NMSettingWirelessSecurity object. [transfer full] +
+gboolean +	+nm_setting_wireless_security_add_proto () +
+void +	+nm_setting_wireless_security_remove_proto () +
+gboolean +	+nm_setting_wireless_security_remove_proto_by_value () +
+void +	+nm_setting_wireless_security_clear_protos () +
+guint32 +	+nm_setting_wireless_security_get_num_pairwise () +
const char * +	+nm_setting_wireless_security_get_pairwise () +
+gboolean +	+nm_setting_wireless_security_add_pairwise () +
+void +	+nm_setting_wireless_security_remove_pairwise () +
+gboolean +	+nm_setting_wireless_security_remove_pairwise_by_value () +
+void +	+nm_setting_wireless_security_clear_pairwise () +
+guint32 +	+nm_setting_wireless_security_get_num_groups () +
const char * +	+nm_setting_wireless_security_get_group () +
+gboolean +	+nm_setting_wireless_security_add_group () +
+void +	+nm_setting_wireless_security_remove_group () +
+gboolean +	+nm_setting_wireless_security_remove_group_by_value () +
+void +	+nm_setting_wireless_security_clear_groups () +
const char * +	+nm_setting_wireless_security_get_psk () +
+NMSettingSecretFlags +	+nm_setting_wireless_security_get_psk_flags () +
const char * +	+nm_setting_wireless_security_get_leap_username () +
const char * +	+nm_setting_wireless_security_get_leap_password () +
+NMSettingSecretFlags +	+nm_setting_wireless_security_get_leap_password_flags () +
const char * +	+nm_setting_wireless_security_get_wep_key () +
+void
+nm_setting_wireless_security_set_wep_key () +
+guint32 +	+nm_setting_wireless_security_get_wep_tx_keyidx () +
const char * +	+nm_setting_wireless_security_get_auth_alg () +
+NMSettingSecretFlags +	+nm_setting_wireless_security_get_wep_key_flags () +
+NMWepKeyType +	+nm_setting_wireless_security_get_wep_key_type () +

nm_setting_wireless_security_get_key_mgmt ()

const char *        nm_setting_wireless_security_get_key_mgmt
-                                                        (NMSettingWirelessSecurity *setting);

Properties

--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + +

`setting` :	the NMSettingWirelessSecurity -	+gchar *	auth-alg	Read / Write
GStrv	group	Read / Write
+gchar *	key-mgmt	Read / Write
+gchar *	leap-password	Read / Write
NMSettingSecretFlags	leap-password-flags	Read / Write
+gchar *	leap-username	Read / Write
GStrv	pairwise	Read / Write
GStrv	proto	Read / Write
+gchar *	psk	Read / Write
NMSettingSecretFlags	psk-flags	Read / Write
NMSettingSecretFlags	wep-key-flags	Read / Write
NMWepKeyType	wep-key-type	Read / Write / Construct
+gchar *	wep-key0	Read / Write
+gchar *	wep-key1	Read / Write
+gchar *	wep-key2	Read / Write
+gchar *	wep-key3	Read / Write
Returns :	the "key-mgmt" property of the setting	guint	wep-tx-keyidx	Read / Write / Construct

nm_setting_wireless_security_get_num_protos ()

guint32             nm_setting_wireless_security_get_num_protos
-                                                        (NMSettingWirelessSecurity *setting);

Types and Values

--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + +

`setting` :	the NMSettingWirelessSecurity -	#define	NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
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_PROTO
#define	NM_SETTING_WIRELESS_SECURITY_PAIRWISE
#define	NM_SETTING_WIRELESS_SECURITY_GROUP
#define	NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME
#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_PSK
#define	NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
#define	NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
Returns :	the number of security protocols this connection allows when -connecting to secure Wi-Fi networks	#define	NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

Object Hierarchy

    GEnum
+    ╰── NMWepKeyType
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWirelessSecurity
+

Description

The NMSettingWirelessSecurity object is a NMSetting subclass that describes +properties necessary for connection to encrypted Wi-Fi networks.

It's a good idea to read up on wpa_supplicant configuration before using this +setting extensively, since most of the options here correspond closely with +the relevant wpa_supplicant configuration options. To get a better overview +of how Wi-Fi security works, you may want to get copies of the following books.

802.11 Wireless Networks: The Definitive Guide, Second Edition + Author: Matthew Gast + ISBN: 978-0596100520

Cisco Wireless LAN Security + Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky + ISBN: 978-1587051548

Functions

nm_setting_wireless_security_new ()

NMSetting *
+nm_setting_wireless_security_new (void);

Creates a new NMSettingWirelessSecurity object with default values.

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);

Parameters

+++++ + + + + + +

setting

the NMSettingWirelessSecurity

Returns

the “key-mgmt” property of the setting

nm_setting_wireless_security_get_num_protos ()

guint32
+nm_setting_wireless_security_get_num_protos
+                               (NMSettingWirelessSecurity *setting);

Parameters

+++++ + + + + + +

setting

the NMSettingWirelessSecurity

Returns

the number of security protocols this connection allows when +connecting to secure Wi-Fi networks

nm_setting_wireless_security_get_proto ()

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

nm_setting_wireless_security_get_proto ()

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

Parameters

--+++ - - - - - - + + + - - + + +

`setting` :	the NMSettingWirelessSecurity -
`i` :	an index into the protocol list	setting	the NMSettingWirelessSecurity
Returns :	the protocol at index `i` -	i	an index into the protocol list

Returns

the protocol at index i +

nm_setting_wireless_security_add_proto ()

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

-Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; +

nm_setting_wireless_security_add_proto ()

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

Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; only protocols in this list will be used when finding and connecting to the Wi-Fi network specified by this connection. For example, if the 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. -

+with the access point.

Parameters

--+++ - - - - - - + + + - - + + +

`setting` :	the NMSettingWirelessSecurity -
`proto` :	the protocol to add, one of "wpa" or "rsn"	setting	the NMSettingWirelessSecurity
Returns :	-`TRUE` if the protocol was new and and was added to the allowed -protocol list, or `FALSE` if it was already in the list	proto	the protocol to add, one of "wpa" or "rsn"

Returns

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

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_remove_proto ()

void
+nm_setting_wireless_security_remove_proto
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);

Removes a protocol from the allowed protocol list.

Parameters

--+++ - - + + + - - + + +

`setting` :	the NMSettingWirelessSecurity -	setting	the NMSettingWirelessSecurity
`i` :	index of the protocol to remove	i	index of the protocol to remove

Property Details

The `"auth-alg"` property

  "auth-alg"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
+

-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 -using Cisco LEAP (ie, key-mgmt = "ieee8021x" and auth-alg = "leap") the -"leap-username" and "leap-password" properties must be specified.

Default value: NULL

The `"group"` property

  "group"                    GStrv                 : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
+

-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".

The `"key-mgmt"` property

  "key-mgmt"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
+

-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.

Default value: NULL

The `"leap-password"` property

  "leap-password"            gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_PROTO

#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
+

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

Default value: NULL

The `"leap-password-flags"` property

  "leap-password-flags"      NMSettingSecretFlags  : Read / Write

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
+

-Flags indicating how to handle the -"leap-password" property.

The `"leap-username"` property

  "leap-username"            gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_GROUP

#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
+

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

Default value: NULL

The `"pairwise"` property

  "pairwise"                 GStrv                 : Read / Write

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
+

-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 "tkip" or "ccmp".

The `"proto"` property

  "proto"                    GStrv                 : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
+

-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.

The `"psk"` property

  "psk"                      gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
+

-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.

Default value: NULL

The `"psk-flags"` property

  "psk-flags"                NMSettingSecretFlags  : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
+

-Flags indicating how to handle the "psk" -property.

The `"wep-key-flags"` property

  "wep-key-flags"            NMSettingSecretFlags  : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
+

-Flags indicating how to handle the "wep-key0", -"wep-key1", "wep-key2", -and "wep-key3" properties.

The `"wep-key-type"` property

  "wep-key-type"             NMWepKeyType          : Read / Write / Construct

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
+

-Controls the interpretation of WEP keys. Allowed values are -NM_WEP_KEY_TYPE_KEY, in which case the key is either a 10- or -26-character hexadecimal string, or a 5- or 13-character ASCII password; -or NM_WEP_KEY_TYPE_PASSPHRASE, in which case the passphrase is provided -as a string and will be hashed using the de-facto MD5 method to derive -the actual WEP key.

Default value: NM_WEP_KEY_TYPE_UNKNOWN

The `"wep-key0"` property

  "wep-key0"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
+

-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.

Default value: NULL

The `"wep-key1"` property

  "wep-key1"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_PSK

#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
+

-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.

Default value: NULL

The `"wep-key2"` property

  "wep-key2"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
+

-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.

Default value: NULL

The `"wep-key3"` property

  "wep-key3"                 gchar*                : Read / Write

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
+

-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.

Default value: NULL

The `"wep-tx-keyidx"` property

  "wep-tx-keyidx"            guint                 : Read / Write / Construct

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
+

-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 -Linksys WRT54G) number the keys 1 - 4.

Property Details

The `“auth-alg”` property

  “auth-alg”                 gchar *

Flags: Read / Write

Default value: NULL

The `“group”` property

  “group”                    GStrv

Flags: Read / Write

The `“key-mgmt”` property

  “key-mgmt”                 gchar *

Flags: Read / Write

Default value: NULL

The `“leap-password”` property

  “leap-password”            gchar *

Flags: Read / Write

Default value: NULL

The `“leap-password-flags”` property

  “leap-password-flags”      NMSettingSecretFlags

Flags: Read / Write

The `“leap-username”` property

  “leap-username”            gchar *

Flags: Read / Write

Default value: NULL

The `“pairwise”` property

  “pairwise”                 GStrv

Flags: Read / Write

The `“proto”` property

  “proto”                    GStrv

Flags: Read / Write

The `“psk”` property

  “psk”                      gchar *

Flags: Read / Write

Default value: NULL

The `“psk-flags”` property

  “psk-flags”                NMSettingSecretFlags

Flags: Read / Write

The `“wep-key-flags”` property

  “wep-key-flags”            NMSettingSecretFlags

Flags: Read / Write

The `“wep-key-type”` property

  “wep-key-type”             NMWepKeyType

Flags: Read / Write / Construct

Default value: NM_WEP_KEY_TYPE_UNKNOWN

The `“wep-key0”` property

  “wep-key0”                 gchar *

Flags: Read / Write

Default value: NULL

The `“wep-key1”` property

  “wep-key1”                 gchar *

Flags: Read / Write

Default value: NULL

The `“wep-key2”` property

  “wep-key2”                 gchar *

Flags: Read / Write

Default value: NULL

The `“wep-key3”` property

  “wep-key3”                 gchar *

Flags: Read / Write

Default value: NULL

The `“wep-tx-keyidx”` property

  “wep-tx-keyidx”            guint

Flags: Read / Write / Construct

Allowed values: <= 3

Default value: 0

@@ -1445,6 +1796,6 @@ Linksys WRT54G) number the keys 1 - 4.

			libnm Reference Manual
-Top - \| - Description - \| - Object Hierarchy - \| - Properties -

`setting` :	the NMSettingWirelessSecurity -
`pairwise` :	the encryption algorithm to add, one of "tkip" or "ccmp"	setting	the NMSettingWirelessSecurity
Returns :	-`TRUE` if the algorithm was added to the list, `FALSE` if it was -already in the list	pairwise	the encryption algorithm to add, one of "tkip" or "ccmp"

`setting` :	the NMSettingWirelessSecurity -
`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	group	the encryption algorithm to add, one of "wep40", "wep104", +"tkip", or "ccmp"

`setting` :	the NMSettingWirelessSecurity -
`idx` :	the WEP key index (0..3 inclusive)
Returns :	the WEP key at the given index
setting	the NMSettingWirelessSecurity

`setting` :	the NMSettingWirelessSecurity +	NM_WEP_KEY_TYPE_UNKNOWN	+ unknown WEP key type
Returns :	the NMSettingSecretFlags pertaining to the all WEP keys	NM_WEP_KEY_TYPE_KEY	+ indicates a hexadecimal or ASCII formatted WEP key. +Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or +"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII +characters (ie "abcde" or "blahblah99$*1"). +

`setting` :	the NMSettingWirelessSecurity +	NM_WEP_KEY_TYPE_PASSPHRASE	+ indicates a WEP passphrase (ex "I bought a duck +on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII +key. Passphrases are between 8 and 64 characters inclusive and are hashed +the actual WEP key using the MD5 hash algorithm.
Returns :	the "wep-key-type" property of the setting	NM_WEP_KEY_TYPE_LAST	+ placeholder value for bounds-checking +

Synopsis

Object Hierarchy

Properties

Description

Details

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

enum NMWepKeyType

Functions

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

NM_SETTING_WIRELESS_SECURITY_PROTO

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

NM_SETTING_WIRELESS_SECURITY_GROUP

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

NM_SETTING_WIRELESS_SECURITY_PSK

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

struct NMSettingWirelessSecurity

NMSettingWirelessSecurityClass

nm_setting_wireless_security_new ()

nm_setting_wireless_security_get_key_mgmt ()

Properties

nm_setting_wireless_security_get_num_protos ()

Types and Values

Object Hierarchy

Description

Functions

nm_setting_wireless_security_new ()

Returns

nm_setting_wireless_security_get_key_mgmt ()

Parameters

Returns

nm_setting_wireless_security_get_num_protos ()

Parameters

Returns

nm_setting_wireless_security_get_proto ()

nm_setting_wireless_security_get_proto ()

Parameters

Returns

nm_setting_wireless_security_add_proto ()

nm_setting_wireless_security_add_proto ()

Parameters

Returns

nm_setting_wireless_security_remove_proto ()

nm_setting_wireless_security_remove_proto ()

Parameters

nm_setting_wireless_security_remove_proto_by_value ()

nm_setting_wireless_security_remove_proto_by_value ()

Parameters

Returns

nm_setting_wireless_security_clear_protos ()

nm_setting_wireless_security_clear_protos ()

Parameters

nm_setting_wireless_security_get_num_pairwise ()

nm_setting_wireless_security_get_num_pairwise ()

Parameters

Returns

nm_setting_wireless_security_get_pairwise ()

nm_setting_wireless_security_get_pairwise ()

Parameters

Returns

nm_setting_wireless_security_add_pairwise ()

nm_setting_wireless_security_add_pairwise ()

Parameters

Returns

nm_setting_wireless_security_remove_pairwise ()

nm_setting_wireless_security_remove_pairwise ()

Parameters

nm_setting_wireless_security_remove_pairwise_by_value ()

nm_setting_wireless_security_remove_pairwise_by_value ()

Parameters

Returns