salomon.sh

#!/usr/bin/env bash

#
# Salomon - Simple log file monitor and analyzer
# Main script
# Copyright (c) 2025 by Ralf Kilian
# Distributed under the MIT License (https://opensource.org/licenses/MIT)
#
# GitHub: https://github.com/urbanware-org/salomon
# GitLab: https://gitlab.com/urbanware-org/salomon
#

script_dir=$(dirname $(readlink -f $0))
. ${script_dir}/core/shell.sh   # Use POSIX standard instead of 'source' here
shell_precheck

source ${script_dir}/core/compat.sh
compatibility_precheck
script_file=$(basename "$0")

source ${script_dir}/core/analyze.sh
source ${script_dir}/core/colors.sh
source ${script_dir}/core/common.sh
source ${script_dir}/core/dialogs.sh
source ${script_dir}/core/global.sh
source ${script_dir}/core/interactive.sh
source ${script_dir}/core/monitor.sh
source ${script_dir}/core/output.sh

read_config_file; check_config
set_global_variables
set_line_characters
get_dialog_program

# Script files stored inside the 'debug' sub-directory (if existing) will be
# loaded after the included ones listed above. This allows to overwrite
# existing functions from scripts inside the 'core' sub-directory without
# manipulating them
if [ -d "${script_dir}/debug" ]; then
    ls "${script_dir}/debug" | grep "\.sh$" &>/dev/null
    if [ $? -eq 0 ]; then
        if [[ ! $* == *"--debug"* ]]; then
            debug_notification
        fi
        source ${script_dir}/debug/*.sh &>/dev/null
    fi
fi

# Check command-line arguments
if [ $# -eq 0 ]; then
    usage "At least one required argument is missing"
else
    while [ $# -gt 0 ]; do
        arg="$1"
        case "$arg" in
            # Required arguments
            -a|--action)
                if [ -n "$action" ]; then
                    usage "The action argument can only be given once"
                fi
                shift
                action="$1"
                shift
            ;;
            -i|--input-file)
                shift
                prepare_path "$1"
                input_file="$input_file $path_prepared"
                check_argument "-i/--input-file" "$input_file" "file"
                shift
            ;;

            # Optional arguments
            -c|--color-file)
                if [ -n "$color_file" ]; then
                    usage "The color file argument can only be given once"
                fi
                shift
                color_file="$1"
                check_argument "-c/--color-file" "$color_file" "file"
                shift
            ;;
            --cut-off)
                highlight_cut_off=1
                shift
            ;;
            -d|--delay)
                shift
                delay="$1"
                shift
            ;;
            --dialogs)
                interactive=1
                shift
            ;;
            -e|--exclude)
                if [ -n "$exclude_pattern" ]; then
                    usage "The exclude argument can only be given once" \
                          "Use a pattern instead"
                fi
                shift
                exclude_pattern="$1"
                shift
            ;;
            --export-file)
                if [ -n "$export_file" ]; then
                    usage "The export argument can only be given once"
                fi
                shift
                export_file="$1"
                export_log=1
                shift
            ;;
            -f|--filter)
                if [ -n "$filter_pattern" ]; then
                    usage "The filter argument can only be given once" \
                          "Use a pattern instead"
                fi
                shift
                filter_pattern="$1"
                shift
            ;;
            --force-dark)
                if [ -n "$color_force" ]; then
                    usage "The force dark argument can only be given once"
                fi
                color_force="dark"
                shift
            ;;
            --force-light)
                if [ -n "$color_force" ]; then
                    usage "The force light argument can only be given once"
                fi
                color_force="light"
                shift
            ;;
            -h|--head)
                shift
                head_lines="$1"
                shift
            ;;
            -ha|--highlight-all)
                highlight_all=1
                shift
            ;;
            -hm|--highlight-matches)
                if [ $is_openbsd -eq 1 ]; then
                    highlight_upper=1
                else
                    highlight_matches=1
                fi
                shift
            ;;
            -hu|--highlight-upper)
                highlight_upper=1
                shift
            ;;
            -ic|--ignore-case)
                arg_case="-i"
                shift
            ;;
            --interactive)
                interactive=1
                shift
            ;;
            --less)
                analyze_less=1
                shift
            ;;
            -m|--merge)
                merge=1
                shift
            ;;
            -mi|--merge-interleaved)
                merge_append=0
                shift
            ;;
            --no-info)
                header=0
                shift
            ;;
            -p|--prompt)
                prompt=1
                shift
            ;;
            --pause)
                shift
                pause_lines="$1"
                pause=1
                shift
            ;;
            -r|--remove)
                if [ -n "$remove_pattern" ]; then
                    usage "The remove argument can only be given once" \
                          "Use a pattern instead"
                fi
                shift
                remove_pattern="$1"
                shift
            ;;
            -s|--slow)
                slow=1
                shift
            ;;
            -t|--tail)
                shift
                tail_lines="$1"
                shift
            ;;
            --timestamp)
                timestamp=1
                shift
            ;;
            -w|--wait)
                shift
                wait_match="$1"
                shift
            ;;

            # General arguments
            --color-table)
                color_table=1
                shift
            ;;
            --format-list)
                format_list=1
                shift
            ;;
            --version)
                echo "$version"
                exit
            ;;
            --version-update)
                check_update
            ;;
            -\?|--help)
                usage
            ;;

            # Alternatives to the required arguments
            --analyze)
                if [ -n "$action" ]; then
                    usage "An action argument can only be given once"
                fi
                action="analyze"
                shift
            ;;
            --monitor)
                if [ -n "$action" ]; then
                    usage "An action argument can only be given once"
                fi
                action="monitor"
                shift
            ;;

            # Inofficial arguments
            --debug)
                debug=1
                shift
            ;;

            # Unrecognized arguments
            *)
                usage "The given argument '$1' is unrecognized"
            ;;
        esac
    done

    # Print color table (if requested)
    if [ $color_table -eq 1 ]; then
        print_color_table
        exit
    fi
    # Print color table (if requested)
    if [ $format_list -eq 1 ]; then
        print_format_list
        exit
    fi

    if [ $interactive -eq 1 ]; then
        if [ -z "$dialog_program" ]; then
            usage "No supported dialog program found"
        fi
        init_dialogs
        interactive_mode
    else
        # Input file
        input_file=$(sed -e "s/^ *//g;s/ *$//g" <<< "$input_file")

        if [ -z "$input_file" ]; then
            usage "No input file(s) given"
        fi

        for item in $input_file; do
            file=$(sed -e "s/^ *//g;s/ *$//g;s/\/\//\ /g" <<< $item)
            if [ -e "$file" ]; then
                filepath="$file"
            elif [ -e "/var/log/$file" ]; then
                filepath="/var/log/$file"
            else
                usage "The given input file '$file' does not exist"
            fi

            if [ ! -f "$filepath" ]; then
                usage "The given input file path '$file' is not a file"
            fi

            tail "$filepath" &>/dev/null
            if [ $? -ne 0 ]; then
                usage "No read permission on the given input file '$filepath'"
            fi

            filelist="$filelist $(sed -e "s/\ /\/\//g" <<< "$filepath")"
        done
        input_file="$filelist"

        # Action to perform
        if [ -n "$action" ]; then
            if [ "$action" = "analyze" ]; then
                follow=0
            elif [ "$action" = "monitor" ]; then
                if [ $follow -eq 0 ]; then
                    usage "Multiple action arguments given (only one allowed)"
                fi
            else
                usage "The action '$action' does not exist"
            fi
        else
            usage \
              "No action given (must either be '--analyze' or '--monitor')"
        fi

        # Color file
        if [ -n "$color_file" ]; then
            msg="The given color config file"
            color_file_found=1
            color_file_path="$color_file"
            if [ ! -e "$color_file_path" ]; then
                color_file_path="${user_colors}/${color_file}"
                if [ ! -e "$color_file_path" ]; then
                    color_file_path="${color_dir}/${color_file}"
                    if [ ! -e "$color_file_path" ]; then
                        color_file_found=0
                    fi
                fi
            fi

            if [ $color_file_found -eq 0 ]; then
                usage "$msg path '$color_file' does not exist"
            else
                color_file="$color_file_path"
            fi

            if [ ! -f "$color_file" ]; then
                usage "$msg path '$color_file' is not a file"
            else
                msg="No read permission"
                tail "$color_file" &>/dev/null
                if [ $? -ne 0 ]; then
                    usage "$msg on the given color file '$color_file'"
                else
                    read_color_file "$color_file"
                fi
            fi
        fi

        # Filter pattern
        if [ -z "$filter_pattern" ]; then
            msg="can only be used with"
            if [ "$arg_case" = "-i" ]; then
                usage "The '--ignore-case' argument $msg a filter"
            fi
            if [ $highlight_matches -eq 1 ] || \
               [ $highlight_upper -eq 1 ]; then
                usage "This highlighting argument $msg a filter"
            fi
        else
            msg="The given filter file"
            filter_file_found=1
            filter_file="$filter_pattern"
            filter_file_path="$filter_file"
            if [ ! -e "$filter_file_path" ]; then
                filter_file_path="${user_filters}/${filter_file}"
                if [ ! -e "$filter_file_path" ]; then
                    filter_file_path="${filter_dir}/${filter_file}"
                    if [ ! -e "$filter_file_path" ]; then
                        filter_file_found=0
                    fi
                fi
            fi

            if [ $filter_file_found -eq 1 ]; then
                if [ ! -f "$filter_file_path" ]; then
                    usage "$msg path '$filter_file' is not a file"
                else
                    msg="No read permission"
                    tail "$filter_file_path" &>/dev/null
                    if [ $? -ne 0 ]; then
                        usage "$msg on the given color file '$filter_file'"
                    else
                        filter_file="$filter_file_path"
                        read_filter "$filter_file"
                    fi
                fi
            else
                filter_file=""
                if [[ $filter_pattern == *"§"* ]]; then
                    usage \
                      "The filter pattern must not contain any section signs"
                fi
            fi

            filter_pattern=$((tr -s ";;" ";" | \
                    sed -e "s/^;//" \
                        -e "s/;$//") <<< "$filter_pattern")
            if [ $is_bsd -eq 1 ]; then
                filter_list=$(sed -e "s/^;*//g" \
                                  -e "s/;*$//g" \
                                  -e "s/\ /§/g" \
                                  -e $'s/;/\\\n/g' <<< "$filter_pattern")
            else  # Linux
                filter_list=$(sed -e "s/^;*//g" \
                                  -e "s/;*$//g" \
                                  -e "s/\ /§/g" \
                                  -e "s/;/\n/g" <<< "$filter_pattern")
            fi
            filter_pattern=$(sed -e "s/§/\ /g" <<< "$filter_pattern")
            filter=1
        fi

        # Highlighting
        highlight_params=$((
            highlight_all + highlight_matches + highlight_upper ))

        if [ $highlight_params -gt 1 ]; then
            usage "Multiple highlighting arguments given (only one allowed)"
        fi

        if [ $highlight_all -eq 0 ] && [ $highlight_cut_off -eq 1 ]; then
            msg="can only be used with"
            usage "The '--cut-off' argument $msg '--highlight-all'"
        fi

        if [ "$highlight_forecolor" = "1" ] || \
           [ "$highlight_forecolor" = "black" ]; then
            hl_fgcolor="$cl_bk"
        elif [ "$highlight_forecolor" = "2" ] || \
             [ "$highlight_forecolor" = "white" ]; then
            hl_fgcolor="$cl_wh"
        else
            hl_fgcolor="$cl_n"
        fi

        # Exclude pattern
        if [ -n "$exclude_pattern" ]; then
            if [[ $exclude_pattern == *"§"* ]]; then
                usage "The exclude pattern must not contain any section signs"
            fi
            exclude_list=$((tr -s ";;" ";" | \
                            sed -e "s/^;*//" \
                                -e "s/;*$//" \
                                -e "s/\ /§/g" \
                                -e "s/;/\n/g") <<< "$exclude_pattern")
            exclude=1
        fi

        # Remove pattern
        if [ -n "$remove_pattern" ]; then
            if [[ $remove_pattern == *"§"* ]]; then
                usage "The remove pattern must not contain any section signs"
            fi
            remove_list=$((tr -s ";;" ";" | \
                           sed -e "s/^;*//" \
                               -e "s/;*$//" \
                               -e "s/\ /§/g" \
                               -e "s/;/\n/g") <<< "$remove_pattern")
            remove=1
        fi

        # Head and tail
        input_count=$(wc -w <<< "$input_file")
        if [ -z "$head_lines" ]; then
            head_lines=0
        else
            re='^[0-9]+$'
            if [[ ! $head_lines =~ $re ]]; then
                usage \
                  "The argument '--head' expects a number greater than zero"
            fi
            if [[ ! $tail_lines =~ $re ]]; then
                usage \
                  "The argument '--tail' expects a number greater than zero"
            fi
            if [ $head_lines -gt 0 ] && [ $follow = 1 ]; then
                usage \
                  "The '--head' argument cannot be used with monitoring mode"
            fi
            if [ $head_lines -gt 0 ] && [ $tail_lines -gt 0 ]; then
                usage \
                  "Use either '--head' or '--tail', not both at the same time"
            elif [ $head_lines -gt 0 ] || [ $tail_lines -gt 0 ]; then
                if [ $input_count -gt 1 ]; then
                   msg_args="'--head' or '--tail'"
                   usage \
                       "When using $msg_args only one input file can be given"
                fi
            fi
        fi

        # Merge input files
        if [ $merge -eq 1 ] && [ $merge_append -eq 0 ]; then
            msg_args="'--merge' or '--merge-interleaved'"
            usage "Use either $msg_args, not both at the same time"
        fi

        merge_msg="argument requires at least two input files"
        if [ $merge -eq 1 ] && [ $input_count -lt 2 ]; then
            usage "The '--merge' $merge_msg"
        fi

        if [ $merge_append -eq 0 ] && [ $input_count -lt 2 ]; then
            usage "The '--merge-interleaved' $merge_msg"
        fi

        # Use 'less' command to analyze input files
        if [ $analyze_less -eq 1 ]; then
            less_msg="The '--less' argument cannot be used"
            if [ "$action" = "monitor" ]; then
                usage "$less_msg with monitoring mode"
            elif [ $pause -eq 1 ]; then
                usage "$less_msg together with '--pause'"
            elif [ $prompt -eq 1 ]; then
                usage "$less_msg together with '-p' (or '--prompt')"
            elif [ $slow -eq 1 ]; then
                usage "$less_msg together with '-s' (or '--slow')"
            elif [ ! "$wait_match" = "0" ]; then
                usage "$less_msg together with '-w' (or '--wait')"
            fi
        fi

        # Pause output
        if [ $pause -eq 1 ] && [ $follow -eq 1 ]; then
            usage "The '--pause' argument cannot be used with monitoring mode"
        fi
        if [ -z "$pause_lines" ] && [ $pause -eq 1 ]; then
            expects="expects a number greater than zero or 'auto'"
            usage "The '--pause' argument $expects"
        elif [ "$pause_lines" = "auto" ]; then
            pause=1
        else
            if [ $pause -eq 1 ]; then
                re='^[0-9]+$'
                if [ $pause_lines -lt 1 ] || [[ ! $pause_lines =~ $re ]]; then
                    expects="expects a number greater than zero or 'auto'"
                    usage "The '--pause' argument $expects"
                fi
            fi
        fi

        # Slow down (delay)
        grep -E "^[0-9]*$" <<< "$delay" &>/dev/null
        if [ $? -eq 0 ]; then
            if [ $delay -lt 100 ]; then
                delay=100
            elif [ $delay -gt 900 ]; then
                delay=900
            fi
        else
            usage "The delay must be a number between 100 and 900"
        fi

        # Wait on match
        if [ -z "$wait_match" ]; then
            usage "The wait value must not be empty"
        else
            grep -E "^[0-9]*$" <<< "$wait_match" &>/dev/null
            if [ $? -eq 0 ]; then
                if [ $wait_match -le 0 ]; then
                    wait=0
                fi
            else
                usage "The wait value must be a number greater than zero"
            fi
        fi

        # Export file
        if [ $export_log -eq 1 ]; then
            msg_export="The given export file path '$export_file'"
            if [ -z "$export_file" ]; then
                export_log=0
            else
                if [ -e "$export_file" ]; then
                    if [ -d "$export_file" ]; then
                        usage "$msg_export is not a file"
                    elif [ -f "$export_file" ]; then
                        usage "$msg_export already exists"
                    fi
                fi

                touch $export_file &>/dev/null
                if [ $? -ne 0 ]; then
                    usage "$msg_export seems to be read-only"
                fi
            fi
        fi
    fi

    # Force dark/light text colors
    if [ "$color_force" = "dark" ]; then
        color_lightblue=$cl_db            ; cl_lb=$color_lightblue
        color_lightcyan=$cl_dc            ; cl_lc=$color_lightcyan
        color_lightgray=$cl_dy            ; cl_ly=$color_lightgray
        color_lightgreen=$cl_dg           ; cl_lg=$color_lightgreen
        color_lightpurple=$cl_dp          ; cl_lp=$color_lightpurple
        color_lightred=$cl_dr             ; cl_lr=$color_lightred
        color_white=$cl_bk                ; cl_wh=$color_white
        color_yellow=$cl_br               ; cl_yl=$color_yellow
    elif [ "$color_force" = "light" ]; then
        color_black=$cl_wh                ; cl_bk=$color_black
        color_brown=$cl_yl                ; cl_br=$color_brown
        color_darkblue=$cl_lb             ; cl_db=$color_darkblue
        color_darkcyan=$cl_dc             ; cl_dc=$color_darkcyan
        color_darkgray=$cl_ly             ; cl_dy=$color_darkgray
        color_darkgreen=$cl_lg            ; cl_dg=$color_darkgreen
        color_darkpurple=$cl_lp           ; cl_dp=$color_darkpurple
        color_darkred=$cl_lr              ; cl_dr=$color_darkred
    fi
fi

# Check requirements
check_command grep grep
check_command sed sed
check_command tail coreutils

if [ $warn_suffix -ne 0 ]; then
    notice "Global config file extensions other than '*.cfg' are deprecated"
fi

if [ $header -eq 1 ]; then
    print_output_header
fi

# Finally, process the given input file
if [ $analyze_less -eq 0 ]; then
    trap "cancel_process" 2
fi
if [ $follow -eq 1 ]; then
    monitor_input_file
else
    analyze_input_file
fi