diff options
| author | Dan Williams <dcbw@redhat.com> | 2013-07-24 10:41:39 -0500 |
|---|---|---|
| committer | Dan Williams <dcbw@redhat.com> | 2013-10-31 15:33:58 -0500 |
| commit | 35124dbb1432693d650d835dde95d2d4a6e0b65f (patch) | |
| tree | 3cf03b856388435877348b865080449acb9b6869 /introspection/nm-manager.xml | |
| parent | f4befaab00cb365456b25954c60faecd180e64c5 (diff) | |
| download | NetworkManager-35124dbb1432693d650d835dde95d2d4a6e0b65f.tar.gz | |
core: extend ActivateConnection to allow NULL connection paths
When called with a connection path, activates that connection.
When called without a connection path, picks the best available
connection to activate for that device.
Doesn't work with VPN connections because they don't have devices.
Diffstat (limited to 'introspection/nm-manager.xml')
| -rw-r--r-- | introspection/nm-manager.xml | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/introspection/nm-manager.xml b/introspection/nm-manager.xml index a3d6647926..e076e0516e 100644 --- a/introspection/nm-manager.xml +++ b/introspection/nm-manager.xml @@ -41,12 +41,17 @@ </tp:docstring> <arg name="connection" type="o" direction="in"> <tp:docstring> - The connection to activate the devices with. + The connection to activate. If "/" is given, a valid device path must + be given, and NetworkManager picks the best connection to activate for + the given device. VPN connections must always pass a valid connection + path. </tp:docstring> </arg> <arg name="device" type="o" direction="in"> <tp:docstring> - The object path of device to be activated for physical connections. This parameter is ignored for VPN connections, because the specific_object (if provided) specifies the device to use. + The object path of device to be activated for physical connections. + This parameter is ignored for VPN connections, because the + specific_object (if provided) specifies the device to use. </tp:docstring> </arg> <arg name="specific_object" type="o" direction="in"> @@ -55,7 +60,7 @@ This parameter is currently ignored for wired and mobile broadband connections, and the value of "/" should be used (ie, no specific object). For WiFi connections, pass the object path of a specific AP from the card's scan - list, or "/" to pick and AP automatically. For VPN connections, pass + list, or "/" to pick an AP automatically. For VPN connections, pass the object path of an ActiveConnection object that should serve as the "base" connection (to which the VPN connections lifetime will be tied), or pass "/" and NM will automatically use the current default device. |