NAME

       comitup-cli - command-line interface for comitup network management

   SYNOPSIS
              $ `comitup-cli`

              State: HOTSPOT
              Connection: hotspot-123
              Points:
                  1: MyAccessPoint
                  2: HisAccessPoint
              Available Commands:
                  (r)eload
                  (q)uit
                  connect to (<n>)
              command?:

   DESCRIPTION
       The comitup-cli utility provides access to the comitup(8) D-Bus interface.  It is intended
       to serve as a debug tool, and a source code example for connecting to the interface.

       If the comitup(8) service is not running, comitup-cli will immediately exit.

       Display:

       · State

         The comitup states are HOTSPOT, CONNECTING, and CONNECTED.

         In the HOTSPOT mode, comitup creates a wifi hotspot with the name  comitup-<nnn>,  where
         <nnn> is a persistent number.

         Once  in  HOTSPOT  mode,  the  system will occasionally (~1/min) cycle through available
         defined connections, by transitioning to the CONNECTING mode.  The Access Point list  is
         updated  by this process.  Any command issued by comitup-cli will cause the next timeout
         instance to be skipped.

         Once a connection is established, the system will be in  the  CONNECTED  mode.   If  the
         connection  is  lost, failed, or deleted, the system will transition back to the HOTSPOT
         state.

       · Connection

         The ssid of the current active connection.

       · Points

         While in the HOTSPOT mode, comitup-cli will list the currently-visible access points, by
         ssid.   Access  points with the strongest signal are sorted to the top of the list.  The
         entries are numbered, for use with the connect command.

       Commands:

       · r - Reload

         Refresh the displayed state, mode, and list of access points.

       · q - Quit

         Exit comitup.cli.

       · d - Delete connection

         Delete the configuration information for the current wifi connection.  This  will  cause
         comitup to transition to the HOTSPOT mode.

         This command is not available in the HOTSPOT mode.

       · <n> - Connect to access point <n>

         Define a connection for the selected access point, and then attempt to connect.

         This command is only available in the HOTSPOT mode.

       · m - Manual connection

         Enter an SSID manually.

       · i - Get information

         Return the comitup version and host name for the current instance.

   COPYRIGHT
       Comitup is Copyright (C) 2016-2019 David Steele <steele@debian.org>

   SEE ALSO
       comitup(8), comitup-conf(5), comitup-web(8)

                                          February 2019                            comitup-cli(8)