Scroll to navigation

comitup-cli(1) comitup-cli(1)

NAME

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

SYNOPSIS


$ `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-<nn>, where <nn> 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.

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

SEE ALSO

comitup(8), comitup-conf(5), comitup-web(8)
April 2018