feature: Initial commit

This commit is contained in:
Keith Solomon
2025-10-19 14:28:54 -05:00
commit 8bc8e0125d
4 changed files with 257 additions and 0 deletions

8
.vscode/settings.json vendored Normal file
View File

@@ -0,0 +1,8 @@
{
"workbench.colorCustomizations": {
"tree.indentGuidesStroke": "#3d92ec",
"activityBar.background": "#5C0A2F",
"titleBar.activeBackground": "#800E42",
"titleBar.activeForeground": "#FFFCFD"
}
}

8
cifs-watch.service.sh Normal file
View File

@@ -0,0 +1,8 @@
# /etc/systemd/system/cifs-watch.service
[Unit]
Description=Monitor and repair CIFS mounts
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/cifs-watch
Nice=10

229
cifs-watch.sh Normal file
View File

@@ -0,0 +1,229 @@
#!/usr/bin/env bash
# Monitor CIFS mounts from /etc/fstab and (re)mount if needed.
# Designed for cron/systemd timer. Requires root.
set -Eeuo pipefail
IFS=$'\n\t'
# ---------------------------
# Config (edit if desired)
# ---------------------------
LOGFILE="/var/log/cifs-remount.log" # Set empty ("") to disable file logging.
PING_COUNT=1
PING_TIMEOUT=1 # seconds
TCP_TIMEOUT=2 # seconds for port 445 check
PROBE_TIMEOUT=2 # seconds to test mount health (listing)
REMOUNT_RETRY=2 # attempts
SLEEP_BETWEEN=1 # seconds between retries
SYSLOG_TAG="cifs-watch"
DRY_RUN=0
VERBOSE=0
# ---------------------------
# Helpers
# ---------------------------
log() {
local level="$1"; shift
local msg="$*"
local ts
ts="$(date '+%Y-%m-%d %H:%M:%S')"
if [[ "$VERBOSE" -eq 1 || "$level" != "DEBUG" ]]; then
echo "[$ts] [$level] $msg"
fi
logger -t "$SYSLOG_TAG[$$]" -p "user.$(tr '[:upper:]' '[:lower:]' <<<"$level")" -- "$msg" || true
if [[ -n "$LOGFILE" ]]; then
( umask 0077; echo "[$ts] [$level] $msg" >> "$LOGFILE" ) || true
fi
}
vdbg() { [[ "$VERBOSE" -eq 1 ]] && log "DEBUG" "$*"; }
fail() { log "ERROR" "$*"; exit 1; }
have_cmd() { command -v "$1" >/dev/null 2>&1; }
tcp_open_445() {
local host="$1"
if have_cmd nc; then
nc -z -w "$TCP_TIMEOUT" "$host" 445 >/dev/null 2>&1
return $?
else
timeout "$TCP_TIMEOUT" bash -c "cat < /dev/null > /dev/tcp/$host/445" 2>/dev/null
return $?
fi
}
host_reachable() {
local host="$1"
if ! getent ahosts "$host" >/dev/null 2>&1; then
vdbg "DNS resolution failed for $host"
return 1
fi
if have_cmd ping; then
ping -c "$PING_COUNT" -W "$PING_TIMEOUT" "$host" >/dev/null 2>&1 || vdbg "Ping to $host failed"
fi
if tcp_open_445 "$host"; then
return 0
else
vdbg "TCP/445 closed on $host"
return 1
fi
}
is_cifs_mounted() {
local mnt="$1"
if findmnt -no FSTYPE -T "$mnt" 2>/dev/null | grep -qi '^cifs$'; then
return 0
fi
return 1
}
mount_healthy() {
local mnt="$1"
timeout "$PROBE_TIMEOUT" bash -c 'ls -1A -- "$0" >/dev/null 2>&1' "$mnt"
}
repair_mount() {
local mnt="$1"
local attempt=1
while (( attempt <= REMOUNT_RETRY )); do
vdbg "Attempt $attempt: remounting $mnt"
if (( DRY_RUN )); then
log "INFO" "DRY-RUN: would remount $mnt"
return 0
fi
if mount -o remount "$mnt" >/dev/null 2>&1; then
if mount_healthy "$mnt"; then
log "INFO" "Remounted healthy: $mnt"
return 0
fi
vdbg "Remount completed but health probe failed: $mnt"
fi
sleep "$SLEEP_BETWEEN"
(( attempt++ ))
done
log "WARN" "Remount failed/unhealthy for $mnt; trying forced unmount + clean mount"
if (( DRY_RUN )); then
log "INFO" "DRY-RUN: would umount -f $mnt && mount $mnt"
return 0
fi
if umount -f "$mnt" >/dev/null 2>&1 || umount -l "$mnt" >/dev/null 2>&1; then
:
else
log "WARN" "Unable to unmount $mnt; will still attempt a mount"
fi
if mount "$mnt" >/dev/null 2>&1; then
if mount_healthy "$mnt"; then
log "INFO" "Mounted healthy: $mnt"
return 0
else
log "WARN" "Mounted but health probe failed: $mnt"
return 1
fi
else
log "ERROR" "Mount failed for $mnt"
return 1
fi
}
usage() {
cat <<'USAGE'
cifs-watch.sh [-n|--dry-run] [-v|--verbose] [--logfile PATH]
Monitors CIFS entries in /etc/fstab, checks server reachability, and (re)mounts as needed.
- Processes uncommented lines with type "cifs".
- Accepts fstab lines with 46 fields.
- Skips entries containing "noauto".
Options:
-n, --dry-run Show actions without changing anything
-v, --verbose More detailed output
--logfile P Override logfile path (empty to disable file logging)
USAGE
}
# ---------------------------
# Parse args
# ---------------------------
while [[ $# -gt 0 ]]; do
case "$1" in
-n|--dry-run) DRY_RUN=1; shift ;;
-v|--verbose) VERBOSE=1; shift ;;
--logfile) LOGFILE="${2:-}"; shift 2 ;;
-h|--help) usage; exit 0 ;;
*) echo "Unknown arg: $1"; usage; exit 2 ;;
esac
done
# Ensure tools present
for bin in findmnt mount umount awk grep sed timeout; do
have_cmd "$bin" || fail "Required command not found: $bin"
done
# ---------------------------
# Main: parse /etc/fstab
# ---------------------------
mapfile -t CIFS_LINES < <(awk '
$0 !~ /^[[:space:]]*#/ && NF>=4 && tolower($3)=="cifs" { print }
' /etc/fstab)
if [[ ${#CIFS_LINES[@]} -eq 0 ]]; then
log "INFO" "No CIFS entries found in /etc/fstab. Nothing to do."
exit 0
fi
overall_rc=0
for line in "${CIFS_LINES[@]}"; do
# fields: fs_spec mountpoint fstype options [dump] [pass]
fs_spec=$(awk '{print $1}' <<<"$line")
mnt_point=$(awk '{print $2}' <<<"$line")
fstype=$(awk '{print tolower($3)}' <<<"$line")
options=$(awk '{print $4}' <<<"$line")
dumpv=$(awk 'NF>=5{print $5}' <<<"$line")
passv=$(awk 'NF>=6{print $6}' <<<"$line")
# Skip noauto entries
if grep -qi '(^|,)noauto(,|$)' <<<",$options,"; then
vdbg "Skipping noauto CIFS entry: $mnt_point ($fs_spec)"
continue
fi
# Parse server from //server/share
if [[ "$fs_spec" =~ ^//([^/]+)/.+$ ]]; then
server="${BASH_REMATCH[1]}"
else
log "WARN" "Could not parse server from fs_spec: $fs_spec (skipping)"
continue
fi
log "INFO" "Checking CIFS mount: $mnt_point (server: $server)"
if is_cifs_mounted "$mnt_point"; then
if mount_healthy "$mnt_point"; then
vdbg "Healthy: $mnt_point"
continue
else
log "WARN" "Mounted but unhealthy: $mnt_point"
fi
else
log "WARN" "Not mounted: $mnt_point"
fi
if host_reachable "$server"; then
log "INFO" "Server reachable: $server — attempting repair for $mnt_point"
else
log "ERROR" "Server NOT reachable: $server — skipping $mnt_point for now"
overall_rc=1
continue
fi
if ! repair_mount "$mnt_point"; then
log "ERROR" "Repair failed: $mnt_point"
overall_rc=1
fi
done
exit "$overall_rc"

12
cifs-watch.timer.txt Normal file
View File

@@ -0,0 +1,12 @@
# /etc/systemd/system/cifs-watch.timer
[Unit]
Description=Run cifs-watch periodically
[Timer]
OnBootSec=2min
OnUnitActiveSec=5min
AccuracySec=30s
Unit=cifs-watch.service
[Install]
WantedBy=timers.target