Command Line

Documentation / CyTinyMon

• Overview of CyTinyMon
  • What It Does
  • What It Is Not
• Using CyTinyMon
  • Enable The Monitor
  • What The Lamps Mean
  • Preferences Panel
  • Tray Host
  • Conf By Hand
• Command Line
  • cytinymon
  • cytinymon-prefs
  • Conf Keys (Read By The Mon)
• Copyright

Command Line

Two binaries. cytinymon is the tray monitor. cytinymon-prefs is the Motif panel that writes conf and notifies a running mon.

cytinymon

cytinymon [--help] [--version] [--foreground]

• -h, --help -- usage and exit
• -V, --version -- version and exit
• -f, --foreground -- stay in the foreground (accepted; the mon is foreground today)

Conf: ~/.cyanotype/cytinymon.conf, or $CYTINYMON_CONF. Enable the monitor in prefs; default is off. With enabled off the process exits so the tray stays empty.

DISPLAY is required. Probing uses share/cytinymon/linkprobe.sh under the install prefix (unprivileged ICMP / gateway / discover helper).

cytinymon-prefs

cytinymon-prefs [--help] [--version]

• -h, --help -- short usage and exit
• -V, --version -- version and exit

Opens Link Monitor Preferences. Apply writes the conf and reloads a running cytinymon. Singleton per screen. Esc / q quit like other prefs panels. Cy* widgets throughout.

Conf Keys (Read By The Mon)

• enabled -- on|off (default off)
• lan_address / wan_address -- ICMP targets; omit the line to clear
• interval_sec -- seconds between checks (default 10, clamp 5..3600)
• show_labels -- on|off (default on)
• label_color_normal -- scheme (HighlightColor) or #rrggbb / rgb.txt
• label_color_outage -- default #ff0000
• hover_graphs -- on|off
• graph_minutes -- history window when hover graphs are on (default 360)

Examples

cytinymon-prefs
cytinymon --foreground
CYTINYMON_CONF=/tmp/tinymon.conf cytinymon

See Also

• Using CyTinyMon
• Overview of CyTinyMon