ns2 0.2.6__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. ns2/__init__.py +0 -0
  2. ns2/core.py +0 -0
  3. ns2/dbus/__init__.py +0 -0
  4. ns2/dbus/dbus.py +13 -0
  5. ns2/lib/__init__.py +0 -0
  6. ns2/lib/accounts.py +130 -0
  7. ns2/lib/commands.py +32 -0
  8. ns2/lib/firewalld.py +167 -0
  9. ns2/lib/introspection/org.fedoraproject.FirewallD1.config.xml +3 -0
  10. ns2/lib/introspection/org.fedoraproject.FirewallD1.xml +763 -0
  11. ns2/lib/introspection/org.freedesktop.NetworkManager.AccessPoint.xml +106 -0
  12. ns2/lib/introspection/org.freedesktop.NetworkManager.AgentManager.xml +43 -0
  13. ns2/lib/introspection/org.freedesktop.NetworkManager.Checkpoint.xml +36 -0
  14. ns2/lib/introspection/org.freedesktop.NetworkManager.Connection.Active.xml +185 -0
  15. ns2/lib/introspection/org.freedesktop.NetworkManager.DHCP4Config.xml +21 -0
  16. ns2/lib/introspection/org.freedesktop.NetworkManager.DHCP6Config.xml +20 -0
  17. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Adsl.xml +21 -0
  18. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Bluetooth.xml +36 -0
  19. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Bond.xml +40 -0
  20. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Bridge.xml +41 -0
  21. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Dummy.xml +20 -0
  22. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Generic.xml +27 -0
  23. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Hsr.xml +51 -0
  24. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.IPTunnel.xml +107 -0
  25. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Infiniband.xml +31 -0
  26. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Ipvlan.xml +38 -0
  27. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Loopback.xml +8 -0
  28. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Lowpan.xml +27 -0
  29. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Macsec.xml +109 -0
  30. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Macvlan.xml +39 -0
  31. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Modem.xml +62 -0
  32. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.OlpcMesh.xml +34 -0
  33. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.OvsBridge.xml +21 -0
  34. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.OvsInterface.xml +11 -0
  35. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.OvsPort.xml +21 -0
  36. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Ppp.xml +11 -0
  37. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Statistics.xml +35 -0
  38. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Team.xml +48 -0
  39. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Tun.xml +65 -0
  40. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Veth.xml +18 -0
  41. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Vlan.xml +45 -0
  42. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Vrf.xml +18 -0
  43. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Vxlan.xml +139 -0
  44. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.WiMax.xml +109 -0
  45. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.WifiP2P.xml +76 -0
  46. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.WireGuard.xml +38 -0
  47. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Wired.xml +53 -0
  48. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Wireless.xml +131 -0
  49. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.Wpan.xml +20 -0
  50. ns2/lib/introspection/org.freedesktop.NetworkManager.Device.xml +407 -0
  51. ns2/lib/introspection/org.freedesktop.NetworkManager.DnsManager.xml +40 -0
  52. ns2/lib/introspection/org.freedesktop.NetworkManager.IP4Config.xml +125 -0
  53. ns2/lib/introspection/org.freedesktop.NetworkManager.IP6Config.xml +95 -0
  54. ns2/lib/introspection/org.freedesktop.NetworkManager.PPP.xml +34 -0
  55. ns2/lib/introspection/org.freedesktop.NetworkManager.SecretAgent.xml +94 -0
  56. ns2/lib/introspection/org.freedesktop.NetworkManager.Settings.Connection.xml +224 -0
  57. ns2/lib/introspection/org.freedesktop.NetworkManager.Settings.xml +233 -0
  58. ns2/lib/introspection/org.freedesktop.NetworkManager.VPN.Connection.xml +42 -0
  59. ns2/lib/introspection/org.freedesktop.NetworkManager.VPN.Plugin.xml +204 -0
  60. ns2/lib/introspection/org.freedesktop.NetworkManager.WiMax.Nsp.xml +35 -0
  61. ns2/lib/introspection/org.freedesktop.NetworkManager.WifiP2PPeer.xml +91 -0
  62. ns2/lib/introspection/org.freedesktop.NetworkManager.xml +598 -0
  63. ns2/lib/lib.py +0 -0
  64. ns2/lib/network_delay.py +92 -0
  65. ns2/lib/networking.py +528 -0
  66. ns2/lib/ntl.py +188 -0
  67. ns2/lib/pam_client.py +37 -0
  68. ns2/lib/ping_data_collector.py +37 -0
  69. ns2/lib/snmp.py +511 -0
  70. ns2/lib/socket.py +132 -0
  71. ns2/lib/socket_client.py +62 -0
  72. ns2/lib/systemd.py +151 -0
  73. ns2/lib/test.py +374 -0
  74. ns2/lib/udp_client.py +227 -0
  75. ns2/lib/udp_server.py +167 -0
  76. ns2/snmp/__init__.py +0 -0
  77. ns2/snmp/ns_dbus_service.py +38 -0
  78. ns2/snmp/pam_interface.py +19 -0
  79. ns2/snmp/snmp_interface.py +66 -0
  80. ns2/ui/__init__.py +0 -0
  81. ns2/ui/assets/NOVUS_LOGO.svg +105 -0
  82. ns2/ui/assets/favicon.png +0 -0
  83. ns2/ui/firewalld_page.py +375 -0
  84. ns2/ui/fpga_page.py +24 -0
  85. ns2/ui/login.py +65 -0
  86. ns2/ui/main.py +200 -0
  87. ns2/ui/networking_page.py +406 -0
  88. ns2/ui/ntp.py +105 -0
  89. ns2/ui/root.py +31 -0
  90. ns2/ui/snmp_page.py +353 -0
  91. ns2/ui/terminal.py +65 -0
  92. ns2/ui/tests_page.py +116 -0
  93. ns2/ui/theme.py +25 -0
  94. ns2/utils.py +5 -0
  95. ns2-0.2.6.dist-info/METADATA +78 -0
  96. ns2-0.2.6.dist-info/RECORD +98 -0
  97. ns2-0.2.6.dist-info/WHEEL +4 -0
  98. ns2-0.2.6.dist-info/entry_points.txt +3 -0
@@ -0,0 +1,34 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+
3
+ <node name="/">
4
+ <!--
5
+ org.freedesktop.NetworkManager.PPP:
6
+ @short_description: Helper interface for a PPP plugin.
7
+
8
+ -->
9
+ <interface name="org.freedesktop.NetworkManager.PPP">
10
+ <annotation name="org.gtk.GDBus.C.Name" value="PPP_Manager"/>
11
+
12
+ <method name="NeedSecrets">
13
+ <arg name="username" type="s" direction="out"/>
14
+ <arg name="password" type="s" direction="out"/>
15
+ </method>
16
+
17
+ <method name="SetIp4Config">
18
+ <arg name="config" type="a{sv}" direction="in"/>
19
+ </method>
20
+
21
+ <method name="SetIp6Config">
22
+ <arg name="config" type="a{sv}" direction="in"/>
23
+ </method>
24
+
25
+ <method name="SetState">
26
+ <arg name="state" type="u" direction="in"/>
27
+ </method>
28
+
29
+ <method name="SetIfindex">
30
+ <arg name="ifindex" type="i" direction="in"/>
31
+ </method>
32
+
33
+ </interface>
34
+ </node>
@@ -0,0 +1,94 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <node name="/">
3
+
4
+ <!--
5
+ org.freedesktop.NetworkManager.SecretAgent:
6
+ @short_description: User Secret Agent.
7
+
8
+ Private D-Bus interface used by secret agents that store and provide
9
+ secrets to NetworkManager. If an agent provides secrets to NetworkManager
10
+ as part of connection creation, and the some of those secrets are "agent
11
+ owned" the agent should store those secrets itself and should not expect
12
+ its SaveSecrets() method to be called. SaveSecrets() will be called eg if
13
+ some program other than the agent itself (like a connection editor)
14
+ changes the secrets out of band. The agent should implement this D-Bus
15
+ interface on an object with the path
16
+ /org/freedesktop/NetworkManager/SecretAgent.
17
+ -->
18
+ <interface name="org.freedesktop.NetworkManager.SecretAgent">
19
+
20
+ <!--
21
+ GetSecrets:
22
+ @connection: Nested settings maps containing the connection for which secrets are being requested. This may contain system-owned secrets if the agent has successfully authenticated to modify system network settings and the GetSecrets request flags allow user interaction.
23
+ @connection_path: Object path of the connection for which secrets are being requested.
24
+ @setting_name: Setting name for which secrets are being requested.
25
+ @hints: Array of strings of key names in the requested setting for which NetworkManager thinks a secrets may be required, and/or well-known identifiers and data that may be useful to the client in processing the secrets request. Note that it's not always possible to determine which secret is required, so in some cases no hints may be given. The Agent should return any secrets it has, or that it thinks are required, regardless of what hints NetworkManager sends in this request. Some hints have special prefixes that provide information to the agent; for example, VPN requests may send server-specific messages prefixed with "x-vpn-message:".
26
+ @flags: (<link linkend="NMSecretAgentGetSecretsFlags">NMSecretAgentGetSecretsFlags</link>) Flags which modify the behavior of the secrets request. If true, new secrets are assumed to be invalid or incorrect, and the agent should ask the user for new secrets. If false, existing secrets should be retrieved from storage and returned without interrupting the user.
27
+ @secrets: Nested settings maps containing secrets. Each setting MUST contain at least the 'name' field, containing the name of the setting, and one or more secrets.
28
+
29
+ Retrieve and return stored secrets, if any, or request new secrets from
30
+ the agent's user. If user interaction is allowed and the user enters new
31
+ secrets, the agent is expected to save the new secrets to persistent
32
+ storage (if the secret's flags include AGENT_OWNED) as NetworkManager will
33
+ not send these secrets back to the same agent via a SaveSecrets() call. If
34
+ the user canceled any interaction, the agent should return the
35
+ UserCanceled error (see below).
36
+ -->
37
+ <method name="GetSecrets">
38
+ <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_secret_agent_get_secrets"/>
39
+ <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
40
+ <arg name="connection" type="a{sa{sv}}" direction="in"/>
41
+ <arg name="connection_path" type="o" direction="in"/>
42
+ <arg name="setting_name" type="s" direction="in"/>
43
+ <arg name="hints" type="as" direction="in"/>
44
+ <arg name="flags" type="u" direction="in"/>
45
+
46
+ <arg name="secrets" type="a{sa{sv}}" direction="out"/>
47
+ </method>
48
+
49
+ <!--
50
+ CancelGetSecrets:
51
+ @connection_path: Object path of the connection for which, if secrets for the given 'setting_name' are being requested, the request should be canceled.
52
+ @setting_name: Setting name for which secrets for this connection were originally being requested.
53
+
54
+ Cancel a pending GetSecrets request for secrets of the given connection.
55
+ Any GetSecrets request with the same 'connection_path' and 'setting_name'
56
+ that are given in a CancelGetSecrets request should be canceled.
57
+ -->
58
+ <method name="CancelGetSecrets">
59
+ <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_secret_agent_cancel_get_secrets"/>
60
+ <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
61
+ <arg name="connection_path" type="o" direction="in"/>
62
+ <arg name="setting_name" type="s" direction="in"/>
63
+ </method>
64
+
65
+ <!--
66
+ SaveSecrets:
67
+ @connection: Nested settings maps containing the entire connection (including secrets), for which the agent should save the secrets to backing storage. This method will not be called when the agent itself is the process creating or updating a connection; in that case the agent is assumed to have already saved those secrets since it had them already.
68
+ @connection_path: Object path of the connection for which the agent should save secrets to backing storage.
69
+
70
+ Save given secrets to backing storage.
71
+ -->
72
+ <method name="SaveSecrets">
73
+ <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_secret_agent_save_secrets"/>
74
+ <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
75
+ <arg name="connection" type="a{sa{sv}}" direction="in"/>
76
+ <arg name="connection_path" type="o" direction="in"/>
77
+ </method>
78
+
79
+ <!--
80
+ DeleteSecrets:
81
+ @connection: Nested settings maps containing the connection properties (sans secrets), for which the agent should delete the secrets from backing storage.
82
+ @connection_path: Object path of the connection for which the agent should delete secrets from backing storage.
83
+
84
+ Delete secrets from backing storage.
85
+ -->
86
+ <method name="DeleteSecrets">
87
+ <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_secret_agent_delete_secrets"/>
88
+ <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
89
+ <arg name="connection" type="a{sa{sv}}" direction="in"/>
90
+ <arg name="connection_path" type="o" direction="in"/>
91
+ </method>
92
+
93
+ </interface>
94
+ </node>
@@ -0,0 +1,224 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <node name="/">
3
+
4
+ <!--
5
+ org.freedesktop.NetworkManager.Settings.Connection:
6
+ @short_description: Connection Settings Profile.
7
+
8
+ Represents a single network connection configuration.
9
+ -->
10
+ <interface name="org.freedesktop.NetworkManager.Settings.Connection">
11
+
12
+ <!--
13
+ Update:
14
+ @properties: New connection settings, properties, and (optionally) secrets.
15
+
16
+ Update the connection with new settings and properties (replacing all
17
+ previous settings and properties) and save the connection to disk. Secrets
18
+ may be part of the update request, and will be either stored in persistent
19
+ storage or sent to a Secret Agent for storage, depending on the flags
20
+ associated with each secret.
21
+ -->
22
+ <method name="Update">
23
+ <arg name="properties" type="a{sa{sv}}" direction="in"/>
24
+ </method>
25
+
26
+ <!--
27
+ UpdateUnsaved:
28
+ @properties: New connection settings, properties, and (optionally) secrets.
29
+
30
+ Update the connection with new settings and properties (replacing all
31
+ previous settings and properties) but do not immediately save the
32
+ connection to disk. Secrets may be part of the update request and may sent
33
+ to a Secret Agent for storage, depending on the flags associated with each
34
+ secret. Use the 'Save' method to save these changes to disk. Note that
35
+ unsaved changes will be lost if the connection is reloaded from disk
36
+ (either automatically on file change or due to an explicit
37
+ ReloadConnections call).
38
+ -->
39
+ <method name="UpdateUnsaved">
40
+ <arg name="properties" type="a{sa{sv}}" direction="in"/>
41
+ </method>
42
+
43
+ <!--
44
+ Delete:
45
+
46
+ Delete the connection.
47
+ -->
48
+ <method name="Delete"/>
49
+
50
+ <!--
51
+ GetSettings:
52
+ @settings: The nested settings maps describing this object.
53
+
54
+ Get the settings maps describing this network configuration. This will
55
+ never include any secrets required for connection to the network, as those
56
+ are often protected. Secrets must be requested separately using the
57
+ GetSecrets() call.
58
+ -->
59
+ <method name="GetSettings">
60
+ <arg name="settings" type="a{sa{sv}}" direction="out"/>
61
+ </method>
62
+
63
+ <!--
64
+ GetSecrets:
65
+ @setting_name: Name of the setting to return secrets for. If empty, all secrets will be returned.
66
+ @secrets: Nested settings maps containing secrets.
67
+
68
+ Get the secrets belonging to this network configuration. Only secrets from
69
+ persistent storage or a Secret Agent running in the requestor's session
70
+ will be returned. The user will never be prompted for secrets as a result
71
+ of this request.
72
+ -->
73
+ <method name="GetSecrets">
74
+ <arg name="setting_name" type="s" direction="in"/>
75
+
76
+ <arg name="secrets" type="a{sa{sv}}" direction="out"/>
77
+ </method>
78
+
79
+ <!--
80
+ ClearSecrets:
81
+
82
+ Clear the secrets belonging to this network connection profile.
83
+ -->
84
+ <method name="ClearSecrets"/>
85
+
86
+ <!--
87
+ Save:
88
+
89
+ Saves a "dirty" connection (that had previously been updated with
90
+ UpdateUnsaved) to persistent storage.
91
+ -->
92
+ <method name="Save"/>
93
+
94
+ <!--
95
+ Updated:
96
+
97
+ Emitted when any settings or permissions change. When handling this
98
+ signal, clients should re-read the connection using the GetSettings method
99
+ to get the changes and to ensure the client still has permission to access
100
+ the connection.
101
+ -->
102
+ <signal name="Updated"/>
103
+
104
+ <!--
105
+ Update2:
106
+ @settings: New connection settings, properties, and (optionally) secrets. Provide an empty array to use the current settings.
107
+ @flags: Optional flags. Unknown flags cause the call to fail.
108
+ @args: Optional arguments dictionary, for extentibility. Specifying unknown keys causes the call to fail.
109
+ @result: Currently no results are returned.
110
+ @since: 1.12
111
+
112
+ Update the connection with new settings and properties (replacing all
113
+ previous settings and properties).
114
+
115
+ Update2 is an alternative to
116
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Update">Update</link>,
117
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.UpdateUnsaved">UpdateUnsaved</link>
118
+ and <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Save">Save</link>
119
+ extensible with extra %flags and %args arguments.
120
+
121
+ The %flags argument accepts the combination of following values,
122
+ logically or-ed together:
123
+
124
+ <variablelist>
125
+ <varlistentry>
126
+ <term><literal>0x1 (to-disk)</literal>:</term>
127
+ <listitem><para>The connection is persisted to disk.</para></listitem>
128
+ </varlistentry>
129
+ <varlistentry>
130
+ <term><literal>0x2 (in-memory)</literal>:</term>
131
+ <listitem><para>The change is only made in memory (without touching an eventual
132
+ profile on disk). If neither 0x1 nor 0x2 is set, the change is made in memory
133
+ only, if the connection is already in memory only.</para></listitem>
134
+ </varlistentry>
135
+ <varlistentry>
136
+ <term><literal>0x4 (in-memory-detached)</literal>:</term>
137
+ <listitem><para>Like "in-memory", but behaves slightly different when migrating
138
+ the profile from disk to in-memory.</para></listitem>
139
+ </varlistentry>
140
+ <varlistentry>
141
+ <term><literal>0x8 (in-memory-only)</literal>:</term>
142
+ <listitem><para>Like "in-memory", but behaves slightly different when migrating
143
+ the profile from disk to in-memory.</para></listitem>
144
+ </varlistentry>
145
+ <varlistentry>
146
+ <term><literal>0x10 (volatile)</literal>:</term>
147
+ </varlistentry>
148
+ <varlistentry>
149
+ <term><literal>0x20 (block-autoconnect)</literal>:</term>
150
+ <listitem><para>Blocks auto-connect on the updated profile</para></listitem>
151
+ </varlistentry>
152
+ <varlistentry>
153
+ <term><literal>0x40 (no-reapply)</literal>:</term>
154
+ <listitem><para>Prevents "connection.zone" and "connection.metered" properties
155
+ to take effect on currently active devices.</para></listitem>
156
+ </varlistentry>
157
+ </variablelist>
158
+
159
+ The %args argument accepts the following keys:
160
+
161
+ <variablelist>
162
+ <varlistentry>
163
+ <term><literal>plugin</literal>:</term>
164
+ <listitem><para>The settings plugin the connection will be migrated to
165
+ such as "keyfile" or "ifcfg-rh".</para>
166
+ <para role="since">Since 1.38</para></listitem>
167
+ <term><literal>version-id</literal>:</term>
168
+ <listitem><para>If specified, the update request is rejected if the
169
+ profile's version-id does not match. This can be used to catch concurrent
170
+ modifications. Zero means no version check.</para><para role="since">Since 1.44</para></listitem>
171
+ </varlistentry>
172
+ </variablelist>
173
+
174
+ Secrets may be part of the update request, and will be either stored in persistent
175
+ storage or sent to a Secret Agent for storage, depending on the flags
176
+ associated with each secret.
177
+ -->
178
+ <method name="Update2">
179
+ <arg name="settings" type="a{sa{sv}}" direction="in"/>
180
+ <arg name="flags" type="u" direction="in"/>
181
+ <arg name="args" type="a{sv}" direction="in"/>
182
+ <arg name="result" type="a{sv}" direction="out"/>
183
+ </method>
184
+
185
+ <!--
186
+ Removed:
187
+
188
+ Emitted when this connection is no longer available. This happens when the
189
+ connection is deleted or if it is no longer accessible by any of the
190
+ system's logged-in users. After receipt of this signal, the object no
191
+ longer exists. Also see the Settings.ConnectionRemoved signal.
192
+ -->
193
+ <signal name="Removed"/>
194
+
195
+ <!--
196
+ Unsaved:
197
+
198
+ If set, indicates that the in-memory state of the connection does not
199
+ match the on-disk state. This flag will be set when UpdateUnsaved() is
200
+ called or when any connection details change, and cleared when the
201
+ connection is saved to disk via Save() or from internal operations.
202
+ -->
203
+ <property name="Unsaved" type="b" access="read"/>
204
+
205
+ <!--
206
+ Flags:
207
+ @since: 1.12
208
+
209
+ Additional flags of the connection profile.
210
+
211
+ Returns: <link linkend="NMSettingsConnectionFlags">NMSettingsConnectionFlags</link>
212
+ -->
213
+ <property name="Flags" type="u" access="read"/>
214
+
215
+ <!--
216
+ Filename:
217
+ @since: 1.12
218
+
219
+ File that stores the connection in case the connection is file-backed.
220
+ -->
221
+ <property name="Filename" type="s" access="read"/>
222
+
223
+ </interface>
224
+ </node>
@@ -0,0 +1,233 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <node name="/org/freedesktop/NetworkManager/Settings">
3
+
4
+ <!--
5
+ org.freedesktop.NetworkManager.Settings:
6
+ @short_description: Connection Settings Profile Manager.
7
+
8
+ The Settings interface allows clients to view and administrate the
9
+ connections stored and used by NetworkManager.
10
+ -->
11
+ <interface name="org.freedesktop.NetworkManager.Settings">
12
+
13
+ <!--
14
+ ListConnections:
15
+ @connections: List of connections.
16
+
17
+ List the saved network connections known to NetworkManager.
18
+ -->
19
+ <method name="ListConnections">
20
+ <arg name="connections" type="ao" direction="out"/>
21
+ </method>
22
+
23
+ <!--
24
+ GetConnectionByUuid:
25
+ @uuid: The UUID to find the connection object path for.
26
+ @connection: The connection's object path.
27
+
28
+ Retrieve the object path of a connection, given that connection's UUID.
29
+ -->
30
+ <method name="GetConnectionByUuid">
31
+ <arg name="uuid" type="s" direction="in"/>
32
+ <arg name="connection" type="o" direction="out"/>
33
+ </method>
34
+
35
+ <!--
36
+ AddConnection:
37
+ @connection: Connection settings and properties.
38
+ @path: Object path of the new connection that was just added.
39
+
40
+ Add new connection and save it to disk. This operation does not start the
41
+ network connection unless (1) device is idle and able to connect to the
42
+ network described by the new connection, and (2) the connection is allowed
43
+ to be started automatically.
44
+ -->
45
+ <method name="AddConnection">
46
+ <arg name="connection" type="a{sa{sv}}" direction="in"/>
47
+ <arg name="path" type="o" direction="out"/>
48
+ </method>
49
+
50
+ <!--
51
+ AddConnectionUnsaved:
52
+ @connection: Connection settings and properties.
53
+ @path: Object path of the new connection that was just added.
54
+
55
+ Add new connection but do not save it to disk immediately. This operation
56
+ does not start the network connection unless (1) device is idle and able
57
+ to connect to the network described by the new connection, and (2) the
58
+ connection is allowed to be started automatically. Use the 'Save' method
59
+ on the connection to save these changes to disk.
60
+ -->
61
+ <method name="AddConnectionUnsaved">
62
+ <arg name="connection" type="a{sa{sv}}" direction="in"/>
63
+ <arg name="path" type="o" direction="out"/>
64
+ </method>
65
+
66
+ <!--
67
+ AddConnection2:
68
+ @settings: New connection settings, properties, and (optionally) secrets.
69
+ @flags: Flags. Unknown flags cause the call to fail.
70
+ @args: Optional arguments dictionary, for extentibility. Specifying unknown keys causes the call to fail.
71
+ @path: Object path of the new connection that was just added.
72
+ @result: Output argument, currently no additional results are returned.
73
+ @since: 1.20
74
+
75
+ Add a new connection profile.
76
+
77
+ AddConnection2 is an alternative to
78
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection">AddConnection</link> and
79
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnectionUnsaved">AddConnectionUnsaved</link>.
80
+ The new variant can do everything that the older variants could, and more.
81
+ Its behavior is extensible via extra %flags and %args arguments.
82
+
83
+ The %flags argument accepts the combination of following values,
84
+ logically or-ed together:
85
+
86
+ <variablelist>
87
+ <varlistentry>
88
+ <term><literal>0x1 (to-disk)</literal>:</term>
89
+ <listitem><para>The connection is persisted to disk.</para></listitem>
90
+ </varlistentry>
91
+ <varlistentry>
92
+ <term><literal>0x2 (in-memory)</literal>:</term>
93
+ <listitem><para>The change is only made in memory (without touching an eventual
94
+ profile on disk). If neither 0x1 nor 0x2 is set, the change is made in memory
95
+ only, if the connection is already in memory only.</para></listitem>
96
+ </varlistentry>
97
+ <varlistentry>
98
+ <term><literal>0x20 (block-autoconnect)</literal>:</term>
99
+ <listitem><para>Blocks auto-connect on the new profile</para></listitem>
100
+ </varlistentry>
101
+ </variablelist>
102
+
103
+ The %args argument accepts the following keys:
104
+
105
+ <variablelist>
106
+ <varlistentry>
107
+ <term><literal>plugin</literal>:</term>
108
+ <listitem><para>The settings plugin the newly added connection will
109
+ use, such as "keyfile" or "ifcfg-rh".</para>
110
+ <para role="since">Since 1.38</para></listitem>
111
+ </varlistentry>
112
+ </variablelist>
113
+
114
+ Either the flags 0x1 (to-disk) or 0x2 (in-memory) must be specified.
115
+ The effect is whether to behave like
116
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection">AddConnection</link> or
117
+ <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnectionUnsaved">AddConnectionUnsaved</link>.
118
+ -->
119
+ <method name="AddConnection2">
120
+ <arg name="settings" type="a{sa{sv}}" direction="in"/>
121
+ <arg name="flags" type="u" direction="in"/>
122
+ <arg name="args" type="a{sv}" direction="in"/>
123
+ <arg name="path" type="o" direction="out"/>
124
+ <arg name="result" type="a{sv}" direction="out"/>
125
+ </method>
126
+
127
+ <!--
128
+ LoadConnections:
129
+ @filenames: Array of paths to on-disk connection profiles in directories monitored by NetworkManager.
130
+ @status: Success or failure of the operation as a whole. True if NetworkManager at least tried to load the indicated connections, even if it did not succeed. False if an error occurred before trying to load the connections (eg, permission denied).
131
+ @failures: Paths of connection files that could not be loaded.
132
+
133
+ Loads or reloads the indicated connections from disk. You should call this
134
+ after making changes directly to an on-disk connection file to make sure
135
+ that NetworkManager sees the changes.
136
+ As with AddConnection(), this operation does not necessarily
137
+ start the network connection.
138
+
139
+ Note that before 1.20, NetworkManager had a bug and this @status value was wrong.
140
+ It is better to assume success if the method does not return with a D-Bus error.
141
+ On top of that, you can look at @failures to know whether any of the requested files failed.
142
+ -->
143
+ <method name="LoadConnections">
144
+ <arg name="filenames" type="as" direction="in"/>
145
+ <arg name="status" type="b" direction="out"/>
146
+ <arg name="failures" type="as" direction="out"/>
147
+ </method>
148
+
149
+ <!--
150
+ ReloadConnections:
151
+ @status: This always returns %TRUE.
152
+
153
+ Tells NetworkManager to reload all connection files from disk, including
154
+ noticing any added or deleted connection files.
155
+ -->
156
+ <method name="ReloadConnections">
157
+ <arg name="status" type="b" direction="out"/>
158
+ </method>
159
+
160
+ <!--
161
+ SaveHostname:
162
+ @hostname: The hostname to save to persistent configuration. If blank, the persistent hostname is cleared.
163
+
164
+ Save the hostname to persistent configuration.
165
+ -->
166
+ <method name="SaveHostname">
167
+ <arg name="hostname" type="s" direction="in"/>
168
+ </method>
169
+
170
+ <!--
171
+ Connections:
172
+
173
+ List of object paths of available network connection profiles.
174
+ -->
175
+ <property name="Connections" type="ao" access="read"/>
176
+
177
+ <!--
178
+ Hostname:
179
+
180
+ The machine hostname stored in persistent configuration.
181
+ -->
182
+ <property name="Hostname" type="s" access="read"/>
183
+
184
+ <!--
185
+ CanModify:
186
+
187
+ If true, adding and modifying connections is supported.
188
+ -->
189
+ <property name="CanModify" type="b" access="read"/>
190
+
191
+ <!--
192
+ VersionId:
193
+
194
+ The version of the settings. This is incremented whenever the profile
195
+ changes and can be used to detect concurrent modifications.
196
+
197
+ Since: 1.44
198
+ -->
199
+ <property name="VersionId" type="t" access="read"/>
200
+
201
+ <!--
202
+ NewConnection:
203
+ @connection: Object path of the new connection.
204
+
205
+ Emitted when a new connection has been added after NetworkManager has
206
+ started up and initialized. This signal is not emitted for connections
207
+ read while starting up, because NetworkManager's D-Bus service is only
208
+ available after all connections have been read, and to prevent spamming
209
+ listeners with too many signals at one time. To retrieve the initial
210
+ connection list, call the ListConnections() method once, and then listen
211
+ for individual Settings.NewConnection and Settings.Connection.Deleted
212
+ signals for further updates.
213
+ -->
214
+ <signal name="NewConnection">
215
+ <arg name="connection" type="o"/>
216
+ </signal>
217
+
218
+ <!--
219
+ ConnectionRemoved:
220
+ @connection: Object path of the removed connection.
221
+
222
+ Emitted when a connection is no longer available. This happens when the
223
+ connection is deleted or if it is no longer accessible by any of the
224
+ system's logged-in users. After receipt of this signal, the connection no
225
+ longer exists and cannot be used. Also see the Settings.Connection.Removed
226
+ signal.
227
+ -->
228
+ <signal name="ConnectionRemoved">
229
+ <arg name="connection" type="o"/>
230
+ </signal>
231
+
232
+ </interface>
233
+ </node>
@@ -0,0 +1,42 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <node name="/">
3
+
4
+ <!--
5
+ org.freedesktop.NetworkManager.VPN.Connection:
6
+ @short_description: Active VPN Connection.
7
+
8
+ Represents an active connection to a Virtual Private Network.
9
+ -->
10
+ <interface name="org.freedesktop.NetworkManager.VPN.Connection">
11
+ <annotation name="org.gtk.GDBus.C.Name" value="VpnConnection"/>
12
+
13
+ <!--
14
+ VpnState:
15
+
16
+ The VPN-specific state of the connection.
17
+
18
+ Returns: <link linkend="NMVpnConnectionState">NMVpnConnectionState</link>
19
+ -->
20
+ <property name="VpnState" type="u" access="read"/>
21
+
22
+ <!--
23
+ Banner:
24
+
25
+ The banner string of the VPN connection.
26
+ -->
27
+ <property name="Banner" type="s" access="read"/>
28
+
29
+ <!--
30
+ VpnStateChanged:
31
+ @state: (<link linkend="NMVpnConnectionState">NMVpnConnectionState</link>) The new state of the VPN connection.
32
+ @reason: (<link linkend="NMActiveConnectionStateReason">NMActiveConnectionStateReason</link>) Reason code describing the change to the new state.
33
+
34
+ Emitted when the state of the VPN connection has changed.
35
+ -->
36
+ <signal name="VpnStateChanged">
37
+ <arg name="state" type="u"/>
38
+ <arg name="reason" type="u"/>
39
+ </signal>
40
+
41
+ </interface>
42
+ </node>