nm_setting_vpn_error_quark ()

GQuark
nm_setting_vpn_error_quark (void);

Registers an error quark for NMSettingVPN if necessary.

NMVPNIterFunc ()

void
(*NMVPNIterFunc) (const char *key,
                  const char *value,
                  gpointer user_data);

nm_setting_vpn_new ()

NMSetting *
nm_setting_vpn_new (void);

Creates a new NMSettingVPN object with default values.

nm_setting_vpn_get_service_type ()

const char *
nm_setting_vpn_get_service_type (NMSettingVPN *setting);

Returns the service name of the VPN, which identifies the specific VPN plugin that should be used to connect to this VPN.

nm_setting_vpn_get_user_name ()

const char *
nm_setting_vpn_get_user_name (NMSettingVPN *setting);

nm_setting_vpn_get_persistent ()

gboolean
nm_setting_vpn_get_persistent (NMSettingVPN *setting);

nm_setting_vpn_get_num_data_items ()

guint32
nm_setting_vpn_get_num_data_items (NMSettingVPN *setting);

Gets number of key/value pairs of VPN configuration data.

nm_setting_vpn_add_data_item ()

void
nm_setting_vpn_add_data_item (NMSettingVPN *setting,
                              const char *key,
                              const char *item);

Establishes a relationship between key and item internally in the setting which may be retrieved later. Should not be used to store passwords or other secrets, which is what nm_setting_vpn_add_secret() is for.

nm_setting_vpn_get_data_item ()

const char *
nm_setting_vpn_get_data_item (NMSettingVPN *setting,
                              const char *key);

Retrieves the data item of a key/value relationship previously established by nm_setting_vpn_add_data_item().

nm_setting_vpn_remove_data_item ()

gboolean
nm_setting_vpn_remove_data_item (NMSettingVPN *setting,
                                 const char *key);

Deletes a key/value relationship previously established by nm_setting_vpn_add_data_item().

nm_setting_vpn_foreach_data_item ()

void
nm_setting_vpn_foreach_data_item (NMSettingVPN *setting,
                                  NMVPNIterFunc func,
                                  gpointer user_data);

Iterates all data items stored in this setting. It is safe to add, remove, and modify data items inside func , though any additions or removals made during iteration will not be part of the iteration.

nm_setting_vpn_get_num_secrets ()

guint32
nm_setting_vpn_get_num_secrets (NMSettingVPN *setting);

Gets number of VPN plugin specific secrets in the setting.

nm_setting_vpn_add_secret ()

void
nm_setting_vpn_add_secret (NMSettingVPN *setting,
                           const char *key,
                           const char *secret);

Establishes a relationship between key and secret internally in the setting which may be retrieved later.

nm_setting_vpn_get_secret ()

const char *
nm_setting_vpn_get_secret (NMSettingVPN *setting,
                           const char *key);

Retrieves the secret of a key/value relationship previously established by nm_setting_vpn_add_secret().

nm_setting_vpn_remove_secret ()

gboolean
nm_setting_vpn_remove_secret (NMSettingVPN *setting,
                              const char *key);

Deletes a key/value relationship previously established by nm_setting_vpn_add_secret().

nm_setting_vpn_foreach_secret ()

void
nm_setting_vpn_foreach_secret (NMSettingVPN *setting,
                               NMVPNIterFunc func,
                               gpointer user_data);

Iterates all secrets stored in this setting. It is safe to add, remove, and modify secrets inside func , though any additions or removals made during iteration will not be part of the iteration.

NM_SETTING_VPN_SETTING_NAME

#define NM_SETTING_VPN_SETTING_NAME "vpn"

enum NMSettingVpnError

NM_SETTING_VPN_ERROR

#define NM_SETTING_VPN_ERROR nm_setting_vpn_error_quark ()

NM_SETTING_VPN_SERVICE_TYPE

#define NM_SETTING_VPN_SERVICE_TYPE "service-type"

NM_SETTING_VPN_USER_NAME

#define NM_SETTING_VPN_USER_NAME    "user-name"

NM_SETTING_VPN_PERSISTENT

#define NM_SETTING_VPN_PERSISTENT   "persistent"

NM_SETTING_VPN_DATA

#define NM_SETTING_VPN_DATA         "data"

NM_SETTING_VPN_SECRETS

#define NM_SETTING_VPN_SECRETS      "secrets"

The “data” property

  “data”                     GHashTable_gchararray+gchararray_*

Dictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings.

Flags: Read / Write

The “persistent” property

  “persistent”               gboolean

If the VPN service supports persistence, and this property is TRUE, the VPN will attempt to stay connected across link changes and outages, until explicitly disconnected.

Flags: Read / Write

Default value: FALSE

The “secrets” property

  “secrets”                  GHashTable_gchararray+gchararray_*

Dictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings.

Flags: Read / Write

The “service-type” property

  “service-type”             gchar *

D-Bus service name of the VPN plugin that this setting uses to connect to its network. i.e. org.freedesktop.NetworkManager.vpnc for the vpnc plugin.

Flags: Read / Write

Default value: NULL

The “user-name” property

  “user-name”                gchar *

If the VPN connection requires a user name for authentication, that name should be provided here. If the connection is available to more than one user, and the VPN requires each user to supply a different name, then leave this property empty. If this property is empty, NetworkManager will automatically supply the username of the user which requested the VPN connection.

Flags: Read / Write

Default value: NULL