summaryrefslogtreecommitdiff
path: root/introspection/org.freedesktop.NetworkManager.xml
Commit message (Collapse)AuthorAgeFilesLines
* introspection: fix documentation for Wimax(Hardware)?EnabledLubomir Rintel2019-09-201-3/+4
| | | | | | | These properties don't do anything. They just exist for compatibility reasons. https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/274
* libnm,core: Add ConnectivityCheckUri property and accessorsIain Lane2019-07-221-0/+7
| | | | | | | So that applications like GNOME Shell can hit the same URI to show the captive portal login page. https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/209
* all: return output dictionary from "AddAndActivate2"Thomas Haller2019-01-141-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a "a{sv}" output argument to "AddAndActivate2" D-Bus API. "AddAndActivate2" replaces "AddAndActivate" with more options. It also has a dictionary argument to be forward compatible so that we hopefully won't need an "AddAndActivate3". However, it lacked a similar output dictionary. Add it for future extensibility. I think this is really to workaround a shortcoming of D-Bus, which does provide strong typing and type information about its API, but does not allow to extend an existing API in a backward compatible manner. So we either resort to Method(), Method2(), Method3() variants, or a catch-all variant with a generic "a{sv}" input/output argument. In libnm, rename "nm_client_add_and_activate_connection_options()" to "nm_client_add_and_activate_connection2()". I think libnm API should have an obvious correspondence with D-Bus API. Or stated differently, if "AddAndActivateOptions" would be a better name, then the D-Bus API should be renamed. We should prefer one name over the other, but regardless of which is preferred, the naming for D-Bus and libnm API should correspond. In this case, I do think that AddAndActivate2() is a better name than AddAndActivateOptions(). Hence I rename the libnm API. Also, unless necessary, let libnm still call "AddAndActivate" instead of "AddAndActivate2". Our backward compatibility works the way that libnm requires a server version at least as new as itself. As such, libnm theoretically could assume that server version is new enough to support "AddAndActivate2" and could always use the more powerful variant. However, we don't need to break compatibility intentionally and for little gain. Here, it's easy to let libnm also handle old server API, by continuing to use "AddAndActivate" for nm_client_add_and_activate_connection(). Note that during package update, we don't restart the currently running NetworkManager instance. In such a scenario, it can easily happen that nmcli/libnm is newer than the server version. Let's try a bit harder to not break that. Changes as discussed in [1]. [1] https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/37#note_79876
* all: say Wi-Fi instead of "wifi" or "WiFi"Lubomir Rintel2018-11-291-4/+4
| | | | | | | | Correct the spelling across the *entire* tree, including translations, comments, etc. It's easier that way. Even the places where it's not exposed to the user, such as tests, so that we learn how is it spelled correctly.
* all: rename "bind" option for AddAndActivateConnection2 to "bind-activation"Thomas Haller2018-11-191-1/+1
| | | | | | | | | | | | | | "bind" specifically binds the lifetime of the activation (NMActiveConnection). In combination with "persist=volatile", the lifetime of the NMSettingsConnection is indirectly bound to the NMActiveConnection. But still these concepts make sense independently. In the future, it may make sense to also bind the lifetime of the NMSettingsConnection to the D-Bus client. Hence, rename the option to allow for the distinction. Also, belatedly fix libnm comment about "bind" only working with "persist" "volatile". Fixes: eb883e34a5889812d35e5c2d7bc6051723001a3a
* manager: allow add-and-activate option "bind" with non-volatile profilesThomas Haller2018-11-181-1/+1
| | | | | | | | | | | | | | | | | | For one, there was a bug here: we cannot "goto error" without setting the @error variable. Anyway, restricting "bind" "dbus-client" only to profiles that are "persist" mode "volatile" seems wrong. The "bind" option as it is, limits the lifetime of the active-connection. This has no direct relation with the lifetime of the setting-connection. Indeed, if the settings-connection's lifetime is itself set to "volatile", then it will indeed go away with the active-connection. However, these two concepts are not strictly related. In the future, we might add an option to limite the lifetime of a settings-connection to a D-Bus client ("bind-setting"). Possibly we should thus rename "bind" to "bind-activation", to make the distinction clearer.
* core: Add option to AddAndActivateConnection2 to bind the lifetimeBenjamin Berg2018-11-171-0/+1
| | | | | | | | | | This allows binding the lifetime of the created connection to the existance of the requesting dbus client. This feature is useful if one has a service specific connection (e.g. P2P wireless) which will not be useful without the specific service. This is simply a mechanism to ensure proper connection cleanup if the requesting service has a failure.
* core: Add persist option to AddAndActivateConnection2Benjamin Berg2018-11-171-1/+3
| | | | | | | | This option allows setting the rules for how long the connection should be stored. Valid values are "disk" (the default), "memory" and "volatile". If "memory" or "volatile" is selected, the connection will not be saved to disk and with "volatile" it will be automatically removed when it is deactivated again.
* core: Add an AddAndActivateConnection2 routine with options parameterBenjamin Berg2018-11-171-0/+28
| | | | | | This adds a new routine to be able to handle an arbitrary set of further options for AddAndActivateConnection. Note that no options are accepted for now.
* all: replace "it's" with "its" where neededBeniamino Galvani2018-04-181-1/+1
|
* checkpoint: allow resetting the rollback timeout via D-BusThomas Haller2018-04-041-0/+21
| | | | | | | | | | | | | | | | | | | | | | This allows to adjust the timeout of an existing checkpoint. The main usecase of checkpoints, is to have a fail-safe when configuring the network remotely. By allowing to reset the timeout, the user can perform a series of actions, and keep bumping the timeout. That way, the entire series is still guarded by the same checkpoint, but the user can start with short timeout, and re-adjust the timeout as he goes along. The libnm API only implements the async form (at least for now). Sync methods are fundamentally wrong with D-Bus, and it's probably not needed. Also, follow glib convenction, where the async form doesn't have the _async name suffix. Also, accept a D-Bus path as argument, not a NMCheckpoint instance. The libnm API should not be more restricted than the underlying D-Bus API. It would be cumbersome to require the user to lookup the NMCheckpoint instance first, especially since libnm doesn't provide an efficient or convenient lookup-by-path method. On the other hand, retrieving the path from a NMCheckpoint instance is always possible.
* core: export checkpoint list over D-BusBeniamino Galvani2017-11-091-0/+7
|
* manager: add connectivity-check-{available,enabled} properties.James Henstridge2017-08-171-0/+22
| | | | https://bugzilla.gnome.org/show_bug.cgi?id=785117
* introspection: slightly improve checkpoint documentationBeniamino Galvani2017-06-261-8/+7
| | | | | Fix CheckpointCreate() arguments formatting, add link to create flags and capitalize sentences.
* introspection: include short description everywhereLubomir Rintel2017-03-171-0/+5
|
* dbus: improve the connectivity check and manager state documentationLubomir Rintel2017-02-161-1/+22
| | | | | This hopefully clears up the confusion between Connectivity and State properties.
* all: rename the introspection data to use the interface paths in namesLubomir Rintel2016-11-231-0/+465
This makes it easier to install the files with proper names. Also, it makes the makefile rules slightly simpler. Lastly, the documentation is now generated into docs/api, which makes it possible to get rid of the awkward relative file names in docbook.