libnm-util Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME enum NMSettingWirelessSecurityError; #define NM_TYPE_SETTING_WIRELESS_SECURITY_ERROR #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_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 NMSettingWirelessSecurity; NMSettingWirelessSecurityClass; GType nm_setting_wireless_security_get_type (void
); 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
); 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
); 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
); 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
);
GEnum +----NMSettingWirelessSecurityError
GObject +----NMSetting +----NMSettingWirelessSecurity
"auth-alg" gchar* : Read / Write "group" GSList_gchararray_* : Read / Write "key-mgmt" gchar* : Read / Write "leap-password" gchar* : Read / Write "leap-password-flags" guint : Read / Write "leap-username" gchar* : Read / Write "pairwise" GSList_gchararray_* : Read / Write "proto" GSList_gchararray_* : Read / Write "psk" gchar* : Read / Write "psk-flags" guint : Read / Write "wep-key-flags" guint : Read / Write "wep-key-type" guint : 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
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
typedef enum { NM_SETTING_WIRELESS_SECURITY_ERROR_UNKNOWN = 0, NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_PROPERTY, NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_802_1X_SETTING, NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_802_1X, NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_USERNAME, NM_SETTING_WIRELESS_SECURITY_ERROR_SHARED_KEY_REQUIRES_WEP } NMSettingWirelessSecurityError;
#define NM_TYPE_SETTING_WIRELESS_SECURITY_ERROR (nm_setting_wireless_security_error_get_type ())
#define NM_SETTING_WIRELESS_SECURITY_ERROR nm_setting_wireless_security_error_quark ()
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;
#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
typedef struct { NMSettingClass parent; /* Padding for future expansion */ void (*_reserved1) (void); void (*_reserved2) (void); void (*_reserved3) (void); void (*_reserved4) (void); } NMSettingWirelessSecurityClass;
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
);
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
);
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
);
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
);
|
the NMSettingWirelessSecurity |
Returns : |
the NMSettingSecretFlags pertaining to the "psk" |
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
);
|
the NMSettingWirelessSecurity |
Returns : |
the NMSettingSecretFlags pertaining to the "leap-password" |
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
);
|
the NMSettingWirelessSecurity |
Returns : |
the NMSettingSecretFlags pertaining to the all WEP keys |
NMWepKeyType nm_setting_wireless_security_get_wep_key_type
(NMSettingWirelessSecurity *setting
);
"auth-alg"
property"auth-alg" gchar* : Read / Write
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
"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'.
"key-mgmt"
property"key-mgmt" gchar* : Read / Write
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 WiFi connection that uses security.
Default value: NULL
"leap-password"
property"leap-password" gchar* : Read / Write
The login password for legacy LEAP connections (ie, key-mgmt = 'ieee8021x' and auth-alg = 'leap').
Default value: NULL
"leap-password-flags"
property"leap-password-flags" guint : Read / Write
Flags indicating how to handle "leap-password".
Allowed values: <= 7
Default value: 0
"leap-username"
property"leap-username" gchar* : Read / Write
The login username for legacy LEAP connections (ie, key-mgmt = 'ieee8021x' and auth-alg = 'leap').
Default value: NULL
"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'.
"proto"
property "proto" GSList_gchararray_* : Read / Write
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.
"psk"
property"psk" gchar* : Read / Write
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 WiFi network.
Default value: NULL
"psk-flags"
property"psk-flags" guint : Read / Write
Flags indicating how to handle "psk"
Allowed values: <= 7
Default value: 0
"wep-key-flags"
property"wep-key-flags" guint : Read / Write
Flags indicating how to handle NMSettingWirelessSecurity WEP keys.
Allowed values: <= 7
Default value: 0
"wep-key-type"
property"wep-key-type" guint : Read / Write / Construct
Controls the interpretation of WEP keys. Allowed values are 1 (interpret WEP keys as hexadecimal or ASCII keys) or 2 (interpret WEP keys as WEP Passphrases). If set to 1 and the keys are hexadecimal, they must be either 10 or 26 characters in length. If set to 1 and the keys are ASCII keys, they must be either 5 or 13 characters in length. If set to 2, the passphrase is hashed using the de-facto MD5 method to derive the actual WEP key.
Allowed values: <= 2
Default value: 0
"wep-key0"
property"wep-key0" gchar* : Read / Write
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
"wep-key1"
property"wep-key1" gchar* : Read / Write
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
"wep-key2"
property"wep-key2" gchar* : Read / Write
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
"wep-key3"
property"wep-key3" gchar* : Read / Write
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
"wep-tx-keyidx"
property"wep-tx-keyidx" guint : Read / Write / Construct
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.
Allowed values: <= 3
Default value: 0