grub-btrfsd: Add flag for colorless output

Signed-off-by: Pascal Jäger <[email protected]>

README.md

@@ -95,6 +95,21 @@ On most distributions and installs, the grub installation resides in `/boot/grub
 Grub-btrfs comes with a daemon script that automatically updates the grub menu when it sees a snapshot being created or deleted in a directory it is given via command line.
 
 The daemon can be configured by passing different command line arguments to it. 
+The arguments are:
+* `SNAPSHOTS_DIR`
+This argument specifies the path where grub-btrfsd looks for newly created snapshots and snapshot deletions. It is usually defined by the program used to make snapshots.
+E.g. for Snapper this would be `/.snapshots`
+* `-c / --no-color`
+Disable colors in output.
+* `-l / --log-file`
+This arguments specifies a file where grub-btrfsd should write log messages.
+* `-s / --syslog`
+* `-t / --timeshift-auto`
+This is a flag to activate the auto detection of the path where Timeshift stores snapshots. Newer versions (>=22.06) of Timeshift mount their snapshots to `/run/timeshift/$PID/backup/timeshift-btrfs`. Where `$PID` is the process ID of the currently running Timeshift session. The PID is changing every time Timeshift is opened. grub-btrfsd can automatically take care of the detection of the correct PID and directory if this flag is set. In this case the argument `SNAPSHOTS_DIR` has no effect.
+* `-v / --verbose`
+Let the log of the daemon be more verbose
+* `-h / --help`
+Displays a short help message.
 
 ##### Systemd instructions
 To edit the arguments that are passed to the daemon, use 

config

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-GRUB_BTRFS_VERSION=4.11-20221123
+GRUB_BTRFS_VERSION=4.11-20221123-1
 
 # Disable grub-btrfs.
 # Default: "false"

grub-btrfsd

@@ -12,11 +12,21 @@ timeshift_auto=false
 verbose=false
 syslog=false
 
-# helper functions
-GREEN=$'\033[0;32m'
-RED=$'\033[0;31m'
-CYAN=$'\033[;36m'
-RESET=$'\033[0m'
+setcolors() {
+    if [ "${1}" = true ]; then
+          GREEN=$'\033[0;32m'
+          RED=$'\033[0;31m'
+          CYAN=$'\033[;36m'
+          RESET=$'\033[0m'
+    fi
+    if [ "${1}" = false ]; then
+        GREEN=$'\033[0;0m'
+        RED=$'\033[0;0m'
+        CYAN=$'\033[;0m'
+        RESET=$'\033[0m'
+    fi
+}
+setcolors true # normally we want colors
 
 sysconfdir="/etc"
 grub_btrfs_config="${sysconfdir}/default/grub-btrfs/config"
@@ -26,15 +36,16 @@ grub_btrfs_config="${sysconfdir}/default/grub-btrfs/config"
 
 print_help() {
             echo "${CYAN}[?] Usage:"
-            echo "${0##*/} [-h, --help] [-t, --timeshift-auto] [-l, --log-file LOG_FILE] [-v, --verbose] [-s, --syslog] SNAPSHOTS_DIR"
+            echo "${0##*/} [-h, --help] [-c, --no-color] [-l, --log-file LOG_FILE] [-s, --syslog] [-t, --timeshift-auto] [-v, --verbose] SNAPSHOTS_DIR"
             echo
             echo "SNAPSHOTS_DIR         Snapshot directory to watch, without effect when --timeshift-auto"
             echo
             echo "Optional arguments:"
-            echo "-t, --timeshift-auto  Automatically detect Timeshifts snapshot directory"
+            echo "-c, --no-color        Disable colors in output"
             echo "-l, --log-file        Specify a logfile to write to"
-            echo "-v, --verbose         Let the log of the daemon be more verbose"
             echo "-s, --syslog          Write to syslog"
+            echo "-t, --timeshift-auto  Automatically detect Timeshifts snapshot directory"
+            echo "-v, --verbose         Let the log of the daemon be more verbose"
             echo "-h, --help            Display this message"
             echo
             echo "Version ${GRUB_BTRFS_VERSION}${RESET}"
@@ -73,10 +84,13 @@ err() {
 }
 
 # parse arguments
-while getopts :l:tvsh-: opt; do
+while getopts :l:ctvsh-: opt; do
     case "$opt" in
         -)
             case "${OPTARG}" in
+                no-color)
+                    setcolors false
+                    ;;
                 log-file)
                     logfile="${!OPTIND}"; OPTIND=$(( $OPTIND + 1 ))
                     ;;
@@ -102,6 +116,9 @@ while getopts :l:tvsh-: opt; do
                     exit 1
                     ;;
             esac;;
+        c)
+            setcolors false
+            ;;
         l)
             logfile="${OPTARG}"
             ;;

manpages/grub-btrfsd.8.man

@@ -9,38 +9,44 @@ when a new btrfs snapshot is created.
 
 .SH "SYNOPSIS"
 .PP
-\fCgrub\-btrfsd [\-h, \-\-help] [\-t, \-\-timeshift\-auto] [\-l, \-\-log\-file LOG_FILE] [\-v, \-\-verbose] [\-s, \-\-syslog] SNAPSHOTS_DIR\fP
+\fCgrub\-btrfsd [\-h, \-\-help] [\-c, \-\-no\-color] [\-l, \-\-log\-file LOG_FILE] [\-s, \-\-syslog] [\-t, \-\-timeshift\-auto] [\-v, \-\-verbose] SNAPSHOTS_DIR\fP
 
 .SH "DESCRIPTION"
 .PP
-Grub-btrfs-openrc is a shell script which is meant to be run as a daemon.
-Grub-btrfsd watches a directory where snapshots are created or deleted via inotifywait and runs grub-mkconfig (if grub-mkconfig never ran before since grub-btrfs was installed) or \fC/etc/grub.d/41_snapshots\-btrfs\fP (when grub-mkconfig ran before with grub-btrfs installed) when something in that directory changes.
+Grub-btrfsd is a shell script which is meant to be run as a daemon.
+Grub-btrfsd watches a directory where btrfs-snapshots are created or deleted via inotifywait and runs grub-mkconfig (if grub-mkconfig never ran before since grub-btrfs was installed) or \fC/etc/grub.d/41_snapshots\-btrfs\fP (when grub-mkconfig ran before with grub-btrfs installed) when something in that directory changes.
 
 .SH "OPTIONS"
 .SS "\fCSNAPSHOTS_DIR\fP"
 .PP
 This argument specifies the path where grub-btrfsd looks for newly created snapshots and snapshot deletions. It is usually defined by the program used to make snapshots.
 E.g. for Snapper this would be \fC/.snapshots\fP
 
-.SS "\fC\-t / \-\-timeshift\-auto\fP"
+.SS "\fC\-c / \-\-no\-color\fP"
 .PP
-This is a flag to activate the auto detection of the path where Timeshift stores snapshots. Newer versions (>=22.06) of Timeshift mount their snapshots to \fC/run/timeshift/$PID/backup/timeshift\-btrfs\fP. Where \fC$PID\fP is the process ID of the currently running Timeshift session. The PID is changing every time Timeshift is opened. grub-btrfsd can automatically take care of the detection of the correct PID and directory if this flag is set. In this case the argument \fCSNAPSHOTS_DIR\fP has no effect.
+Disable colors in output.
 
 .SS "\fC\-l / \-\-log\-file\fP"
 .PP
 This arguments specifies a file where grub-btrfsd should write log messages.
 
-.SS "\fC\-h / \-\-help\fP"
+.SS "\fC\-s / \-\-syslog\fP"
 .PP
-Displays a short help message.
+Write to syslog
+
+.SS "\fC\-t / \-\-timeshift\-auto\fP"
+.PP
+This is a flag to activate the auto detection of the path where Timeshift stores snapshots. Newer versions (>=22.06) of Timeshift mount their snapshots to \fC/run/timeshift/$PID/backup/timeshift\-btrfs\fP. Where \fC$PID\fP is the process ID of the currently running Timeshift session. The PID is changing every time Timeshift is opened. grub-btrfsd can automatically take care of the detection of the correct PID and directory if this flag is set. In this case the argument \fCSNAPSHOTS_DIR\fP has no effect.
 
 .SS "\fC\-v / \-\-verbose\fP"
 .PP
 Let the log of the daemon be more verbose
 
-.SS "\fC\-s / \-\-syslog\fP"
+.SS "\fC\-h / \-\-help\fP"
 .PP
-Write to syslog
+Displays a short help message.
+
+
 
 .SH "CONFIGURATION"
 .PP

manpages/grub-btrfsd.8.org

@@ -10,31 +10,36 @@ grub-btrfsd - An OpenRC daemon to automatically update the grub menu with
 when a new btrfs snapshot is created.
 
 * SYNOPSIS
-~grub-btrfsd [-h, --help] [-t, --timeshift-auto] [-l, --log-file LOG_FILE] [-v, --verbose] [-s, --syslog] SNAPSHOTS_DIR~
+~grub-btrfsd [-h, --help] [-c, --no-color] [-l, --log-file LOG_FILE] [-s, --syslog] [-t, --timeshift-auto] [-v, --verbose] SNAPSHOTS_DIR~
 
 * DESCRIPTION
-Grub-btrfs-openrc is a shell script which is meant to be run as a daemon.
-Grub-btrfsd watches a directory where snapshots are created or deleted via inotifywait and runs grub-mkconfig (if grub-mkconfig never ran before since grub-btrfs was installed) or ~/etc/grub.d/41_snapshots-btrfs~ (when grub-mkconfig ran before with grub-btrfs installed) when something in that directory changes.
+Grub-btrfsd is a shell script which is meant to be run as a daemon.
+Grub-btrfsd watches a directory where btrfs-snapshots are created or deleted via inotifywait and runs grub-mkconfig (if grub-mkconfig never ran before since grub-btrfs was installed) or ~/etc/grub.d/41_snapshots-btrfs~ (when grub-mkconfig ran before with grub-btrfs installed) when something in that directory changes.
 
 * OPTIONS
 ** ~SNAPSHOTS_DIR~
 This argument specifies the path where grub-btrfsd looks for newly created snapshots and snapshot deletions. It is usually defined by the program used to make snapshots.
 E.g. for Snapper this would be ~/.snapshots~
 
-** ~-t / --timeshift-auto~
-This is a flag to activate the auto detection of the path where Timeshift stores snapshots. Newer versions (>=22.06) of Timeshift mount their snapshots to ~/run/timeshift/$PID/backup/timeshift-btrfs~. Where ~$PID~ is the process ID of the currently running Timeshift session. The PID is changing every time Timeshift is opened. grub-btrfsd can automatically take care of the detection of the correct PID and directory if this flag is set. In this case the argument ~SNAPSHOTS_DIR~ has no effect.
+** ~-c / --no-color~
+Disable colors in output.
 
 ** ~-l / --log-file~
 This arguments specifies a file where grub-btrfsd should write log messages.
 
-** ~-h / --help~
-Displays a short help message.
+** ~-s / --syslog~
+Write to syslog
+
+** ~-t / --timeshift-auto~
+This is a flag to activate the auto detection of the path where Timeshift stores snapshots. Newer versions (>=22.06) of Timeshift mount their snapshots to ~/run/timeshift/$PID/backup/timeshift-btrfs~. Where ~$PID~ is the process ID of the currently running Timeshift session. The PID is changing every time Timeshift is opened. grub-btrfsd can automatically take care of the detection of the correct PID and directory if this flag is set. In this case the argument ~SNAPSHOTS_DIR~ has no effect.
 
 ** ~-v / --verbose~
 Let the log of the daemon be more verbose
 
-** ~-s / --syslog~
-Write to syslog
+** ~-h / --help~
+Displays a short help message.
+
+
 
 * CONFIGURATION
 The daemon is usually configured via the file ~/etc/conf.d/grub-btrfsd~ on openrc-init systems and ~sudo systemctl edit --full grub-btrfsd~ on systemd systems. In this file the arguments (See OPTIONS), that OpenRC passes to the daemon when it is started, can be configured.