Provided by: connman_1.36-2ubuntu0.1_amd64 bug

NAME

       connmanctl - Connman CLI

SYNOPSIS

       connmanctl [state |      technologies |      enable technology|offline |     disable technology|offline |
       tether technology on|off |   tether wifi on|off ssid passphrase |    services [service] |    peers peer |
       scan technology |   connect service|peer |   disconnect service|peer |   config   service option arg... |
       vpnconnections [connection] | help]

DESCRIPTION

       Connmanctl is a Connman command line interface which can be run in two modes: a plain synchronous command
       input,  and  an  asynchronous  interactive  shell.   To  run  a  specific  command  the  user  may  enter
       connmanctl command [options] or just connmanctl, in the latter case an interactive shell will start.

       Connmanctl can handle most network connections. It can be used  to  enable/disable  any  technology  that
       exists  on the system, display a list of services available, connect/disconnect networks, show properties
       of the system, the technologies, and any individual service, and configure all of the properties.  It  is
       also able to monitor changes in the properties of the services, technologies, and the system.

       In the interactive shell, all of the same commands can be used. It provides quicker usage when needing to
       use connmanctl more extensively. In addition, connecting to protected  wireless  access  points  for  the
       first time requires interactive shell.

COMMANDS AND OPTIONS

       help   Shows the abbreviated help menu in the terminal.

       state  Shows  the  system  properties. Includes ths online state of the system, offline mode, and session
              mode.

       technologies
              Shows a list of all technology types  existing  on  the  system  and  their  properties.  See  the
              properties section of the Technology API for explanations of each property.

       enable technology
              Enables  the  given  technology  type  (e.g.  ethernet,  wifi,  3g,  etc.)   Turns power on to the
              technology, but doesn't connect unless there is a service with autoconnect set to True.

       disable technology
              Disables the given technology type. Turns power off to the technology and  disconnects  if  it  is
              already connected.

       enable offline
              Enables  offline  mode.  Disconnects  and  powers  down all technologies system-wide, however each
              technology can be powered back on individually.

       disable offline
              Disables offline mode. Technologies are powered back on according to their individual policies.

       tether technology on | off
              Enable or disable tethering on technology. Ethernet cannot be tethered by default since  tethering
              it usually breaks local networks. See connman.conf(5) for enabling.

       tether wifi on | off ssid passphrase
              Enable or disable wireless tethering, as well set the SSID and passphrase.

       services
              Shows a list of all available services. This includes the nearby wifi networks, the wired ethernet
              connections, bluetooth devices, etc.  An asterisk in front  of  the  service  indicates  that  the
              service has been connected before.

       services service
              Shows   a   list   of   all   properties   for   that   service.   Only  the  service  path  (e.g.
              wifi_6834534139723_managed_none) is accepted as a parameter.

       scan technology
              Scans for new services on the given technology.

       connect service
              Connects to the given service. Some services need  a  so-called  provisioning  file  in  order  to
              connect to them, see connman-service.config(5).

       disconnect service
              Disconnects from the given service.

       move-before service target-service
              Prefer connecting to service over target-service.

       move-after service target-service
              Prefer connecting to target-service over service.

       config service option arg...
              Configures  a writable property of the given service to the value(s) entered after option. See the
              Config Options subsection for details.

       monitor target
              Listens for and displays DBus signals sent by Connman. If a currently monitored property  changes,
              the  changes  will be shown. If no target is specified, all changes will be shown. See the Monitor
              Options subsection for a summary of parameters.

       vpnconnections
              Shows a list of all available vpn connections.

       vpnconnections connection
              Shows the current properties of connection.

   Commands only available in interactive mode:
       agent on | off
              Enable or disable the wireless agent, used for entering  wireless  network  passphrases.  See  the
              EXAMPLE section of this man page for an example of connecting to a wireless access point.

       vpnagent on | off
              Enable or disable the vpn agent, used for entering vpn credentials.

   Config Options:
       autoconnect on | off
              Sets the autoconnect property of the service.

       ipv4 off | dhcp | manual address netmask gateway
              Configures the IPv4 settings for the service. The argument off means that IPv4 won't be used, dhcp
              means that dhcp will be used to get the settings and manual means that the given arguments will be
              used as IPv4 settings.  address, netmask and gateway must be valid IPv4 addresses. See the EXAMPLE
              section of this man page for details.

       ipv6 off | auto | manual address prefixlength gateway
              Configures the IPv6 settings for the service. The argument off means that IPv6 won't be used, auto
              means  that settings will be asked from the network and manual means that the given arguments will
              be used as IPv6 settings.  address and gateway must be valid IPv4 addresses. prefixlength  is  the
              length of the prefix in bits. See the EXAMPLE section of this man page for details.

       nameservers dns [...]
              Set the list of nameservers, separated by spaces.

       timeservers server [...]
              Set the list of timeservers, separated by spaces.

       domains domain [...]
              Set the list of search domains, separated by spaces.

       proxy direct | auto URL | manual server[...] [--excludes server[...]]
              Configures  the  proxy settings for the service. direct means that no proxy will be used. If using
              auto without a parameter, the network will be asked for the proxy settings. Otherwise, use URL  as
              an  proxy  autoconfiguration  URL.  When set to manual, the first list of servers is used as proxy
              servers, and the traffic to the second list of servers are excluded from the proxy.  The  list  of
              excluded servers is optional. See the EXAMPLE section of this man page for details.

   Monitor Options:
       services [off]
              Listens for changes to services, for example a service getting an IP address.

       tech [off]
              Listens for changes to technologies, for example a technology getting enabled.

       manager [off]
              Listens for the changes to global properties, available technologies, services, and peers.

       vpnmanager [off]
              Listens for added or removed vpn connections.

       vpnconnection [off]
              Listens for the changes to vpn connections, for example connecting to a VPN.

EXAMPLE

       Listing available technologies:

             $ connmanctl technologies

       Listing available services:

             $ connmanctl services

       Scanning for wireless networks:

             $ connmanctl scan wifi

       Using the interactive mode to access a wireless access point:

             $ connmanctl
             connmanctl> agent on
             Agent registered
             connmanctl> connect wifi_100ba9d170fc_666f6f626172_managed_psk
             Agent RequestInput wifi_100ba9d170fc_666f6f626172_managed_psk
               Passphrase = [ Type=psk, Requirement=mandatory ]
             Passphrase? password
             Connected wifi_100ba9d170fc_666f6f626172_managed_psk
             connmanctl>

       Configuring a static IP from the command line:

             $   connmanctl   config   wifi_100ba9d170fc_666f6f626172_managed_psk   ipv4   manual  192.168.1.101
       255.255.255.0 192.168.1.1

       Changing the IP back to dhcp:

             $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk ipv4 dhcp

       Setting a proxy server:

             $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk proxy manual proxy.example.com

       Setting multiple proxy servers:

             $  connmanctl  config  wifi_100ba9d170fc_666f6f626172_managed_psk  proxy  manual  proxy.example.com
       http://httpproxy.example.com --excludes internal.example.com

       Tethering a wireless connection (ssid "SSID", passphrase "password"):

             $ connmanctl tether wifi on SSID password

SEE ALSO

       connman.conf(5), connman-service.config(5), connman-vpn-provider.config(5), connman(8), connman-vpn(8)

                                                   2015-10-15                                      connmanctl(1)