huge longrun improvements

profile.d/processes.sh

@@ -36,18 +36,38 @@
 
 # ------------------------------------------------------------------------------
 # Search processes matching the given string
-# ------------------------------------------------------------------------------
+# Usage: ppg <string>
 ppg()
 {
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "ppg: Search processes matching the given string.\n\n"
+        printf "Usage: ppg <string>\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
+    if [[ -z "$1" ]]; then
+        disp E "Usage: ppg <string>"
+        return 1
+    fi
     ps -edf | grep "$@" | grep -v "grep $@"
 }
 export -f ppg
+# ------------------------------------------------------------------------------
+
 
 # ------------------------------------------------------------------------------
 # List processes owned by a specific user
-# ------------------------------------------------------------------------------
+# Usage: ppu <username>
 ppu()
 {
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "ppu: List processes owned by a specific user.\n\n"
+        printf "Usage: ppu <username>\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
     if [[ -z "$1" ]]; then
         disp E "Usage: ppu <username>"
         return 1
@@ -58,12 +78,21 @@ ppu()
     ps -u "$1" -o pid,user,%cpu,%mem,start,time,command
 }
 export -f ppu
+# ------------------------------------------------------------------------------
+
 
 # ------------------------------------------------------------------------------
 # List processes by exact command name (no path/parameters)
-# ------------------------------------------------------------------------------
+# Usage: ppn <command_name>
 ppn()
 {
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "ppn: List processes by exact command name (no path/parameters).\n\n"
+        printf "Usage: ppn <command_name>\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
     if [[ -z "$1" ]]; then
         disp E "Usage: ppn <command_name>"
         return 1
@@ -75,12 +104,25 @@ ppn()
     ps -eo pid,comm | grep -w "$1"
 }
 export -f ppn
+# ------------------------------------------------------------------------------
+
 
 # ------------------------------------------------------------------------------
 # Get PID list of the given process name
-# ------------------------------------------------------------------------------
+# Usage: ppid <process_name [process_name2 ...]>
 gpid()
 {
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "gpid: Get PID list of the given process name.\n\n"
+        printf "Usage: gpid <process_name [process_name2 ...]>\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
+    if [[ -z "$1" ]]; then
+        disp E "Usage: gpid <process_name [process_name2 ...]>"
+        return 1
+    fi
     [[ $UID -eq 0 ]] && local psopt="-A"
     [[ $# -eq 1 ]] && local single=1
     for pid in $@; do
@@ -94,34 +136,65 @@ gpid()
     [[ $result ]] || return 1
 }
 export -f gpid
+# ------------------------------------------------------------------------------
+
 
 # ------------------------------------------------------------------------------
 # Kill all processes owned by the given users (kill user)
-# ------------------------------------------------------------------------------
+# Usage: ku <username1 [username2 ...]>
 ku()
 {
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "ku: Kill all processes owned by the given users.\n\n"
+        printf "Usage: ku <username1 [username2 ...]>\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
+    if [[ -z "$1" ]]; then
+        disp E "Usage: ku <username1 [username2 ...]>"
+        return 1
+    fi
     for u in $@; do
         killall -u "$u"
     done
 }
 export -f ku
+# ------------------------------------------------------------------------------
+
 
 # ------------------------------------------------------------------------------
 # Kill all children of a process then the process (kill tree)
-# ------------------------------------------------------------------------------
+# Usage: kt <pid> [kill_options]
 kt()
 {
-    [[ -z $1 ]] && echo -e "Usage:\n\tkt <pid> [kill_options]"
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "kt: Kill all children of a process then the process (kill tree).\n\n"
+        printf "Usage: kt <pid> [kill_options]\n\n"
+        printf "Options:\n"
+        printf "\t-h, --help\t\tDisplay this help screen\n"
+        return 0
+    fi
+    if [[ -z "$1" ]]; then
+        disp E "Usage: ppg <string>"
+        return 1
+    fi
 
     local parent_pid="$1"
     shift
+    if [[ "$parent_pid" == "0" || "$parent_pid" == "1" ]]; then
+        disp E "Safety abort: Refusing to kill PID $parent_pid (system critical)."
+        return 1
+    fi
+
     children_pids=$(pgrep -P "$parent_pid")
 
     for pid in $children_pids; do
-        kt "$pid" "$@"
+        kt "$pid" "$@" || break
     done
     kill "$@" "$parent_pid"
 }
-
 # ------------------------------------------------------------------------------
+
+
 # EOF