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

Functions

-
+
@@ -43,7 +43,7 @@ -
-gboolean +gboolean (*NMSettingClearSecretsWithFlagsFn) () @@ -59,7 +59,7 @@
-GType +GType nm_setting_lookup_type () @@ -82,7 +82,7 @@
-gboolean +gboolean nm_setting_verify () @@ -90,7 +90,7 @@
-gboolean +gboolean nm_setting_verify_secrets () @@ -98,7 +98,7 @@
-gboolean +gboolean nm_setting_compare () @@ -106,7 +106,7 @@
-gboolean +gboolean nm_setting_diff () @@ -130,7 +130,7 @@
-gboolean +gboolean nm_setting_get_secret_flags () @@ -138,14 +138,14 @@
-gboolean +gboolean nm_setting_set_secret_flags ()
const GVariantType * +const GVariantType * nm_setting_get_dbus_property_type () @@ -156,7 +156,7 @@

Properties

-
+
@@ -164,7 +164,7 @@ +gchar * @@ -172,7 +172,7 @@

Types and Values

-
-gchar * name Read
+
@@ -225,7 +225,7 @@ ╰── NMSettingMacRandomization GFlags╰── NMSettingSecretFlags - GObject + GObject╰── NMSetting ├──NMSetting8021x├──NMSettingAdsl @@ -271,14 +271,14 @@ of properties and allowed values.

Functions

NMSettingClearSecretsWithFlagsFn ()

-
gboolean
+
gboolean
 (*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
                                      const char *secret,
                                      NMSettingSecretFlags flags,
-                                     gpointer user_data);
+ gpointer user_data);

Parameters

-
+
@@ -310,7 +310,7 @@ of properties and allowed values.

Returns

-

TRUE to clear the secret, FALSE to not clear the secret

+

TRUE to clear the secret, FALSE to not clear the secret


@@ -319,12 +319,12 @@ of properties and allowed values.

void
 (*NMSettingValueIterFn) (NMSetting *setting,
                          const char *key,
-                         const GValue *value,
-                         GParamFlags flags,
-                         gpointer user_data);
+ const GValue *value, + GParamFlags flags, + gpointer user_data);

Parameters

-
+
@@ -364,12 +364,12 @@ of properties and allowed values.


nm_setting_lookup_type ()

-
GType
+
GType
 nm_setting_lookup_type (const char *name);
-

Returns the GType of the setting's class for a given setting name.

+

Returns the GType of the setting's class for a given setting name.

Parameters

-
+
@@ -384,7 +384,7 @@ nm_setting_lookup_type (const cha

Returns

-

the GType of the setting's class, or G_TYPE_INVALID if +

the GType of the setting's class, or G_TYPE_INVALID if name is not recognized.

@@ -397,7 +397,7 @@ nm_setting_duplicate (NMSetting.

Parameters

-
+
@@ -425,7 +425,7 @@ nm_setting_get_name (NMSetting object

Parameters

-
+
@@ -447,18 +447,18 @@ like 'ppp' or 'wireless' or 'wired'.


nm_setting_verify ()

-
gboolean
+
gboolean
 nm_setting_verify (NMSetting *setting,
                    NMConnection *connection,
-                   GError **error);
+ GError **error);

Validates the setting. Each setting's properties have allowed values, and some are dependent on other values (hence the need for connection ). The -returned GError contains information about which property of the setting +returned GError contains information about which property of the setting failed validation, and in what way that property failed validation.

Parameters

-
+
@@ -474,13 +474,13 @@ failed validation, and in what way that property failed validation.

- + @@ -488,24 +488,24 @@ is being verified in isolation.

Returns

-

TRUE if the setting is valid, FALSE if it is not

+

TRUE if the setting is valid, FALSE if it is not


nm_setting_verify_secrets ()

-
gboolean
+
gboolean
 nm_setting_verify_secrets (NMSetting *setting,
                            NMConnection *connection,
-                           GError **error);
+ GError **error);

Verifies the secrets in the setting. -The returned GError contains information about which secret of the setting +The returned GError contains information about which secret of the setting failed validation, and in what way that secret failed validation. The secret validation is done separately from main setting validation, because in some cases connection failure is not desired just for the secrets.

Parameters

-

connection

the NMConnection that setting came from, or -NULL if setting +NULL if setting is being verified in isolation.

[allow-none]

error

location to store error, or NULL

location to store error, or NULL

 
+
@@ -521,13 +521,13 @@ in some cases connection failure is not desired just for the secrets.

- + @@ -535,14 +535,14 @@ is being verified in isolation.

Returns

-

TRUE if the setting secrets are valid, FALSE if they are not

+

TRUE if the setting secrets are valid, FALSE if they are not

Since: 1.2


nm_setting_compare ()

-
gboolean
+
gboolean
 nm_setting_compare (NMSetting *a,
                     NMSetting *b,
                     NMSettingCompareFlags flags);
@@ -551,7 +551,7 @@ modified by a set of flags. See the documentation for

Parameters

-

connection

the NMConnection that setting came from, or -NULL if setting +NULL if setting is being verified in isolation.

[allow-none]

error

location to store error, or NULL

location to store error, or NULL

 
+
@@ -578,18 +578,18 @@ for a description of each flag's behavior.

Returns

-

TRUE if the comparison succeeds, FALSE if it does not

+

TRUE if the comparison succeeds, FALSE if it does not


nm_setting_diff ()

-
gboolean
+
gboolean
 nm_setting_diff (NMSetting *a,
                  NMSetting *b,
                  NMSettingCompareFlags flags,
-                 gboolean invert_results,
-                 GHashTable **results);
+ gboolean invert_results, + GHashTable **results);

Compares two NMSetting objects for similarity, with comparison behavior modified by a set of flags. See the documentation for NMSettingCompareFlags for a description of each flag's behavior. If the settings differ, the keys @@ -598,7 +598,7 @@ of each setting that differ from the other are added to NMSettingDiffResult values.

Parameters

-
+
@@ -623,7 +623,7 @@ one or more

invert_results

+be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

@@ -640,7 +640,7 @@ in and the settings differ, a new one is created and returned.

Returns

-

TRUE if the settings contain the same values, FALSE if they do not

+

TRUE if the settings contain the same values, FALSE if they do not


@@ -649,12 +649,12 @@ in and the settings differ, a new one is created and returned.

void
 nm_setting_enumerate_values (NMSetting *setting,
                              NMSettingValueIterFn func,
-                             gpointer user_data);
+ gpointer user_data);

Iterates over each property of the NMSetting object, calling the supplied user function for each property.

Parameters

-

this parameter is used internally by libnm and should -be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

 
+
@@ -691,7 +691,7 @@ be used for serialization of the setting, or machine-parsed in any way. The output format is not guaranteed to be stable and may change at any time.

Parameters

-
+
@@ -708,22 +708,22 @@ output format is not guaranteed to be stable and may change at any time.

Returns

an allocated string containing a textual representation of the setting's properties and values (including secrets!), which the caller should -free with g_free()

+free with g_free()


nm_setting_get_secret_flags ()

-
gboolean
+
gboolean
 nm_setting_get_secret_flags (NMSetting *setting,
                              const char *secret_name,
                              NMSettingSecretFlags *out_flags,
-                             GError **error);
+ GError **error);

For a given secret, retrieves the NMSettingSecretFlags describing how to handle that secret.

Parameters

-
+
@@ -747,7 +747,7 @@ handle that secret.

- + @@ -755,23 +755,23 @@ handle that secret.

Returns

-

TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not


nm_setting_set_secret_flags ()

-
gboolean
+
gboolean
 nm_setting_set_secret_flags (NMSetting *setting,
                              const char *secret_name,
                              NMSettingSecretFlags flags,
-                             GError **error);
+ GError **error);

For a given secret, stores the NMSettingSecretFlags describing how to handle that secret.

Parameters

-

error

location to store error, or NULL

location to store error, or NULL

 
+
@@ -795,7 +795,7 @@ handle that secret.

- + @@ -803,22 +803,22 @@ handle that secret.

Returns

-

TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not


nm_setting_get_dbus_property_type ()

-
const GVariantType *
+
const GVariantType *
 nm_setting_get_dbus_property_type (NMSetting *setting,
                                    const char *property_name);

Gets the D-Bus marshalling type of a property. property_name is a D-Bus -property name, which may not necessarily be a GObject property.

+property name, which may not necessarily be a GObject property.

Parameters

-

error

location to store error, or NULL

location to store error, or NULL

 
+
@@ -880,7 +880,7 @@ secret has a corresponding set of these flags which indicate how the secret is to be stored and/or requested when it is needed.

Members

-
+
@@ -933,7 +933,7 @@ secret is not required

two connections.

Members

-
+
@@ -1039,7 +1039,7 @@ two connections.

Controls if and how the MAC address of a device is randomzied.

Members

-
+
@@ -1085,7 +1085,7 @@ It should only be accessed through the functions described below.

These values indicate the result of a setting difference operation.

Members

-
+
@@ -1140,7 +1140,7 @@ if you specify NM_SETTING_COMPARE_FLAG_DIFF_RESULT_W

Property Details

The “name” property

-
  “name”                     gchar *
+
  “name”                     gchar *

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".

-- cgit 1.3.0-6-gf8a5