diff options
Diffstat (limited to 'docs/libnm/html/NMSetting8021x.html')
| -rw-r--r-- | docs/libnm/html/NMSetting8021x.html | 607 |
1 files changed, 369 insertions, 238 deletions
diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index 993d2bde..a71d5022 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -59,7 +59,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<span class="returnvalue">guint32</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-num-eap-methods" title="nm_setting_802_1x_get_num_eap_methods ()">nm_setting_802_1x_get_num_eap_methods</a> <span class="c_punctuation">()</span> @@ -74,7 +74,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-add-eap-method" title="nm_setting_802_1x_add_eap_method ()">nm_setting_802_1x_add_eap_method</a> <span class="c_punctuation">()</span> @@ -90,7 +90,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-remove-eap-method-by-value" title="nm_setting_802_1x_remove_eap_method_by_value ()">nm_setting_802_1x_remove_eap_method_by_value</a> <span class="c_punctuation">()</span> @@ -127,7 +127,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-system-ca-certs" title="nm_setting_802_1x_get_system_ca_certs ()">nm_setting_802_1x_get_system_ca_certs</a> <span class="c_punctuation">()</span> @@ -157,7 +157,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-ca-cert-blob" title="nm_setting_802_1x_get_ca_cert_blob ()">nm_setting_802_1x_get_ca_cert_blob</a> <span class="c_punctuation">()</span> @@ -172,7 +172,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-ca-cert" title="nm_setting_802_1x_set_ca_cert ()">nm_setting_802_1x_set_ca_cert</a> <span class="c_punctuation">()</span> @@ -187,7 +187,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<span class="returnvalue">guint32</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-num-altsubject-matches" title="nm_setting_802_1x_get_num_altsubject_matches ()">nm_setting_802_1x_get_num_altsubject_matches</a> <span class="c_punctuation">()</span> @@ -202,7 +202,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-add-altsubject-match" title="nm_setting_802_1x_add_altsubject_match ()">nm_setting_802_1x_add_altsubject_match</a> <span class="c_punctuation">()</span> @@ -218,7 +218,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-remove-altsubject-match-by-value" title="nm_setting_802_1x_remove_altsubject_match_by_value ()">nm_setting_802_1x_remove_altsubject_match_by_value</a> <span class="c_punctuation">()</span> @@ -233,6 +233,13 @@ </td> </tr> <tr> +<td class="function_type">const <span class="returnvalue">char</span> * +</td> +<td class="function_name"> +<a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-domain-suffix-match" title="nm_setting_802_1x_get_domain_suffix_match ()">nm_setting_802_1x_get_domain_suffix_match</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> <td class="function_type"> <a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="returnvalue">NMSetting8021xCKScheme</span></a> </td> @@ -242,7 +249,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-blob" title="nm_setting_802_1x_get_client_cert_blob ()">nm_setting_802_1x_get_client_cert_blob</a> <span class="c_punctuation">()</span> @@ -257,7 +264,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-client-cert" title="nm_setting_802_1x_set_client_cert ()">nm_setting_802_1x_set_client_cert</a> <span class="c_punctuation">()</span> @@ -308,7 +315,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-phase2-ca-cert-blob" title="nm_setting_802_1x_get_phase2_ca_cert_blob ()">nm_setting_802_1x_get_phase2_ca_cert_blob</a> <span class="c_punctuation">()</span> @@ -323,7 +330,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-phase2-ca-cert" title="nm_setting_802_1x_set_phase2_ca_cert ()">nm_setting_802_1x_set_phase2_ca_cert</a> <span class="c_punctuation">()</span> @@ -338,7 +345,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<span class="returnvalue">guint32</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-num-phase2-altsubject-matches" title="nm_setting_802_1x_get_num_phase2_altsubject_matches ()">nm_setting_802_1x_get_num_phase2_altsubject_matches</a> <span class="c_punctuation">()</span> @@ -353,7 +360,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-add-phase2-altsubject-match" title="nm_setting_802_1x_add_phase2_altsubject_match ()">nm_setting_802_1x_add_phase2_altsubject_match</a> <span class="c_punctuation">()</span> @@ -369,7 +376,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-remove-phase2-altsubject-match-by-value" title="nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()">nm_setting_802_1x_remove_phase2_altsubject_match_by_value</a> <span class="c_punctuation">()</span> @@ -384,6 +391,13 @@ </td> </tr> <tr> +<td class="function_type">const <span class="returnvalue">char</span> * +</td> +<td class="function_name"> +<a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-phase2-domain-suffix-match" title="nm_setting_802_1x_get_phase2_domain_suffix_match ()">nm_setting_802_1x_get_phase2_domain_suffix_match</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> <td class="function_type"> <a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="returnvalue">NMSetting8021xCKScheme</span></a> </td> @@ -393,7 +407,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-phase2-client-cert-blob" title="nm_setting_802_1x_get_phase2_client_cert_blob ()">nm_setting_802_1x_get_phase2_client_cert_blob</a> <span class="c_punctuation">()</span> @@ -408,7 +422,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-phase2-client-cert" title="nm_setting_802_1x_set_phase2_client_cert ()">nm_setting_802_1x_set_phase2_client_cert</a> <span class="c_punctuation">()</span> @@ -431,7 +445,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-password-raw" title="nm_setting_802_1x_get_password_raw ()">nm_setting_802_1x_get_password_raw</a> <span class="c_punctuation">()</span> @@ -470,7 +484,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-private-key-blob" title="nm_setting_802_1x_get_private_key_blob ()">nm_setting_802_1x_get_private_key_blob</a> <span class="c_punctuation">()</span> @@ -485,7 +499,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-private-key" title="nm_setting_802_1x_set_private_key ()">nm_setting_802_1x_set_private_key</a> <span class="c_punctuation">()</span> @@ -524,7 +538,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<span class="returnvalue">GBytes</span> * </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-phase2-private-key-blob" title="nm_setting_802_1x_get_phase2_private_key_blob ()">nm_setting_802_1x_get_phase2_private_key_blob</a> <span class="c_punctuation">()</span> @@ -539,7 +553,7 @@ </tr> <tr> <td class="function_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-phase2-private-key" title="nm_setting_802_1x_set_phase2_private_key ()">nm_setting_802_1x_set_phase2_private_key</a> <span class="c_punctuation">()</span> @@ -581,54 +595,60 @@ </colgroup> <tbody> <tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> +<td class="property_type"><span class="type">GStrv</span></td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--altsubject-matches" title="The “altsubject-matches” property">altsubject-matches</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--anonymous-identity" title="The “anonymous-identity” property">anonymous-identity</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-cert" title="The “ca-cert” property">ca-cert</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-path" title="The “ca-path” property">ca-path</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--client-cert" title="The “client-cert” property">client-cert</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> +<td class="property_type"> +<span class="type">gchar</span> *</td> +<td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--domain-suffix-match" title="The “domain-suffix-match” property">domain-suffix-match</a></td> +<td class="property_flags">Read / Write</td> +</tr> +<tr> +<td class="property_type"><span class="type">GStrv</span></td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property">eap</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--identity" title="The “identity” property">identity</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--pac-file" title="The “pac-file” property">pac-file</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property">password</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -639,7 +659,7 @@ </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--password-raw" title="The “password-raw” property">password-raw</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -650,66 +670,72 @@ </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-fast-provisioning" title="The “phase1-fast-provisioning” property">phase1-fast-provisioning</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-peaplabel" title="The “phase1-peaplabel” property">phase1-peaplabel</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-peapver" title="The “phase1-peapver” property">phase1-peapver</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> +<td class="property_type"><span class="type">GStrv</span></td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-altsubject-matches" title="The “phase2-altsubject-matches” property">phase2-altsubject-matches</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-auth" title="The “phase2-auth” property">phase2-auth</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-autheap" title="The “phase2-autheap” property">phase2-autheap</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-cert" title="The “phase2-ca-cert” property">phase2-ca-cert</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-path" title="The “phase2-ca-path” property">phase2-ca-path</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-client-cert" title="The “phase2-client-cert” property">phase2-client-cert</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">gchar</span> *</td> +<td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-domain-suffix-match" title="The “phase2-domain-suffix-match” property">phase2-domain-suffix-match</a></td> +<td class="property_flags">Read / Write</td> +</tr> +<tr> +<td class="property_type"> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key" title="The “phase2-private-key” property">phase2-private-key</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key-password" title="The “phase2-private-key-password” property">phase2-private-key-password</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -720,13 +746,13 @@ </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-subject-match" title="The “phase2-subject-match” property">phase2-subject-match</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--pin" title="The “pin” property">pin</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -737,13 +763,13 @@ </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</td> +<span class="type">GBytes</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key" title="The “private-key” property">private-key</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key-password" title="The “private-key-password” property">private-key-password</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -754,12 +780,12 @@ </tr> <tr> <td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<span class="type">gchar</span> *</td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--subject-match" title="The “subject-match” property">subject-match</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> +<td class="property_type"><span class="type">gboolean</span></td> <td class="property_name"><a class="link" href="NMSetting8021x.html#NMSetting8021x--system-ca-certs" title="The “system-ca-certs” property">system-ca-certs</a></td> <td class="property_flags">Read / Write / Construct</td> </tr> @@ -824,6 +850,10 @@ </tr> <tr> <td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-DOMAIN-SUFFIX-MATCH:CAPS" title="NM_SETTING_802_1X_DOMAIN_SUFFIX_MATCH">NM_SETTING_802_1X_DOMAIN_SUFFIX_MATCH</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> <td class="function_name"><a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CLIENT-CERT:CAPS" title="NM_SETTING_802_1X_CLIENT_CERT">NM_SETTING_802_1X_CLIENT_CERT</a></td> </tr> <tr> @@ -864,6 +894,10 @@ </tr> <tr> <td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-PHASE2-DOMAIN-SUFFIX-MATCH:CAPS" title="NM_SETTING_802_1X_PHASE2_DOMAIN_SUFFIX_MATCH">NM_SETTING_802_1X_PHASE2_DOMAIN_SUFFIX_MATCH</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> <td class="function_name"><a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-PHASE2-CLIENT-CERT:CAPS" title="NM_SETTING_802_1X_PHASE2_CLIENT_CERT">NM_SETTING_802_1X_PHASE2_CLIENT_CERT</a></td> </tr> <tr> @@ -923,10 +957,10 @@ </div> <div class="refsect1"> <a name="NMSetting8021x.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-Enumeration-and-Flag-Types.html">GEnum</a> +<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> <span class="lineart">├──</span> NMSetting8021xCKFormat <span class="lineart">╰──</span> NMSetting8021xCKScheme - <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + GObject <span class="lineart">╰──</span> <a class="link" href="NMSetting.html" title="NMSetting">NMSetting</a> <span class="lineart">╰──</span> NMSetting8021x </pre> @@ -968,9 +1002,9 @@ nm_setting_802_1x_new (<em class="parameter"><code><span class="type">void</span <div class="refsect2"> <a name="nm-setting-802-1x-check-cert-scheme"></a><h3>nm_setting_802_1x_check_cert_scheme ()</h3> <pre class="programlisting"><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="returnvalue">NMSetting8021xCKScheme</span></a> -nm_setting_802_1x_check_cert_scheme (<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> pdata</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +nm_setting_802_1x_check_cert_scheme (<em class="parameter"><code><span class="type">gconstpointer</span> pdata</code></em>, + <em class="parameter"><code><span class="type">gsize</span> length</code></em>, + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>Determines and verifies the blob type. When setting certificate properties of NMSetting8021x the blob must be not UNKNOWN (or NULL).</p> @@ -1011,7 +1045,7 @@ For NULL it also returns NM_SETTING_802_1X_CK_SCHEME_UNKNOWN.</p> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-num-eap-methods"></a><h3>nm_setting_802_1x_get_num_eap_methods ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<pre class="programlisting"><span class="returnvalue">guint32</span> nm_setting_802_1x_get_num_eap_methods (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Returns the number of eap methods allowed for use when connecting to the network. Generally only one EAP method is used. Use the functions @@ -1043,7 +1077,7 @@ allowed EAP methods.</p> <a name="nm-setting-802-1x-get-eap-method"></a><h3>nm_setting_802_1x_get_eap_method ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_eap_method (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Returns the name of the allowed EAP method at index <em class="parameter"><code>i</code></em> .</p> <div class="refsect3"> @@ -1077,7 +1111,7 @@ nm_setting_802_1x_get_eap_method (<em class="parameter"><code><a class="link" hr <hr> <div class="refsect2"> <a name="nm-setting-802-1x-add-eap-method"></a><h3>nm_setting_802_1x_add_eap_method ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_add_eap_method (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *eap</code></em>);</pre> <p>Adds an allowed EAP method. The setting is not valid until at least one @@ -1107,7 +1141,7 @@ allowed EAP methods.</p> </div> <div class="refsect3"> <a name="id-1.4.6.8.6.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the EAP method was successfully added, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was +<p> <code class="literal">TRUE</code> if the EAP method was successfully added, <code class="literal">FALSE</code> if it was not a valid method or if it was already allowed.</p> </div> </div> @@ -1116,7 +1150,7 @@ not a valid method or if it was already allowed.</p> <a name="nm-setting-802-1x-remove-eap-method"></a><h3>nm_setting_802_1x_remove_eap_method ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> nm_setting_802_1x_remove_eap_method (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Removes the allowed EAP method at the specified index.</p> <div class="refsect3"> <a name="id-1.4.6.8.7.5"></a><h4>Parameters</h4> @@ -1144,7 +1178,7 @@ nm_setting_802_1x_remove_eap_method (<em class="parameter"><code><a class="link" <hr> <div class="refsect2"> <a name="nm-setting-802-1x-remove-eap-method-by-value"></a><h3>nm_setting_802_1x_remove_eap_method_by_value ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_remove_eap_method_by_value (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *eap</code></em>);</pre> @@ -1174,7 +1208,7 @@ nm_setting_802_1x_remove_eap_method_by_value </div> <div class="refsect3"> <a name="id-1.4.6.8.8.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the EAP method was founs and removed, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was not.</p> +<p> <code class="literal">TRUE</code> if the EAP method was founs and removed, <code class="literal">FALSE</code> if it was not.</p> </div> </div> <hr> @@ -1285,12 +1319,12 @@ nm_setting_802_1x_get_pac_file (<em class="parameter"><code><a class="link" href <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-system-ca-certs"></a><h3>nm_setting_802_1x_get_system_ca_certs ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_get_system_ca_certs (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Sets the <a class="link" href="NMSetting8021x.html#NMSetting8021x--system-ca-certs" title="The “system-ca-certs” property"><span class="type">“system-ca-certs”</span></a> property. The <a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-path" title="The “ca-path” property"><span class="type">“ca-path”</span></a> and <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-path" title="The “phase2-ca-path” property"><span class="type">“phase2-ca-path”</span></a> properties are ignored if the <a class="link" href="NMSetting8021x.html#NMSetting8021x--system-ca-certs" title="The “system-ca-certs” property"><span class="type">“system-ca-certs”</span></a> property is -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, in which case a system-wide CA certificate directory specified at +<code class="literal">TRUE</code>, 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.</p> <div class="refsect3"> @@ -1310,7 +1344,7 @@ of these properties.</p> </div> <div class="refsect3"> <a name="id-1.4.6.8.13.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a system CA certificate path should be used, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</p> +<p> <code class="literal">TRUE</code> if a system CA certificate path should be used, <code class="literal">FALSE</code> if not</p> </div> </div> <hr> @@ -1404,7 +1438,7 @@ if <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CA <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-ca-cert-blob"></a><h3>nm_setting_802_1x_get_ca_cert_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_ca_cert_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Returns the CA certificate blob if the CA certificate is stored using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a> scheme. Not all EAP methods use a @@ -1467,12 +1501,12 @@ of the network cannot be confirmed by the client.</p> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-ca-cert"></a><h3>nm_setting_802_1x_set_ca_cert ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_ca_cert (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *cert_path</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>Reads a certificate from disk and sets the <a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-cert" title="The “ca-cert” property"><span class="type">“ca-cert”</span></a> property with the raw certificate data if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a> scheme, or with the path to the certificate file if using the @@ -1497,7 +1531,7 @@ scheme, or with the path to the certificate file if using the is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -<a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with any <em class="parameter"><code>scheme</code></em> +<code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the CA certificate.</p></td> <td class="parameter_annotations"> </td> </tr> @@ -1521,7 +1555,7 @@ clears the CA certificate.</p></td> </div> <div class="refsect3"> <a name="id-1.4.6.8.19.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -1548,14 +1582,14 @@ nm_setting_802_1x_get_subject_match (<em class="parameter"><code><a class="link" <a name="id-1.4.6.8.20.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting8021x.html#NMSetting8021x--subject-match" title="The “subject-match” property"><span class="type">“subject-match”</span></a> property. This is the substring to be matched against the subject of the authentication -server certificate, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> no subject verification is to be +server certificate, or <code class="literal">NULL</code> no subject verification is to be performed.</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-num-altsubject-matches"></a><h3>nm_setting_802_1x_get_num_altsubject_matches ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<pre class="programlisting"><span class="returnvalue">guint32</span> nm_setting_802_1x_get_num_altsubject_matches (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Returns the number of entries in the @@ -1586,7 +1620,7 @@ nm_setting_802_1x_get_num_altsubject_matches <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Returns the altSubjectName match at index <em class="parameter"><code>i</code></em> .</p> <div class="refsect3"> @@ -1620,7 +1654,7 @@ nm_setting_802_1x_get_altsubject_match <hr> <div class="refsect2"> <a name="nm-setting-802-1x-add-altsubject-match"></a><h3>nm_setting_802_1x_add_altsubject_match ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_add_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *altsubject_match</code></em>);</pre> @@ -1651,8 +1685,8 @@ server is not verified.</p> </div> <div class="refsect3"> <a name="id-1.4.6.8.23.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the alternative subject name match was -successfully added, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was already allowed.</p> +<p> <code class="literal">TRUE</code> if the alternative subject name match was +successfully added, <code class="literal">FALSE</code> if it was already allowed.</p> </div> </div> <hr> @@ -1661,7 +1695,7 @@ successfully added, <a href="https://developer.gnome.org/glib/unstable/glib-Stan <pre class="programlisting"><span class="returnvalue">void</span> nm_setting_802_1x_remove_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Removes the allowed altSubjectName at the specified index.</p> <div class="refsect3"> <a name="id-1.4.6.8.24.5"></a><h4>Parameters</h4> @@ -1689,7 +1723,7 @@ nm_setting_802_1x_remove_altsubject_match <hr> <div class="refsect2"> <a name="nm-setting-802-1x-remove-altsubject-match-by-value"></a><h3>nm_setting_802_1x_remove_altsubject_match_by_value ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_remove_altsubject_match_by_value (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *altsubject_match</code></em>);</pre> @@ -1719,8 +1753,8 @@ nm_setting_802_1x_remove_altsubject_match_by_value </div> <div class="refsect3"> <a name="id-1.4.6.8.25.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the alternative subject name match was found and removed, -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was not.</p> +<p> <code class="literal">TRUE</code> if the alternative subject name match was found and removed, +<code class="literal">FALSE</code> if it was not.</p> </div> </div> <hr> @@ -1748,6 +1782,33 @@ nm_setting_802_1x_clear_altsubject_matches </div> <hr> <div class="refsect2"> +<a name="nm-setting-802-1x-get-domain-suffix-match"></a><h3>nm_setting_802_1x_get_domain_suffix_match ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * +nm_setting_802_1x_get_domain_suffix_match + (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> +<div class="refsect3"> +<a name="id-1.4.6.8.27.4"></a><h4>Parameters</h4> +<div class="informaltable"><table width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>setting</p></td> +<td class="parameter_description"><p>the <a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="id-1.4.6.8.27.5"></a><h4>Returns</h4> +<p> the <a class="link" href="NMSetting8021x.html#NMSetting8021x--domain-suffix-match" title="The “domain-suffix-match” property"><span class="type">“domain-suffix-match”</span></a> property.</p> +</div> +<p class="since">Since: 1.2</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-setting-802-1x-get-client-cert-scheme"></a><h3>nm_setting_802_1x_get_client_cert_scheme ()</h3> <pre class="programlisting"><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="returnvalue">NMSetting8021xCKScheme</span></a> nm_setting_802_1x_get_client_cert_scheme @@ -1756,7 +1817,7 @@ nm_setting_802_1x_get_client_cert_scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-blob" title="nm_setting_802_1x_get_client_cert_blob ()"><code class="function">nm_setting_802_1x_get_client_cert_blob()</code></a>; if <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-path" title="nm_setting_802_1x_get_client_cert_path ()"><code class="function">nm_setting_802_1x_get_client_cert_path()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.6.8.27.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.28.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1771,21 +1832,21 @@ if <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CA </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.27.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.28.6"></a><h4>Returns</h4> <p> scheme used to store the client certificate (blob or path)</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-client-cert-blob"></a><h3>nm_setting_802_1x_get_client_cert_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_client_cert_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.28.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.29.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1800,7 +1861,7 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.28.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.29.6"></a><h4>Returns</h4> <p> the client certificate data. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -1815,7 +1876,7 @@ nm_setting_802_1x_get_client_cert_path when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.29.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.30.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1830,19 +1891,19 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.29.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.30.6"></a><h4>Returns</h4> <p> path to the client certificate file</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-client-cert"></a><h3>nm_setting_802_1x_set_client_cert ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_client_cert (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *cert_path</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>Reads a certificate from disk and sets the <a class="link" href="NMSetting8021x.html#NMSetting8021x--client-cert" title="The “client-cert” property"><span class="type">“client-cert”</span></a> property with the raw certificate data if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a> scheme, or with the path to the certificate @@ -1851,7 +1912,7 @@ file if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.30.6"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.31.6"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1870,7 +1931,7 @@ authentication method.</p> is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use <a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with +encoded; use <code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the client certificate.</p></td> <td class="parameter_annotations"> </td> @@ -1894,8 +1955,8 @@ clears the client certificate.</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.30.7"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<a name="id-1.4.6.8.31.7"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -1904,7 +1965,7 @@ clears the client certificate.</p></td> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_phase1_peapver (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.31.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.32.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1919,10 +1980,10 @@ nm_setting_802_1x_get_phase1_peapver (<em class="parameter"><code><a class="link </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.31.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.32.5"></a><h4>Returns</h4> <p> the "phase 1" PEAP version to be used when authenticating with EAP-PEAP as contained in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-peapver" title="The “phase1-peapver” property"><span class="type">“phase1-peapver”</span></a> property. Valid -values are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (unset), "0" (PEAP version 0), and "1" (PEAP version 1).</p> +values are <code class="literal">NULL</code> (unset), "0" (PEAP version 0), and "1" (PEAP version 1).</p> </div> </div> <hr> @@ -1932,7 +1993,7 @@ values are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macr nm_setting_802_1x_get_phase1_peaplabel (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.32.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.33.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1947,10 +2008,10 @@ nm_setting_802_1x_get_phase1_peaplabel </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.32.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.33.5"></a><h4>Returns</h4> <p> whether the "phase 1" PEAP label is new-style or old-style, to be used when authenticating with EAP-PEAP, as contained in the -<a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-peaplabel" title="The “phase1-peaplabel” property"><span class="type">“phase1-peaplabel”</span></a> property. Valid values are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (unset), +<a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-peaplabel" title="The “phase1-peaplabel” property"><span class="type">“phase1-peaplabel”</span></a> property. Valid values are <code class="literal">NULL</code> (unset), "0" (use old-style label), and "1" (use new-style label). See the wpa_supplicant documentation for more details.</p> </div> @@ -1962,7 +2023,7 @@ wpa_supplicant documentation for more details.</p> nm_setting_802_1x_get_phase1_fast_provisioning (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.33.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.34.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1977,7 +2038,7 @@ nm_setting_802_1x_get_phase1_fast_provisioning </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.33.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.34.5"></a><h4>Returns</h4> <p> whether "phase 1" PEAP fast provisioning should be used, as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase1-fast-provisioning" title="The “phase1-fast-provisioning” property"><span class="type">“phase1-fast-provisioning”</span></a> property. See the wpa_supplicant documentation for more details.</p> @@ -1989,7 +2050,7 @@ wpa_supplicant documentation for more details.</p> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_phase2_auth (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.34.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.35.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2004,7 +2065,7 @@ nm_setting_802_1x_get_phase2_auth (<em class="parameter"><code><a class="link" h </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.34.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.35.5"></a><h4>Returns</h4> <p> the "phase 2" non-EAP (ex MD5) allowed authentication method as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-auth" title="The “phase2-auth” property"><span class="type">“phase2-auth”</span></a> property.</p> </div> @@ -2015,7 +2076,7 @@ specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_phase2_autheap (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.35.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.36.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2030,7 +2091,7 @@ nm_setting_802_1x_get_phase2_autheap (<em class="parameter"><code><a class="link </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.35.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.36.5"></a><h4>Returns</h4> <p> the "phase 2" EAP-based (ex TLS) allowed authentication method as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-autheap" title="The “phase2-autheap” property"><span class="type">“phase2-autheap”</span></a> property.</p> </div> @@ -2046,7 +2107,7 @@ returned scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-C <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-ca-cert-blob" title="nm_setting_802_1x_get_ca_cert_blob ()"><code class="function">nm_setting_802_1x_get_ca_cert_blob()</code></a>; if <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-ca-cert-path" title="nm_setting_802_1x_get_ca_cert_path ()"><code class="function">nm_setting_802_1x_get_ca_cert_path()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.6.8.36.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.37.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2061,14 +2122,14 @@ use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-ca-cert-path </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.36.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.37.6"></a><h4>Returns</h4> <p> scheme used to store the "phase 2" CA certificate (blob or path)</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-phase2-ca-cert-blob"></a><h3>nm_setting_802_1x_get_phase2_ca_cert_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_phase2_ca_cert_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Returns the "phase 2" CA certificate blob if the CA certificate is stored @@ -2078,7 +2139,7 @@ CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity of the network cannot be confirmed by the client.</p> <div class="refsect3"> -<a name="id-1.4.6.8.37.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.38.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2093,7 +2154,7 @@ of the network cannot be confirmed by the client.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.37.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.38.6"></a><h4>Returns</h4> <p> the "phase 2" CA certificate data. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -2111,7 +2172,7 @@ CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity of the network cannot be confirmed by the client.</p> <div class="refsect3"> -<a name="id-1.4.6.8.38.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.39.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2126,25 +2187,25 @@ of the network cannot be confirmed by the client.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.38.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.39.6"></a><h4>Returns</h4> <p> path to the "phase 2" CA certificate file</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-phase2-ca-cert"></a><h3>nm_setting_802_1x_set_phase2_ca_cert ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_phase2_ca_cert (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *cert_path</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>Reads a certificate from disk and sets the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-cert" title="The “phase2-ca-cert” property"><span class="type">“phase2-ca-cert”</span></a> property with the raw certificate data if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a> scheme, or with the path to the certificate file if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> scheme.</p> <div class="refsect3"> -<a name="id-1.4.6.8.39.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.40.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2163,7 +2224,7 @@ file if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the "phase2" CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -<a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with any <em class="parameter"><code>scheme</code></em> +<code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the "phase2" CA certificate.</p></td> <td class="parameter_annotations"> </td> </tr> @@ -2186,8 +2247,8 @@ clears the "phase2" CA certificate.</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.39.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<a name="id-1.4.6.8.40.6"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -2197,7 +2258,7 @@ clears the "phase2" CA certificate.</p></td> nm_setting_802_1x_get_phase2_subject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.40.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.41.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2212,23 +2273,23 @@ nm_setting_802_1x_get_phase2_subject_match </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.40.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.41.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-subject-match" title="The “phase2-subject-match” property"><span class="type">“phase2-subject-match”</span></a> property. This is the substring to be matched against the subject of the "phase 2" -authentication server certificate, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> no subject verification +authentication server certificate, or <code class="literal">NULL</code> no subject verification is to be performed.</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-num-phase2-altsubject-matches"></a><h3>nm_setting_802_1x_get_num_phase2_altsubject_matches ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> +<pre class="programlisting"><span class="returnvalue">guint32</span> nm_setting_802_1x_get_num_phase2_altsubject_matches (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Returns the number of entries in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-altsubject-matches" title="The “phase2-altsubject-matches” property"><span class="type">“phase2-altsubject-matches”</span></a> property of this setting.</p> <div class="refsect3"> -<a name="id-1.4.6.8.41.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.42.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2243,7 +2304,7 @@ nm_setting_802_1x_get_num_phase2_altsubject_matches </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.41.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.42.6"></a><h4>Returns</h4> <p> the number of phase2-altsubject-matches entries.</p> </div> </div> @@ -2253,11 +2314,11 @@ nm_setting_802_1x_get_num_phase2_altsubject_matches <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_phase2_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Returns the "phase 2" altSubjectName match at index <em class="parameter"><code>i</code></em> .</p> <div class="refsect3"> -<a name="id-1.4.6.8.42.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.43.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2279,7 +2340,7 @@ nm_setting_802_1x_get_phase2_altsubject_match </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.42.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.43.6"></a><h4>Returns</h4> <p> the "phase 2" altSubjectName match at index <em class="parameter"><code>i</code></em> </p> </div> @@ -2287,7 +2348,7 @@ nm_setting_802_1x_get_phase2_altsubject_match <hr> <div class="refsect2"> <a name="nm-setting-802-1x-add-phase2-altsubject-match"></a><h3>nm_setting_802_1x_add_phase2_altsubject_match ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_add_phase2_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *phase2_altsubject_match</code></em>);</pre> @@ -2295,7 +2356,7 @@ nm_setting_802_1x_add_phase2_altsubject_match at least one match is added, the altSubjectName of the "phase 2" remote authentication server is not verified.</p> <div class="refsect3"> -<a name="id-1.4.6.8.43.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.44.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2318,9 +2379,9 @@ connection</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.43.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the "phase 2" alternative subject name match was -successfully added, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was already allowed.</p> +<a name="id-1.4.6.8.44.6"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the "phase 2" alternative subject name match was +successfully added, <code class="literal">FALSE</code> if it was already allowed.</p> </div> </div> <hr> @@ -2329,10 +2390,10 @@ successfully added, <a href="https://developer.gnome.org/glib/unstable/glib-Stan <pre class="programlisting"><span class="returnvalue">void</span> nm_setting_802_1x_remove_phase2_altsubject_match (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> i</code></em>);</pre> + <em class="parameter"><code><span class="type">guint32</span> i</code></em>);</pre> <p>Removes the allowed "phase 2" altSubjectName at the specified index.</p> <div class="refsect3"> -<a name="id-1.4.6.8.44.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.45.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2357,14 +2418,14 @@ nm_setting_802_1x_remove_phase2_altsubject_match <hr> <div class="refsect2"> <a name="nm-setting-802-1x-remove-phase2-altsubject-match-by-value"></a><h3>nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_remove_phase2_altsubject_match_by_value (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *phase2_altsubject_match</code></em>);</pre> <p>Removes the allowed "phase 2" altSubjectName <em class="parameter"><code>phase2_altsubject_match</code></em> .</p> <div class="refsect3"> -<a name="id-1.4.6.8.45.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.46.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2386,9 +2447,9 @@ nm_setting_802_1x_remove_phase2_altsubject_match_by_value </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.45.6"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the alternative subject name match for "phase 2" was found and removed, -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was not.</p> +<a name="id-1.4.6.8.46.6"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the alternative subject name match for "phase 2" was found and removed, +<code class="literal">FALSE</code> if it was not.</p> </div> </div> <hr> @@ -2399,7 +2460,7 @@ nm_setting_802_1x_clear_phase2_altsubject_matches (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Clears all "phase 2" altSubjectName matches.</p> <div class="refsect3"> -<a name="id-1.4.6.8.46.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.47.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2416,6 +2477,33 @@ nm_setting_802_1x_clear_phase2_altsubject_matches </div> <hr> <div class="refsect2"> +<a name="nm-setting-802-1x-get-phase2-domain-suffix-match"></a><h3>nm_setting_802_1x_get_phase2_domain_suffix_match ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * +nm_setting_802_1x_get_phase2_domain_suffix_match + (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> +<div class="refsect3"> +<a name="id-1.4.6.8.48.4"></a><h4>Parameters</h4> +<div class="informaltable"><table width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>setting</p></td> +<td class="parameter_description"><p>the <a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="id-1.4.6.8.48.5"></a><h4>Returns</h4> +<p> the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-domain-suffix-match" title="The “phase2-domain-suffix-match” property"><span class="type">“phase2-domain-suffix-match”</span></a> property.</p> +</div> +<p class="since">Since: 1.2</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-setting-802-1x-get-phase2-client-cert-scheme"></a><h3>nm_setting_802_1x_get_phase2_client_cert_scheme ()</h3> <pre class="programlisting"><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="returnvalue">NMSetting8021xCKScheme</span></a> nm_setting_802_1x_get_phase2_client_cert_scheme @@ -2426,7 +2514,7 @@ returned scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-C <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-path" title="nm_setting_802_1x_get_client_cert_path ()"><code class="function">nm_setting_802_1x_get_client_cert_path()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.6.8.47.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.49.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2441,21 +2529,21 @@ returned scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-C </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.47.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.49.6"></a><h4>Returns</h4> <p> scheme used to store the "phase 2" client certificate (blob or path)</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-phase2-client-cert-blob"></a><h3>nm_setting_802_1x_get_phase2_client_cert_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_phase2_client_cert_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.48.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.50.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2470,7 +2558,7 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.48.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.50.6"></a><h4>Returns</h4> <p> the "phase 2" client certificate data. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -2485,7 +2573,7 @@ nm_setting_802_1x_get_phase2_client_cert_path when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.49.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.51.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2500,20 +2588,20 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.49.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.51.6"></a><h4>Returns</h4> <p> path to the "phase 2" client certificate file</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-phase2-client-cert"></a><h3>nm_setting_802_1x_set_phase2_client_cert ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_phase2_client_cert (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *cert_path</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>Reads a certificate from disk and sets the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-client-cert" title="The “phase2-client-cert” property"><span class="type">“phase2-client-cert”</span></a> property with the raw certificate data if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a> scheme, or with the path to the certificate @@ -2522,7 +2610,7 @@ file if using the <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.50.6"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.52.6"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2541,7 +2629,7 @@ authentication method.</p> is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the "phase2" client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use <a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with +encoded; use <code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the "phase2" client certificate.</p></td> <td class="parameter_annotations"> </td> @@ -2565,8 +2653,8 @@ clears the "phase2" client certificate.</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.50.7"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<a name="id-1.4.6.8.52.7"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -2575,7 +2663,7 @@ clears the "phase2" client certificate.</p></td> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_password (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.51.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.53.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2590,7 +2678,7 @@ nm_setting_802_1x_get_password (<em class="parameter"><code><a class="link" href </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.51.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.53.5"></a><h4>Returns</h4> <p> the password used by the authentication method, if any, as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property"><span class="type">“password”</span></a> property</p> </div> @@ -2601,7 +2689,7 @@ by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title <pre class="programlisting"><a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="returnvalue">NMSettingSecretFlags</span></a> nm_setting_802_1x_get_password_flags (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.52.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.54.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2616,17 +2704,17 @@ nm_setting_802_1x_get_password_flags (<em class="parameter"><code><a class="link </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.52.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.54.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property"><span class="type">“password”</span></a></p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-password-raw"></a><h3>nm_setting_802_1x_get_password_raw ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_password_raw (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.53.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.55.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2641,7 +2729,7 @@ nm_setting_802_1x_get_password_raw (<em class="parameter"><code><a class="link" </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.53.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.55.5"></a><h4>Returns</h4> <p> the password used by the authentication method as a UTF-8-encoded array of bytes, as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password-raw" title="The “password-raw” property"><span class="type">“password-raw”</span></a> property. </p> @@ -2655,7 +2743,7 @@ UTF-8-encoded array of bytes, as specified by the nm_setting_802_1x_get_password_raw_flags (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.54.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.56.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2670,7 +2758,7 @@ nm_setting_802_1x_get_password_raw_flags </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.54.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.56.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password-raw" title="The “password-raw” property"><span class="type">“password-raw”</span></a></p> </div> @@ -2681,7 +2769,7 @@ nm_setting_802_1x_get_password_raw_flags <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_802_1x_get_pin (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.55.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.57.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2696,7 +2784,7 @@ nm_setting_802_1x_get_pin (<em class="parameter"><code><a class="link" href="NMS </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.55.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.57.5"></a><h4>Returns</h4> <p> the PIN used by the authentication method, if any, as specified by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--pin" title="The “pin” property"><span class="type">“pin”</span></a> property</p> </div> @@ -2707,7 +2795,7 @@ by the <a class="link" href="NMSetting8021x.html#NMSetting8021x--pin" title="The <pre class="programlisting"><a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="returnvalue">NMSettingSecretFlags</span></a> nm_setting_802_1x_get_pin_flags (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.56.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.58.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2722,7 +2810,7 @@ nm_setting_802_1x_get_pin_flags (<em class="parameter"><code><a class="link" hre </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.56.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.58.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSetting8021x.html#NMSetting8021x--pin" title="The “pin” property"><span class="type">“pin”</span></a></p> </div> @@ -2739,7 +2827,7 @@ nm_setting_802_1x_get_private_key_scheme <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-path" title="nm_setting_802_1x_get_client_cert_path ()"><code class="function">nm_setting_802_1x_get_client_cert_path()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.6.8.57.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.59.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2754,14 +2842,14 @@ nm_setting_802_1x_get_private_key_scheme </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.57.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.59.6"></a><h4>Returns</h4> <p> scheme used to store the private key (blob or path)</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-private-key-blob"></a><h3>nm_setting_802_1x_get_private_key_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_private_key_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Private keys are used to authenticate the connecting client to the network @@ -2771,7 +2859,7 @@ authentication method.</p> unencrypted private key data may be readable by unprivileged users. Private keys should always be encrypted with a private key password.</p> <div class="refsect3"> -<a name="id-1.4.6.8.58.6"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.60.6"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2786,7 +2874,7 @@ keys should always be encrypted with a private key password.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.58.7"></a><h4>Returns</h4> +<a name="id-1.4.6.8.60.7"></a><h4>Returns</h4> <p> the private key data. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -2801,7 +2889,7 @@ nm_setting_802_1x_get_private_key_path when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.59.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.61.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2816,20 +2904,20 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.59.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.61.6"></a><h4>Returns</h4> <p> path to the private key file</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-private-key"></a><h3>nm_setting_802_1x_set_private_key ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_private_key (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *key_path</code></em>, <em class="parameter"><code>const <span class="type">char</span> *password</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>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.</p> @@ -2843,7 +2931,7 @@ verify that <em class="parameter"><code>password</code></em> is correct, and if it is, updates the <a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key-password" title="The “private-key-password” property"><span class="type">“private-key-password”</span></a> property with the given <em class="parameter"><code>password</code></em> . If -the decryption is unsuccessful, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, <em class="parameter"><code>error</code></em> +the decryption is unsuccessful, <code class="literal">FALSE</code> is returned, <em class="parameter"><code>error</code></em> is set, and no internal data is changed. If no <em class="parameter"><code>password</code></em> is given, the private key is @@ -2854,7 +2942,7 @@ unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private key password to prevent unauthorized access to unencrypted private key data.</p> <div class="refsect3"> -<a name="id-1.4.6.8.60.8"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.62.8"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2873,13 +2961,13 @@ key password to prevent unauthorized access to unencrypted private key data.</p> is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; use -<a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with any <em class="parameter"><code>scheme</code></em> +<code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the private key.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>password</p></td> -<td class="parameter_description"><p>password used to decrypt the private key, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the password +<td class="parameter_description"><p>password used to decrypt the private key, or <code class="literal">NULL</code> if the password is unknown. If the password is given but fails to decrypt the private key, an error is returned.</p></td> <td class="parameter_annotations"> </td> @@ -2903,8 +2991,8 @@ an error is returned.</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.60.9"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<a name="id-1.4.6.8.62.9"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -2914,7 +3002,7 @@ an error is returned.</p></td> nm_setting_802_1x_get_private_key_password (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.61.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.63.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2929,7 +3017,7 @@ nm_setting_802_1x_get_private_key_password </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.61.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.63.5"></a><h4>Returns</h4> <p> the private key password used to decrypt the private key if previously set with <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-private-key" title="nm_setting_802_1x_set_private_key ()"><code class="function">nm_setting_802_1x_set_private_key()</code></a>, or the <a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key-password" title="The “private-key-password” property"><span class="type">“private-key-password”</span></a> property.</p> @@ -2942,7 +3030,7 @@ previously set with <a class="link" href="NMSetting8021x.html#nm-setting-802-1x- nm_setting_802_1x_get_private_key_password_flags (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.62.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.64.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2957,7 +3045,7 @@ nm_setting_802_1x_get_private_key_password_flags </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.62.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.64.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key-password" title="The “private-key-password” property"><span class="type">“private-key-password”</span></a></p> </div> @@ -2969,7 +3057,7 @@ nm_setting_802_1x_get_private_key_password_flags nm_setting_802_1x_get_private_key_format (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.63.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.65.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -2984,7 +3072,7 @@ nm_setting_802_1x_get_private_key_format </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.63.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.65.5"></a><h4>Returns</h4> <p> the data format of the private key data stored in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key" title="The “private-key” property"><span class="type">“private-key”</span></a> property</p> </div> @@ -3001,7 +3089,7 @@ scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME- <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a>, use <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-get-client-cert-path" title="nm_setting_802_1x_get_client_cert_path ()"><code class="function">nm_setting_802_1x_get_client_cert_path()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.6.8.64.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.66.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3016,14 +3104,14 @@ scheme is <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME- </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.64.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.66.6"></a><h4>Returns</h4> <p> scheme used to store the "phase 2" private key (blob or path)</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-get-phase2-private-key-blob"></a><h3>nm_setting_802_1x_get_phase2_private_key_blob ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +<pre class="programlisting"><span class="returnvalue">GBytes</span> * nm_setting_802_1x_get_phase2_private_key_blob (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <p>Private keys are used to authenticate the connecting client to the network @@ -3033,7 +3121,7 @@ authentication method.</p> unencrypted private key data may be readable by unprivileged users. Private keys should always be encrypted with a private key password.</p> <div class="refsect3"> -<a name="id-1.4.6.8.65.6"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.67.6"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3048,7 +3136,7 @@ keys should always be encrypted with a private key password.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.65.7"></a><h4>Returns</h4> +<a name="id-1.4.6.8.67.7"></a><h4>Returns</h4> <p> the "phase 2" private key data. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -3063,7 +3151,7 @@ nm_setting_802_1x_get_phase2_private_key_path when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.</p> <div class="refsect3"> -<a name="id-1.4.6.8.66.5"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.68.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3078,21 +3166,21 @@ authentication method.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.66.6"></a><h4>Returns</h4> +<a name="id-1.4.6.8.68.6"></a><h4>Returns</h4> <p> path to the "phase 2" private key file</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-802-1x-set-phase2-private-key"></a><h3>nm_setting_802_1x_set_phase2_private_key ()</h3> -<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +<pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_802_1x_set_phase2_private_key (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *key_path</code></em>, <em class="parameter"><code>const <span class="type">char</span> *password</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKScheme" title="enum NMSetting8021xCKScheme"><span class="type">NMSetting8021xCKScheme</span></a> scheme</code></em>, <em class="parameter"><code><a class="link" href="NMSetting8021x.html#NMSetting8021xCKFormat" title="enum NMSetting8021xCKFormat"><span class="type">NMSetting8021xCKFormat</span></a> *out_format</code></em>, - <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> + <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> <p>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.</p> @@ -3106,7 +3194,7 @@ verify that <em class="parameter"><code>password</code></em> is correct, and if it is, updates the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key-password" title="The “phase2-private-key-password” property"><span class="type">“phase2-private-key-password”</span></a> property with the given <em class="parameter"><code>password</code></em> -. If the decryption is unsuccessful, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, <em class="parameter"><code>error</code></em> +. If the decryption is unsuccessful, <code class="literal">FALSE</code> is returned, <em class="parameter"><code>error</code></em> is set, and no internal data is changed. If no <em class="parameter"><code>password</code></em> is given, the private @@ -3117,7 +3205,7 @@ thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private key password to prevent unauthorized access to unencrypted private key data.</p> <div class="refsect3"> -<a name="id-1.4.6.8.67.8"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.69.8"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3136,14 +3224,14 @@ key password to prevent unauthorized access to unencrypted private key data.</p> is set to either <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-PATH:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_PATH</code></a> or <a class="link" href="NMSetting8021x.html#NM-SETTING-802-1X-CK-SCHEME-BLOB:CAPS"><code class="literal">NM_SETTING_802_1X_CK_SCHEME_BLOB</code></a>, pass the path of the "phase2" private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; -use <a href="https://developer.gnome.org/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert if needed. Passing <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> with any +use <code class="function">g_filename_to_utf8()</code> to convert if needed. Passing <code class="literal">NULL</code> with any <em class="parameter"><code>scheme</code></em> clears the private key.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>password</p></td> -<td class="parameter_description"><p>password used to decrypt the private key, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the password +<td class="parameter_description"><p>password used to decrypt the private key, or <code class="literal">NULL</code> if the password is unknown. If the password is given but fails to decrypt the private key, an error is returned.</p></td> <td class="parameter_annotations"> </td> @@ -3167,8 +3255,8 @@ an error is returned.</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.67.9"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was unsuccessful</p> +<a name="id-1.4.6.8.69.9"></a><h4>Returns</h4> +<p> <code class="literal">TRUE</code> if the operation succeeded, <code class="literal">FALSE</code> if it was unsuccessful</p> </div> </div> <hr> @@ -3178,7 +3266,7 @@ an error is returned.</p></td> nm_setting_802_1x_get_phase2_private_key_password (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.68.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.70.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3193,7 +3281,7 @@ nm_setting_802_1x_get_phase2_private_key_password </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.68.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.70.5"></a><h4>Returns</h4> <p> the private key password used to decrypt the private key if previously set with <a class="link" href="NMSetting8021x.html#nm-setting-802-1x-set-phase2-private-key" title="nm_setting_802_1x_set_phase2_private_key ()"><code class="function">nm_setting_802_1x_set_phase2_private_key()</code></a> or the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key-password" title="The “phase2-private-key-password” property"><span class="type">“phase2-private-key-password”</span></a> property.</p> @@ -3206,7 +3294,7 @@ previously set with <a class="link" href="NMSetting8021x.html#nm-setting-802-1x- nm_setting_802_1x_get_phase2_private_key_password_flags (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.69.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.71.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3221,7 +3309,7 @@ nm_setting_802_1x_get_phase2_private_key_password_flags </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.69.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.71.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key-password" title="The “phase2-private-key-password” property"><span class="type">“phase2-private-key-password”</span></a></p> </div> @@ -3233,7 +3321,7 @@ nm_setting_802_1x_get_phase2_private_key_password_flags nm_setting_802_1x_get_phase2_private_key_format (<em class="parameter"><code><a class="link" href="NMSetting8021x.html" title="NMSetting8021x"><span class="type">NMSetting8021x</span></a> *setting</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.6.8.70.4"></a><h4>Parameters</h4> +<a name="id-1.4.6.8.72.4"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -3248,7 +3336,7 @@ nm_setting_802_1x_get_phase2_private_key_format </table></div> </div> <div class="refsect3"> -<a name="id-1.4.6.8.70.5"></a><h4>Returns</h4> +<a name="id-1.4.6.8.72.5"></a><h4>Returns</h4> <p> the data format of the "phase 2" private key data stored in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key" title="The “phase2-private-key” property"><span class="type">“phase2-private-key”</span></a> property</p> </div> @@ -3408,6 +3496,12 @@ to a file containing the certificate or key data</p> </div> <hr> <div class="refsect2"> +<a name="NM-SETTING-802-1X-DOMAIN-SUFFIX-MATCH:CAPS"></a><h3>NM_SETTING_802_1X_DOMAIN_SUFFIX_MATCH</h3> +<pre class="programlisting">#define NM_SETTING_802_1X_DOMAIN_SUFFIX_MATCH "domain-suffix-match" +</pre> +</div> +<hr> +<div class="refsect2"> <a name="NM-SETTING-802-1X-CLIENT-CERT:CAPS"></a><h3>NM_SETTING_802_1X_CLIENT_CERT</h3> <pre class="programlisting">#define NM_SETTING_802_1X_CLIENT_CERT "client-cert" </pre> @@ -3468,6 +3562,12 @@ to a file containing the certificate or key data</p> </div> <hr> <div class="refsect2"> +<a name="NM-SETTING-802-1X-PHASE2-DOMAIN-SUFFIX-MATCH:CAPS"></a><h3>NM_SETTING_802_1X_PHASE2_DOMAIN_SUFFIX_MATCH</h3> +<pre class="programlisting">#define NM_SETTING_802_1X_PHASE2_DOMAIN_SUFFIX_MATCH "phase2-domain-suffix-match" +</pre> +</div> +<hr> +<div class="refsect2"> <a name="NM-SETTING-802-1X-PHASE2-CLIENT-CERT:CAPS"></a><h3>NM_SETTING_802_1X_PHASE2_CLIENT_CERT</h3> <pre class="programlisting">#define NM_SETTING_802_1X_PHASE2_CLIENT_CERT "phase2-client-cert" </pre> @@ -3555,7 +3655,7 @@ to a file containing the certificate or key data</p> <a name="NMSetting8021x.property-details"></a><h2>Property Details</h2> <div class="refsect2"> <a name="NMSetting8021x--altsubject-matches"></a><h3>The <code class="literal">“altsubject-matches”</code> property</h3> -<pre class="programlisting"> “altsubject-matches” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> +<pre class="programlisting"> “altsubject-matches” <span class="type">GStrv</span></pre> <p>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.</p> @@ -3564,7 +3664,7 @@ no verification of the server certificate's altSubjectName is performed.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--anonymous-identity"></a><h3>The <code class="literal">“anonymous-identity”</code> property</h3> -<pre class="programlisting"> “anonymous-identity” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “anonymous-identity” <span class="type">gchar</span> *</pre> <p>Anonymous identity string for EAP authentication methods. Used as the unencrypted identity with EAP types that support different tunneled identity like EAP-TTLS.</p> @@ -3574,7 +3674,7 @@ identity like EAP-TTLS.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--ca-cert"></a><h3>The <code class="literal">“ca-cert”</code> property</h3> -<pre class="programlisting"> “ca-cert” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “ca-cert” <span class="type">GBytes</span> *</pre> <p>Contains the CA certificate if used by the EAP method specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property.</p> <p>Certificate data is specified using a "scheme"; two are currently @@ -3592,7 +3692,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--ca-path"></a><h3>The <code class="literal">“ca-path”</code> property</h3> -<pre class="programlisting"> “ca-path” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “ca-path” <span class="type">gchar</span> *</pre> <p>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 <a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-cert" title="The “ca-cert” property"><span class="type">“ca-cert”</span></a> property.</p> @@ -3602,7 +3702,7 @@ certificate specified in the <a class="link" href="NMSetting8021x.html#NMSetting <hr> <div class="refsect2"> <a name="NMSetting8021x--client-cert"></a><h3>The <code class="literal">“client-cert”</code> property</h3> -<pre class="programlisting"> “client-cert” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “client-cert” <span class="type">GBytes</span> *</pre> <p>Contains the client certificate if used by the EAP method specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property.</p> <p>Certificate data is specified using a "scheme"; two are currently @@ -3617,8 +3717,21 @@ with the string "file://" and ending with a terminating NUL byte.</p> </div> <hr> <div class="refsect2"> +<a name="NMSetting8021x--domain-suffix-match"></a><h3>The <code class="literal">“domain-suffix-match”</code> property</h3> +<pre class="programlisting"> “domain-suffix-match” <span class="type">gchar</span> *</pre> +<p>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 +constraint is met. If no dNSName values are present, this constraint is +matched against SubjectName CN using same suffix match comparison.</p> +<p>Flags: Read / Write</p> +<p>Default value: NULL</p> +<p class="since">Since: 1.2</p> +</div> +<hr> +<div class="refsect2"> <a name="NMSetting8021x--eap"></a><h3>The <code class="literal">“eap”</code> property</h3> -<pre class="programlisting"> “eap” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> +<pre class="programlisting"> “eap” <span class="type">GStrv</span></pre> <p>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 @@ -3629,7 +3742,7 @@ allowed combinations.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--identity"></a><h3>The <code class="literal">“identity”</code> property</h3> -<pre class="programlisting"> “identity” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “identity” <span class="type">gchar</span> *</pre> <p>Identity string for EAP authentication methods. Often the user's user or login name.</p> <p>Flags: Read / Write</p> @@ -3638,7 +3751,7 @@ login name.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--pac-file"></a><h3>The <code class="literal">“pac-file”</code> property</h3> -<pre class="programlisting"> “pac-file” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “pac-file” <span class="type">gchar</span> *</pre> <p>UTF-8 encoded file path containing PAC for EAP-FAST.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> @@ -3646,7 +3759,7 @@ login name.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--password"></a><h3>The <code class="literal">“password”</code> property</h3> -<pre class="programlisting"> “password” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “password” <span class="type">gchar</span> *</pre> <p>UTF-8 encoded password used for EAP authentication methods. If both the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property"><span class="type">“password”</span></a> property and the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password-raw" title="The “password-raw” property"><span class="type">“password-raw”</span></a> property are specified, <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property"><span class="type">“password”</span></a> is preferred.</p> @@ -3663,7 +3776,7 @@ property are specified, <a class="link" href="NMSetting8021x.html#NMSetting8021x <hr> <div class="refsect2"> <a name="NMSetting8021x--password-raw"></a><h3>The <code class="literal">“password-raw”</code> property</h3> -<pre class="programlisting"> “password-raw” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “password-raw” <span class="type">GBytes</span> *</pre> <p>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 <a class="link" href="NMSetting8021x.html#NMSetting8021x--password" title="The “password” property"><span class="type">“password”</span></a> property and the <a class="link" href="NMSetting8021x.html#NMSetting8021x--password-raw" title="The “password-raw” property"><span class="type">“password-raw”</span></a> @@ -3680,7 +3793,7 @@ property are specified, <a class="link" href="NMSetting8021x.html#NMSetting8021x <hr> <div class="refsect2"> <a name="NMSetting8021x--phase1-fast-provisioning"></a><h3>The <code class="literal">“phase1-fast-provisioning”</code> property</h3> -<pre class="programlisting"> “phase1-fast-provisioning” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase1-fast-provisioning” <span class="type">gchar</span> *</pre> <p>Enables or disables in-line provisioning of EAP-FAST credentials when FAST is specified as the EAP method in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property. Recognized values are "0" (disabled), "1" (allow unauthenticated @@ -3693,7 +3806,7 @@ wpa_supplicant documentation for more details.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase1-peaplabel"></a><h3>The <code class="literal">“phase1-peaplabel”</code> property</h3> -<pre class="programlisting"> “phase1-peaplabel” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase1-peaplabel” <span class="type">gchar</span> *</pre> <p>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 @@ -3704,7 +3817,7 @@ wpa_supplicant documentation for more details.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase1-peapver"></a><h3>The <code class="literal">“phase1-peapver”</code> property</h3> -<pre class="programlisting"> “phase1-peapver” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase1-peapver” <span class="type">gchar</span> *</pre> <p>Forces which PEAP version is used when PEAP is set as the EAP method in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property. When unset, the version reported by the server will be used. Sometimes when using older RADIUS servers, it @@ -3717,7 +3830,7 @@ version.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-altsubject-matches"></a><h3>The <code class="literal">“phase2-altsubject-matches”</code> property</h3> -<pre class="programlisting"> “phase2-altsubject-matches” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> +<pre class="programlisting"> “phase2-altsubject-matches” <span class="type">GStrv</span></pre> <p>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 @@ -3727,7 +3840,7 @@ server certificate's altSubjectName is performed.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-auth"></a><h3>The <code class="literal">“phase2-auth”</code> property</h3> -<pre class="programlisting"> “phase2-auth” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase2-auth” <span class="type">gchar</span> *</pre> <p>Specifies the allowed "phase 2" inner non-EAP authentication methods when an EAP method that uses an inner TLS tunnel is specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property. Recognized non-EAP "phase 2" methods are @@ -3740,7 +3853,7 @@ authentication; see the wpa_supplicant documentation for more details.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-autheap"></a><h3>The <code class="literal">“phase2-autheap”</code> property</h3> -<pre class="programlisting"> “phase2-autheap” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase2-autheap” <span class="type">gchar</span> *</pre> <p>Specifies the allowed "phase 2" inner EAP-based authentication methods when an EAP method that uses an inner TLS tunnel is specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property. Recognized EAP-based "phase 2" methods are @@ -3753,7 +3866,7 @@ wpa_supplicant documentation for more details.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-ca-cert"></a><h3>The <code class="literal">“phase2-ca-cert”</code> property</h3> -<pre class="programlisting"> “phase2-ca-cert” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “phase2-ca-cert” <span class="type">GBytes</span> *</pre> <p>Contains the "phase 2" CA certificate if used by the EAP method specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-auth" title="The “phase2-auth” property"><span class="type">“phase2-auth”</span></a> or <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-autheap" title="The “phase2-autheap” property"><span class="type">“phase2-autheap”</span></a> properties.</p> @@ -3772,7 +3885,7 @@ but this allows man-in-the-middle attacks and is NOT recommended.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-ca-path"></a><h3>The <code class="literal">“phase2-ca-path”</code> property</h3> -<pre class="programlisting"> “phase2-ca-path” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase2-ca-path” <span class="type">gchar</span> *</pre> <p>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 <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-cert" title="The “phase2-ca-cert” property"><span class="type">“phase2-ca-cert”</span></a> property.</p> @@ -3782,7 +3895,7 @@ certificate specified in the <a class="link" href="NMSetting8021x.html#NMSetting <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-client-cert"></a><h3>The <code class="literal">“phase2-client-cert”</code> property</h3> -<pre class="programlisting"> “phase2-client-cert” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “phase2-client-cert” <span class="type">GBytes</span> *</pre> <p>Contains the "phase 2" client certificate if used by the EAP method specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-auth" title="The “phase2-auth” property"><span class="type">“phase2-auth”</span></a> or <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-autheap" title="The “phase2-autheap” property"><span class="type">“phase2-autheap”</span></a> properties.</p> @@ -3800,8 +3913,22 @@ but this allows man-in-the-middle attacks and is NOT recommended.</p> </div> <hr> <div class="refsect2"> +<a name="NMSetting8021x--phase2-domain-suffix-match"></a><h3>The <code class="literal">“phase2-domain-suffix-match”</code> property</h3> +<pre class="programlisting"> “phase2-domain-suffix-match” <span class="type">gchar</span> *</pre> +<p>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 +a matching dNSName is found, this constraint is met. If no dNSName +values are present, this constraint is matched against SubjectName CN +using same suffix match comparison.</p> +<p>Flags: Read / Write</p> +<p>Default value: NULL</p> +<p class="since">Since: 1.2</p> +</div> +<hr> +<div class="refsect2"> <a name="NMSetting8021x--phase2-private-key"></a><h3>The <code class="literal">“phase2-private-key”</code> property</h3> -<pre class="programlisting"> “phase2-private-key” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “phase2-private-key” <span class="type">GBytes</span> *</pre> <p>Contains the "phase 2" inner private key when the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-auth" title="The “phase2-auth” property"><span class="type">“phase2-auth”</span></a> or <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-autheap" title="The “phase2-autheap” property"><span class="type">“phase2-autheap”</span></a> property is set to "tls".</p> @@ -3827,7 +3954,7 @@ password used to decode the PKCS#12 private key and certificate.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-private-key-password"></a><h3>The <code class="literal">“phase2-private-key-password”</code> property</h3> -<pre class="programlisting"> “phase2-private-key-password” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase2-private-key-password” <span class="type">gchar</span> *</pre> <p>The password used to decrypt the "phase 2" private key specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-private-key" title="The “phase2-private-key” property"><span class="type">“phase2-private-key”</span></a> property when the private key either uses the path scheme, or is a PKCS#12 format key. Setting this @@ -3849,18 +3976,20 @@ function.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--phase2-subject-match"></a><h3>The <code class="literal">“phase2-subject-match”</code> property</h3> -<pre class="programlisting"> “phase2-subject-match” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “phase2-subject-match” <span class="type">gchar</span> *</pre> <p>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 -certificate's subject is performed.</p> +certificate's subject is performed. This property provides little security, +if any, and its use is deprecated in favor of +NMSetting8021x:phase2-domain-suffix-match.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> </div> <hr> <div class="refsect2"> <a name="NMSetting8021x--pin"></a><h3>The <code class="literal">“pin”</code> property</h3> -<pre class="programlisting"> “pin” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “pin” <span class="type">gchar</span> *</pre> <p>PIN used for EAP authentication methods.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> @@ -3875,7 +4004,7 @@ certificate's subject is performed.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--private-key"></a><h3>The <code class="literal">“private-key”</code> property</h3> -<pre class="programlisting"> “private-key” <a href="https://developer.gnome.org/glib/unstable/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *</pre> +<pre class="programlisting"> “private-key” <span class="type">GBytes</span> *</pre> <p>Contains the private key when the <a class="link" href="NMSetting8021x.html#NMSetting8021x--eap" title="The “eap” property"><span class="type">“eap”</span></a> property is set to "tls".</p> <p>Key data is specified using a "scheme"; two are currently supported: blob @@ -3905,7 +4034,7 @@ private key data.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--private-key-password"></a><h3>The <code class="literal">“private-key-password”</code> property</h3> -<pre class="programlisting"> “private-key-password” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “private-key-password” <span class="type">gchar</span> *</pre> <p>The password used to decrypt the private key specified in the <a class="link" href="NMSetting8021x.html#NMSetting8021x--private-key" title="The “private-key” property"><span class="type">“private-key”</span></a> property when the private key either uses the path scheme, or if the private key is a PKCS#12 format key. Setting this @@ -3926,18 +4055,20 @@ property.</p> <hr> <div class="refsect2"> <a name="NMSetting8021x--subject-match"></a><h3>The <code class="literal">“subject-match”</code> property</h3> -<pre class="programlisting"> “subject-match” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<pre class="programlisting"> “subject-match” <span class="type">gchar</span> *</pre> <p>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.</p> +authentication server certificate's subject is performed. This property +provides little security, if any, and its use is deprecated in favor of +NMSetting8021x:domain-suffix-match.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> </div> <hr> <div class="refsect2"> <a name="NMSetting8021x--system-ca-certs"></a><h3>The <code class="literal">“system-ca-certs”</code> property</h3> -<pre class="programlisting"> “system-ca-certs” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> -<p>When <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, overrides the <a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-path" title="The “ca-path” property"><span class="type">“ca-path”</span></a> and +<pre class="programlisting"> “system-ca-certs” <span class="type">gboolean</span></pre> +<p>When <code class="literal">TRUE</code>, overrides the <a class="link" href="NMSetting8021x.html#NMSetting8021x--ca-path" title="The “ca-path” property"><span class="type">“ca-path”</span></a> and <a class="link" href="NMSetting8021x.html#NMSetting8021x--phase2-ca-path" title="The “phase2-ca-path” property"><span class="type">“phase2-ca-path”</span></a> 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 |