From afcd268ea7b1149fbfb66bce4eca659b675da0a2 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Tue, 12 Dec 2017 15:53:07 +0100 Subject: New upstream version 1.10.2 --- docs/libnm/html/NMSetting8021x.html | 360 ++++++++++++++++++------------------ 1 file changed, 180 insertions(+), 180 deletions(-) (limited to 'docs/libnm/html/NMSetting8021x.html') diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index e9d35c7a..56c2b9dd 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -8,7 +8,7 @@ - + @@ -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 () @@ -179,7 +179,7 @@ -gboolean +gboolean nm_setting_802_1x_set_ca_cert () @@ -209,7 +209,7 @@ -guint32 +guint32 nm_setting_802_1x_get_num_altsubject_matches () @@ -224,7 +224,7 @@ -gboolean +gboolean nm_setting_802_1x_add_altsubject_match () @@ -240,7 +240,7 @@ -gboolean +gboolean nm_setting_802_1x_remove_altsubject_match_by_value () @@ -271,7 +271,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_client_cert_blob () @@ -293,7 +293,7 @@ -gboolean +gboolean nm_setting_802_1x_set_client_cert () @@ -359,7 +359,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_phase2_ca_cert_blob () @@ -381,7 +381,7 @@ -gboolean +gboolean nm_setting_802_1x_set_phase2_ca_cert () @@ -411,7 +411,7 @@ -guint32 +guint32 nm_setting_802_1x_get_num_phase2_altsubject_matches () @@ -426,7 +426,7 @@ -gboolean +gboolean nm_setting_802_1x_add_phase2_altsubject_match () @@ -442,7 +442,7 @@ -gboolean +gboolean nm_setting_802_1x_remove_phase2_altsubject_match_by_value () @@ -473,7 +473,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_phase2_client_cert_blob () @@ -495,7 +495,7 @@ -gboolean +gboolean nm_setting_802_1x_set_phase2_client_cert () @@ -533,7 +533,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_password_raw () @@ -572,7 +572,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_private_key_blob () @@ -594,7 +594,7 @@ -gboolean +gboolean nm_setting_802_1x_set_private_key () @@ -633,7 +633,7 @@ -GBytes * +GBytes * nm_setting_802_1x_get_phase2_private_key_blob () @@ -655,7 +655,7 @@ -gboolean +gboolean nm_setting_802_1x_set_phase2_private_key () @@ -694,7 +694,7 @@ -gint +gint nm_setting_802_1x_get_auth_timeout () @@ -713,30 +713,30 @@ -GStrv +GStrv altsubject-matches Read / Write -gchar * +gchar * anonymous-identity Read / Write -gint +gint auth-timeout Read / Write -GBytes * +GBytes * ca-cert Read / Write -gchar * +gchar * ca-cert-password Read / Write @@ -747,19 +747,19 @@ -gchar * +gchar * ca-path Read / Write -GBytes * +GBytes * client-cert Read / Write -gchar * +gchar * client-cert-password Read / Write @@ -770,30 +770,30 @@ -gchar * +gchar * domain-suffix-match Read / Write -GStrv +GStrv eap Read / Write -gchar * +gchar * identity Read / Write -gchar * +gchar * pac-file Read / Write -gchar * +gchar * password Read / Write @@ -804,7 +804,7 @@ -GBytes * +GBytes * password-raw Read / Write @@ -814,54 +814,54 @@ Read / Write -guint +guint phase1-auth-flags Read / Write / Construct -gchar * +gchar * phase1-fast-provisioning Read / Write -gchar * +gchar * phase1-peaplabel Read / Write -gchar * +gchar * phase1-peapver Read / Write -GStrv +GStrv phase2-altsubject-matches Read / Write -gchar * +gchar * phase2-auth Read / Write -gchar * +gchar * phase2-autheap Read / Write -GBytes * +GBytes * phase2-ca-cert Read / Write -gchar * +gchar * phase2-ca-cert-password Read / Write @@ -872,19 +872,19 @@ -gchar * +gchar * phase2-ca-path Read / Write -GBytes * +GBytes * phase2-client-cert Read / Write -gchar * +gchar * phase2-client-cert-password Read / Write @@ -895,19 +895,19 @@ -gchar * +gchar * phase2-domain-suffix-match Read / Write -GBytes * +GBytes * phase2-private-key Read / Write -gchar * +gchar * phase2-private-key-password Read / Write @@ -918,13 +918,13 @@ -gchar * +gchar * phase2-subject-match Read / Write -gchar * +gchar * pin Read / Write @@ -935,13 +935,13 @@ -GBytes * +GBytes * private-key Read / Write -gchar * +gchar * private-key-password Read / Write @@ -952,12 +952,12 @@ -gchar * +gchar * subject-match Read / Write -gboolean +gboolean system-ca-certs Read / Write / Construct @@ -1181,12 +1181,12 @@

Object Hierarchy

-
    GEnum
+
    GEnum
     ├── NMSetting8021xCKFormat
     ╰── NMSetting8021xCKScheme
-    GFlags
+    GFlags
     ╰── NMSetting8021xAuthFlags
-    GObject
+    GObject
     ╰── NMSetting
         ╰── NMSetting8021x
 
@@ -1228,9 +1228,9 @@ 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).

@@ -1245,7 +1245,7 @@ the blob must be not UNKNOWN (or NULL).

pdata

-

the data pointer.

+

the data pointer.

[allow-none] @@ -1255,7 +1255,7 @@ the blob must be not UNKNOWN (or NULL).

error

-

(out): validation reason.

+

(out): validation reason.

[allow-none] @@ -1271,7 +1271,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 @@ -1303,7 +1303,7 @@ 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 .

@@ -1337,7 +1337,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 @@ -1367,7 +1367,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.

@@ -1376,7 +1376,7 @@ 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

@@ -1404,7 +1404,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);
@@ -1434,7 +1434,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.


@@ -1545,12 +1545,12 @@ 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.

@@ -1570,7 +1570,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


@@ -1665,7 +1665,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 @@ -1690,7 +1690,7 @@ of the network cannot be confirmed by the client.

Returns

-

the CA certificate data.

+

the CA certificate data.

[transfer none]

@@ -1760,12 +1760,12 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_ca_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_ca_cert (NMSetting8021x *setting,
                                const char *value,
                                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 @@ -1790,7 +1790,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.

  @@ -1814,7 +1814,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


@@ -1898,14 +1898,14 @@ 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 @@ -1936,7 +1936,7 @@ 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 .

@@ -1970,7 +1970,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);
@@ -2001,8 +2001,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.


@@ -2011,7 +2011,7 @@ 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

@@ -2039,7 +2039,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);
@@ -2069,8 +2069,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.


@@ -2156,7 +2156,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 @@ -2179,7 +2179,7 @@ authentication method.

Returns

-

the client certificate data.

+

the client certificate data.

[transfer none]

@@ -2247,12 +2247,12 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_client_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_client_cert (NMSetting8021x *setting,
                                    const char *value,
                                    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 @@ -2280,7 +2280,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.

  @@ -2305,7 +2305,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


@@ -2389,7 +2389,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).


@@ -2417,7 +2417,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.

@@ -2536,7 +2536,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 @@ -2562,7 +2562,7 @@ of the network cannot be confirmed by the client.

Returns

-

the "phase 2" CA certificate data.

+

the "phase 2" CA certificate data.

[transfer none]

@@ -2634,12 +2634,12 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_phase2_ca_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_ca_cert (NMSetting8021x *setting,
                                       const char *value,
                                       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 @@ -2664,7 +2664,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.

  @@ -2688,7 +2688,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


@@ -2773,14 +2773,14 @@ 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 @@ -2811,7 +2811,7 @@ 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 .

@@ -2845,7 +2845,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);
@@ -2877,8 +2877,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.


@@ -2887,7 +2887,7 @@ 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

@@ -2915,7 +2915,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);
@@ -2945,8 +2945,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.


@@ -3035,7 +3035,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 @@ -3058,7 +3058,7 @@ authentication method.

Returns

-

the "phase 2" client certificate data.

+

the "phase 2" client certificate data.

[transfer none]

@@ -3127,13 +3127,13 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_phase2_client_cert ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_client_cert
                                (NMSetting8021x *setting,
                                 const char *value,
                                 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 @@ -3161,7 +3161,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.

  @@ -3186,7 +3186,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


@@ -3300,7 +3300,7 @@ 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

@@ -3319,7 +3319,7 @@ nm_setting_802_1x_get_password_raw (

Returns

-

the password used by the authentication method as a +

the password used by the authentication method as a UTF-8-encoded array of bytes, as specified by the “password-raw” property.

[transfer none]

@@ -3440,7 +3440,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 @@ -3466,7 +3466,7 @@ keys should always be encrypted with a private key password.

Returns

-

the private key data.

+

the private key data.

[transfer none]

@@ -3534,13 +3534,13 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_private_key ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_private_key (NMSetting8021x *setting,
                                    const char *value,
                                    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.

@@ -3554,7 +3554,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 @@ -3584,13 +3584,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.

 

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.

  @@ -3615,7 +3615,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


@@ -3736,7 +3736,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 @@ -3762,7 +3762,7 @@ keys should always be encrypted with a private key password.

Returns

-

the "phase 2" private key data.

+

the "phase 2" private key data.

[transfer none]

@@ -3831,14 +3831,14 @@ for local files and 'data' URIs for inline certificate data).


nm_setting_802_1x_set_phase2_private_key ()

-
gboolean
+
gboolean
 nm_setting_802_1x_set_phase2_private_key
                                (NMSetting8021x *setting,
                                 const char *value,
                                 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.

@@ -3852,7 +3852,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 @@ -3882,14 +3882,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.

 

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.

  @@ -3914,7 +3914,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


@@ -4029,7 +4029,7 @@ nm_setting_802_1x_get_phase1_auth_flags

nm_setting_802_1x_get_auth_timeout ()

-
gint
+
gint
 nm_setting_802_1x_get_auth_timeout (NMSetting8021x *setting);

Returns the value contained in the “auth-timeout” property.

@@ -4507,7 +4507,7 @@ should be used.

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.

@@ -4516,7 +4516,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.

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


The “auth-timeout” property

-
  “auth-timeout”             gint
+
  “auth-timeout”             gint

A timeout for the authentication. Zero means the global default; if the global default is not set, the authentication timeout is 25 seconds.

Flags: Read / Write

@@ -4537,7 +4537,7 @@ global default is not set, the authentication timeout is 25 seconds.


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 @@ -4555,7 +4555,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.


The “ca-cert-password” property

-
  “ca-cert-password”         gchar *
+
  “ca-cert-password”         gchar *

The password used to access the CA certificate stored in “ca-cert” property. Only makes sense if the certificate is stored on a PKCS#11 token that requires a login.

@@ -4574,7 +4574,7 @@ is stored on a PKCS#11 token that requires a login.


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.

@@ -4584,7 +4584,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 @@ -4600,7 +4600,7 @@ with the string "file://" and ending with a terminating NUL byte.


The “client-cert-password” property

-
  “client-cert-password”     gchar *
+
  “client-cert-password”     gchar *

The password used to access the client certificate stored in “client-cert” property. Only makes sense if the certificate is stored on a PKCS#11 token that requires a login.

@@ -4619,7 +4619,7 @@ is stored on a PKCS#11 token that requires a login.


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 @@ -4632,7 +4632,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 @@ -4643,7 +4643,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

@@ -4652,7 +4652,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

@@ -4660,7 +4660,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.

@@ -4677,7 +4677,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” @@ -4694,7 +4694,7 @@ property are specified,

The “phase1-auth-flags” property

-
  “phase1-auth-flags”        guint
+
  “phase1-auth-flags”        guint

Specifies authentication flags to use in "phase 1" outer authentication using NMSetting8021xAuthFlags options. The individual TLS versions can be explicitly disabled. If a certain @@ -4708,7 +4708,7 @@ See the wpa_supplicant documentation for more details.


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 @@ -4721,7 +4721,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 @@ -4732,7 +4732,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 @@ -4745,7 +4745,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 @@ -4755,7 +4755,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 @@ -4768,7 +4768,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 @@ -4781,7 +4781,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.

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


The “phase2-ca-cert-password” property

-
  “phase2-ca-cert-password”  gchar *
+
  “phase2-ca-cert-password”  gchar *

The password used to access the "phase2" CA certificate stored in “phase2-ca-cert” property. Only makes sense if the certificate is stored on a PKCS#11 token that requires a login.

@@ -4819,7 +4819,7 @@ is stored on a PKCS#11 token that requires a login.


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.

@@ -4829,7 +4829,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.

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


The “phase2-client-cert-password” property

-
  “phase2-client-cert-password” gchar *
+
  “phase2-client-cert-password” gchar *

The password used to access the "phase2" client certificate stored in “phase2-client-cert” property. Only makes sense if the certificate is stored on a PKCS#11 token that requires a login.

@@ -4867,7 +4867,7 @@ is stored on a PKCS#11 token that requires a login.


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 @@ -4881,7 +4881,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".

@@ -4907,7 +4907,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 @@ -4929,7 +4929,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 @@ -4942,7 +4942,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

@@ -4957,7 +4957,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 @@ -4987,7 +4987,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 @@ -5008,7 +5008,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 @@ -5020,8 +5020,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 @@ -5036,6 +5036,6 @@ properties instead (sets ca_cert/ca_cert2 options for wpa_supplicant).

+
Generated by GTK-Doc V1.26
\ No newline at end of file -- cgit 1.3.0-6-gf8a5 From 50f6b47074e01dffb8dc536c0a20961dcf28ae9b Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Wed, 7 Feb 2018 02:39:23 +0100 Subject: New upstream version 1.10.4 --- docs/libnm/html/NMSetting8021x.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/libnm/html/NMSetting8021x.html') diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index 56c2b9dd..cce84fb7 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -8,7 +8,7 @@ - + @@ -5036,6 +5036,6 @@ properties instead (sets ca_cert/ca_cert2 options for wpa_supplicant).

+
Generated by GTK-Doc V1.27
\ No newline at end of file -- cgit 1.3.0-6-gf8a5