From 45cb5bb3c0e6edb887cf69b417fcaf7053814a9b Mon Sep 17 00:00:00 2001 From: Aron Xu Date: Tue, 20 Dec 2016 20:06:37 +0800 Subject: Imported Upstream version 1.4.4 --- docs/libnm/html/NMSetting8021x.html | 458 ++++++++++++++++++------------------ 1 file changed, 229 insertions(+), 229 deletions(-) (limited to 'docs/libnm/html/NMSetting8021x.html') diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index 3d134eaf..20def76f 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -3,7 +3,7 @@ NMSetting8021x: libnm Reference Manual - + @@ -35,7 +35,7 @@

Functions

-
+
@@ -59,7 +59,7 @@
-guint32 +guint32 nm_setting_802_1x_get_num_eap_methods () @@ -74,7 +74,7 @@
-gboolean +gboolean nm_setting_802_1x_add_eap_method () @@ -90,7 +90,7 @@
-gboolean +gboolean nm_setting_802_1x_remove_eap_method_by_value () @@ -127,7 +127,7 @@
-gboolean +gboolean nm_setting_802_1x_get_system_ca_certs () @@ -157,7 +157,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_ca_cert_blob () @@ -172,7 +172,7 @@
-gboolean +gboolean nm_setting_802_1x_set_ca_cert () @@ -187,7 +187,7 @@
-guint32 +guint32 nm_setting_802_1x_get_num_altsubject_matches () @@ -202,7 +202,7 @@
-gboolean +gboolean nm_setting_802_1x_add_altsubject_match () @@ -218,7 +218,7 @@
-gboolean +gboolean nm_setting_802_1x_remove_altsubject_match_by_value () @@ -249,7 +249,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_client_cert_blob () @@ -264,7 +264,7 @@
-gboolean +gboolean nm_setting_802_1x_set_client_cert () @@ -315,7 +315,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_phase2_ca_cert_blob () @@ -330,7 +330,7 @@
-gboolean +gboolean nm_setting_802_1x_set_phase2_ca_cert () @@ -345,7 +345,7 @@
-guint32 +guint32 nm_setting_802_1x_get_num_phase2_altsubject_matches () @@ -360,7 +360,7 @@
-gboolean +gboolean nm_setting_802_1x_add_phase2_altsubject_match () @@ -376,7 +376,7 @@
-gboolean +gboolean nm_setting_802_1x_remove_phase2_altsubject_match_by_value () @@ -407,7 +407,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_phase2_client_cert_blob () @@ -422,7 +422,7 @@
-gboolean +gboolean nm_setting_802_1x_set_phase2_client_cert () @@ -445,7 +445,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_password_raw () @@ -484,7 +484,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_private_key_blob () @@ -499,7 +499,7 @@
-gboolean +gboolean nm_setting_802_1x_set_private_key () @@ -538,7 +538,7 @@
-GBytes * +GBytes * nm_setting_802_1x_get_phase2_private_key_blob () @@ -553,7 +553,7 @@
-gboolean +gboolean nm_setting_802_1x_set_phase2_private_key () @@ -587,7 +587,7 @@

Properties

-
+
@@ -595,60 +595,60 @@ - + +gchar * +GBytes * +gchar * +GBytes * +gchar * - + +gchar * +gchar * +gchar * @@ -659,7 +659,7 @@ +GBytes * @@ -670,72 +670,72 @@ +gchar * +gchar * +gchar * - + +gchar * +gchar * +GBytes * +gchar * +GBytes * +gchar * +GBytes * +gchar * @@ -746,13 +746,13 @@ +gchar * +gchar * @@ -763,13 +763,13 @@ +GBytes * +gchar * @@ -780,12 +780,12 @@ +gchar * - + @@ -794,7 +794,7 @@

Types and Values

-
GStrvGStrv altsubject-matches Read / Write
-gchar * anonymous-identity Read / Write
-GBytes * ca-cert Read / Write
-gchar * ca-path Read / Write
-GBytes * client-cert Read / Write
-gchar * domain-suffix-match Read / Write
GStrvGStrv eap Read / Write
-gchar * identity Read / Write
-gchar * pac-file Read / Write
-gchar * password Read / Write
-GBytes * password-raw Read / Write
-gchar * phase1-fast-provisioning Read / Write
-gchar * phase1-peaplabel Read / Write
-gchar * phase1-peapver Read / Write
GStrvGStrv phase2-altsubject-matches Read / Write
-gchar * phase2-auth Read / Write
-gchar * phase2-autheap Read / Write
-GBytes * phase2-ca-cert Read / Write
-gchar * phase2-ca-path Read / Write
-GBytes * phase2-client-cert Read / Write
-gchar * phase2-domain-suffix-match Read / Write
-GBytes * phase2-private-key Read / Write
-gchar * phase2-private-key-password Read / Write
-gchar * phase2-subject-match Read / Write
-gchar * pin Read / Write
-GBytes * private-key Read / Write
-gchar * private-key-password Read / Write
-gchar * subject-match Read / Write
gbooleangboolean system-ca-certs Read / Write / Construct
+
@@ -964,7 +964,7 @@ 
    GEnum
     ├── NMSetting8021xCKFormat
     ╰── NMSetting8021xCKScheme
-    GObject
+    GObject
     ╰── NMSetting
         ╰── NMSetting8021x
@@ -1006,15 +1006,15 @@ nm_setting_802_1x_new (void

nm_setting_802_1x_check_cert_scheme ()

NMSetting8021xCKScheme
-nm_setting_802_1x_check_cert_scheme (gconstpointer pdata,
-                                     gsize length,
-                                     GError **error);
+nm_setting_802_1x_check_cert_scheme (gconstpointer pdata, + gsize length, + GError **error);

Determines and verifies the blob type. When setting certificate properties of NMSetting8021x the blob must be not UNKNOWN (or NULL).

Parameters

-
+
@@ -1049,7 +1049,7 @@ For NULL it also returns NM_SETTING_802_1X_CK_SCHEME_UNKNOWN.

nm_setting_802_1x_get_num_eap_methods ()

-
guint32
+
guint32
 nm_setting_802_1x_get_num_eap_methods (NMSetting8021x *setting);

 
Returns the number of eap methods allowed for use when connecting to the
 network.  Generally only one EAP method is used.  Use the functions
@@ -1058,7 +1058,7 @@ and 
 
Parameters

-
+
@@ -1081,12 +1081,12 @@ allowed EAP methods.

nm_setting_802_1x_get_eap_method ()

const char *
 nm_setting_802_1x_get_eap_method (NMSetting8021x *setting,
-                                  guint32 i);
+ guint32 i);

Returns the name of the allowed EAP method at index i .

Parameters

-
+
@@ -1115,7 +1115,7 @@ nm_setting_802_1x_get_eap_method (

nm_setting_802_1x_add_eap_method ()

-
gboolean
+
gboolean
 nm_setting_802_1x_add_eap_method (NMSetting8021x *setting,
                                   const char *eap);

 
Adds an allowed EAP method.  The setting is not valid until at least one
@@ -1123,7 +1123,7 @@ EAP method has been added.  See 
 
Parameters

-
+
@@ -1145,7 +1145,7 @@ allowed EAP methods.

Returns

-

TRUE if the EAP method was successfully added, FALSE if it was +

TRUE if the EAP method was successfully added, FALSE if it was not a valid method or if it was already allowed.

@@ -1154,11 +1154,11 @@ not a valid method or if it was already allowed.

nm_setting_802_1x_remove_eap_method ()

void
 nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
-                                     guint32 i);
+ guint32 i);

Removes the allowed EAP method at the specified index.

Parameters

-
+
@@ -1182,7 +1182,7 @@ nm_setting_802_1x_remove_eap_method (

nm_setting_802_1x_remove_eap_method_by_value ()

-
gboolean
+
gboolean
 nm_setting_802_1x_remove_eap_method_by_value
                                (NMSetting8021x *setting,
                                 const char *eap);

@@ -1190,7 +1190,7 @@ nm_setting_802_1x_remove_eap_method_by_value
 .

 

 
Parameters

-
+
@@ -1212,7 +1212,7 @@ nm_setting_802_1x_remove_eap_method_by_value

Returns

-

TRUE if the EAP method was founs and removed, FALSE if it was not.

+

TRUE if the EAP method was founs and removed, FALSE if it was not.

@@ -1223,7 +1223,7 @@ nm_setting_802_1x_clear_eap_methods (Clears all allowed EAP methods.

Parameters

-
+
@@ -1246,7 +1246,7 @@ nm_setting_802_1x_get_identity (

Parameters

-
+
@@ -1276,7 +1276,7 @@ inner "phase 2" authentication will use the

Parameters

-
+
@@ -1302,7 +1302,7 @@ nm_setting_802_1x_get_pac_file (Returns the file containing PAC credentials used by EAP-FAST method.

Parameters

-
+
@@ -1323,17 +1323,17 @@ nm_setting_802_1x_get_pac_file (

nm_setting_802_1x_get_system_ca_certs ()

-
gboolean
+
gboolean
 nm_setting_802_1x_get_system_ca_certs (NMSetting8021x *setting);

 
Sets the “system-ca-certs” property. The
 “ca-path” and “phase2-ca-path”
 properties are ignored if the “system-ca-certs” property is
-TRUE, in which case a system-wide CA certificate directory specified at
+TRUE, in which case a system-wide CA certificate directory specified at
 compile time (using the --system-ca-path configure option) is used in place
 of these properties.

 

 
Parameters

-
+
@@ -1348,7 +1348,7 @@ of these properties.

Returns

-

TRUE if a system CA certificate path should be used, FALSE if not

+

TRUE if a system CA certificate path should be used, FALSE if not

@@ -1363,7 +1363,7 @@ used in addition to the

Parameters

-
+
@@ -1393,7 +1393,7 @@ This may be used in addition to the

Parameters

-
+
@@ -1421,7 +1421,7 @@ is NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_ca_cert_path().

Parameters

-
+
@@ -1442,7 +1442,7 @@ if

nm_setting_802_1x_get_ca_cert_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_ca_cert_blob (NMSetting8021x *setting);

 
Returns the CA certificate blob if the CA certificate is stored using the
 NM_SETTING_802_1X_CK_SCHEME_BLOB scheme.  Not all EAP methods use a
@@ -1452,7 +1452,7 @@ reduces security by allowing man-in-the-middle attacks, because the identity
 of the network cannot be confirmed by the client.

 

 
Parameters

-
+
@@ -1484,7 +1484,7 @@ reduces security by allowing man-in-the-middle attacks, because the identity of the network cannot be confirmed by the client.

Parameters

-
+
@@ -1505,19 +1505,19 @@ of the network cannot be confirmed by the client.

nm_setting_802_1x_set_ca_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_ca_cert (NMSetting8021x *setting,
                                const char *cert_path,
                                NMSetting8021xCKScheme scheme,
                                NMSetting8021xCKFormat *out_format,
-                               GError **error);

+                               GError **error);

Reads a certificate from disk and sets the “ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

Parameters

-
+
@@ -1535,7 +1535,7 @@ scheme, or with the path to the certificate file if using the is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the CA certificate.

 @@ -1559,7 +1559,7 @@ clears the CA certificate.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -1569,7 +1569,7 @@ clears the CA certificate.

nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);

Parameters

-
 
+
@@ -1586,21 +1586,21 @@ nm_setting_802_1x_get_subject_match (

Returns

the “subject-match” property. This is the substring to be matched against the subject of the authentication -server certificate, or NULL no subject verification is to be +server certificate, or NULL no subject verification is to be performed.

nm_setting_802_1x_get_num_altsubject_matches ()

-
guint32
+
guint32
 nm_setting_802_1x_get_num_altsubject_matches
                                (NMSetting8021x *setting);

 
Returns the number of entries in the
 “altsubject-matches” property of this setting.

 

 
Parameters

-
+
@@ -1624,12 +1624,12 @@ nm_setting_802_1x_get_num_altsubject_matches 
const char *
 nm_setting_802_1x_get_altsubject_match
                                (NMSetting8021x *setting,
-                                guint32 i);
+ guint32 i);

Returns the altSubjectName match at index i .

Parameters

-
+
@@ -1658,7 +1658,7 @@ nm_setting_802_1x_get_altsubject_match

nm_setting_802_1x_add_altsubject_match ()

-
gboolean
+
gboolean
 nm_setting_802_1x_add_altsubject_match
                                (NMSetting8021x *setting,
                                 const char *altsubject_match);

@@ -1667,7 +1667,7 @@ match is added, the altSubjectName of the remote authentication
 server is not verified.

 

 
Parameters

-
+
@@ -1689,8 +1689,8 @@ server is not verified.

Returns

-

TRUE if the alternative subject name match was -successfully added, FALSE if it was already allowed.

+

TRUE if the alternative subject name match was +successfully added, FALSE if it was already allowed.

@@ -1699,11 +1699,11 @@ successfully added, void nm_setting_802_1x_remove_altsubject_match (NMSetting8021x *setting, - guint32 i); + guint32 i);

Removes the allowed altSubjectName at the specified index.

Parameters

-
+
@@ -1727,7 +1727,7 @@ nm_setting_802_1x_remove_altsubject_match

nm_setting_802_1x_remove_altsubject_match_by_value ()

-
gboolean
+
gboolean
 nm_setting_802_1x_remove_altsubject_match_by_value
                                (NMSetting8021x *setting,
                                 const char *altsubject_match);

@@ -1735,7 +1735,7 @@ nm_setting_802_1x_remove_altsubject_match_by_value
 .

 

 
Parameters

-
+
@@ -1757,8 +1757,8 @@ nm_setting_802_1x_remove_altsubject_match_by_value

Returns

-

TRUE if the alternative subject name match was found and removed, -FALSE if it was not.

+

TRUE if the alternative subject name match was found and removed, +FALSE if it was not.

@@ -1770,7 +1770,7 @@ nm_setting_802_1x_clear_altsubject_matches

Clears all altSubjectName matches.

Parameters

-
+
@@ -1792,7 +1792,7 @@ nm_setting_802_1x_get_domain_suffix_match (NMSetting8021x *setting);

Parameters

-
+
@@ -1822,7 +1822,7 @@ is NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_client_cert_path().

Parameters

-
+
@@ -1843,7 +1843,7 @@ if

nm_setting_802_1x_get_client_cert_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_client_cert_blob
                                (NMSetting8021x *setting);

 
Client certificates are used to identify the connecting client to the network
@@ -1851,7 +1851,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x
 authentication method.

 

 
Parameters

-
+
@@ -1881,7 +1881,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -1902,12 +1902,12 @@ authentication method.

nm_setting_802_1x_set_client_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_client_cert (NMSetting8021x *setting,
                                    const char *cert_path,
                                    NMSetting8021xCKScheme scheme,
                                    NMSetting8021xCKFormat *out_format,
-                                   GError **error);

+                                   GError **error);

Reads a certificate from disk and sets the “client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate @@ -1917,7 +1917,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -1935,7 +1935,7 @@ authentication method.

is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the client certificate.

 @@ -1960,7 +1960,7 @@ clears the client certificate.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -1970,7 +1970,7 @@ clears the client certificate.

nm_setting_802_1x_get_phase1_peapver (NMSetting8021x *setting);

Parameters

-
 
+
@@ -1987,7 +1987,7 @@ nm_setting_802_1x_get_phase1_peapver (

Returns

the "phase 1" PEAP version to be used when authenticating with EAP-PEAP as contained in the “phase1-peapver” property. Valid -values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

+values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

@@ -1998,7 +1998,7 @@ nm_setting_802_1x_get_phase1_peaplabel (NMSetting8021x *setting);

Parameters

-
+
@@ -2015,7 +2015,7 @@ nm_setting_802_1x_get_phase1_peaplabel

Returns

whether the "phase 1" PEAP label is new-style or old-style, to be used when authenticating with EAP-PEAP, as contained in the -“phase1-peaplabel” property. Valid values are NULL (unset), +“phase1-peaplabel” property. Valid values are NULL (unset), "0" (use old-style label), and "1" (use new-style label). See the wpa_supplicant documentation for more details.

@@ -2028,7 +2028,7 @@ nm_setting_802_1x_get_phase1_fast_provisioning (NMSetting8021x *setting);

Parameters

-
+
@@ -2055,7 +2055,7 @@ wpa_supplicant documentation for more details.

nm_setting_802_1x_get_phase2_auth (NMSetting8021x *setting);

Parameters

-
+
@@ -2081,7 +2081,7 @@ specified by the NMSetting8021x *setting);

Parameters

-
+
@@ -2112,7 +2112,7 @@ returned scheme is nm_setting_802_1x_get_ca_cert_path().

Parameters

-
+
@@ -2133,7 +2133,7 @@ use

nm_setting_802_1x_get_phase2_ca_cert_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_phase2_ca_cert_blob
                                (NMSetting8021x *setting);

 
Returns the "phase 2" CA certificate blob if the CA certificate is stored
@@ -2144,7 +2144,7 @@ reduces security by allowing man-in-the-middle attacks, because the identity
 of the network cannot be confirmed by the client.

 

 
Parameters

-
+
@@ -2177,7 +2177,7 @@ reduces security by allowing man-in-the-middle attacks, because the identity of the network cannot be confirmed by the client.

Parameters

-
+
@@ -2198,19 +2198,19 @@ of the network cannot be confirmed by the client.

nm_setting_802_1x_set_phase2_ca_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_ca_cert (NMSetting8021x *setting,
                                       const char *cert_path,
                                       NMSetting8021xCKScheme scheme,
                                       NMSetting8021xCKFormat *out_format,
-                                      GError **error);

+                                      GError **error);

Reads a certificate from disk and sets the “phase2-ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

Parameters

-
+
@@ -2228,7 +2228,7 @@ file if using the NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the "phase2" CA certificate.

 @@ -2252,7 +2252,7 @@ clears the "phase2" CA certificate.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -2263,7 +2263,7 @@ nm_setting_802_1x_get_phase2_subject_match (NMSetting8021x *setting);

Parameters

-
 
+
@@ -2280,21 +2280,21 @@ nm_setting_802_1x_get_phase2_subject_match

Returns

the “phase2-subject-match” property. This is the substring to be matched against the subject of the "phase 2" -authentication server certificate, or NULL no subject verification +authentication server certificate, or NULL no subject verification is to be performed.

nm_setting_802_1x_get_num_phase2_altsubject_matches ()

-
guint32
+
guint32
 nm_setting_802_1x_get_num_phase2_altsubject_matches
                                (NMSetting8021x *setting);

 
Returns the number of entries in the
 “phase2-altsubject-matches” property of this setting.

 

 
Parameters

-
+
@@ -2318,12 +2318,12 @@ nm_setting_802_1x_get_num_phase2_altsubject_matches 
const char *
 nm_setting_802_1x_get_phase2_altsubject_match
                                (NMSetting8021x *setting,
-                                guint32 i);
+ guint32 i);

Returns the "phase 2" altSubjectName match at index i .

Parameters

-
+
@@ -2352,7 +2352,7 @@ nm_setting_802_1x_get_phase2_altsubject_match

nm_setting_802_1x_add_phase2_altsubject_match ()

-
gboolean
+
gboolean
 nm_setting_802_1x_add_phase2_altsubject_match
                                (NMSetting8021x *setting,
                                 const char *phase2_altsubject_match);

@@ -2361,7 +2361,7 @@ at least one match is added, the altSubjectName of the "phase 2"
 remote authentication server is not verified.

 

 
Parameters

-
+
@@ -2384,8 +2384,8 @@ connection

Returns

-

TRUE if the "phase 2" alternative subject name match was -successfully added, FALSE if it was already allowed.

+

TRUE if the "phase 2" alternative subject name match was +successfully added, FALSE if it was already allowed.

@@ -2394,11 +2394,11 @@ successfully added, void nm_setting_802_1x_remove_phase2_altsubject_match (NMSetting8021x *setting, - guint32 i); + guint32 i);

Removes the allowed "phase 2" altSubjectName at the specified index.

Parameters

-
+
@@ -2422,7 +2422,7 @@ nm_setting_802_1x_remove_phase2_altsubject_match

nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()

-
gboolean
+
gboolean
 nm_setting_802_1x_remove_phase2_altsubject_match_by_value
                                (NMSetting8021x *setting,
                                 const char *phase2_altsubject_match);

@@ -2430,7 +2430,7 @@ nm_setting_802_1x_remove_phase2_altsubject_match_by_value
 .

 

 
Parameters

-
+
@@ -2452,8 +2452,8 @@ nm_setting_802_1x_remove_phase2_altsubject_match_by_value

Returns

-

TRUE if the alternative subject name match for "phase 2" was found and removed, -FALSE if it was not.

+

TRUE if the alternative subject name match for "phase 2" was found and removed, +FALSE if it was not.

@@ -2465,7 +2465,7 @@ nm_setting_802_1x_clear_phase2_altsubject_matches

Clears all "phase 2" altSubjectName matches.

Parameters

-
+
@@ -2487,7 +2487,7 @@ nm_setting_802_1x_get_phase2_domain_suffix_match (NMSetting8021x *setting);

Parameters

-
+
@@ -2519,7 +2519,7 @@ returned scheme is nm_setting_802_1x_get_client_cert_path().

Parameters

-
+
@@ -2540,7 +2540,7 @@ returned scheme is

nm_setting_802_1x_get_phase2_client_cert_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_phase2_client_cert_blob
                                (NMSetting8021x *setting);

 
Client certificates are used to identify the connecting client to the network
@@ -2548,7 +2548,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x
 authentication method.

 

 
Parameters

-
+
@@ -2578,7 +2578,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -2599,13 +2599,13 @@ authentication method.

nm_setting_802_1x_set_phase2_client_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_client_cert
                                (NMSetting8021x *setting,
                                 const char *cert_path,
                                 NMSetting8021xCKScheme scheme,
                                 NMSetting8021xCKFormat *out_format,
-                                GError **error);

+                                GError **error);

Reads a certificate from disk and sets the “phase2-client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate @@ -2615,7 +2615,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -2633,7 +2633,7 @@ authentication method.

is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the "phase2" client certificate.

 @@ -2658,7 +2658,7 @@ clears the "phase2" client certificate.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -2668,7 +2668,7 @@ clears the "phase2" client certificate.

nm_setting_802_1x_get_password (NMSetting8021x *setting);

Parameters

-
 
+
@@ -2694,7 +2694,7 @@ by the NMSetting8021x *setting);

Parameters

-
+
@@ -2715,11 +2715,11 @@ nm_setting_802_1x_get_password_flags (

nm_setting_802_1x_get_password_raw ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_password_raw (NMSetting8021x *setting);

 

 
Parameters

-
+
@@ -2748,7 +2748,7 @@ nm_setting_802_1x_get_password_raw_flags (NMSetting8021x *setting);

Parameters

-
+
@@ -2774,7 +2774,7 @@ nm_setting_802_1x_get_password_raw_flags nm_setting_802_1x_get_pin (NMSetting8021x *setting);

Parameters

-
+
@@ -2800,7 +2800,7 @@ by the NMSetting8021x *setting);

Parameters

-
+
@@ -2832,7 +2832,7 @@ nm_setting_802_1x_get_private_key_scheme nm_setting_802_1x_get_client_cert_path().

Parameters

-
+
@@ -2853,7 +2853,7 @@ nm_setting_802_1x_get_private_key_scheme

nm_setting_802_1x_get_private_key_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_private_key_blob
                                (NMSetting8021x *setting);

 
Private keys are used to authenticate the connecting client to the network
@@ -2864,7 +2864,7 @@ unencrypted private key data may be readable by unprivileged users.  Private
 keys should always be encrypted with a private key password.

 

 
Parameters

-
+
@@ -2894,7 +2894,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -2915,13 +2915,13 @@ authentication method.

nm_setting_802_1x_set_private_key ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_private_key (NMSetting8021x *setting,
                                    const char *key_path,
                                    const char *password,
                                    NMSetting8021xCKScheme scheme,
                                    NMSetting8021xCKFormat *out_format,
-                                   GError **error);

+                                   GError **error);

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

@@ -2935,7 +2935,7 @@ verify that password is correct, and if it is, updates the “private-key-password” property with the given password . If -the decryption is unsuccessful, FALSE is returned, error +the decryption is unsuccessful, FALSE is returned, error is set, and no internal data is changed. If no password is given, the private key is @@ -2947,7 +2947,7 @@ unprivileged users. Private keys should always be encrypted with a private key password to prevent unauthorized access to unencrypted private key data.

Parameters

-
+
@@ -2965,13 +2965,13 @@ key password to prevent unauthorized access to unencrypted private key data.

is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the private key.

 - @@ -2996,7 +2996,7 @@ an error is returned.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -3007,7 +3007,7 @@ nm_setting_802_1x_get_private_key_password (NMSetting8021x *setting);

Parameters

-
 

password

password used to decrypt the private key, or NULL if the password +

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, an error is returned.

  
+
@@ -3035,7 +3035,7 @@ nm_setting_802_1x_get_private_key_password_flags (NMSetting8021x *setting);

Parameters

-
+
@@ -3062,7 +3062,7 @@ nm_setting_802_1x_get_private_key_format (NMSetting8021x *setting);

Parameters

-
+
@@ -3094,7 +3094,7 @@ scheme is nm_setting_802_1x_get_client_cert_path().

Parameters

-
+
@@ -3115,7 +3115,7 @@ scheme is

nm_setting_802_1x_get_phase2_private_key_blob ()

-
GBytes *
+
GBytes *
 nm_setting_802_1x_get_phase2_private_key_blob
                                (NMSetting8021x *setting);

 
Private keys are used to authenticate the connecting client to the network
@@ -3126,7 +3126,7 @@ unencrypted private key data may be readable by unprivileged users.  Private
 keys should always be encrypted with a private key password.

 

 
Parameters

-
+
@@ -3156,7 +3156,7 @@ when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

Parameters

-
+
@@ -3177,14 +3177,14 @@ authentication method.

nm_setting_802_1x_set_phase2_private_key ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_private_key
                                (NMSetting8021x *setting,
                                 const char *key_path,
                                 const char *password,
                                 NMSetting8021xCKScheme scheme,
                                 NMSetting8021xCKFormat *out_format,
-                                GError **error);

+                                GError **error);

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.

@@ -3198,7 +3198,7 @@ verify that password is correct, and if it is, updates the “phase2-private-key-password” property with the given password -. If the decryption is unsuccessful, FALSE is returned, error +. If the decryption is unsuccessful, FALSE is returned, error is set, and no internal data is changed. If no password is given, the private @@ -3210,7 +3210,7 @@ unprivileged users. Private keys should always be encrypted with a private key password to prevent unauthorized access to unencrypted private key data.

Parameters

-
+
@@ -3228,14 +3228,14 @@ key password to prevent unauthorized access to unencrypted private key data.

is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; -use g_filename_to_utf8() to convert if needed. Passing NULL with any +use g_filename_to_utf8() to convert if needed. Passing NULL with any scheme clears the private key.

 - @@ -3260,7 +3260,7 @@ an error is returned.

Returns

-

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

@@ -3271,7 +3271,7 @@ nm_setting_802_1x_get_phase2_private_key_password (NMSetting8021x *setting);

Parameters

-
 

password

password used to decrypt the private key, or NULL if the password +

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, an error is returned.

  
+
@@ -3299,7 +3299,7 @@ nm_setting_802_1x_get_phase2_private_key_password_flags (NMSetting8021x *setting);

Parameters

-
+
@@ -3326,7 +3326,7 @@ nm_setting_802_1x_get_phase2_private_key_format (NMSetting8021x *setting);

Parameters

-
+
@@ -3360,7 +3360,7 @@ nm_setting_802_1x_get_phase2_private_key_format or private key

Members

-
+
@@ -3409,7 +3409,7 @@ stored in the setting properties, either as a blob of the item's data, or as a path to a certificate or private key file on the filesystem

Members

-
+
@@ -3664,7 +3664,7 @@ to a file containing the certificate or key data

Property Details

The “altsubject-matches” property

-
  “altsubject-matches”       GStrv
+
  “altsubject-matches”       GStrv

List of strings to be matched against the altSubjectName of the certificate presented by the authentication server. If the list is empty, no verification of the server certificate's altSubjectName is performed.

@@ -3673,7 +3673,7 @@ no verification of the server certificate's altSubjectName is performed.

The “anonymous-identity” property

-
  “anonymous-identity”       gchar *
+
  “anonymous-identity”       gchar *

Anonymous identity string for EAP authentication methods. Used as the unencrypted identity with EAP types that support different tunneled identity like EAP-TTLS.

@@ -3683,7 +3683,7 @@ identity like EAP-TTLS.

The “ca-cert” property

-
  “ca-cert”                  GBytes *
+
  “ca-cert”                  GBytes *

Contains the CA certificate if used by the EAP method specified in the “eap” property.

Certificate data is specified using a "scheme"; two are currently @@ -3701,7 +3701,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.

The “ca-path” property

-
  “ca-path”                  gchar *
+
  “ca-path”                  gchar *

UTF-8 encoded path to a directory containing PEM or DER formatted certificates to be added to the verification chain in addition to the certificate specified in the “ca-cert” property.

@@ -3711,7 +3711,7 @@ certificate specified in the

The “client-cert” property

-
  “client-cert”              GBytes *
+
  “client-cert”              GBytes *

Contains the client certificate if used by the EAP method specified in the “eap” property.

Certificate data is specified using a "scheme"; two are currently @@ -3727,7 +3727,7 @@ with the string "file://" and ending with a terminating NUL byte.

The “domain-suffix-match” property

-
  “domain-suffix-match”      gchar *
+
  “domain-suffix-match”      gchar *

Constraint for server domain name. If set, this FQDN is used as a suffix match requirement for dNSName element(s) of the certificate presented by the authentication server. If a matching dNSName is found, this @@ -3740,7 +3740,7 @@ matched against SubjectName CN using same suffix match comparison.

The “eap” property

-
  “eap”                      GStrv
+
  “eap”                      GStrv

The allowed EAP method to be used when authenticating to the network with 802.1x. Valid methods are: "leap", "md5", "tls", "peap", "ttls", "pwd", and "fast". Each method requires different configuration using the @@ -3751,7 +3751,7 @@ allowed combinations.

The “identity” property

-
  “identity”                 gchar *
+
  “identity”                 gchar *

Identity string for EAP authentication methods. Often the user's user or login name.

Flags: Read / Write

@@ -3760,7 +3760,7 @@ login name.

The “pac-file” property

-
  “pac-file”                 gchar *
+
  “pac-file”                 gchar *

UTF-8 encoded file path containing PAC for EAP-FAST.

Flags: Read / Write

Default value: NULL

@@ -3768,7 +3768,7 @@ login name.

The “password” property

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

UTF-8 encoded password used for EAP authentication methods. If both the “password” property and the “password-raw” property are specified, “password” is preferred.

@@ -3785,7 +3785,7 @@ property are specified,

The “password-raw” property

-
  “password-raw”             GBytes *
+
  “password-raw”             GBytes *

Password used for EAP authentication methods, given as a byte array to allow passwords in other encodings than UTF-8 to be used. If both the “password” property and the “password-raw” @@ -3802,7 +3802,7 @@ property are specified,

The “phase1-fast-provisioning” property

-
  “phase1-fast-provisioning” gchar *
+
  “phase1-fast-provisioning” gchar *

Enables or disables in-line provisioning of EAP-FAST credentials when FAST is specified as the EAP method in the “eap” property. Recognized values are "0" (disabled), "1" (allow unauthenticated @@ -3815,7 +3815,7 @@ wpa_supplicant documentation for more details.

The “phase1-peaplabel” property

-
  “phase1-peaplabel”         gchar *
+
  “phase1-peaplabel”         gchar *

Forces use of the new PEAP label during key derivation. Some RADIUS servers may require forcing the new PEAP label to interoperate with PEAPv1. Set to "1" to force use of the new PEAP label. See the @@ -3826,7 +3826,7 @@ wpa_supplicant documentation for more details.

The “phase1-peapver” property

-
  “phase1-peapver”           gchar *
+
  “phase1-peapver”           gchar *

Forces which PEAP version is used when PEAP is set as the EAP method in the “eap” property. When unset, the version reported by the server will be used. Sometimes when using older RADIUS servers, it @@ -3839,7 +3839,7 @@ version.

The “phase2-altsubject-matches” property

-
  “phase2-altsubject-matches” GStrv
+
  “phase2-altsubject-matches” GStrv

List of strings to be matched against the altSubjectName of the certificate presented by the authentication server during the inner "phase 2" authentication. If the list is empty, no verification of the @@ -3849,7 +3849,7 @@ server certificate's altSubjectName is performed.

The “phase2-auth” property

-
  “phase2-auth”              gchar *
+
  “phase2-auth”              gchar *

Specifies the allowed "phase 2" inner non-EAP authentication methods when an EAP method that uses an inner TLS tunnel is specified in the “eap” property. Recognized non-EAP "phase 2" methods are @@ -3862,7 +3862,7 @@ authentication; see the wpa_supplicant documentation for more details.

The “phase2-autheap” property

-
  “phase2-autheap”           gchar *
+
  “phase2-autheap”           gchar *

Specifies the allowed "phase 2" inner EAP-based authentication methods when an EAP method that uses an inner TLS tunnel is specified in the “eap” property. Recognized EAP-based "phase 2" methods are @@ -3875,7 +3875,7 @@ wpa_supplicant documentation for more details.

The “phase2-ca-cert” property

-
  “phase2-ca-cert”           GBytes *
+
  “phase2-ca-cert”           GBytes *

Contains the "phase 2" CA certificate if used by the EAP method specified in the “phase2-auth” or “phase2-autheap” properties.

@@ -3894,7 +3894,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.

The “phase2-ca-path” property

-
  “phase2-ca-path”           gchar *
+
  “phase2-ca-path”           gchar *

UTF-8 encoded path to a directory containing PEM or DER formatted certificates to be added to the verification chain in addition to the certificate specified in the “phase2-ca-cert” property.

@@ -3904,7 +3904,7 @@ certificate specified in the

The “phase2-client-cert” property

-
  “phase2-client-cert”       GBytes *
+
  “phase2-client-cert”       GBytes *

Contains the "phase 2" client certificate if used by the EAP method specified in the “phase2-auth” or “phase2-autheap” properties.

@@ -3923,7 +3923,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.

The “phase2-domain-suffix-match” property

-
  “phase2-domain-suffix-match” gchar *
+
  “phase2-domain-suffix-match” gchar *

Constraint for server domain name. If set, this FQDN is used as a suffix match requirement for dNSName element(s) of the certificate presented by the authentication server during the inner "phase 2" authentication. If @@ -3937,7 +3937,7 @@ using same suffix match comparison.

The “phase2-private-key” property

-
  “phase2-private-key”       GBytes *
+
  “phase2-private-key”       GBytes *

Contains the "phase 2" inner private key when the “phase2-auth” or “phase2-autheap” property is set to "tls".

@@ -3963,7 +3963,7 @@ password used to decode the PKCS#12 private key and certificate.

The “phase2-private-key-password” property

-
  “phase2-private-key-password” gchar *
+
  “phase2-private-key-password” gchar *

The password used to decrypt the "phase 2" private key specified in the “phase2-private-key” property when the private key either uses the path scheme, or is a PKCS#12 format key. Setting this @@ -3985,7 +3985,7 @@ function.

The “phase2-subject-match” property

-
  “phase2-subject-match”     gchar *
+
  “phase2-subject-match”     gchar *

Substring to be matched against the subject of the certificate presented by the authentication server during the inner "phase 2" authentication. When unset, no verification of the authentication server @@ -3998,7 +3998,7 @@ NMSetting8021x:phase2-domain-suffix-match.

The “pin” property

-
  “pin”                      gchar *
+
  “pin”                      gchar *

PIN used for EAP authentication methods.

Flags: Read / Write

Default value: NULL

@@ -4013,7 +4013,7 @@ NMSetting8021x:phase2-domain-suffix-match.

The “private-key” property

-
  “private-key”              GBytes *
+
  “private-key”              GBytes *

Contains the private key when the “eap” property is set to "tls".

Key data is specified using a "scheme"; two are currently supported: blob @@ -4043,7 +4043,7 @@ private key data.

The “private-key-password” property

-
  “private-key-password”     gchar *
+
  “private-key-password”     gchar *

The password used to decrypt the private key specified in the “private-key” property when the private key either uses the path scheme, or if the private key is a PKCS#12 format key. Setting this @@ -4064,7 +4064,7 @@ property.

The “subject-match” property

-
  “subject-match”            gchar *
+
  “subject-match”            gchar *

Substring to be matched against the subject of the certificate presented by the authentication server. When unset, no verification of the authentication server certificate's subject is performed. This property @@ -4076,8 +4076,8 @@ NMSetting8021x:domain-suffix-match.

The “system-ca-certs” property

-
  “system-ca-certs”          gboolean
-

When TRUE, overrides the “ca-path” and +

  “system-ca-certs”          gboolean
+

When TRUE, overrides the “ca-path” and “phase2-ca-path” properties using the system CA directory specified at configure time with the --system-ca-path switch. The certificates in this directory are added to the verification chain in -- cgit 1.3.0-6-gf8a5