1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
% comitup-cli(1)
%
% April 2018
# 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.
## COPYRIGHT
Comitup is Copyright (C) 2016-2017 David Steele <steele@debian.org>
## SEE ALSO
comitup(8), comitup-conf(5), comitup-web(8)
|