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

NAME

       main.conf - ConnMan configuration file

SYNOPSIS

       /etc/connman/main.conf

DESCRIPTION

       main.conf  is  a configuration file for ConnMan. The configuration file is optional but it
       can be used to set up various aspects of ConnMan's behavior. The location of the file  may
       be changed through use of the --config= argument for connman(8).

FILE FORMAT

       The  configuration file consists of sections (groups) of key-value pairs.  Lines beginning
       with a '#' and blank lines are considered comments.  Sections are started by a header line
       containing  the  section enclosed in '[' and ']', and ended implicitly by the start of the
       next section or the end of the file. Each key-value pair must be contained in a section.

       Description of sections and available keys follows:

   [General]
       This section is the only mandatory section of the configuration file.

       InputRequestTimeout=secs
              Set input request timeout. Default is 120  seconds  The  request  for  inputs  like
              passphrase  will timeout after certain amount of time. Use this setting to increase
              the value in case of different user interface designs.

       BrowserLaunchTimeout=secs
              Set browser launch timeout. Default is 300 seconds  The  request  for  launching  a
              browser  for  portal  pages  will  timeout  after  certain amount of time. Use this
              setting to increase the value in case of different user interface designs.

       BackgroundScanning=true | false
              Enable background  scanning.  Default  is  true.   If  wifi  is  disconnected,  the
              background scanning will follow a simple backoff mechanism from 3s up to 5 minutes.
              Then, it will stay in 5 minutes unless user specifically asks for scanning  through
              a D-Bus call. If so, the mechanism will start again from 3s. This feature activates
              also the background scanning while being connected, which is required  for  roaming
              on  wifi.   When  BackgroundScanning  is  false,  ConnMan will not perform any scan
              regardless of wifi is connected or not, unless it is requested by the user  through
              a D-Bus call.

       FallbackTimeservers=server[,...]
              List  of Fallback timeservers separated by ",".  These timeservers are used for NTP
              sync when there are no timeserver set by the user or by  the  service.   These  can
              contain mixed combination of fully qualified domain names, IPv4 and IPv6 addresses.

       FallbackNameservers=server[,...]
              List  of  fallback nameservers separated by "," appended to the list of nameservers
              given by the service. The nameserver entries must be in numeric format, host  names
              are ignored.

       DefaultAutoConnectTechnologies=technology[,...]
              List  of  technologies  that  are  marked  autoconnectable by default, separated by
              commas ",". The default value for this entry when empty is  ethernet,wifi,cellular.
              Services  that  are  automatically  connected  must  have  been set up and saved to
              storage beforehand.

       AlwaysConnectedTechnologies=technology[,...]
              List of technoolgies which are always connected regardless of PreferredTechnologies
              setting  (AutoConnect  =  true).  The  default  value  is empty and this feature is
              disabled unless explicitly enabled in the config file.

       PreferredTechnologies=technology[,...]
              List of preferred technologies from the most preferred one to the  least  preferred
              one  separated by commas ",".  Services of the listed technology type will be tried
              one by one in the order given, until one of them gets connected  or  they  are  all
              tried.  A  service  of  a  preferred  technology type in state 'ready' will get the
              default route when compared to another preferred type further down  the  list  with
              state  'ready'  or  with  a non-preferred type; a service of a preferred technology
              type in state 'online' will get the default route when compared to  either  a  non-
              preferred type or a preferred type further down in the list.

       NetworkInterfaceBlacklist=interface[,...]
              List  of blacklisted network interfaces separated by ",".  Found interfaces will be
              compared to the list and will not be handled by connman, if their first  characters
              match any of the list entries. Default value is vmnet,vboxnet,virbr,ifb.

       AllowHostnameUpdates=true | false
              Allow  connman  to  change  the  system hostname. This can happen for example if we
              receive DHCP hostname option.  Default value is true.

       AllowDomainnameUpdates=true | false
              Allow connman to change the system domainname. This can happen for  example  if  we
              receive DHCP domainname option.  Default value is true.

       SingleConnectedTechnology=true | false
              Keep  only  a  single  connected  technology  at  any  time.  When a new service is
              connected by the user or a better one is found according to  PreferredTechnologies,
              the  new  service is kept connected and all the other previously connected services
              are disconnected. With this setting it  does  not  matter  whether  the  previously
              connected  services  are in 'online' or 'ready' states, the newly connected service
              is the only one that will be kept connected. A service connected by the  user  will
              be used until going out of network coverage. With this setting enabled applications
              will notice more network breaks than normal. Default value is false.

       TetheringTechnologies=technology[,...]
              List of technologies that are allowed to enable tethering separated  by  ",".   The
              default  value  is  wifi,bluetooth,gadget.  Only those technologies listed here are
              used for tethering. If one wants to tether ethernet, then  add  "ethernet"  in  the
              list.  NOTE that if ethernet tethering is enabled, then a DHCP server is started on
              all ethernet interfaces. Tethered ethernet should never be connected  to  corporate
              or  home network as it will disrupt normal operation of these networks. Due to this
              ethernet is not tethered by default. Do not activate ethernet tethering unless  you
              really know what you are doing.

       PersistentTetheringMode=true | false
              Restore  earlier  tethering  status when returning from offline mode, re-enabling a
              technology, and after restarts and reboots.  Default value is false.

       Enable6to4=true | false
              Automatically enable Anycast 6to4 if possible. This is not recommended, as the  use
              of  6to4  will  generally  lead to a severe degradation of connection quality.  See
              RFC6343.  Default value is false (as recommended by RFC6343 section 4.1).

       VendorClassID=string
              Set DHCP option 60 (Vendor Class ID) to the given string. This option can  be  used
              by  DHCP servers to identify specific clients without having to rely on MAC address
              ranges, etc

       EnableOnlineCheck=true | false
              Enable or disable use of HTTP GET as an online status check.  When a service is  in
              a  READY  state, and is selected as default, ConnMan will issue an HTTP GET request
              to verify that end-to-end connectivity is successful. Only then the service will be
              transitioned  to  ONLINE state.  If this setting is false, the default service will
              remain in READY state.  Default value is true.

       AutoConnectRoamingServices=true | false
              Automatically connect roaming services. This is not recommended unless you know you
              won't have any billing problem.  Default value is false.

EXAMPLE

       The  following  example  configuration  disables  hostname  updates  and  enables ethernet
       tethering.

       [General]
       AllowHostnameUpdates = false
       AllowDomainnameUpdates = false
       TetheringTechnologies = ethernet,wifi,bluetooth,gadget

SEE ALSO

       connman(8)

                                            2015-10-15                            connman.conf(5)