From e9f567a0333e9edd5eba8fa00d96cb0912694443 Mon Sep 17 00:00:00 2001
From: cuqmbr <me@cuqmbr.xyz>
Date: Thu, 14 Nov 2024 17:53:38 +0200
Subject: [PATCH] initial commit

---
 README           |  1 +
 check            |  5 +++++
 conf             |  2 ++
 env/ENV_VAR_NAME |  1 +
 finish           | 10 ++++++++++
 log/conf         |  2 ++
 log/config       |  2 ++
 log/run          | 13 +++++++++++++
 run              | 24 ++++++++++++++++++++++++
 9 files changed, 60 insertions(+)
 create mode 100644 README
 create mode 100755 check
 create mode 100644 conf
 create mode 100644 env/ENV_VAR_NAME
 create mode 100755 finish
 create mode 100644 log/conf
 create mode 100644 log/config
 create mode 100755 log/run
 create mode 100755 run

diff --git a/README b/README
new file mode 100644
index 0000000..7314f74
--- /dev/null
+++ b/README
@@ -0,0 +1 @@
+See https://smarden.org/runit/ and `man 8 runit` for more extensive documentation
diff --git a/check b/check
new file mode 100755
index 0000000..587fba7
--- /dev/null
+++ b/check
@@ -0,0 +1,5 @@
+#!/bin/sh
+
+# Logic to check if the service is running correctly
+# Executed when sv check is issued
+# Reposrts success when exit code is 0
diff --git a/conf b/conf
new file mode 100644
index 0000000..1658a78
--- /dev/null
+++ b/conf
@@ -0,0 +1,2 @@
+OPTS=""
+VAR_NAME="VAR_VALUE"
diff --git a/env/ENV_VAR_NAME b/env/ENV_VAR_NAME
new file mode 100644
index 0000000..19a2ac9
--- /dev/null
+++ b/env/ENV_VAR_NAME
@@ -0,0 +1 @@
+env_var_value
diff --git a/finish b/finish
new file mode 100755
index 0000000..4187b59
--- /dev/null
+++ b/finish
@@ -0,0 +1,10 @@
+#!/bin/sh
+
+# Execution finish point
+# Executes on service shutdown
+
+exec 2>&1; set -e
+
+[ -r conf ] && . ./conf
+
+exec /path/to/executable $OPTS
diff --git a/log/conf b/log/conf
new file mode 100644
index 0000000..7fe0b7a
--- /dev/null
+++ b/log/conf
@@ -0,0 +1,2 @@
+LOGDIR="/home/cuqmbr/.local/runit/logs/template"
+OPTS="-tt"
diff --git a/log/config b/log/config
new file mode 100644
index 0000000..2cb1fc8
--- /dev/null
+++ b/log/config
@@ -0,0 +1,2 @@
+svlogd configuration file
+see 'man svlogd(1)' for details
diff --git a/log/run b/log/run
new file mode 100755
index 0000000..67cf0c4
--- /dev/null
+++ b/log/run
@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# Same as run in service directory except for the loggin
+# See 'man svlogd(1)' for more info
+
+exec 2>&1; set -e
+
+[ -r conf ] && . ./conf
+
+# If the directory doesn't exist create it with specified mod bits
+[ -d "$LOGDIR" ] || /usr/bin/install -dm 755 "$LOGDIR" 
+
+exec /usr/bin/svlogd $OPTS "$LOGDIR" 
diff --git a/run b/run
new file mode 100755
index 0000000..5cf39f6
--- /dev/null
+++ b/run
@@ -0,0 +1,24 @@
+#!/bin/sh
+
+# Execution starting point
+# This file must run the process in the foreground
+
+# Redirect stderr to stdout
+# Set strict mode. See 'set --help' for more info
+exec 2>&1; set -e
+
+# Source variables from ./conf
+[ -r conf ] && . ./conf
+
+exec /path/to/executable $OPTS
+
+# Use instead of statement above if you need to use environment variables
+#exec chpst -e env /path/to/executable $OPTS
+
+# Use if you need service supervision but the programm doesnt execute much work (exit shortly after start)
+# This way the service will have 'running' status and you will be able to stop which will execute finish file
+# NOTE: argument is not supported with this method
+#exec chpst -b /path/to/executable pause
+
+# Same as above but with arguments support
+#exec sh -c "/path/to/executable arguments; pause"