NMSettingUser: libnm Reference Manual

NMSettingUser

NMSettingUser — Describes user properties

Functions

NMSetting *	nm_setting_user_new ()
const char const	nm_setting_user_get_keys ()
const char *	nm_setting_user_get_data ()
gboolean	nm_setting_user_set_data ()
gboolean	nm_setting_user_check_key ()
gboolean	nm_setting_user_check_val ()

Types and Values

#define	NM_SETTING_USER_SETTING_NAME
#define	NM_SETTING_USER_DATA

Description

The NMSettingUser object is a NMSetting subclass that allow to attach arbitrary user data to NMConnection objects.

Functions

nm_setting_user_new ()

NMSetting *
nm_setting_user_new (void);

Creates a new NMSettingUser object with default values.

Returns

the new empty NMSettingUser object

Since: 1.8

nm_setting_user_get_keys ()

const char *const *
nm_setting_user_get_keys (NMSettingUser *setting,
                          guint *out_len);

Parameters

setting	the NMSettingUser
out_len	the length of the returned array.	[out]

Returns

a NULL-terminated array containing each key from the table.

[array length=out_len][transfer none]

Since: 1.8

nm_setting_user_get_data ()

const char *
nm_setting_user_get_data (NMSettingUser *setting,
                          const char *key);

Parameters

setting	the NMSettingUser instance
key	the key to lookup

Returns

the value associated with key or NULL if no such value exists.

[transfer none]

Since: 1.8

nm_setting_user_set_data ()

gboolean
nm_setting_user_set_data (NMSettingUser *setting,
                          const char *key,
                          const char *val,
                          GError **error);

Parameters

setting	the NMSettingUser instance
key	the key to set
val	the value to set or `NULL` to clear a key.	[allow-none]
error	optional error argument.	[allow-none]

Returns

TRUE if the operation was successful. The operation can fail if key or val are not valid strings according to nm_setting_user_check_key() and nm_setting_user_check_val().

Since: 1.8

nm_setting_user_check_key ()

gboolean
nm_setting_user_check_key (const char *key,
                           GError **error);

Checks whether key is a valid user data key. This means, key is not NULL, not too large and valid ASCII. Also, only digits and numbers are allowed with a few special characters. The key must contain at least one '.' and look like a fully qualified DNS name.

Parameters

key	the key to check
error	a GError, `NULL` to ignore.

Returns

TRUE if key is a valid user data key.

Since: 1.8

nm_setting_user_check_val ()

gboolean
nm_setting_user_check_val (const char *val,
                           GError **error);

Checks whether val is a valid user data value. This means, value is not NULL, not too large and valid UTF-8.

Parameters

val	the value to check
error	a GError, `NULL` to ignore.

Returns

TRUE if val is a valid user data value.

Since: 1.8

Types and Values

NM_SETTING_USER_SETTING_NAME

#define NM_SETTING_USER_SETTING_NAME "user"

NM_SETTING_USER_DATA

#define NM_SETTING_USER_DATA "data"