1connmanctl(1) General Commands Manual connmanctl(1)
2
3
4
6 connmanctl - Connman CLI
7
9 connmanctl [state | technologies | enable technology|offline | dis‐
10 able technology|offline | tether technology on|off |
11 tether wifi on|off ssid passphrase | services [service] | peers peer |
12 scan technology | connect service|peer | disconnect service|peer | con‐
13 fig service option arg... | vpnconnections [connection] | help]
14
16 Connmanctl is a Connman command line interface which can be run in two
17 modes: a plain synchronous command input, and an asynchronous interac‐
18 tive shell. To run a specific command the user may enter conn‐
19 manctl command [options] or just connmanctl, in the latter case an
20 interactive shell will start.
21
22 Connmanctl can handle most network connections. It can be used to
23 enable/disable any technology that exists on the system, display a list
24 of services available, connect/disconnect networks, show properties of
25 the system, the technologies, and any individual service, and configure
26 all of the properties. It is also able to monitor changes in the prop‐
27 erties of the services, technologies, and the system.
28
29 In the interactive shell, all of the same commands can be used. It pro‐
30 vides quicker usage when needing to use connmanctl more extensively. In
31 addition, connecting to protected wireless access points for the first
32 time requires interactive shell.
33
35 help Shows the abbreviated help menu in the terminal.
36
37 state Shows the system properties. Includes ths online state of the
38 system, offline mode, and session mode.
39
40 technologies
41 Shows a list of all technology types existing on the system and
42 their properties. See the properties section of the Technology
43 API for explanations of each property.
44
45 enable technology
46 Enables the given technology type (e.g. ethernet, wifi, 3g,
47 etc.) Turns power on to the technology, but doesn't connect
48 unless there is a service with autoconnect set to True.
49
50 disable technology
51 Disables the given technology type. Turns power off to the tech‐
52 nology and disconnects if it is already connected.
53
54 enable offline
55 Enables offline mode. Disconnects and powers down all technolo‐
56 gies system-wide, however each technology can be powered back on
57 individually.
58
59 disable offline
60 Disables offline mode. Technologies are powered back on accord‐
61 ing to their individual policies.
62
63 tether technology on | off
64 Enable or disable tethering on technology. Ethernet cannot be
65 tethered by default since tethering it usually breaks local net‐
66 works. See connman.conf(5) for enabling.
67
68 tether wifi on | off ssid passphrase
69 Enable or disable wireless tethering, as well set the SSID and
70 passphrase.
71
72 services
73 Shows a list of all available services. This includes the nearby
74 wifi networks, the wired ethernet connections, bluetooth
75 devices, etc. An asterisk in front of the service indicates
76 that the service has been connected before.
77
78 services service
79 Shows a list of all properties for that service. Only the ser‐
80 vice path (e.g. wifi_6834534139723_managed_none) is accepted as
81 a parameter.
82
83 scan technology
84 Scans for new services on the given technology.
85
86 connect service
87 Connects to the given service. Some services need a so-called
88 provisioning file in order to connect to them, see connman-ser‐
89 vice.config(5).
90
91 disconnect service
92 Disconnects from the given service.
93
94 move-before service target-service
95 Prefer connecting to service over target-service.
96
97 move-after service target-service
98 Prefer connecting to target-service over service.
99
100 config service option arg...
101 Configures a writable property of the given service to the
102 value(s) entered after option. See the Config Options subsection
103 for details.
104
105 monitor target
106 Listens for and displays DBus signals sent by Connman. If a cur‐
107 rently monitored property changes, the changes will be shown. If
108 no target is specified, all changes will be shown. See the Moni‐
109 tor Options subsection for a summary of parameters.
110
111 vpnconnections
112 Shows a list of all available vpn connections.
113
114 vpnconnections connection
115 Shows the current properties of connection.
116
117 Commands only available in interactive mode:
118 agent on | off
119 Enable or disable the wireless agent, used for entering wireless
120 network passphrases. See the EXAMPLE section of this man page
121 for an example of connecting to a wireless access point.
122
123 vpnagent on | off
124 Enable or disable the vpn agent, used for entering vpn creden‐
125 tials.
126
127 Config Options:
128 autoconnect on | off
129 Sets the autoconnect property of the service.
130
131 ipv4 off | dhcp | manual address netmask gateway
132 Configures the IPv4 settings for the service. The argument off
133 means that IPv4 won't be used, dhcp means that dhcp will be used
134 to get the settings and manual means that the given arguments
135 will be used as IPv4 settings. address, netmask and gateway
136 must be valid IPv4 addresses. See the EXAMPLE section of this
137 man page for details.
138
139 ipv6 off | auto | manual address prefixlength gateway
140 Configures the IPv6 settings for the service. The argument off
141 means that IPv6 won't be used, auto means that settings will be
142 asked from the network and manual means that the given arguments
143 will be used as IPv6 settings. address and gateway must be
144 valid IPv4 addresses. prefixlength is the length of the prefix
145 in bits. See the EXAMPLE section of this man page for details.
146
147 nameservers dns [...]
148 Set the list of nameservers, separated by spaces.
149
150 timeservers server [...]
151 Set the list of timeservers, separated by spaces.
152
153 domains domain [...]
154 Set the list of search domains, separated by spaces.
155
156 proxy direct | auto URL | manual server[...] [--excludes server[...]]
157 Configures the proxy settings for the service. direct means that
158 no proxy will be used. If using auto without a parameter, the
159 network will be asked for the proxy settings. Otherwise, use URL
160 as an proxy autoconfiguration URL. When set to manual, the first
161 list of servers is used as proxy servers, and the traffic to the
162 second list of servers are excluded from the proxy. The list of
163 excluded servers is optional. See the EXAMPLE section of this
164 man page for details.
165
166 Monitor Options:
167 services [off]
168 Listens for changes to services, for example a service getting
169 an IP address.
170
171 tech [off]
172 Listens for changes to technologies, for example a technology
173 getting enabled.
174
175 manager [off]
176 Listens for the changes to global properties, available tech‐
177 nologies, services, and peers.
178
179 vpnmanager [off]
180 Listens for added or removed vpn connections.
181
182 vpnconnection [off]
183 Listens for the changes to vpn connections, for example connect‐
184 ing to a VPN.
185
187 Listing available technologies:
188
189 $ connmanctl technologies
190
191 Listing available services:
192
193 $ connmanctl services
194
195 Scanning for wireless networks:
196
197 $ connmanctl scan wifi
198
199 Using the interactive mode to access a wireless access point:
200
201 $ connmanctl
202 connmanctl> agent on
203 Agent registered
204 connmanctl> connect wifi_100ba9d170fc_666f6f626172_managed_psk
205 Agent RequestInput wifi_100ba9d170fc_666f6f626172_managed_psk
206 Passphrase = [ Type=psk, Requirement=mandatory ]
207 Passphrase? password
208 Connected wifi_100ba9d170fc_666f6f626172_managed_psk
209 connmanctl>
210
211 Configuring a static IP from the command line:
212
213 $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk
214 ipv4 manual 192.168.1.101 255.255.255.0 192.168.1.1
215
216 Changing the IP back to dhcp:
217
218 $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk
219 ipv4 dhcp
220
221 Setting a proxy server:
222
223 $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk
224 proxy manual proxy.example.com
225
226 Setting multiple proxy servers:
227
228 $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk
229 proxy manual proxy.example.com http://httpproxy.example.com --excludes
230 internal.example.com
231
232 Tethering a wireless connection (ssid "SSID", passphrase "password"):
233
234 $ connmanctl tether wifi on SSID password
235
237 connman.conf(5), connman-service.config(5), connman-vpn-provider.con‐
238 fig(5), connman(8), connman-vpn(8)
239
240
241
242 2015-10-15 connmanctl(1)