"0x1" (to-disk), - "0x2" (in-memory), - "0x20" (block-autoconnect). - Unknown flags cause the call to fail. - args: optional arguments dictionary, for extentibility. Currently, no - arguments are accepted. Specifying unknown keys causes the call - to fail. - path: Object path of the new connection that was just added. - result: output argument, currently no additional results are returned. -

Either the flags 0x1 (to-disk) or 0x2 (in-memory) must be specified. - The effect is whether to behave like AddConnection or AddConnectionUnsaved. - If 0x20 (block-autoconnect) is specified, autoconnect for the new profile - is blocked from the beginning. Otherwise, the profile might automatically - connect if a suitable device is around. -

AddConnection2 is a extensible alternative to AddConnection, and AddConnectionUnsaved. +

AddConnection2 is an alternative to + AddConnection and + AddConnectionUnsaved. The new variant can do everything that the older variants could, and more. + Its behavior is extensible via extra flags and args arguments. +

The flags argument accepts the combination of following values, + logically or-ed together: +

++++ + + + + + + + + + + + + + + +

`0x1 (to-disk)`:	The connection is persisted to disk.
`0x2 (in-memory)`:	The change is only made in memory (without touching an eventual + profile on disk). If neither 0x1 nor 0x2 is set, the change is made in memory + only, if the connection is already in memory only.
`0x20 (block-autoconnect)`:	Blocks auto-connect on the new profile

Either the flags 0x1 (to-disk) or 0x2 (in-memory) must be specified. + The effect is whether to behave like + AddConnection or + AddConnectionUnsaved.

@@ -226,22 +263,23 @@ AddConnection2 (IN a{sa{sv}} settings, - + - + - + - +

`IN u flags`:	optional flags argument. Currently, the following flags are supported:	Flags. Unknown flags cause the call to fail.
`IN a{sv} args`:		Optional arguments dictionary, for extentibility. Specifying unknown keys causes the call to fail.
`OUT o path`:		Object path of the new connection that was just added.
`OUT a{sv} result`:		Output argument, currently no additional results are returned.

@@ -251,15 +289,16 @@ LoadConnections (IN as filenames, OUT b status, OUT as failures); -

Note that before 1.20, NetworkManager had a bug and this status value was wrong. It is better to assume success if the method does not return with a D-Bus error. On top of that, you can look at failures to know whether any of the requested files failed. - failures: Paths of connection files that could not be loaded. -

Loads or reloads the indicated connections from disk. You should call this after making changes directly to an on-disk connection file to make sure that NetworkManager sees the changes. As with AddConnection(), this operation does not necessarily start the network connection.

Note that before 1.20, NetworkManager had a bug and this status value was wrong. + It is better to assume success if the method does not return with a D-Bus error. + On top of that, you can look at failures to know whether any of the requested files failed. +

@@ -276,7 +315,7 @@ LoadConnections (IN as filenames, - +

OUT as failures:

Paths of connection files that could not be loaded.

@@ -403,6 +442,6 @@ CanModify readable b

org.freedesktop.NetworkManager.Settings