table of contents
COMITUP-CLI(1) | COMITUP-CLI(1) |
NAME¶
comitup-cli - command-line interface for comitup network managementSYNOPSIS¶
$ `comitup-cli` State: HOTSPOT Connection: hotspot-1234 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-<nnnn>, where <nnnn> is a persistent 4-digit 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-2017 David Steele <steele@debian.org>SEE ALSO¶
comitup(8), comitup-conf(5), comitup-web(8)January 2017 |