1connmanctl(1)               General Commands Manual              connmanctl(1)
2
3
4

NAME

6       connmanctl - Connman CLI
7

SYNOPSIS

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

DESCRIPTION

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

COMMANDS AND OPTIONS

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

EXAMPLE

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

SEE ALSO

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)
Impressum