Provided by: cmst_2023.03.14-1build2_amd64 
NAME
CMST - Connman System Tray
SYNOPSIS
Usage: cmst [options]
DESCRIPTION
A QT5 based GUI front end for the Connman network daemon
OPTIONS
-b, --bypass-restore-state
If restore state is specified in the settings file this take precedence over that
setting and not restore the state when starting.
-B, --bypass-start-options
Ignore completely any start options specified in the settings file.
-c, --enable-counters [Experimental]
Enable the counters. Counters are disabled by default to minimize load on your
system.
-d, --disable-tray-icon
Disable the system tray icon. May be needed for system trays not compliant with
the Freedesktop.org system tray specification.
-h, --help
Displays this help.
-i, --icon-theme <Icon Theme Name>
Use a specific icon theme from your system. The Icon Theme name is optional and if
specified CMST will try to use icons from that theme. If no name is provided and
if a system wide icon theme is defined (via your DE) it will be used. If the icon
theme cannot be found CMST will fallback to using internal built in icons.
-I, --icon-scale <Icon Scale>
Scale icons and other artwork in CMST. For High DPI moitors it may be necessary to
specify a scale factor on icons and other artwork in CMST. You may override the
default using this option. For High DPI monitors a factor of 2 has been found to be
good. The default scale is 1.0. Valid values of scale factor are from 1.0 to 3.0.
-l, --log-input-request
Log the Connman inputRequest for debugging purposes.
-m, --minimized
Start the GUI minimized in the system tray.
-M, --disable-minimize
Disable the minimize button. Use when you want the window manager to have sole
control in minimizing the interface.
-n, --disable-vpn
Disable VPN support. This will disable (grey out) the VPN tab and the VPN editor
button. More importantly it will also bypass setting up a DBUS connection to
connman-vpn. If Connman is compiled without VPN support this option should be
supplied.
-v, --version
Displays version information.
-w, --wait-time <seconds>
Specify the wait time in seconds before starting the system tray icon (default is 0
seconds). If CMST is started and tries to create a tray icon before the system
tray itself is created CMST will not be able to start minimized. This sometimes
happens when the program is started automatically. If you know the tray will exist
once the system is up you may specify a wait time and CMST will wait that number of
seconds before trying to create the tray icon. This is to give the window manager
or panel time to create the tray before we try to place the icon there. If you
plan to start with the main dialog shown on screen there is no reason to use this
option. This is only intended to be used for starting minimized.
--counter-update-kb <KB> [Experimental]
Specify the amount of data in KB that must be transmitted before the counters
update (default is 1024 KB). Connman will accept this entry, but according to a
comment in the Connman code the actual feature still needs to be implemented.
--counter-update-rate <seconds> [Experimental]
Specify the frequency in seconds between counter updates (default is 10 seconds).
--fake-transparency <RRGGBB>
On some systems the system tray icon background, which is transparent, will display
as white or black. This seems to be an issue between QT, system tray
implementations, compositing, and perhaps certain graphics cards. To work around
it we've implemented a fake transparency for tray icons. To use it specify the
system tray background color with this option. If the background color is provided
CMST will convert the tray icon image to have the specified background color.
Color is a hex number in the format: RRGGBB.
COMMAND LINE STABILITY
Command line options marked [Experimental] refer to some option in Connman that is
currently flagged experimental. These options should not be assumed to be fixed and could
change at any time. Other command line options may be assumed to be fixed and should be
safe to use in startup scripts.
GUI INFO
The GUI contains one main dialog with separate tab pages. Program help is mainly provided
through a "What's This" interface. The "What's This" button in the lower left corner will
allow you to enter "What's This" mode, click the button and then click the GUI feature, or
control that you are interested in. A right mouse click on a GUI feature or control will
also enter "What's This" mode.
Status Tab
The status tab displays information about the global properties, found
technologies, and services. Checkbox at the top right will allow you to put
everything in "offline" mode. To toggle a technology on or off click the entry
under the Powered column
Details Tab
The details tab will display detailed setup and connection information about a
service. Select the service you wish to investigate in the combo box at the top.
Wireless Tab
The Wireless tab will display information, connect, disconnect, and edit certain
properties of wireless services.
VPN Tab
The VNP tab will display information, connect and disconnect already provisioned
VPN services.
Counters Tab
The Counters tab will display information about the Connect time, the Transmit (TX)
and Receiving (RX) counters for the service currently in the "online" state. The
counters are set to fairly course intervals to minimize system usage. Currently
these interval settings are hard coded into the program.
Preferences Tab
The preferences tab will allow you to change some aspects of the GUI.
CONFIGURATION
For typical networks and access points, even hidden ones, Connman will find and
automatically configure the network for you. If Connman needs information, for instance a
passphrase, CMST registers an agent and this agent will prompt you for the needed
information. For most cases this "just works", however there are options for fine tuning
the automatic configuration or creating provisioning files.
Profile Editor
There are a variety of connection settings that may be used to override the
automatic settings. An editor is provided to access these settings via the
Configuration button in the lower right corner of the Details tab. One common use
is to define a static IP address for the connection. Hidden or provisioned (see
below) services cannot be edited.
802.1x Encrypted Networks (Eduroam and similar)
Certain types encrypted networks require a config (provisioning) file to be created
before you first connect. As of 2014.10.30 CMST has a provisioning editor built
in, but it is considered an advanced control and by default it is hidden. To
enable the control check the Advanced Controls box on the Provisioning tab. The
button to open the editor will appear in the lower left corner of the dialog. With
this editor you may create, open, edit, delete and save config files to
/var/lib/connman. The menu at the top may be used to enter some information
automatically, and many of the input fields are validated as you enter text into
them. There are also predefined template files that may be used to seed the
editing area. All of this can be bypassed if you wish and you may cut and paste or
type into the editor directly.
Creating and Editing VPN Connections
As of 2016.01.26 CMST has a VPN provisioning editor built in, but it is considered
an advanced control and by default it is hidden. To enable the control check the
Advanced Controls box on the Provisioning tab. The button to open the editor will
appear in the lower left corner of the dialog. With this editor you may create,
open, edit, delete and save config files to /var/lib/connman-vpn. The menu at the
top may be used to enter some information automatically, and many of the input
fields are validated as you enter text into them. The first item under each menu
heading (Provider xxx) will start a junior wizard to walk you through entering all
the mandatory information for each connection type. For OpenVPN the second menu
item (Import Configuration) will import an OpenVPN .opvn file. The import will
extract and save keys and certificates and will place the proper provisioning
entries into the editor window.
BUGS
For the tray icon to display is it required that the system tray be compliant with the
Freedesktop.org systemtray specification.
The tray icon is known to not work in the DWM system tray which appears to be a
noncompliant tray.
Author
Andrew J. Bibb. Project web page: https://github.com/andrew-bibb/cmst