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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
% comitup(8)
%
% July 2021
# NAME
comitup -- Manage wifi connections on headless, unconnected systems
## SYNOPSIS
`comitup [options]`
## DESCRIPTION
The **comitup** service provides a means to establish a connection between a
computer and a wifi access point, in the case where wifi is the only means
available to access the computer.
On startup, the service will attempt to connect to wifi using established
networkmanager(8) connections. If this is not successful, **comitup** will
establish a wifi hotspot with the name _comitup-<nnn>_, where <nnn>
is a persistent number.
While the hotspot is active, a comitup-web(8) service is available to manage
connecting to an access point. A captive portal environment is
established to aid in discovery of the web service.
If two wifi interfaces are available, the hotspot will remain active on the
first interface, and the internet connection will be made on the second.
Otherwise, the hotspot will be replaced with the internet connection.
In all states, avahi-daemon(8) is used to publish the mdns host name
_comitup-<nnn>.local_, making the web service accessible
as e.g. _http://comitup-123.local_, for systems supporting Zeroconf. For other
systems, a _comitup_ Workstation entry is published which is visible to Zeroconf
browsing applications, allowing the IP address to be manually determined.
The web service address is _http://10.41.0.1_.
**comitup** logs to _/var/log/comitup.log_.
## Options
* _-h_, _--help_ - Print help and exit
* _-c_, _--check_ - Check the wifi device configuration and exit
* _-i_, _--info_ - Print info about the current configuration, and exit
* _-v_, _--verbose_ - Increase logging to _/var/log/comitup.log_
## D-Bus Interface
**Comitup** provides a D-Bus object which claims the name
_com.github.davesteele.comitup_ on the path
_/com/github/davesteele/comitup_, supporting the
interface _com.github.davesteele.comitup_. The interface includes the
following methods.
* _get_info()_
Input: None
Output: _DICT_ENTRY_
Return information about the current **Comitup** service. The keys are
as follows:
* _version_ - The package version.
* _apname_ - The currently configured AP hotspot name.
* _hostnames_ - A list of host names that are published for the service
IP address.
* _imode_ - The current interface mode for comitup. This returns the string
'single' or 'router'. In 'single' mode, the hotspot is terminated when
**CONNECTED**. In 'router' mode, the hotspot is retained, the upstream
connection is made with the other wifi device, and traffic is routed
between them. The web service is terminated when **CONNECTED**.
* _access_points()_
Input: None
Output: Array of _DICT_ENTRY_
Return a list of visible access points. This is represented as an array
of D-Bus _DICT_ENTRY_. Each _DICT_ENTRY_ contains strings associated with
the following keys, _ssid_, _strength_ (0 to 100) and _security_
(_encrypted_ or _unencrypted_).
* _state()_
Input: None
Output: _state_, _connection_
This returns strings for the current **comitup** state (either
**HOTSPOT**, **CONNECTING**, or **CONNECTED**) and the _ssid_ name for
the current connection on the wifi device.
* _connect()_
Input: _ssid_, _password_
Output: None
Delete any existing connection for _ssid_, create a new connection, and
attempt to connect to it. The password may be a zero length string if
not needed.
* _delete_connection()_
Input: _ssid_
Output: None
Delete the connection for _ssid_. The system will not be able to reconnect
using this connection.
* _nuke()_
Input: None
Output: None
Perform a factory reset of Comitup information on the device, which
consists of removing all WiFi connections, and restarting the service. Note
that _enable\_nuke_ must be enabled in comitup.conf for this to succeed.
## COPYRIGHT
Comitup is Copyright (C) 2016-2019 David Steele <steele@debian.org>.
## SEE ALSO
comitup-conf(5), comitup-cli(1), comitup-web(8), comitup-watch(1)
|
