diff options
Diffstat (limited to 'docs/libnm-util/html/NMSetting.html')
| -rw-r--r-- | docs/libnm-util/html/NMSetting.html | 132 |
1 files changed, 66 insertions, 66 deletions
diff --git a/docs/libnm-util/html/NMSetting.html b/docs/libnm-util/html/NMSetting.html index e6ad3db8..d91cd184 100644 --- a/docs/libnm-util/html/NMSetting.html +++ b/docs/libnm-util/html/NMSetting.html @@ -43,7 +43,7 @@ <tbody> <tr> <td class="function_type"> -<span class="returnvalue">GQuark</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-error-quark" title="nm_setting_error_quark ()">nm_setting_error_quark</a> <span class="c_punctuation">()</span> @@ -51,7 +51,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <span class="c_punctuation">(</span><a class="link" href="NMSetting.html#NMSettingClearSecretsWithFlagsFn" title="NMSettingClearSecretsWithFlagsFn ()">*NMSettingClearSecretsWithFlagsFn</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> @@ -67,7 +67,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">GHashTable</span> * +<a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-to-hash" title="nm_setting_to_hash ()">nm_setting_to_hash</a> <span class="c_punctuation">()</span> @@ -98,7 +98,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-verify" title="nm_setting_verify ()">nm_setting_verify</a> <span class="c_punctuation">()</span> @@ -106,7 +106,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-compare" title="nm_setting_compare ()">nm_setting_compare</a> <span class="c_punctuation">()</span> @@ -114,7 +114,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-diff" title="nm_setting_diff ()">nm_setting_diff</a> <span class="c_punctuation">()</span> @@ -154,7 +154,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">GPtrArray</span> * +<a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> * </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-need-secrets" title="nm_setting_need_secrets ()">nm_setting_need_secrets</a> <span class="c_punctuation">()</span> @@ -162,7 +162,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-update-secrets" title="nm_setting_update_secrets ()">nm_setting_update_secrets</a> <span class="c_punctuation">()</span> @@ -170,7 +170,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-get-secret-flags" title="nm_setting_get_secret_flags ()">nm_setting_get_secret_flags</a> <span class="c_punctuation">()</span> @@ -178,7 +178,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">gboolean</span> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="NMSetting.html#nm-setting-set-secret-flags" title="nm_setting_set_secret_flags ()">nm_setting_set_secret_flags</a> <span class="c_punctuation">()</span> @@ -204,7 +204,7 @@ </colgroup> <tbody><tr> <td class="property_type"> -<span class="type">gchar</span> *</td> +<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> <td class="property_name"><a class="link" href="NMSetting.html#NMSetting--name" title="The “name” property">name</a></td> <td class="property_flags">Read / Write</td> </tr></tbody> @@ -271,13 +271,13 @@ </div> <div class="refsect1"> <a name="NMSetting.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> +<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-Enumeration-and-Flag-Types.html">GEnum</a> <span class="lineart">├──</span> NMSettingCompareFlags <span class="lineart">├──</span> NMSettingDiffResult <span class="lineart">├──</span> NMSettingError <span class="lineart">├──</span> NMSettingHashFlags <span class="lineart">╰──</span> NMSettingSecretFlags - GObject + <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> <span class="lineart">╰──</span> NMSetting <span class="lineart">├──</span> <a class="link" href="NMSetting8021x.html" title="NMSetting8021x">NMSetting8021x</a> <span class="lineart">├──</span> <a class="link" href="NMSettingAdsl.html" title="NMSettingAdsl">NMSettingAdsl</a> @@ -325,7 +325,7 @@ of properties and allowed values.</p> <a name="NMSetting.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="nm-setting-error-quark"></a><h3>nm_setting_error_quark ()</h3> -<pre class="programlisting"><span class="returnvalue">GQuark</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> nm_setting_error_quark (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> <p>Registers an error quark for <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> if necessary.</p> <div class="refsect3"> @@ -336,11 +336,11 @@ nm_setting_error_quark (<em class="parameter"><code><span class="type">void</spa <hr> <div class="refsect2"> <a name="NMSettingClearSecretsWithFlagsFn"></a><h3>NMSettingClearSecretsWithFlagsFn ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <span class="c_punctuation">(</span>*NMSettingClearSecretsWithFlagsFn<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *secret</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <div class="refsect3"> <a name="NMSettingClearSecretsWithFlagsFn.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -375,7 +375,7 @@ nm_setting_error_quark (<em class="parameter"><code><span class="type">void</spa </div> <div class="refsect3"> <a name="NMSettingClearSecretsWithFlagsFn.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> to clear the secret, <code class="literal">FALSE</code> to not clear the secret</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to clear the secret, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to not clear the secret</p> </div> </div> <hr> @@ -384,9 +384,9 @@ nm_setting_error_quark (<em class="parameter"><code><span class="type">void</spa <pre class="programlisting"><span class="returnvalue">void</span> <span class="c_punctuation">(</span>*NMSettingValueIterFn<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *key</code></em>, - <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>, - <em class="parameter"><code><span class="type">GParamFlags</span> flags</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> + <em class="parameter"><code>const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-GParamSpec.html#GParamFlags"><span class="type">GParamFlags</span></a> flags</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <div class="refsect3"> <a name="NMSettingValueIterFn.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -429,10 +429,10 @@ nm_setting_error_quark (<em class="parameter"><code><span class="type">void</spa <hr> <div class="refsect2"> <a name="nm-setting-to-hash"></a><h3>nm_setting_to_hash ()</h3> -<pre class="programlisting"><span class="returnvalue">GHashTable</span> * +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * nm_setting_to_hash (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingHashFlags" title="enum NMSettingHashFlags"><span class="type">NMSettingHashFlags</span></a> flags</code></em>);</pre> -<p>Converts the <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> into a <span class="type">GHashTable</span> mapping each setting property +<p>Converts the <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> into a <a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> mapping each setting property name to a GValue describing that property, suitable for marshalling over D-Bus or serializing. The mapping is string to GValue.</p> <div class="refsect3"> @@ -459,7 +459,7 @@ D-Bus or serializing. The mapping is string to GValue.</p> </div> <div class="refsect3"> <a name="nm-setting-to-hash.returns"></a><h4>Returns</h4> -<p> a new <span class="type">GHashTable</span> +<p> a new <a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> describing the setting's properties. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span></p> </div> @@ -468,8 +468,8 @@ describing the setting's properties. </p> <div class="refsect2"> <a name="nm-setting-new-from-hash"></a><h3>nm_setting_new_from_hash ()</h3> <pre class="programlisting"><a class="link" href="NMSetting.html" title="NMSetting"><span class="returnvalue">NMSetting</span></a> * -nm_setting_new_from_hash (<em class="parameter"><code><span class="type">GType</span> setting_type</code></em>, - <em class="parameter"><code><span class="type">GHashTable</span> *hash</code></em>);</pre> +nm_setting_new_from_hash (<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> setting_type</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *hash</code></em>);</pre> <p>Creates a new <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> object and populates that object with the properties contained in the hash table, using each hash key as the property to set, and each hash value as the value to set that property to. Setting properties @@ -492,7 +492,7 @@ property names and value types.</p> </tr> <tr> <td class="parameter_name"><p>hash</p></td> -<td class="parameter_description"><p> the <span class="type">GHashTable</span> containing a +<td class="parameter_description"><p> the <a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> containing a string to GValue mapping of properties that apply to the setting. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span></td> </tr> @@ -502,7 +502,7 @@ string to GValue mapping of properties that apply to the setting. </p></td> <div class="refsect3"> <a name="nm-setting-new-from-hash.returns"></a><h4>Returns</h4> <p> a new <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> object populated with the properties from the -hash table, or <code class="literal">NULL</code> on failure</p> +hash table, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure</p> </div> </div> <hr> @@ -563,14 +563,14 @@ like 'ppp' or 'wireless' or 'wired'.</p> <hr> <div class="refsect2"> <a name="nm-setting-verify"></a><h3>nm_setting_verify ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_verify (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, - <em class="parameter"><code><span class="type">GSList</span> *all_settings</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *all_settings</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> <p>Validates the setting. Each setting's properties have allowed values, and some are dependent on other values (hence the need for <em class="parameter"><code>all_settings</code></em> ). The -returned <span class="type">GError</span> contains information about which property of the setting +returned <a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> contains information about which property of the setting failed validation, and in what way that property failed validation.</p> <div class="refsect3"> <a name="nm-setting-verify.parameters"></a><h4>Parameters</h4> @@ -588,14 +588,14 @@ failed validation, and in what way that property failed validation.</p> </tr> <tr> <td class="parameter_name"><p>all_settings</p></td> -<td class="parameter_description"><p> a <span class="type">GSList</span> of all settings +<td class="parameter_description"><p> a <a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> of all settings in the connection from which <em class="parameter"><code>setting</code></em> came. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMSetting]</span></td> </tr> <tr> <td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code></p></td> +<td class="parameter_description"><p>location to store error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> @@ -603,13 +603,13 @@ came. </p></td> </div> <div class="refsect3"> <a name="nm-setting-verify.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the setting is valid, <code class="literal">FALSE</code> if it is not</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the setting is valid, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-compare"></a><h3>nm_setting_compare ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_compare (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *a</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *b</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingCompareFlags" title="enum NMSettingCompareFlags"><span class="type">NMSettingCompareFlags</span></a> flags</code></em>);</pre> @@ -645,18 +645,18 @@ for a description of each flag's behavior.</p> </div> <div class="refsect3"> <a name="nm-setting-compare.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the comparison succeeds, <code class="literal">FALSE</code> if it does not</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the comparison succeeds, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it does not</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-diff"></a><h3>nm_setting_diff ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_diff (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *a</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *b</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingCompareFlags" title="enum NMSettingCompareFlags"><span class="type">NMSettingCompareFlags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> invert_results</code></em>, - <em class="parameter"><code><span class="type">GHashTable</span> **results</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invert_results</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **results</code></em>);</pre> <p>Compares two <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> objects for similarity, with comparison behavior modified by a set of flags. See the documentation for <a class="link" href="NMSetting.html#NMSettingCompareFlags" title="enum NMSettingCompareFlags"><span class="type">NMSettingCompareFlags</span></a> for a description of each flag's behavior. If the settings differ, the keys @@ -690,7 +690,7 @@ one or more <a class="link" href="NMSetting.html#NMSettingDiffResult" title="enu <tr> <td class="parameter_name"><p>invert_results</p></td> <td class="parameter_description"><p>this parameter is used internally by libnm-util and should -be set to <code class="literal">FALSE</code>. If <code class="literal">TRUE</code> inverts the meaning of the <a class="link" href="NMSetting.html#NMSettingDiffResult" title="enum NMSettingDiffResult"><span class="type">NMSettingDiffResult</span></a>.</p></td> +be set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. If <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> inverts the meaning of the <a class="link" href="NMSetting.html#NMSettingDiffResult" title="enum NMSettingDiffResult"><span class="type">NMSettingDiffResult</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> @@ -707,7 +707,7 @@ in and the settings differ, a new one is created and returned. </p></td> </div> <div class="refsect3"> <a name="nm-setting-diff.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the settings contain the same values, <code class="literal">FALSE</code> if they do not</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the settings contain the same values, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if they do not</p> </div> </div> <hr> @@ -716,7 +716,7 @@ in and the settings differ, a new one is created and returned. </p></td> <pre class="programlisting"><span class="returnvalue">void</span> nm_setting_enumerate_values (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingValueIterFn" title="NMSettingValueIterFn ()"><span class="type">NMSettingValueIterFn</span></a> func</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p>Iterates over each property of the <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> object, calling the supplied user function for each property.</p> <div class="refsect3"> @@ -775,7 +775,7 @@ output format is not guaranteed to be stable and may change at any time.</p> <a name="nm-setting-to-string.returns"></a><h4>Returns</h4> <p> an allocated string containing a textual representation of the setting's properties and values (including secrets!), which the caller should -free with <code class="function">g_free()</code></p> +free with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p> </div> </div> <hr> @@ -808,7 +808,7 @@ leakage of information.</p> <pre class="programlisting"><span class="returnvalue">void</span> nm_setting_clear_secrets_with_flags (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingClearSecretsWithFlagsFn" title="NMSettingClearSecretsWithFlagsFn ()"><span class="type">NMSettingClearSecretsWithFlagsFn</span></a> func</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p>Clears and frees secrets determined by <em class="parameter"><code>func</code></em> .</p> <div class="refsect3"> @@ -844,7 +844,7 @@ specific secret should be cleared or not. </p></td> <hr> <div class="refsect2"> <a name="nm-setting-need-secrets"></a><h3>nm_setting_need_secrets ()</h3> -<pre class="programlisting"><span class="returnvalue">GPtrArray</span> * +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> * nm_setting_need_secrets (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>);</pre> <p>Returns an array of property names for each secret which may be required to make a successful connection. The returned hints are only intended as a @@ -867,9 +867,9 @@ is no way to conclusively determine exactly which secrets are needed.</p> </div> <div class="refsect3"> <a name="nm-setting-need-secrets.returns"></a><h4>Returns</h4> -<p> a <span class="type">GPtrArray</span> containing +<p> a <a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> containing the property names of secrets of the <a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> which may be required; the -caller owns the array and must free it with <code class="function">g_ptr_array_free()</code>, but must not +caller owns the array and must free it with <a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#g-ptr-array-free"><code class="function">g_ptr_array_free()</code></a>, but must not free the elements. </p> <p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p> </div> @@ -877,10 +877,10 @@ free the elements. </p> <hr> <div class="refsect2"> <a name="nm-setting-update-secrets"></a><h3>nm_setting_update_secrets ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_update_secrets (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, - <em class="parameter"><code><span class="type">GHashTable</span> *secrets</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *secrets</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> <p>Update the setting's secrets, given a hash table of secrets intended for that setting (deserialized from D-Bus for example).</p> <div class="refsect3"> @@ -899,13 +899,13 @@ setting (deserialized from D-Bus for example).</p> </tr> <tr> <td class="parameter_name"><p>secrets</p></td> -<td class="parameter_description"><p> a <span class="type">GHashTable</span> mapping -string to <span class="type">GValue</span> of setting property names and secrets. </p></td> +<td class="parameter_description"><p> a <a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> mapping +string to <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of setting property names and secrets. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span></td> </tr> <tr> <td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code></p></td> +<td class="parameter_description"><p>location to store error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> @@ -913,18 +913,18 @@ string to <span class="type">GValue</span> of setting property names and secrets </div> <div class="refsect3"> <a name="nm-setting-update-secrets.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the secrets were successfully updated, <code class="literal">FALSE</code> on failure to +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the secrets were successfully updated, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure to update one or more of the secrets.</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-get-secret-flags"></a><h3>nm_setting_get_secret_flags ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_get_secret_flags (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *secret_name</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> *out_flags</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> + <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> <p>For a given secret, retrieves the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> describing how to handle that secret.</p> <div class="refsect3"> @@ -953,7 +953,7 @@ handle that secret.</p> </tr> <tr> <td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code></p></td> +<td class="parameter_description"><p>location to store error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> @@ -961,18 +961,18 @@ handle that secret.</p> </div> <div class="refsect3"> <a name="nm-setting-get-secret-flags.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success (if the given secret name was a valid property of -this setting, and if that property is secret), <code class="literal">FALSE</code> if not</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success (if the given secret name was a valid property of +this setting, and if that property is secret), <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</p> </div> </div> <hr> <div class="refsect2"> <a name="nm-setting-set-secret-flags"></a><h3>nm_setting_set_secret_flags ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_set_secret_flags (<em class="parameter"><code><a class="link" href="NMSetting.html" title="NMSetting"><span class="type">NMSetting</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *secret_name</code></em>, <em class="parameter"><code><a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> + <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> <p>For a given secret, stores the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> describing how to handle that secret.</p> <div class="refsect3"> @@ -1001,7 +1001,7 @@ handle that secret.</p> </tr> <tr> <td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code></p></td> +<td class="parameter_description"><p>location to store error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> @@ -1009,8 +1009,8 @@ handle that secret.</p> </div> <div class="refsect3"> <a name="nm-setting-set-secret-flags.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success (if the given secret name was a valid property of -this setting, and if that property is secret), <code class="literal">FALSE</code> if not</p> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success (if the given secret name was a valid property of +this setting, and if that property is secret), <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</p> </div> </div> <hr> @@ -1037,7 +1037,7 @@ needs to use if specified in the settings.</p> </div> <div class="refsect3"> <a name="nm-setting-get-virtual-iface-name.returns"></a><h4>Returns</h4> -<p> Name of the virtual interface or <code class="literal">NULL</code> if the setting does not +<p> Name of the virtual interface or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the setting does not support this feature</p> </div> </div> @@ -1389,7 +1389,7 @@ if you specify <em class="parameter"><code>NM_SETTING_COMPARE_FLAG_DIFF_RESULT_W <a name="NMSetting.property-details"></a><h2>Property Details</h2> <div class="refsect2"> <a name="NMSetting--name"></a><h3>The <code class="literal">“name”</code> property</h3> -<pre class="programlisting"> “name” <span class="type">gchar</span> *</pre> +<pre class="programlisting"> “name” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> <p>The setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired".</p> |