mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2026-05-08 07:48:10 +02:00
doc: document vpn setting properties
This commit is contained in:
parent
9a9e833af6
commit
7f3f5bfef3
1 changed files with 43 additions and 4 deletions
|
|
@ -380,35 +380,74 @@ nm_setting_vpn_class_init (NMSettingVPNClass *setting_class)
|
||||||
parent_class->update_one_secret = update_one_secret;
|
parent_class->update_one_secret = update_one_secret;
|
||||||
|
|
||||||
/* Properties */
|
/* Properties */
|
||||||
|
/**
|
||||||
|
* NMSettingVPN:service-type:
|
||||||
|
*
|
||||||
|
* 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.
|
||||||
|
**/
|
||||||
g_object_class_install_property
|
g_object_class_install_property
|
||||||
(object_class, PROP_SERVICE_TYPE,
|
(object_class, PROP_SERVICE_TYPE,
|
||||||
g_param_spec_string (NM_SETTING_VPN_SERVICE_TYPE,
|
g_param_spec_string (NM_SETTING_VPN_SERVICE_TYPE,
|
||||||
"Service type",
|
"Service type",
|
||||||
"Service type",
|
"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.",
|
||||||
NULL,
|
NULL,
|
||||||
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
||||||
|
|
||||||
|
/**
|
||||||
|
* NMSettinVPN:user-name:
|
||||||
|
*
|
||||||
|
* User name of the currently logged in user for connections provided by the
|
||||||
|
* user settings service. This name is provided to the VPN plugin to use in
|
||||||
|
* lieu of a custom username provided by that VPN plugins specific
|
||||||
|
* configuration. The VPN plugin itself decides which user name to use.
|
||||||
|
**/
|
||||||
g_object_class_install_property
|
g_object_class_install_property
|
||||||
(object_class, PROP_USER_NAME,
|
(object_class, PROP_USER_NAME,
|
||||||
g_param_spec_string (NM_SETTING_VPN_USER_NAME,
|
g_param_spec_string (NM_SETTING_VPN_USER_NAME,
|
||||||
"User name",
|
"User name",
|
||||||
"User name",
|
"User name of the currently logged in user for "
|
||||||
|
"connections provided by the user settings service. "
|
||||||
|
"This name is provided to the VPN plugin to use in "
|
||||||
|
"lieu of a custom username provided by that VPN "
|
||||||
|
"plugins specific configuration. The VPN plugin "
|
||||||
|
"itself decides which user name to use.",
|
||||||
NULL,
|
NULL,
|
||||||
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
||||||
|
|
||||||
|
/**
|
||||||
|
* NMSettingVPN:data:
|
||||||
|
*
|
||||||
|
* Dictionary of key/value pairs of VPN plugin specific data. Both keys
|
||||||
|
* and values must be strings.
|
||||||
|
**/
|
||||||
g_object_class_install_property
|
g_object_class_install_property
|
||||||
(object_class, PROP_DATA,
|
(object_class, PROP_DATA,
|
||||||
_nm_param_spec_specialized (NM_SETTING_VPN_DATA,
|
_nm_param_spec_specialized (NM_SETTING_VPN_DATA,
|
||||||
"Data",
|
"Data",
|
||||||
"VPN Service specific data",
|
"Dictionary of key/value pairs of VPN plugin "
|
||||||
|
"specific data. Both keys and values must be "
|
||||||
|
"strings.",
|
||||||
DBUS_TYPE_G_MAP_OF_STRING,
|
DBUS_TYPE_G_MAP_OF_STRING,
|
||||||
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
|
||||||
|
|
||||||
|
/**
|
||||||
|
* NMSettingVPN:secrets:
|
||||||
|
*
|
||||||
|
* Dictionary of key/value pairs of VPN plugin specific secrets like
|
||||||
|
* passwords or private keys. Both keys and values must be strings.
|
||||||
|
**/
|
||||||
g_object_class_install_property
|
g_object_class_install_property
|
||||||
(object_class, PROP_SECRETS,
|
(object_class, PROP_SECRETS,
|
||||||
_nm_param_spec_specialized (NM_SETTING_VPN_SECRETS,
|
_nm_param_spec_specialized (NM_SETTING_VPN_SECRETS,
|
||||||
"Secrets",
|
"Secrets",
|
||||||
"VPN Service specific secrets",
|
"Dictionary of key/value pairs of VPN plugin "
|
||||||
|
"specific secrets like passwords or private keys."
|
||||||
|
" Both keys and values must be strings.",
|
||||||
DBUS_TYPE_G_MAP_OF_STRING,
|
DBUS_TYPE_G_MAP_OF_STRING,
|
||||||
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE | NM_SETTING_PARAM_SECRET));
|
G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE | NM_SETTING_PARAM_SECRET));
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue