CLI Reference

This reference documents all command-line options for the License Monitor executable.

Synopsis

license_monitor [OPTIONS]
license_monitor --self-update [UPDATE_OPTIONS]
license_monitor --help
license_monitor --version

General Options

Option	Short	Description
--help	-h	Print help information
--version	-V	Print version information
--config <FILE>	-c	Path to configuration file
--debug	-d	Run in debug mode (output to stdout)
--daemon	-x	Run in daemon mode (output to log file)
--level <LEVEL>	-l	Log level (error, warn, info, debug, trace)

Mode Selection

Option	Short	Description
--mode <MODE>	-m	Operating mode: command, tail, api, or both

Mode Details

Mode	Description
command	Execute commands periodically, includes API server
tail	Monitor log file in real-time
api	API server only
both	Combined command and tail modes

Command Mode Options

Option	Short	Description	Default
--execute <CMD>	-e	Command to execute	Required
--interval <SEC>	-i	Execution interval in seconds	300
--no-api		Disable integrated API server	API enabled

Examples

# Basic command mode
license_monitor --mode command --execute "lmstat -a" --interval 300

# Command mode without API
license_monitor --mode command --execute "lmstat -a" --no-api

# With custom interval
license_monitor --mode command --execute "lmstat -a" --interval 60

Tail Mode Options

Option	Short	Description	Default
--file <PATH>	-f	Log file to monitor	Required
--regex <PATTERN>	-r	Regex pattern for parsing	None
--batch-size <N>	-b	Batch processing size	10

Examples

# Basic tail mode
license_monitor --mode tail --file /var/log/lmstat.log

# With regex parsing
license_monitor --mode tail \
    --file /var/log/lmstat.log \
    --regex "^(\d{4}-\d{2}-\d{2})"

# With batch processing
license_monitor --mode tail \
    --file /var/log/lmstat.log \
    --batch-size 50

API Server Options

Option	Description	Default
--api-host <HOST>	API server bind address	127.0.0.1
--api-port <PORT>	API server bind port	8080
--no-api	Disable API server	API enabled

Examples

# API mode only
license_monitor --mode api --api-host 0.0.0.0 --api-port 8080

# Custom port
license_monitor --mode command --execute "lmstat -a" --api-port 9090

Caution

When binding to 0.0.0.0, set ALLOW_PUBLIC_BIND=true or configure allow_public_bind = true in the config file. This is a safety measure to prevent accidental exposure.

Self-Update Options

Option	Description
--self-update	Run the self-update process
--check	Check for updates only (exit code 10 if available)
--channel <CHANNEL>	Update channel: stable or beta
--force	Force update even if versions match
--rollback	Revert to previous version
--token <TOKEN>	GitHub token for private repos
--quiet	Suppress progress output
--notes	Print release notes summary

Examples

# Check for updates
license_monitor --self-update --check

# Update to latest stable
license_monitor --self-update

# Update to beta channel
license_monitor --self-update --channel beta

# Force update
license_monitor --self-update --force

# Rollback to previous version
license_monitor --self-update --rollback

# Check with quiet output
license_monitor --self-update --check --quiet
echo $?  # 0 = up to date, 10 = update available

Logging Options

Option	Short	Description
--level <LEVEL>	-l	Set log level
--debug	-d	Output to stdout (debug mode)
--daemon	-x	Output to log file (daemon mode)

Log Levels

Level	Description
error	Errors only
warn	Warnings and errors
info	Informational messages
debug	Debug information
trace	Detailed tracing (verbose)

Examples

# Debug mode with verbose logging
license_monitor --debug --level debug

# Daemon mode with info logging
license_monitor --daemon --level info

# Production (warnings only)
license_monitor --daemon --level warn

Configuration Priority

Options are applied in this priority (highest first):

1. Command-line arguments
2. Environment variables
3. Configuration file
4. Default values

Example Priority

# Command line overrides config file
license_monitor \
    --config /etc/license-monitor/config.toml \
    --level debug  # Overrides log_level in config

Exit Codes

Code	Meaning
0	Success
1	General error
2	Configuration error
10	Update available (with —check)
130	Interrupted (Ctrl+C)

Environment Variables

CLI options can also be set via environment variables:

Environment Variable	Equivalent Option
LICENSE_MONITOR_CONFIG	--config
LICENSE_MONITOR_MODE	--mode
LICENSE_MONITOR_LOG_LEVEL	--level
LICENSE_MONITOR_API_HOST	--api-host
LICENSE_MONITOR_API_PORT	--api-port
LICENSE_MONITOR_EXECUTE	--execute
LICENSE_MONITOR_INTERVAL	--interval

Complete Examples

Production Deployment

# systemd service command
/usr/local/bin/license_monitor \
    --config /etc/license-monitor/config.toml \
    --mode command \
    --execute "lmstat -a -c 27000@license-server" \
    --interval 300 \
    --daemon \
    --level warn

Development Testing

# Quick test with debug output
/usr/local/bin/license_monitor \
    --mode api \
    --api-host 127.0.0.1 \
    --api-port 8080 \
    --debug \
    --level debug

Combined Mode

# Command + Tail with API
/usr/local/bin/license_monitor \
    --config /etc/license-monitor/config.toml \
    --mode both \
    --execute "lmstat -a" \
    --file /var/log/flexlm/lmstat.log \
    --daemon

Next Steps

• Configuration Reference - TOML configuration
• Environment Variables - All environment variables