Add run target for running Finit as a stand alone unprivileged process

It could be very useful, during development, to be able to run Finit on a
host system without having to provision a full VM. We have all the building
blocks for easily containerizing Finit - in the test framework - so adding
a "run" target that does the orchestration makes sense.

Signed-off-by: Jacques de Laval <jacques@de-laval.se>

.github/CONTRIBUTING.md

@@ -9,9 +9,9 @@ For email questions/requests/alerts there is always the risk of memory
 exhaustion on the part of the maintainer(s).
 
 If you are unsure of what to do, or how to implement an idea or bugfix,
-open an issue with `"[RFC: Unsure if this is a bug ... ?"`, or use the
+open an issue with `"[RFC: Unsure if this is a bug ... ?"`, or similar,
-GitHub discussions forum, so we can discuss it.  Talking about the code
+so we can discuss it.  Talking about the code first is the best way to
-first is the best way to get started before submitting a pull request.
+get started before submitting a pull request.
 
 Either way, when sending an email, patch, or pull request, start by
 stating the version the change is made against, what it does, and why.
@@ -20,17 +20,18 @@ Please take care to ensure you follow the project coding style and the
 commit message format.  If you follow these recommendations you help
 the maintainer(s) and make it easier for them to include your code.
 
+
 Coding Style
 ------------
 
-> [!TIP]
+> **Tip:** Always submit code that follows the style of surrounding code!
-> Always submit code that follows the style of surrounding code!
 
 First of all, lines are allowed to be longer than 72 characters these
 days.  In fact, there exist no enforced maximum, but keeping it around
 100 chars is OK.
 
-The coding style itself is strictly [Linux coding style][KNF].
+The coding style itself is strictly Linux [KNF][].
+
 
 Commit Messages
 ---------------
@@ -39,38 +40,31 @@ Commit messages exist to track *why* a change was made.  Try to be as
 clear and concise as possible in your commit messages, and always, be
 proud of your work and set up a proper GIT identity for your commits:
 
-```bash
+    git config --global user.name "Jane Doe"
-$ git config --global user.name "Jane Doe"
+    git config --global user.email jane.doe@example.com
-$ git config --global user.email jane.doe@example.com
-```
 
 Example commit message from the [Pro Git][gitbook] online book, notice
 how `git commit -s` is used to automatically add a `Signed-off-by`:
 
-```
+    Brief, but clear and concise summary of changes
-Brief, but clear and concise summary of changes
     
-More detailed explanatory text, if necessary.  Remember, a future
+    More detailed explanatory text, if necessary.  Wrap it to about 72
-reader has the diff and can see what it does, the commit message in
+    characters or so.  In some contexts, the first line is treated as
-itself should usually talk about the *why* of a change and/or any
+    the subject of an email and the rest of the text as the body.  The
-technical limitations and future work.
+    blank line separating the ummary from the body is critical (unless
+    you omit the body entirely); tools like rebase can get confused if
+    you run the two together.
     
-Wrap the text to about 72 characters or so.  In some contexts, the
+    Further paragraphs come after blank lines.
-first line is treated as the subject of an email and the rest of the
-text as the body.  The blank line separating the summary from the body
-is critical (unless you omit the body entirely); tools like rebase can
-get confused if you run the two together.
     
-Further paragraphs come after blank lines.
+     - Bullet points are okay, too
     
- - Bullet points are okay, too
+     - Typically a hyphen or asterisk is used for the bullet, preceded
+       by a single space, with blank lines in between, but conventions
+       vary here
     
- - Typically a hyphen or asterisk is used for the bullet, preceded
+    Signed-off-by: Jane Doe <jane.doe@example.com>
-   by a single space, with blank lines in between, but conventions
-   vary here
 
-Signed-off-by: Jane Doe <jane.doe@example.com>
-```
 
 Code of Conduct
 ---------------
@@ -78,6 +72,8 @@ Code of Conduct
 It is expected of everyone engaging in the project to, in the words of
 Bill & Ted; [be excellent to each other][conduct].
 
-[KNF]:      https://www.kernel.org/doc/html/v5.8/process/coding-style.html
+
-[gitbook]:  https://git-scm.com/book/en/v2/Distributed-Git-Contributing-to-a-Project#_commit_guidelines
+[github]:   https://github.com/troglobit/finit/
+[KNF]:      https://en.wikipedia.org/wiki/Kernel_Normal_Form
+[gitbook]:  https://git-scm.com/book/ch5-2.html
 [conduct]:  CODE-OF-CONDUCT.md

.github/SECURITY.md

@@ -5,7 +5,7 @@
 finit is a small project, as such we have no possibility to support older versions.
 The only supported version is the latest released on GitHub:
 
-<https://github.com/finit-project/finit/releases>
+<https://github.com/troglobit/finit/releases>
 
 ## Reporting a Vulnerability
 

.github/scripts/extract-changelog.sh

@@ -1,29 +0,0 @@
-#!/bin/sh
-#
-# Extract the topmost release entry from doc/ChangeLog.md and unwrap
-# its paragraphs, so the GitHub releases page can wrap them to the
-# browser width instead of showing the hard 72-column breaks.
-#
-# Usage: .github/scripts/extract-changelog.sh < doc/ChangeLog.md > release.md
-#
-set -e
-
-# The entry sits between the first two underlines, minus the blank
-# line separating it from the next heading.
-awk '/^-----*$/{if (x == 1) exit; x=1;next}x' | head -n -1 |
-
-# Blank lines, headings, blockquotes, tables, and list items (at any
-# indent) start a new block, everything else continues the current one.
-awk '
-function flush() { if (buf) print buf; buf = "" }
-{
-    if (/^$/) { flush(); print; blank = 1; next }
-    if (/^ *([-*] |[0-9]+\. |[>#|])/ || blank || !buf || brk)
-        { flush(); buf = $0 }
-    else
-        { sub(/^ +/, ""); buf = buf " " $0 }
-    blank = 0
-    brk = /  $/
-}
-END { flush() }
-'

.github/workflows/build.yml

@@ -1,189 +0,0 @@
-name: Bob the Builder
-
-# Run on all branches, including all pull requests, except the 'dev'
-# branch since that's where we run Coverity Scan (limited tokens/day)
-on:
-  push:
-    branches:
-      - '**'
-      - '!dev'
-  pull_request:
-    types: [opened, synchronize, reopened, labeled]
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  fuzz:
-    name: fuzz
-    runs-on: ubuntu-latest
-    if: github.event_name != 'push' || github.ref == 'refs/heads/master'
-    steps:
-      - name: Install dependencies
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config libconfuse-dev clang libblkid-dev
-          # clang picks the newest gcc tree it finds and needs the
-          # matching libstdc++ headers to link the fuzzer runtime
-          sudo apt-get -y install libstdc++-14-dev || true
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - uses: actions/checkout@v7
-      - name: Configure
-        run: |
-          ./autogen.sh
-          ./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var
-      - name: Build fuzz target
-        run: |
-          clang -fsanitize=fuzzer,address -DLINK_FUZZ_LIBFUZZER -D_GNU_SOURCE \
-                -I libink -I . -o fuzz-msg-parse                              \
-                test/src/fuzz-msg-parse.c libink/*.c
-      # Restores the newest corpus and saves a fresh one, since a cache
-      # entry is immutable once written.  Caches made on a branch are
-      # private to it, so the corpus that accumulates on master is what
-      # pull requests start from, rather than nothing.
-      - name: Restore corpus
-        uses: actions/cache@v6
-        with:
-          path: .fuzz-corpus
-          key: fuzz-corpus-${{ github.run_id }}
-          restore-keys: fuzz-corpus-
-      - name: Fuzz
-        run: |
-          mkdir -p .fuzz-corpus
-          ./fuzz-msg-parse .fuzz-corpus -max_total_time=120 -max_len=4096 \
-                           -print_final_stats=1
-      # Without this the corpus only ever grows, and most of what it
-      # accumulates reaches code some earlier input already reached.
-      - name: Minimise corpus
-        if: always()
-        run: |
-          mkdir -p .fuzz-corpus-min
-          ./fuzz-msg-parse -merge=1 .fuzz-corpus-min .fuzz-corpus
-          rm -rf .fuzz-corpus
-          mv .fuzz-corpus-min .fuzz-corpus
-          echo "corpus: $(ls .fuzz-corpus | wc -l) inputs"
-      - name: Upload crashers
-        if: failure()
-        uses: actions/upload-artifact@v7
-        with:
-          name: fuzz-crashers
-          path: |
-            crash-*
-            leak-*
-            timeout-*
-          if-no-files-found: ignore
-
-  build:
-    # Verify we can build on latest Ubuntu with both gcc and clang
-    name: ${{ matrix.compiler }}
-    runs-on: ubuntu-latest
-    # Skip redundant builds for PRs - prefer PR builds over push builds
-    if: github.event_name != 'push' || github.ref == 'refs/heads/master'
-    strategy:
-      matrix:
-        compiler: [gcc, clang]
-      fail-fast: false
-    env:
-      CC: ${{ matrix.compiler }}
-    steps:
-      - name: Install dependencies
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config tree jq libcap-dev libconfuse-dev libblkid-dev libpam0g-dev
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - uses: actions/checkout@v7
-      - name: Static Finit
-        run: |
-          ./autogen.sh
-          ./configure --prefix= --enable-static
-          make -j9 V=1
-      - name: Regular Finit
-        run: |
-          ./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var \
-                      --enable-x11-common-plugin --enable-testserv-plugin \
-                      CFLAGS="-fsanitize=address -ggdb"
-          make -j9 clean
-          make -j9 V=1
-      - name: Install to /tmp
-        run: |
-          DESTDIR=/tmp make install-strip
-          tree /tmp || true
-      - name: Check dependencies
-        run: |
-          ldd  /tmp/sbin/finit
-          size /tmp/sbin/finit
-          ldd  /tmp/sbin/initctl
-          size /tmp/sbin/initctl
-          ldd  /tmp/sbin/reboot
-          size /tmp/sbin/reboot
-      - name: Verify starting and showing usage text
-        run: |
-          sudo /tmp/sbin/finit -h
-          sudo /tmp/sbin/initctl -h
-      - name: Enable unprivileged userns (unshare)
-        run: |
-          sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0
-      - name: Run Unit Tests
-        run: |
-          make -j1 check || (cat test/test-suite.log; false)
-      - name: Upload Test Results
-        if: always()
-        uses: actions/upload-artifact@v7
-        with:
-          name: finit-test-${{ matrix.compiler }}
-          path: test/*.log
-
-  no-dbus:
-    # The D-Bus support is default-enabled, so the HAVE_DBUS paths in
-    # initctl and finit only bit-rot silently without this leg.
-    name: no-dbus
-    runs-on: ubuntu-latest
-    if: github.event_name != 'push' || github.ref == 'refs/heads/master'
-    steps:
-      - name: Install dependencies
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config tree jq libcap-dev libconfuse-dev libblkid-dev
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - uses: actions/checkout@v7
-      - name: Build without D-Bus
-        run: |
-          ./autogen.sh
-          ./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var \
-                      --disable-dbus --enable-testserv-plugin
-          make -j9 V=1
-      - name: Verify no bus artifacts
-        run: |
-          DESTDIR=/tmp make install-strip
-          ! strings /tmp/sbin/initctl | grep -q finit/bus
-          ! strings /tmp/sbin/finit   | grep -q org.finit
-      - name: Enable unprivileged userns (unshare)
-        run: |
-          sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0
-      - name: Smoke test
-        run: |
-          make -C test setup-chroot
-          make -j1 -C test check TESTS='start-stop-serv.sh' \
-              || (cat test/test-suite.log; false)

.github/workflows/coverity.yml

@@ -1,91 +0,0 @@
-name: Coverity Scan
-
-on:
-  push:
-    branches:
-      - 'dev'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-env:
-  PROJECT_NAME: finit
-  CONTACT_EMAIL: troglobit@gmail.com
-  COVERITY_NAME: troglobit-finit
-  COVERITY_PROJ: troglobit%2Ffinit
-
-jobs:
-  coverity:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v7
-      - name: Fetch latest Coverity Scan MD5
-        id: var
-        env:
-          TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
-        run: |
-          wget -q https://scan.coverity.com/download/cxx/linux64         \
-               --post-data "token=$TOKEN&project=${COVERITY_PROJ}&md5=1" \
-               -O coverity-latest.tar.gz.md5
-          echo "md5=$(cat coverity-latest.tar.gz.md5)" | tee -a $GITHUB_OUTPUT
-      - uses: actions/cache@v6
-        id: cache
-        with:
-          path: coverity-latest.tar.gz
-          key: ${{ runner.os }}-coverity-${{ steps.var.outputs.md5 }}
-          restore-keys: |
-            ${{ runner.os }}-coverity-${{ steps.var.outputs.md5 }}
-            ${{ runner.os }}-coverity-
-            ${{ runner.os }}-coverity
-      - name: Download Coverity Scan
-        env:
-          TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
-        run: |
-          if [ ! -f coverity-latest.tar.gz ]; then
-            wget -q https://scan.coverity.com/download/cxx/linux64   \
-                 --post-data "token=$TOKEN&project=${COVERITY_PROJ}" \
-                 -O coverity-latest.tar.gz
-          else
-            echo "Latest Coverity Scan available from cache :-)"
-            md5sum coverity-latest.tar.gz
-          fi
-          mkdir coverity
-          tar xzf coverity-latest.tar.gz --strip 1 -C coverity
-      - name: Install dependencies
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config libcap-dev libconfuse-dev libblkid-dev
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - name: Configure
-        run: |
-          ./autogen.sh
-          ./configure --prefix= --enable-x11-common-plugin
-      - name: Build
-        run: |
-          export PATH=`pwd`/coverity/bin:$PATH
-          cov-build --dir cov-int make
-      - name: Submit results to Coverity Scan
-        env:
-          TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
-        run: |
-          tar czvf ${PROJECT_NAME}.tgz cov-int
-          curl \
-            --form project=${COVERITY_NAME} \
-            --form token=$TOKEN \
-            --form email=${CONTACT_EMAIL} \
-            --form file=@${PROJECT_NAME}.tgz \
-            --form version=trunk \
-            --form description="${PROJECT_NAME} $(git rev-parse HEAD)" \
-            https://scan.coverity.com/builds?project=${COVERITY_PROJ}
-      - name: Upload build.log
-        uses: actions/upload-artifact@v7
-        with:
-          name: coverity-build.log
-          path: cov-int/build-log.txt

.github/workflows/docs.yml

@@ -1,163 +0,0 @@
-name: Dotty the Documenteer
-
-on:
-  push:
-    branches:
-      - master
-      - 4.x
-    paths:
-      - 'doc/**'
-      - 'README.md'
-      - 'mkdocs.yml'
-      - 'configure.ac'
-      - '.github/workflows/docs.yml'
-  pull_request:
-    types: [opened, synchronize, reopened, labeled]
-    paths:
-      - 'doc/**'
-      - 'README.md'
-      - 'mkdocs.yml'
-      - 'configure.ac'
-      - '.github/workflows/docs.yml'
-
-permissions:
-  contents: read
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    outputs:
-      version: ${{ steps.version.outputs.version }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v7
-        with:
-          fetch-depth: 0  # Needed for git-revision-date-localized plugin
-
-      - name: Determine docs version
-        id: version
-        run: |
-          version=$(sed -n 's/^AC_INIT(\[Finit\], *\[\([0-9]*\)\..*/\1.x/p' configure.ac)
-          test -n "$version"
-          echo "version=$version" >> $GITHUB_OUTPUT
-
-      - name: Setup Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
-
-      - name: Install dependencies
-        run: |
-          pipx install mkdocs
-          pipx inject mkdocs mkdocs-material
-          pipx inject mkdocs pymdown-extensions
-          pipx inject mkdocs mkdocs-callouts
-          pipx inject mkdocs mkdocs-glightbox
-
-      - name: Build documentation
-        run: mkdocs build --clean
-
-      - name: Upload site artifact
-        uses: actions/upload-artifact@v7
-        with:
-          name: site
-          path: site/
-
-  deploy:
-    if: github.event_name == 'push'
-    needs: build
-    runs-on: ubuntu-latest
-    env:
-      VERSION: ${{ needs.build.outputs.version }}
-
-    steps:
-      - name: Download site artifact
-        uses: actions/download-artifact@v8
-        with:
-          name: site
-          path: site/
-
-      - name: Checkout pages repo
-        uses: actions/checkout@v7
-        with:
-          repository: finit-project/finit-project.github.io
-          path: pages
-          ssh-key: ${{ secrets.DOCS_DEPLOY_KEY }}
-          persist-credentials: true
-
-      - name: Setup SSH for push
-        run: |
-          mkdir -p ~/.ssh
-          chmod 700 ~/.ssh
-          ssh-keyscan github.com >> ~/.ssh/known_hosts
-
-      - name: Sync site to pages repo
-        run: |
-          rsync -a --delete site/ "pages/$VERSION/"
-
-      - name: Update version index and redirects
-        run: |
-          cd pages/
-
-          # The root holds only version directories and the files
-          # generated below, drop anything else (pre-versioned site)
-          find . -maxdepth 1 ! -name . ! -name .git ! -name CNAME \
-               ! -name '[0-9]*.x' -exec rm -rf {} +
-
-          latest=$(ls -d [0-9]*.x | sort -rV | head -1)
-
-          sep=
-          printf '[' > versions.json
-          for v in $(ls -d [0-9]*.x | sort -rV); do
-              printf '%s{"version": "%s", "title": "%s", "aliases": []}' \
-                     "$sep" "$v" "$v" >> versions.json
-              sep=', '
-          done
-          printf ']\n' >> versions.json
-
-          cat > index.html <<EOF
-          <!DOCTYPE html>
-          <html>
-            <head>
-              <meta charset="utf-8">
-              <meta http-equiv="refresh" content="0; url=$latest/">
-              <link rel="canonical" href="https://finit-project.github.io/$latest/">
-            </head>
-          </html>
-          EOF
-
-          cat > 404.html <<EOF
-          <!DOCTYPE html>
-          <html>
-            <head>
-              <meta charset="utf-8">
-              <title>Finit &mdash; page not found</title>
-              <script>
-                var path = window.location.pathname;
-                if (!/^\/[0-9]+\.x(\/|$)/.test(path))
-                  window.location.replace("/$latest" + path);
-              </script>
-            </head>
-            <body>
-              <p>Page not found.  Try the <a href="/$latest/">latest User Guide</a>.</p>
-            </body>
-          </html>
-          EOF
-
-      - name: Commit and push
-        run: |
-          cd pages/
-          if [ -z "$(git status --porcelain)" ]; then
-              exit 0
-          fi
-
-          SRC_REPO="${GITHUB_REPOSITORY}"
-          SRC_REF="${GITHUB_SHA::7}"
-          SRC_URL="https://github.com/${SRC_REPO}/commit/${SRC_REF}"
-
-          git config user.name "GitHub Actions"
-          git config user.email "actions@github.com"
-          git add -A
-          git commit -m "docs: update from ${SRC_REPO}@${SRC_REF}" \
-                     -m "For details, see ${SRC_URL}"
-          git push

.github/workflows/release.yml

@@ -1,80 +0,0 @@
-name: Release General
-
-on:
-  push:
-    tags:
-      - '[0-9]+.[0-9]+*'
-
-permissions:
-  contents: write
-
-jobs:
-  release:
-    name: Build and upload release tarball
-    if: startsWith(github.ref, 'refs/tags/')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v7
-      - name: Installing dependencies ...
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config jq libcap-dev libconfuse-dev libblkid-dev
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - name: Setting release variables ...
-        id: build
-        run: |
-          ver=${GITHUB_REF#refs/tags/}
-          echo "ver=${ver}" >> $GITHUB_OUTPUT
-          if echo $ver | grep -qE '^[0-9]+\.[0-9]+(\.[0-9]+)?(-alpha|-beta|-rc)[0-9]*$'; then
-            echo "pre=true"  >> $GITHUB_OUTPUT
-          else
-            echo "pre=false" >> $GITHUB_OUTPUT
-          fi
-          if echo $ver | grep -qE '^[0-9.]+\.[0-9.]+(\.[0-9]+)?$'; then
-            echo "latest=true"  >> $GITHUB_OUTPUT
-          else
-            echo "latest=false" >> $GITHUB_OUTPUT
-          fi
-      - name: Creating Makefiles ...
-        run: |
-          ./autogen.sh
-          ./configure  --prefix=/usr --exec-prefix= --sysconfdir=/etc  \
-                       --localstatedir=/var --enable-x11-common-plugin \
-                       --enable-testserv-plugin
-      - name: Enable unprivileged userns (unshare)
-        run: |
-          sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0
-      - name: Build release ...
-        run: |
-          # Get version for finding distcheck build directory
-          ./configure --version | head -1
-          ver=$(./configure --version | head -1 | awk '{print $NF}')
-          dir=finit-$ver/_build/sub
-
-          make -j1 release || (cat $dir/test/test-suite.log; false)
-          ls -lF ../
-          mkdir -p artifacts/
-          mv ../*.tar.gz artifacts/
-      - name: Upload Test Results
-        if: always()
-        uses: actions/upload-artifact@v7
-        with:
-          name: finit-release-test-logs
-          path: finit-*/_build/sub/test/*.log
-      - name: Extract ChangeLog entry ...
-        run: |
-          .github/scripts/extract-changelog.sh < doc/ChangeLog.md > release.md
-          cat release.md
-      - uses: ncipollo/release-action@v1
-        with:
-          name: Finit v${{ github.ref_name }}
-          prerelease: ${{ steps.build.outputs.pre }}
-          makeLatest: ${{ steps.build.outputs.latest }}
-          bodyFile: "release.md"
-          artifacts: "artifacts/*"

.github/workflows/weekly.yml

@@ -1,67 +0,0 @@
-name: Weekly Distcheck
-
-# Verify that `make distcheck` works as intended: all tests pass, and
-# any new files are distributed in the tarballs
-on:
-  schedule:
-    - cron: '0 0 * * 0'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  schedule:
-    runs-on: ubuntu-latest
-    outputs:
-      run: ${{ steps.schedule.outputs.run }}
-    steps:
-      - uses: actions/checkout@v7
-      - name: Check for any commits since last week
-        id: schedule
-        run: |
-          commits="$(git log --format=%H --since='1 week ago')"
-          if [ -z "$commits" ]; then
-              echo "run=true"  >> $GITHUB_OUTPUT
-          else
-              echo "run=false" >> $GITHUB_OUTPUT
-          fi
-  distcheck:
-    needs: schedule
-    if: ${{ needs.schedule.outputs.run == 'true' }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Install dependencies
-        run: |
-          sudo apt-get -y update
-          sudo apt-get -y install pkg-config jq libcap-dev libconfuse-dev libblkid-dev
-          wget https://github.com/troglobit/libuev/releases/download/v2.4.1/libuev-2.4.1.tar.xz
-          wget https://github.com/troglobit/libite/releases/download/v2.6.2/libite-2.6.2.tar.gz
-          tar xf libuev-2.4.1.tar.xz
-          tar xf libite-2.6.2.tar.gz
-          (cd libuev-2.4.1 && ./configure && make -j9 && sudo make install-strip)
-          (cd libite-2.6.2 && ./configure && make -j9 && sudo make install-strip)
-          sudo ldconfig
-      - uses: actions/checkout@v7
-      - name: Base run
-        run: |
-          ./autogen.sh
-          ./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var
-          make -j9 V=1
-      - name: Install to /tmp
-        run: |
-          DESTDIR=/tmp make install-strip
-      - name: Enable unprivileged userns (unshare)
-        run: |
-          sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0
-      - name: Check dist tarball
-        run: |
-          ver=$(/tmp/sbin/initctl -V | awk '/Finit.*/ {print $2;}')
-          dir=finit-$ver/_build/sub
-          make -j1 distcheck || (cat $dir/test/test-suite.log; false)
-      - name: Upload Test Results
-        if: always()
-        uses: actions/upload-artifact@v7
-        with:
-          name: finit-weekly-test-logs
-          path: finit-*/_build/sub/test/*.log

.gitignore

@@ -14,7 +14,6 @@ GTAGS
 /autom4te.cache
 /aclocal.m4
 /ar-lib
-/backup/
 /compile
 /config.cache
 /config.h
@@ -37,9 +36,6 @@ GTAGS
 /test-driver
 /test-suite.log
 
-# Misc
-/.gdb_history
-
 # TroglOS build system
 /.config
 /.stamp
@@ -49,11 +45,3 @@ GTAGS
 /.autoconf
 /.automake
 /.built
-
-# VS Code user settings
-.vscode
-
-# Fuzzing: the target is built by hand with clang, see doc/build.md,
-# and the corpus it grows is a local artefact, not something to ship
-/fuzz-msg-parse
-/.fuzz-corpus/

.globalrc

@@ -1,15 +0,0 @@
-# GNU Global .conf file, see /etc/gtags/gtags.conf for details.
-# This configuration is optimized for the Finit project structure.
-
-default:\
-	:tc=default@/etc/gtags/gtags.conf:\
-	:tc=common:
-
-common:\
-	:skip=tags,TAGS,ID,y.tab.c,y.tab.h,gtags.files,cscope.files,cscope.out,cscope.po.out,cscope.in.out,\
-	{arch}/,autom4te.cache/,\
-	*.orig,*.rej,*.bak,*~,#*#,*.swp,*.tmp,*_flymake.*,*_flymake,\
-	*.o,*.a,*.so,*.lo,*.la,\
-	*.zip,*.gz,*.bz2,*.xz,*.lzh,*.Z,*.tgz,\
-	*.log,*.trs,test-suite.log,stamp-*,\
-	sysroot/:

.travis.yml

@@ -0,0 +1,65 @@
+# Travis CI integration -- https://travis-ci.org/troglobit/finit
+# Defaults to GNU GCC and autotools: ./configure && make && make test
+language: c
+
+# Use docker for quicker builds, it now allows https://docs.travis-ci.com/user/apt/
+sudo: false
+
+# Use non-docker builds atm. to install libuEv and libite from source
+#sudo: true
+
+# Test build with both GCC and Clang (LLVM)
+compiler:
+  - gcc
+  - clang
+
+# The secure: declaration is the encrypted COVERITY_SCAN_TOKEN, created
+#   via the "travis encrypt" command using the project repo's public key
+env:
+  global:
+   - PKG_CONFIG_PATH=/tmp/lib/pkgconfig
+   - CFLAGS="-W -Wall -Wextra"
+   - secure: "eOiuHs02lG2Uv146K9dMqucGTWUJFEhpz1oAtwe+kPrRXsXWc20hYMO+DSpMgD05vSvNeQA6p7h7LdRFQ+/g/Obj27TsOE+RKkUvRAtdwzxnKVyii9C/nmML8cFw7rIA0VS8O9mAkVYeyDxNDupBp3e9DPCibhKPvqCvioTnyy4="
+
+addons:
+  apt:
+    packages:
+      - tree
+  coverity_scan:
+    project:
+      name: "troglobit/finit"
+      description: "finit | Fast & Extensible init for Linux"
+    notification_email: troglobit@gmail.com
+    build_command_prepend: "./autogen.sh && ./configure --prefix=/tmp"
+    build_command: "make"
+    branch_pattern: dev
+
+install:
+  - wget https://github.com/troglobit/libuev/releases/download/v2.3.2/libuev-2.3.2.tar.xz
+  - wget https://github.com/troglobit/libite/releases/download/v2.3.1/libite-2.3.1.tar.gz
+  - tar xf libuev-2.3.2.tar.xz
+  - tar xf libite-2.3.1.tar.gz
+  - (cd libuev-2.3.2 && ./configure --prefix=/tmp && make && make install-strip)
+  - (cd libite-2.3.1 && ./configure --prefix=/tmp && make && make install-strip)
+
+# Custom build script for the time being, no "make test" yet
+script:
+  - ./autogen.sh
+  - ./configure --prefix=/tmp --enable-static
+  - make clean
+  - make V=1 -j5
+  - ./configure --prefix=/tmp --enable-x11-common-plugin --enable-fallback-shell --enable-watchdog --enable-logit
+  - cat config.log
+  - make clean
+  - make V=1 -j5
+  - make install-strip
+  - tree /tmp
+  - ldd /tmp/sbin/finit
+  - size /tmp/sbin/finit
+  - size /tmp/sbin/initctl
+  - size /tmp/sbin/reboot
+  - LD_LIBRARY_PATH=/tmp/lib /tmp/sbin/initctl -h
+  - unshare -V
+  - nsenter -V
+  - chroot --version
+  - 'LD_LIBRARY_PATH=/tmp/lib make distcheck || (cat finit-4.0-beta1/_build/sub/test/test-suite.log; exit 1)'

ChangeLog.md

@@ -0,0 +1,884 @@
+Change Log
+==========
+
+All relevant changes are documented in this file.
+
+
+[4.0][UNRELEASED] - 2021-02-21
+------------------------------
+
+This release became v4.0, and not v3.2, because of incompatible changes
+to service conditions.  There are other significant changes as well, so
+make sure to read the whole changelog when upgrading.
+
+### Changes
+* The stand-alone `reboot` tool has been replaced with a symlink to
+  `initctl`, like its siblings: halt, shutdown, poweroff, and suspend.
+  Calling `reboot` & C:o now defaults to the corresponding `initctl cmd`
+  with a fallback to sending signals as per traditional SysV init.  The
+  `-f` (force) flag remains, where `reboot(2)` is called directly
+* Introducing Finit progress 𝓜𝓸𝓭𝓮𝓻𝓷
+* Removed built-in inetd super server.  If you need this functionality,
+  use an external inetd, like xinetd, instead.  A pull request for a
+  stand-alone inetd, like watchdogd and getty, is most welcome!
+* Incompatible `configure` script changes, i.e., you must give proper
+  path arguments to the script, no more guessing just GNU defaults.
+  There are examples in the documentation and the `contrib/` section
+* Change service conditions from the non-obvious `<svc/path/to/foo>` to
+  `<pid/foo:id>`.  This to hopefully make it clear that one service's
+  'pid:!foo' pidfile is another service's `<pid/foo>` condition
+* Initial support for cgroups, every service now runs in its own cgroup
+  https://twitter.com/b0rk/status/1214341831049252870?s=20
+* Major refactor of Finit's `main()` function to be able to start the
+  event loop earlier.  This also facilitated factoring out functionality
+  previously hard-coded in Finit, e.g., starting the bundled watchdogd,
+  various distro packed udevd and other hotplugging tools
+* Support for `sysv` start/stop scripts as well as monitoring forking
+  services, stared using `sysv` or `service` stanza
+* Support for custom `kill:DELAY`, default 3 sec.
+* Support for custom `halt:SIGNAL`, default SIGTERM
+* Support for tracking custom PID files, using `pid:!/path/to/foo.pid`,
+  useful with new `sysv` or `service` which fork to background
+* Support starting run/task/services without absolute path, trust `$PATH`
+* Add support for `--disable-doc` and `--disable-contrib` to speed up
+  builds and work around issue with massively parallel builds
+* Add support for `@console` also for external getty
+* Add `-b`, batch mode, for non-interactive use to `initctl`
+* Prefer udev to handle `/dev/` if mdev is also available
+* Redirect dbus daemon output to syslog
+* Set `$SHELL`, like `$PATH`, to a sane default value, needed by BusyBox
+* Finit no longer automatically reloads its `*.conf` files after running
+  `/etc/rc.local` or run-parts.  Use `initctl reload` instead.
+* `initctl` without an argument or option now defaults to list services
+* Convert built-in watchdog daemon to standalone mini watchdogd, issue #102
+* Improved watchdog hand-over, now based on `svc_t` and not PID
+* Extended bootstrap, runlevel S, timeout: 10 --> 120 sec. before services
+  not allowed in the runtime runlevel are unconditionally stopped
+* Removed `HOOK_SVC_START` and `HOOK_SVC_LOST`, caused more problems
+  than they were worth.  Users are encouraged to use accounting instead
+* Skip displaying "Restarting ..." progress for bootstrap processes
+* Added a simple work queue mechanism to queue up work at boot + runtime
+  - Postpone deletion of `svc_t` until any `SIGKILL` timer has elapsed
+  - As long as a stepped service changes state we queue another step all
+    event, because services may depend on each other
+* Require new libuEv API: `uev_init1()` to reduce event cache so that
+  the kernel can invalidate deleted events before enqueing to userspace
+* Rename `hwclock.so` plugin to `rtc.so` since it now is stand-alone
+  from the `hwclock` tool.  Note: the kernel can also be set to load
+  and store RTC to/from system clock at boot/halt as well, issue #110
+* New plugin to support cold plugging devices, auto-loading of modules
+  at boot.  Detects required modules by reading `/sys/devices/*`
+* New plugin for `/etc/modules-load.d/` by Robert Andersson, Atlas Copco
+* New `name:foo` support for services, by Robert Andersson, Atlas Copco
+* New `manual:yes` support for services, by Robert Andersson, Atlas Copco
+* New `log:console` support for services, by Robert Andersson, Atlas Copco
+* Support for `:ID` as a string, by Jonas Johansson, Westermo
+* Support for auto-reload, instead of having to do `initctl reload`,
+  when a service configuration has changed.  Disabled by default, but
+  can be enabled with `./configure --enable-auto-reload`
+* Support for logging security related events, e.g., runlevel change,
+  star/stop or failure to start services, by Jonas Holmberg, Westermo
+* Mount devtpts with recommended `ptxmode=0666`
+* Mount /run tmpfs with nosuid,nodev,noexec for added security
+* Support for `console` as alias for `@console` in tty stanzas
+* Drop `--enable-rw-roots` configure option, use `rw` for your `/`
+  partition in `/etc/fstab` instead to trigger remount at boot
+* Drop default tty speed (38400) and use 0 (kernel default) instead
+* Make `:ID` optional, use NULL/zero internally this allows ...
+* Handle use-cases where multiple services share the same PID filem
+  and thus the same condition path, e.g. different instances for
+  different runlevels.  Allow custom condition path with `name:foo`
+  syntax, creates conditions w/o a path, and ...
+* Always append `:ID` qualifier to conditions if set for a service
+* The IPC socket has moved from `/run/finit.sock` to `/run/finit/socket`
+  officially only supported for use by the `initctl` tool
+* Improved support for modern `/etc/network/interfaces`, which has
+  include statements.  No more native `ifup` of individual interfaces,
+  Finit now calls `ifup -a`, or `ifdown -a`, delegating all details to
+  the operating system.  Also, this is now done in the background, by
+  popular request
+
+### Fixes
+
+* Fix #96: Start udevd as a proper service
+* Ensure we track run commands as well as task/service, once per runlevel
+* Ensure run/tasks also go to stopping state on exit, like services,
+  otherwise it is unnecessarily hard to restart them
+* Fix missing OS/Finit title bug, adds leading newline before banner
+* Remove "Failed connecting to watchdog ..." error message on systems
+  that do not have a watchdog
+* Fix #100: Early condition handling may not work if `/var/run` does
+  not yet exist (symlink to `/run`).  Added compat layer for access
+* Fix #103: Register multiple getty if `@console` resolves to >1 TTY,
+* Fix #105: Only remove /etc/nologin when moving from runlevel 0, 1, 6
+  Fixed by Jonas Johansson, Westermo
+* Fix #109: Support for PID files in sub-directories to `/var/run`
+* Handle rename of PID files, by Robert Andersson, Atlas Copco
+* Fix #120: Redirect `stdin` to `/dev/null` for services by default
+* Fix #122: Switch to `nanosleep()` to achieve "signal safe" sleep,
+  fixed by Jacques de Laval, Westermo
+* Fix #124: Lingering processes in process group when session leader
+  exits.  E.g., lingering `logit` processes when parent dies
+* Fix service name matching, e.g. for condition handling, may match with
+  wrong service, by Jonas Holmberg, Westermo
+* Run all run-parts scripts using `/bin/sh -c foo` just like the standard
+  run-parts tool.  Found by Magnus Malm, Westermo
+* Fix `initctl [start | restart]`, should behave the same for services
+  that have crashed.  Found by Mattias Walström, Westermo
+* Wait for bootstrap phase to complete before cleaning out any bootstrap
+  processes that have stopped, they may be restarted again
+* Reassert condition when an unmodified run/task/service goes from
+  WAITING back to RUNNING again after a reconfiguration event.  
+  Found and fixed by Jonas Johansson, Westermo
+* Restore Ctrl-D and Ctrl-U support in built-in getty
+* Remove service condition when service is deleted
+* Fix C++ compilation issues, by Robert Andersson, Atlas Copco
+* Build fixes for uClibc
+* Provide service description for built-in watchdog daemon
+* Fix #138: Handle `SIGPWR` like `SIGSUR2`, i.e., power off the system
+* Drop the '%m' GNUism, for compat with older musl libc
+
+
+[3.1][] - 2018-01-23
+--------------------
+
+Improvements to `netlink.so` plugin, per-service `rlimit` support,
+improved integration with `watchdogd`, auto-detect TTY console.  Much
+improved debug, rescue and logging support.  Also, many fixes to both
+big and small issues, most notably in the condition handling, which no
+longer is sensitive to time skips.
+
+This version requires at least libuEv v2.1.0 and libite v2.0.1
+
+### Changes
+
+* Support for more kernel command line settings:
+  - splash, enable boot progress
+  - debug, like `--debug` but also enable kernel debug
+  - single, single user mode (no network)
+  - rescue, new rescue mode
+* Support for `IFF_RUNNING` to netlink plugin => `net/IFNAME/running`
+* Support for restarting `initctl` API socket on `SIGHUP`
+* Greatly updated `initctl status <JOB|NAME>` command
+* Support for `rlimit` per service/run/task/inetd/tty, issue #45
+* Support for setting `hard` and `soft` rlimit for a resource at once
+* Support for auto-detecting serial console using Linux SysFS, the new
+  `tty @console` eliminates the need to keep track of different console
+  devices across embedded platforms: `/dev/ttyS0`, `/dev/ttyAMA0`, etc.
+* Add TTY `nologin` option.  Bypasses login and skips immediately to a
+  root shell.  Useful during board bringup, in developer builds, etc.
+* Support for calling run/tasks on Finit internal HOOK points, issue #18
+* Removed support for long-since deprecated `console DEV` setting
+* Cosmetic change to login, pressing enter at the `Press enter to ...`
+  prompt will now replace that line with the login issue text
+* Calling `initctl` without any arguments or options now defaults to
+  show status of all enabled services, and run/task/inetd jobs
+* Cosmetic change to boot messages, removed `Loading plugins ...`, start
+  of inetd services, and `Loading configuration ...`.  No end user knows
+  what those plugins and configurations are, i.e. internal state+config
+* Change kernel WDT timeout (3 --> 30 sec) for built-in watchdog daemon
+* Advise watchdog dawmon on shutdown and reboot using `SIGPWR` and then
+  `SIGTERM`.  It is recommended the daemon start a timer on the first
+  signal, in case the shutdown process somehow hangs.
+* Handle `/etc/` OverlayFS, reload /etc/finit.d/*.conf after `mount -a`
+* initctl: Add support for printing previous runlevel
+* initctl: Support short forms of all commands
+* initctl: Support for `initctl touch <CONF>` to be used with `reload`
+* initctl: Improved output of `initctl show <SVC>`
+* Support reloading `/etc/finit.conf`.  The main finit.conf file
+  previously did not support reloading at runtime, as of v3.1 all
+  configuration directives supported in `/etc/finit.d/*.conf` are now
+  supported in `/etc/finit.conf`
+* Change `.conf` dependency + reload handling.  Finit no longer relies
+  on mtime of `.conf` files, instead an inotify handler tracks file
+  changes for time *insensitive* dependency tracking
+* Change condition handling to not rely on mtime but a generation id.
+* New configure script option `--enable-redirect` to automatically
+  redirect `stdout` and `stderr` of all applications to `/dev/null`
+* New `pid` sub-option to services when a service does not create a PID
+  file, or when the PID file has another name.  Issue #95
+* Greatly improved `log` sub-option to service/run/tasks, selectively
+  redirect `stdout` and `stderr` using the new tool `logit` to either
+  syslog or a logfile.  Issue #44
+* Support for automatic log rotation of logfiles created by `log`
+  option.  Use `configure --disable-logrotate` on systems with a
+  dedicated log rotation service.  Issue #44
+* Support for disabling service/run/task progress with empty ` --`
+  description.  Note: no description separator gives a default desc.
+* Create `/etc/mtab` symlink if missing on system (bootmisc plugin)
+* New hook: `hook/mount/post` runs after `mount -a` but before the
+  `hook/mount/all`, where `bootmisc.so` runs.  This provides the
+  possibility of running a second stage mount command before files in
+  `/run` and similar are created
+* Skip `gdbserver` when unleashing the grim reaper at shutdown
+* Distribute and install `doc/` and `contrib/` directories
+
+### Fixes
+
+* Reset TTY before restarting it.  A program may manipulate the TTY in
+  various ways before the user logs out, Finit needs to reset the TTY to
+  a sane state before restarting it.  Issue #84
+* On .conf parse errors, do *not* default to set TTY speed 38400, reuse
+  current TTY speed instead
+* Fix run/tasks, must be guaranteed to run once per declared runlevel.
+  All run/tasks on `[S]` with a condition `<...>` failed to run.  Finit
+  now tracks run/tasks more carefully, waiting for them to finish before
+  switching to the configured runlevel at boot.  Issue #86
+* Allow inetd services to be registered with a unique ID, e.g. `:161`,
+  issue #87.  Found by Westermo
+* inetd: drop UDP packets from blocked interfaces, issue #88
+* Handle obscure inter-plugin dependency issue by calling the netlink
+  plugin before the pidfile plugin on `HOOK_SVC_RECONF` events
+* Handle event loop failure modes, issue found by Westermo
+* Handle API socket errors more gracefully, restart socket
+* Do not attempt to load kernel modules more than once at bootstrap
+* Remove reboot symlinks properly on uninstall
+* Fix regression in condition handling, reconf condition must be kept
+  as a reference point to previous reconfiguration, or bootstrap.
+* Fix nasty race condition with internal service stop, abort kill if the
+  service has already terminated, otherwise we may do `kill(0, SIGKILL)`
+* Fix reconfiguration issue with (very quick) systems that don't have
+  highres timers
+* Fix formatting of runlevel string in `initctl show`
+* Allow running `initctl` with `STDOUT` redirected
+* Fix regression in `initctl start/stop <ID>`, using name worked not id
+* Fix error handling in `initctl start/stop` without any argument
+* Fix issue #81 properly, remove use of SYSV shm IPC completely.  Finit
+  now use the API socket for all communication between PID 1 and initctl
+* Fix segfault on x86_64 when started with kernel cmdline `--debug`
+* Normalize condition paths on systems with `/run` instead of `/var/run`
+
+
+[3.0][] - 2017-10-19
+--------------------
+
+Major release, support for conditions/dependencies between services,
+optional built-in watchdog daemon, optional built-in getty, optional
+built-in standard inetd services like echo server, rdate, etc.
+
+Also, native support for Debian/BusyBox `/etc/network/interfaces`,
+overhauled new configure based build system, logging to `/dev/kmsg`
+before syslogd has started, massively improved support for Linux
+distributions.
+
+### Changes
+
+* Added basic code of conduct covenant to project
+* Added contribution guidelines document
+* Removed `finit.conf` option `check DEV`, replaced entirely by automated
+  call to `fsck` for each device listed in `/etc/fstab`
+* Removed deprecated and confusing `startx` and `user` settings.  It is
+  strongly recommended to instead use xdm/gdb/lightdm etc.
+* Add support for `initctl log <SVC>`, shows last 10 lines from syslog
+* Add `initctl cond dump` for debugging conditions
+* Ensure plugins always have a default name, file name
+* Reorganization, move all source files to a `src/` sub-directory
+* Add support for `initctl <list|enable|disable> <SVC>`, much needed by
+  distributions.  See [doc/distro.md](doc/distro.md) for details
+* Remove `UNUSED()` macro, mentioned here because it may have been used
+  by external plugin developers.  Set `-Wno-unused-parameter` instead
+* New table headings in `initctl`, using `top` style inverted text
+* Allow `initctl show` to use full screen width for service descriptions
+* New `HOOK_BANNER` for plugins to override the default `banner()`
+* Allow loading TTYs from `/etc/finit.d`
+* Improvements to built-in getty, ignore signals like `SIGINT`,
+  `SIGHUP`, support Ctrl-U to erase to beginning of line
+* Add TTY `nowait` and `noclear` options
+* Allow using both built-in getty and external getty:  
+
+        tty [12345] /dev/ttyAMA0    115200              noclear vt220
+        tty [12345] /sbin/getty  -L 115200 /dev/ttyAMA0 vt100
+        tty [12345] /sbin/agetty -L ttyAMA0 115200      vt100 nowait
+
+* Silent boot is now the default, use `--enable-progress` to get the old
+  Finit style process progress.  I.e., `--enable-silent` is no more
+* Support for `configure --enable-emergency-shell`, debug-only mode
+* Support for a fallback shell on console if none of the configured TTYs
+  can be started, `configure --enable-fallback-shell`
+* All debug messages to console when Finit `--debug` is enabled
+* Prevent login, by touching `/etc/nologin`, during runlevel changes
+* A more orderly shutdown.  On reboot/halt/poweroff Finit now properly
+  goes to runlevel 0/6 to first stop all processes.
+* Perform sync before remounting as read-only, at shutdown
+* Clean up `/tmp`, `/var/run`, and `/var/lock` at boot on systems which
+  have these directories on persistent storage
+* Call udev triggers at boot, on systems with udev
+* Add missing `/var/lock/subsys` directory for dbus
+* Add support for `poweroff`
+* Add support for a built-in miniature watchdog daemon
+* Remove GLIBC:isms like `__progname`
+* Manage service states based on user defined conditions
+* Manage dependencies between services, w/ conditions (pidfile plugin)
+* Manage service dependencies on network events (netlink plugin)
+* Support for dynamically reloading Finit configuration at runtime
+* Refactor to use GNU configure and build system
+* New hooks for for detecting lost and started services (lost plugin)
+* External libraries, libuEv and libite, now build requirements
+* Early logging support to `/dev/kmsg` instead of console
+* Support for redirecting stdout/stderr of services to syslog
+* Support for managing resource limits for Finit and its processes
+* Add optional built-in inetd services: echo server, chargen, etc.
+* Add simple built-in getty
+* Greatly improved accounting support, both UTMP and WTMP fixes+features
+* Improved udev support, on non-embedded systems
+* Improved shutdown and file-system unmount support (Debian)
+* Support SysV init `/etc/rc.local`
+* Inetd protection against UDP looping attacks
+* Support systems with `/run` instead of `/var/run` (bootmisc plugin)
+* Adopted BusyBox init signals for halt/reboot/poweroff
+* SysV init compat support for reboot (setenv)
+* Compat support for musl libc
+* Add OpenRC-like support for sysctl.d/*.conf
+* Add support for Debian/BusyBox `/etc/network/interfaces`
+* Add support for running fsck on file systems in `/etc/fstab`
+* Added example configs + HowTos for Debian and Alpine Linux
+  to support latest releases of both distributions
+* Lots of documentation updates
+
+### Fixes
+
+* Fix race-condition at configuration reload due to too low resolution.  
+  Thanks to Mattias Walström, Westermo
+* Fix to handle long process (PID) dependency chains, re-run reconf
+  callback until no more applications are in flux.  
+  Thanks to Mattias Walström, Westermo
+* Clear `reconf` condition when `initctl reload` has finished
+* Skip automatic reload of `/etc/finit.d/*.conf` files when changing
+  runlevel to halt or reboot
+* Fix issue #54: Allow halt and poweroff commands even if watchdog is enabled
+* Fix issue #56: Check existence of device before trying to start getty
+* Fix issue #60: `initctl` should display error and return error code
+  for non-existing services should the operator try to start/stop them.
+* Fix issue #61: Reassert `net/*` conditions after `initctl reload`
+* Fix issue #64: Skip `fsck` on already mounted devices
+* Fix issue #66: Log rotate and gzip `/var/log/wtmp`, created by Finit
+* Fix issue #72: Check `ifup` exists before trying to bring up networking,
+  also set `$PATH` earlier to simplify `run()` et al -- no longer any need
+  to use absolute paths for system tools called from Finit.  Thanks to crazy
+* Fix issue #73: Remove double `ntohl()` in inetd handling, prevents matches.  
+  Thanks to Petrus Hellgren, Westermo
+* Fix issue #76: Reap zombie processes in emergency shell mode
+* Fix issue #80: FTBFS on Arch Linux, missing `stdarg.h` in `helpers.h`,
+  thanks to Jörg Krause
+* Fix issue #81: Workaround for systems w/o SYSV shm IPC support in kernel
+* Always collect bootstrap-only tasks when done, we will never re-run them.
+  Also, make sure to never reload bootstrap-only tasks at runtime
+* Remove two second block (!) of Finit when stopping TTYs
+
+
+[2.4][] - 2015-12-04
+--------------------
+
+Bug fix release.
+
+### Changes
+
+* Add support for status/show service by `name:id`
+* Enforce terse mode after boot, if verbose mode is disabled
+* Reenable verbose mode at reboot, if disabled at boot
+* Update section mentioning BusyBox getty
+* Update debugging documentation
+* Allow debug to override terse mode
+* Revert confusing change in service state introduced in [v2.3][2.3].
+  As of [v2.4][2.4] services are listed as "halted" and "stopped", when
+  they have been halted due to a runlevel changed or stopped by the
+  user, respectively.
+
+### Fixes
+
+* Fix system freeze at reconfiguration.  Changed services that
+  all support `SIGHUP` caused a freeze due to Finit waiting for
+  them to stop.
+* Make sure to start and/or `SIGHUP` services after reconfiguration
+  when there was no services to stop.
+
+
+[2.3][] - 2015-11-28
+--------------------
+
+Bug fix release.
+
+### Changes
+
+* Add support for stop/start/restart/reload service by `name:id`
+* Refactor service status listed in `initctl show`, show actual status
+
+### Fixes
+
+* Remove bootstrap-only tasks/services when leaving runlevel 'S'
+* Fix reference counting issue with already stopped and removed services
+  when the user performs `initctl reload` to change system configuration
+* Revert semantic change in behavior of `initctl restart`: users expect
+  service to be stopped/started, not reloaded with `SIGHUP` even if the
+  service supports it
+* Fix `NULL` pointer dereference causing kernel panic when user calls
+  `initctl reload` after change of system configuration
+* Fix column alignment in output of `initctl show` for services not in
+  current runlevel
+
+
+[2.2][] - 2015-11-23
+--------------------
+
+Lots of fixes to handle static builds, but also fixes for dynamic event
+handling and reconfiguration at runtime.
+
+### Changes
+
+* Upgrade to libuEv v1.2.4, to handle static builds
+* Upgrade to libite (LITE) v1.2.0, to handle static builds
+* Clarify how to select different plugins with the configure script
+* Improve urandom plugin for embedded systems w/o random seed
+* Add `--debug` flag to `initctl`
+* The runlevels listed for services in `initctl show` now hightlight the
+  active runlevel.
+* Clarify in the README and in `initctl help` that the GW event to
+  listen for in service declarations is `GW:UP`
+
+### Fixes
+
+* Build fixes for `configure --disable-inetd`
+* Fixed issue #14: Improved support for static Finit builds
+* Misc. fixes to silence warnings when building a static Finit
+* Default to register services as `SIGHUP`'able, regression in v2.0
+* Call `HOOK_SVC_RECONF` only when all processes have been stopped
+* On reload/reconf we must wait for all services to stop first
+* Only trigger on events that matches the service's specification,
+  fix by Tobias Waldekranz
+
+
+[2.1][] - 2015-10-16
+--------------------
+
+### Changes
+
+* Add hook point for fstab mount failure
+* Set hostname on dynamic reload
+* Upgrade to libite v1.1.1
+
+### Fixes
+
+* Fix service callback coredump checks and simplify callback exit
+* Do not use `-Os` use `-O2` as default optimization level.  Many cross
+  compiler toolchains are known to have problems with `-Os`
+* Do not allow build VERSION to be overloaded by an environment variable
+* Fix too small MAX arguments and too few argments in `svc_t` for
+  reading currently running services with `initctl show`
+* Unblock blocked signals after forking off a child
+
+
+[2.0][] - 2015-09-20
+--------------------
+
+Support for multiple instances and event based services, as well as the
+introduction of an `initctl` tool.
+
+**Note:** Incompatible change to syntax for custom `inetd` services,
+  c.f. Finit v[1.12][].
+
+### Changes
+* The most notable change is the support for multiple instances.  A must
+  have when running multiple DHCP clients, OpenVPN tunnels, or anything
+  that means using the same command only with different arguments.  Now
+  simply add a `:ID` after the `service` keyword, where `ID` is a unique
+  instance number for that service.
+
+        service :1 [2345] /sbin/httpd -f -h /http -p 80   -- Web server
+        service :2 [2345] /sbin/httpd -f -h /http -p 8080 -- Old web server
+
+* Another noteworthy new feature is support for starting/stopping
+  services on Netlink events:
+
+        service :1 [2345] <!IFUP:eth0,GW> /sbin/dropbear -R -F -p 22 -- SSH daemon
+
+  Here the first instance `:1` of the SSH daemon is declared to run in
+  runlevels 2-5, but only if eth0 `IFUP:eth0` is up and a gateway `GW`
+  is set.  When the configuration changes, a new gateway is set, or if
+  somehow a new `IFUP` event for eth0 is received, then dropbear is not
+  SIGHUP'ed, but instead stop-started `<!>`.  The latter trick applies
+  to all services, even those that do not define any events.
+* Support for reloading `*.conf` files in `/etc/finit.d/` on SIGHUP.
+  All `task`, `service` and `run` statements can be used in these .conf
+  files.  Use the `telinit q` command, `initctl reload` or simply send
+  `SIGHUP` to PID 1 to reload them.  Finit automatically does reload of
+  these `*.conf` files when changing runlevel.
+* Support for a modern `initctl` tool which can stop/start/reload and
+  list status of all system services.  Also, the old client tool used
+  to change runlevel is now also available as a symlink: `telinit`.
+
+        initctl [-v] <status|stop|start|reload|restart> [JOB]
+
+* Add concept of "jobs".  This is a unique identifier, composed of a
+  service and instance number, `SVC:ID`
+
+        initctl <stop|start|reload|restart> JOB
+
+* Support for *deny filters* in `inetd` services.
+
+        inetd service/proto[@iface,!iface,...] </path/to/cmd | internal[.service]>
+
+  Internal services on a custom port must use the `internal.service`
+  syntax so Finit can properly bind the inetd service to the correct
+  plugin.  Here follows a few examples:
+
+        inetd time/udp                    wait [2345] internal                -- UNIX rdate service
+        inetd time/tcp                  nowait [2345] internal                -- UNIX rdate service
+        inetd 3737/tcp                  nowait [2345] internal.time           -- UNIX rdate service
+        inetd telnet/tcp@*,!eth1,!eth0, nowait [2345] /sbin/telnetd -i -F     -- Telnet service
+        inetd 2323/tcp@eth1,eth2,eth0   nowait [2345] /sbin/telnetd -i -F     -- Telnet service
+        inetd 222/tcp@eth0              nowait [2345] /sbin/dropbear -i -R -F -- SSH service
+        inetd ssh/tcp@*,!eth0           nowait [2345] /sbin/dropbear -i -R -F -- SSH service
+
+  Access to telnet on port `2323` is only possible from interfaces
+  `eth0`, `eth1` and `eth2`.  The standard telnet port (`23`) is
+  available from all other interfaces, but also `eth2`.  The `*`
+  notation used in the ssh stanza means *any* interface, however, here
+  `eth0` is not allowed.
+
+  **NOTE:** This change breaks syntax compatibility with Finit v[1.12].
+* Support for a more user-friendly configure script rather than editing
+  the top Makefile, or setting environment variables at build time.
+* Support for building Finit statically, no external libraries.  This
+  unfortunately means that some plugins cannot be built, at all.
+  Big thanks goes to James Mills for all help testing this out!
+* Support for disabling the built-in inetd server with `configure`.
+* Support for two new hook points: `HOOK_SVC_RECONF` and
+  `HOOK_RUNLEVEL_CHANGE`.  See the source for the exact location.
+* The `include <FILE>` option now needs an absolute path to `FILE`.
+
+### Fixes
+* Rename `patches/` to `contrib/` to simplify integration in 3rd party
+  build systems.
+* Fix for unwanted zombies ... when receiving SIGCHLD we must reap *all*
+  children.  We only receive one signal, but multiple processes may have
+  exited and need to be collected.
+
+
+[1.12][] - 2015-03-04
+---------------------
+
+The inetd release.
+
+### Changes
+* Add support for built-in inetd super server -- launch services on
+  demand.  Supports filtering per interface and custom Inet ports.
+* Upgrade to [libuEv] v1.1.0 to better handle error conditions.
+* Allow mixed case config directives in `finit.conf`
+* Add support for RFC 868 (rdate) time plugin, start as inetd service.
+* Load plugins before parsing `finit.conf`, this makes it possible to
+  extend finit even with configuration commands.  E.g., the `time.so`
+  plugin must be loaded for the `inetd time/tcp internal` service to be
+  accepted when parsing `finit.conf`.
+* Slight change in TTY fallback behavior, if no TTY is listed in the
+  system `finit.conf` first inspect the `console` setting and only if
+  that too is unset fall back to `/bin/sh`
+* When falling back to the `console` TTY or `/bin/sh`, finit now marks
+  this fallback as console.  Should improve usability in some use cases.
+
+### Fixes
+* Revert "Use vfork() instead of fork() before exec()" from v1.11.  It
+  turned out to not work so well after all.  For instance, launching
+  TTYs in a background process completely blocked inetd services from
+  even starting up listening sockets ... proper fork seems to work fine
+  though.  This is the casue for *yanking* the [1.11] release, below.
+* Trap segfaults caused by external plugins/callbacks in a sub-process.
+  This prevents a single programming mistake in by a 3rd party developer
+  from taking down the entire system.
+* Fix Coverity CID 56281: dlopen() resource leak by storing the pointer.
+  For the time being we do not support unloading plugins.
+* Set hostname early, so bootstrap processes like syslog can use it.
+* Only restart *lost daemons* when recovering from a SIGSTOP/norespawn.
+
+
+[1.11][] - 2015-01-24 [YANKED]
+------------------------------
+
+The [libuEv] release.
+
+**Note:** This release has been *yanked* from distribution due to a
+  regression in launching background processes and TTY's.  Fixed in
+  Finit v[1.12].
+
+### Changes
+* Now using the asynchronous libuEv library for handling all events:
+  signals, timers and listening to sockets or file descriptors.
+* Rename NEWS.md --> CHANGELOG.md, with symlinks for `make install`
+* Attempt to align with http://keepachangelog.com/ for this file.
+* Travis CI now only invokes Coverity Scan from the 'dev' branch.  This
+  means that all development, except documentation updates, must go into
+  that branch.
+
+### Fixes
+* Fix bug with finit dying when no `tty` is defined in `finit.conf`, now
+  even the fallback shell has control over its TTY, see fix in GIT
+  commit [dea3ae8] for this.
+
+
+[1.10][] - 2014-11-27
+---------------------
+
+Major bug fix release.
+
+### Changes
+* Project now relies on static code analysis from Coverity, so this
+  release contains many serious bug fixes.
+* Convert to use Markdown for README, NEWS and TODO.
+* Serious update to README and slight pruning of finished TODO items.
+
+### Fixes
+* Fix serious file descriptor and memory leaks in the following
+  functions.  In particular the leaks in `run_interactive()` are very
+  serious since that function is called every time a service is started
+  and/or restarted!  For details, see the GIT log:
+  * `helpers.c:run()`
+  * `helpers.c:run_interactive()`
+  * `helpers.c:set_hostname()`
+  * `helpers.c:procname_kill()`
+* `svc.c:svc_start()`: Fix swapped arguments to dup2() and add close(fd)
+  to prevent descriptor leak.
+* `svc.c:svc_start()`: Fix out of bounds write to local stack variable,
+  wrote off-by-one outside array.
+* Several added checks for return values to `mknod()`, `mkdir()`,
+  `remove()`, etc.
+
+
+[1.9][] - 2014-04-21
+--------------------
+
+### Changes
+* Add support for an include directive to `.conf` files
+* Fallback to `/bin/sh` if user forgets tty setting
+* Initial support for restarting lost services during `norespwan`
+
+### Fixes
+* Bug fixes, code cleanup
+* Handle `SIGHUP` from service callback properly when switching runlevel
+* Misc. major (memleak) and minor fixes and additions to `libite/lite.h`
+
+
+[1.8][] - 2013-06-07
+--------------------
+
+### Changes
+* Support for runlevels, with a bootstrap runlevel 'S'
+* Support for saving previous and current runlevel to UTMP
+* Support for new `finit.conf` commands: run, task, and runlevel
+* Support for tty and console commands in `finit.conf`, like services
+  but for launching multiple getty logins
+* New tty plugin to monitor TTYs coming and going, like USB TTYs
+
+### Fixes
+* Bugfixes to libite
+
+
+[1.7][] - 2012-10-08
+--------------------
+
+### Changes
+* Show `__FILE__` in `_d()` debug messages, useful for plugins with
+  similarily named callbacks. Also, only in debug mode anyway
+* Make sure to cleanup recorded PID when a service is lost.  Required by
+  service plugins for their callbacks to work.
+* Only clear screen when in verbose mode. Maybe this should be removed
+  altogether?
+
+### Fixes
+* Bugfix: Do not `free()` static string in `finit.conf` parser
+
+
+[1.6][] - 2012-10-06
+--------------------
+
+### Changes
+* Skip `.` and `..` in plugin loader and display error when failing to
+  load plugins
+* Support for overriding `/etc/finit.d` with `runparts DIR` in
+  `finit.conf`
+* Revoke support for starting services not starting with a slash.
+* Prevent endless restart of non-existing services in `finit.conf`
+* Support for sysvinit style startstop scripts in `/etc/finit.d`
+
+### Fixes
+* Minor fix to alsa-utils plugin to silence on non-existing cards
+
+
+[1.5][] - 2012-10-03
+--------------------
+
+### Changes
+* Use bootmisc plugin to setup standard FHS 2.3 structure in `/var`
+* Added `FLOG_WARN()` syslog macro, for plugins
+* Add plugin dependency resolver. Checks `plugin_t` for `.depends`
+
+
+[1.4][] - 2012-10-02
+--------------------
+
+### Changes
+* Start refactoring helpers.c into a libite.so (-lite).  This means
+  other user space applications/daemons can make use of the neat toolbox
+  available in finit
+* Use short-form -s/-w -u to work with BusyBox hwclock as well
+* Use RTLD_GLOBAL flag to tell dynamic loader to load dependent .so
+  files as well.  Lets other plugins use global symbols.
+* Greatly simplify svc hook for external plugins and cleanup plugin API.
+* And more ... see the GIT log for more details.
+
+### Fixes
+* Fix I/O plugin watcher and load plugins earlier for a new hook
+
+
+[1.3][] - 2012-09-28
+--------------------
+
+### Changes
+* Cleanup public plugin API a bit and add new pid/pidfile funcs
+* Add plugin hook to end of service startup
+* Remove finit.h from svc.h, plugins should not need this.
+* Move utility macros etc. to helpers.h
+* Make `finit.h` daemon internal, only
+* Move defines of FIFO, conf and rcS.d to Makefile => correct paths
+* Add support for installing required headers in system include dir
+* Better support for distributions and packagers with install-exec,
+  install-data, and install-dev targets in Makefile.  Useful if you want
+  to call targets with different `$DESTDIR`!
+* Makefile fixes for installation, paths encoded wrong
+* Strip binaries + .so files, support for `$(CROSS)` toolchain strip
+* Default install is now to `/sbin/finit` and `/usr/`
+* Note change in `$PLUGIN_DIR` environemnt variable to `$plugindir`
+
+
+[1.2][] - 2012-09-27
+--------------------
+
+### Changes
+* Update README with section on building and enviroment variables
+
+### Fixes
+* Fix installation paths encoded in finit binary
+
+
+[1.1][] - 2012-09-27
+--------------------
+
+### Changes
+* Rename signal.[ch]-->sig.[ch] to avoid name clash w/ system headers
+
+### Fixes
+* Build fixes for ARM eabi/uClibc
+
+
+[1.0][] - 2012-09-26
+--------------------
+
+### Changes
+* New plugin based system for all odd extensions
+* New service monitor that restarts services if they die
+* New maintainer at GitHub http://github.com/troglobit/finit
+* Add standard LICENSE and AUTHORS files
+* New focus: embedded systems and small headless servers
+
+
+[0.6][] - 2010-06-14
+--------------------
+
+* Don't start consolekit manually, dbus starts it (rtp)
+* Unmount all filesystems before rebooting
+* Disable `USE_VAR_RUN_RESOLVCONF` for Mandriva
+* Unset terminal type in Mandriva before running X
+* Remove extra sleep in finit-alt before calling services.sh (caio)
+
+
+[0.5][] - 2008-08-21
+--------------------
+
+* Add option to start dbus and consolekit before the X server
+* finit-alt listens to `/dev/initctl` to work with `reboot(8)` (smurfy)
+* Write runlevel to utmp, needed by Printerdrake (Pascal Terjan)
+* Fix ownership of `/var/run/utmp` (reported by Pascal Terjan)
+* Remove obsolete code to load AGP drivers
+* Conditional build of `/etc/resolveconf/run` support
+* Add support to `/var/run/resolvconf` in Mandriva (blino)
+
+
+[0.4][] - 2008-05-16
+--------------------
+
+* Default username for finit-alt configurable in Makefile
+* Create loopback device node in finit-alt (for squashfs)
+* Add option to use built-in run-parts instead of `/bin/run-parts`
+* Ignore signal instead of setting to an empty handler (Metalshark)
+* Handle pam_console permissions in finit-alt for Mandriva
+* Add services.sh example and nash-hotplug patch for Mandriva
+* Mount `/proc/bus/usb` in Mandriva
+* Add runtime debug to finit-alt if finit_debug parameter is specified
+* Read configuration from `/etc/finit.conf`
+* Run getty with openvt on the virtual terminal
+
+
+[0.3][] - 2008-02-23
+--------------------
+
+* Change poweroff method to `reboot(RB_POWER_OFF)` (Metalshark)
+* Remove duplicate `unionctl()` reimplementation error
+* Fix string termination in path creation
+* Mount `/var/lock` and `/var/run` as tmpfs
+
+
+[0.2][] - 2008-02-19
+--------------------
+
+* Replace `system("touch")` with `touch()` in finit-mod (Metalshark)
+* Disable `NO_HCTOSYS` by default to match stock Eeepc kernel
+* Drop `system("rm -f")` to clean `/tmp`, its a fresh mounted tmpfs
+* Write ACPI sleep state to `/sys/power/state` instead of
+  `/proc/acpi/sleep` (Metalshark)
+* Use direct calls to set loopback instead of `system("ifconfig")`
+* Replace `system("cat")` and `system("dd")` with C implementation
+* Moved finit-mod and finit-alt helpers to `helpers.c`
+* Replace `system("echo;cat")` to draw shutdown splash with C calls
+
+
+0.1 - 2008-02-14
+----------------
+
+* Initial release
+
+[UNRELEASED]: https://github.com/troglobit/finit/compare/3.1...HEAD
+[4.0]: https://github.com/troglobit/finit/compare/3.1...4.0
+[3.1]: https://github.com/troglobit/finit/compare/3.0...3.1
+[3.0]: https://github.com/troglobit/finit/compare/2.4...3.0
+[2.4]: https://github.com/troglobit/finit/compare/2.3...2.4
+[2.3]: https://github.com/troglobit/finit/compare/2.2...2.3
+[2.2]: https://github.com/troglobit/finit/compare/2.1...2.2
+[2.1]: https://github.com/troglobit/finit/compare/2.0...2.1
+[2.0]: https://github.com/troglobit/finit/compare/1.12...2.0
+[1.12]: https://github.com/troglobit/finit/compare/1.11...1.12
+[1.11]: https://github.com/troglobit/finit/compare/1.10...1.11
+[1.10]: https://github.com/troglobit/finit/compare/1.9...1.10
+[1.9]: https://github.com/troglobit/finit/compare/1.8...1.9
+[1.8]: https://github.com/troglobit/finit/compare/1.7...1.8
+[1.7]: https://github.com/troglobit/finit/compare/1.6...1.7
+[1.6]: https://github.com/troglobit/finit/compare/1.5...1.6
+[1.5]: https://github.com/troglobit/finit/compare/1.4...1.5
+[1.4]: https://github.com/troglobit/finit/compare/1.3...1.4
+[1.3]: https://github.com/troglobit/finit/compare/1.2...1.3
+[1.2]: https://github.com/troglobit/finit/compare/1.1...1.2
+[1.1]: https://github.com/troglobit/finit/compare/1.0...1.1
+[1.0]: https://github.com/troglobit/finit/compare/0.9...1.0
+[0.9]: https://github.com/troglobit/finit/compare/0.8...0.9
+[0.8]: https://github.com/troglobit/finit/compare/0.7...0.8
+[0.7]: https://github.com/troglobit/finit/compare/0.6...0.7
+[0.6]: https://github.com/troglobit/finit/compare/0.5...0.6
+[0.5]: https://github.com/troglobit/finit/compare/0.4...0.5
+[0.4]: https://github.com/troglobit/finit/compare/0.3...0.4
+[0.3]: https://github.com/troglobit/finit/compare/0.2...0.3
+[0.2]: https://github.com/troglobit/finit/compare/0.1...0.2
+[libuEv]: https://github.com/troglobit/libuev
+[dea3ae8]: https://github.com/troglobit/finit/commit/dea3ae8
+
+<!--
+  -- Local Variables:
+  -- mode: markdown
+  -- End:
+  -->

LICENSE

@@ -1,5 +1,5 @@
 Copyright (c) 2008-2010  Claudio Matsuoka <cmatsuoka@gmail.com>
-Copyright (c) 2008-2025  Joachim Wiberg <troglobit@gmail.com>
+Copyright (c) 2008-2021  Joachim Wiberg <troglobit@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Makefile.am

@@ -1,22 +1,7 @@
 ACLOCAL_AMFLAGS    = -I m4
-
+SUBDIRS            = plugins src test
-# libink must precede src in SUBDIRS because finit links against
+doc_DATA           = README.md LICENSE contrib/finit.conf
-# libink at build time.  Automake recurses subdirs strictly in
+EXTRA_DIST         = README.md LICENSE ChangeLog.md contrib/finit.conf
-# declaration order, so the typical "explicit dependency" pattern
-# (foo: bar) doesn't help here — ordering is the only thing that
-# does.  libsystemd is consumed by test/serv only, so its position
-# after src is fine.
-SUBDIRS            = man plugins
-if DBUS
-SUBDIRS           += libink dbus-1
-endif
-SUBDIRS           += src system tmpfiles.d
-
-if KEVENTD
-SUBDIRS           += keventd
-endif
-
-dist_doc_DATA      = README.md LICENSE contrib/finit.conf
 
 if CONTRIB
 SUBDIRS           += contrib
@@ -24,36 +9,39 @@ endif
 if DOC
 SUBDIRS           += doc
 endif
-if LIBSYSTEMD
-SUBDIRS           += libsystemd
-endif
-
-if LIBSYSTEMD
-SUBDIRS           += test
-# Explicit dependency to ensure libsystemd is built before test
-test: libsystemd
-else
-SUBDIRS           += test
-endif
 
 # Compat hook
 install-dev:
 	@make -C src install-pkgincludeHEADERS
 
-# The fuzz target is built by hand with clang (doc/build.md), so it is
-# not in any _PROGRAMS and nothing else would clear it or the corpus
-# it grows.
-distclean-local:
-	-rm -f  $(top_builddir)/fuzz-msg-parse
-	-rm -rf $(top_builddir)/.fuzz-corpus
-
 # Target to run when building a release
 release: distcheck
+	@for file in $(DIST_ARCHIVES); do		\
+		md5sum $$file > ../$$file.md5;		\
+		sha256sum $$file > ../$$file.sha256;	\
+	done
 	@mv $(DIST_ARCHIVES) ../
 	@echo
-	@echo "Resulting release tarball(s): $(DIST_ARCHIVES)"
+	@echo "Resulting release files:"
+	@echo "================================================================="
+	@for file in $(DIST_ARCHIVES); do					\
+		printf "$$file    \tDistribution tarball\n";			\
+		printf "$$file.md5\t";    cat ../$$file.md5    | cut -f1 -d' ';	\
+		printf "$$file.sha256\t"; cat ../$$file.sha256 | cut -f1 -d' ';	\
+	done
 
-DISTCHECK_CONFIGURE_FLAGS = --prefix=/usr --sysconfdir=/etc --localstatedir=/var \
+run:
-			    --enable-testserv-plugin --enable-x11-common-plugin  \
+	srcdir=@srcdir@/test \
-			    --with-fstab=/etc/fstab --with-libsystemd            \
+	top_builddir=@top_builddir@ \
-			    --with-bash-completion-dir=no
+	TENV_ROOT=$(tenv_root) \
+		@srcdir@/test/setup-root.sh
+
+	mkdir -p $(dir $(tenv_root)/@FINIT_CONF@)
+	echo 'tty [12345] @console linux noclear nologin' > $(tenv_root)/@FINIT_CONF@
+
+	-TENV_ROOT=$(tenv_root) \
+	 TESTENV_PATH=@sbindir@:/bin \
+	 FINIT_RCSD=@FINIT_RCSD@ \
+		test/tenv/start.sh finit
+
+run : tenv_root ?= @abs_top_builddir@/run-rootfs

README.md

@@ -1,50 +1,478 @@
-[![License Badge][]][License] [![Release Badge][]][Release] [![GitHub Status][]][GitHub] [![Coverity Status][]][Coverity Scan]
+[![License Badge][]][License] [![Travis Status]][Travis] [![Coverity Status]][Coverity Scan]
-<img align="right" src="doc/img/finit3.png" alt="Finit: Fast Init">
+<img align="right" src="img/finit3.png" alt="Finit: Fast Init">
 
-Finit is a fast, simple alternative to [SysV init](https://en.wikipedia.org/wiki/Init)
+* [Introduction](#introduction)
-and [systemd](https://systemd.io), designed for small and embedded Linux systems.
+* [Features](#features)
-It can also run on desktop and server systems, like [finix][].
+* [Bootstrap](doc/bootstrap.md#bootstrap)
+* [Runlevels](#runlevels)
+* [Syntax](doc/config.md#syntax)
+  * [Runparts & /etc/rc.local](#runparts--etcrclocal)
+  * [Hooks, Callbacks & Plugins](doc/plugins.md#hooks-callbacks--plugins)
+* [Rebooting & Halting](#rebooting--halting)
+* [Commands & Status](#commands--status)
+* [Tips & Tricks with the kernel cmdline](doc/cmdline.md)
+* [Building](doc/build.md#building)
+  * [Running](doc/build.md#running)
+  * [Recovery](doc/build.md#recovery)
+  * [Debugging](doc/build.md#debugging)
+* [Requirements](#requirements)
+* [Origin & References](#origin--references)
 
-> Reverse engineered from the [EeePC fastinit][]  
-> "gaps filled with frog DNA …"  
-> — [Claudio Matsuoka][]
 
-For detailed information, explore our extensive documentation  
+Introduction
-:books: **<http://finit-project.github.io>**
+------------
 
-<div align="center">
+Finit is a simple alternative to [SysV init][4] and [systemd][6].  It
-  <img src="doc/img/alpine-screenshot2.png" alt="Alpine screenshot"><br/>
+was reverse engineered from the [EeePC fastinit][] over ten years ago
-</div>
+by [Claudio Matsuoka][] — "gaps filled with frog DNA …"
 
-For working examples, see the :rocket: [contrib/](contrib/) section or these
+Focus is on small and embedded systems, although Finit is fully usable
-tutorials:
+on server and desktop systems as well.  For working examples, see the
+[contrib/](contrib/) section with tutorials for:
 
-* :hammer_and_wrench: [Buildroot embedded Linux][br2demo],
+  * [Void Linux](contrib/void/),
-* :package: [Debian GNU/Linux](contrib/debian/),
+  * [Alpine Linux](contrib/alpine/), and
-* :mountain: [Alpine Linux](contrib/alpine/), and
+  * [Debian GNU/Linux](contrib/debian/)
-* :milky_way: [Void Linux](contrib/void/)
 
-> [!NOTE]
+![Alpine screenshot](img/alpine-screenshot.png)  
-> Finit can run on various Linux distributions, but the bundled install
+The screenshot shows [Alpine Linux](https://www.alpinelinux.org/).
-> scripts are examples only. They have been tested on amd64 (x86_64) systems
-> with standard configurations.
->
-> For embedded systems, see these [Buildroot][]-based examples:
-> [myLinux][], [Infix][], or [br2-finit-demo][].
 
-[finix]:            https://github.com/finix-community/finix
+
-[Buildroot]:        https://buildroot.org
+Example
-[Infix]:            https://kernelkit.github.io
+-------
-[myLinux]:          https://github.com/troglobit/myLinux/
+
-[br2demo]:          https://troglobit.com/post/2022-12-26-buildroot-demo-of-fastinit-finit/
+This example `/etc/finit.conf` can also be split up in multiple `.conf`
+files in `/etc/finit.d`.  Available, but not yet enabled, services can
+be placed in `/etc/finit.d/available` and enabled by an operator using
+the [initctl](#commands--status) tool.
+
+```ApacheConf
+# Fallback if /etc/hostname is missing
+host default
+
+# Runlevel to start after bootstrap, 'S', default: 2
+runlevel 2
+
+# Max file size for each log file: 100 kiB, rotate max 4 copies:
+# log => log.1 => log.2.gz => log.3.gz => log.4.gz
+log size=100k count=4
+
+# Services to be monitored and respawned as needed
+service [S12345] watchdogd -L -f                 -- System watchdog daemon
+service [S12345] syslogd -n -b 3 -D              -- System log daemon
+service [S12345] <pid/syslogd> klogd -n          -- Kernel log daemon
+service   [2345] lldpd -d -c -M1 -H0 -i          -- LLDP daemon (IEEE 802.1ab)
+
+# The BusyBox ntpd does not use syslog when running in the foreground
+# So we use this trick to redirect stdout/stderr to a log file.  The
+# log file is rotated with the above settings.  The condition declares
+# a dependency on a system default route (gateway) to be set.  A single
+# <!> at the beginning means ntpd does not respect SIGHUP for restart.
+service [2345] log:/var/log/ntpd.log <!net/route/default> ntpd -n -l -I eth0 -- NTP daemon
+
+# For multiple instances of the same service, add :ID somewhere between
+# the service/run/task keyword and the command.
+service :80   [2345] merecat -n -p 80   /var/www -- Web server
+service :8080 [2345] merecat -n -p 8080 /var/www -- Old web server
+
+# Alternative method instead of below runparts, can also use /etc/rc.local
+#task [S] /etc/init.d/keyboard-setup start       -- Setting up preliminary keymap
+#task [S] /etc/init.d/acpid start                -- Starting ACPI Daemon
+#task [S] /etc/init.d/kbd start                  -- Preparing console
+
+# Run start scripts from this directory
+# runparts /etc/start.d
+
+# Virtual consoles run BusyBox getty, keep kernel default speed
+tty [12345] /sbin/getty -L 0 /dev/tty1 linux
+tty [12345] /sbin/getty -L 0 /dev/tty2 linux
+tty [12345] /sbin/getty -L 0 /dev/tty3 linux
+
+# Use built-in getty for serial port and USB serial
+tty [12345] /dev/ttyAMA0 noclear nowait
+tty [12345] /dev/ttyUSB0 noclear
+
+# Just give me a shell, I need to debug this embedded system!
+tty [12345] @console noclear nologin
+```
+
+The `service` stanza, as well as `task`, `run` and others are described
+in full in [doc/config.md](doc/config.md).  Here's a quick overview of
+some of the most common components needed to start a UNIX daemon:
+
+```
+service [LVLS] <COND> log env:[-]/etc/default/daemon daemon ARGS -- Daemon daemon
+^       ^      ^      ^   ^                          ^              ^       ^
+|       |      |      |   |                          |              |        `-- Optional description
+|       |      |      |   |                          |              `----------- Daemon arguments
+|       |      |      |   |                          `-------------------------- Path to daemon
+|       |      |      |    `---------------------------------------------------- Optional env. file
+|       |      |       `-------------------------------------------------------- Redirect output to log
+|       |       `--------------------------------------------------------------- Optional conditions
+|        `---------------------------------------------------------------------- Optional Runlevels
+ `------------------------------------------------------------------------------ Monitored application
+```
+
+Some components are optional: runlevel(s), condition(s) and description,
+making it easy to create simple start scripts and still possible for more
+advanced uses as well:
+
+    service sshd -D
+
+Dependencies are handled using [conditions](doc/conditions.md).  One of
+the most common conditions is to wait for basic networking to become
+available:
+
+    service <net/route/default> nginx -- High performace HTTP server
+
+Here is another example where we instruct Finit to not start BusyBox
+`ntpd` until `syslogd` has started properly.  Finit waits for `syslogd`
+to create its PID file, by default `/var/run/syslogd.pid`.
+
+    service [2345] log <!pid/syslogd> ntpd -n -N -p pool.ntp.org
+    service [S12345] syslogd -n -- Syslog daemon
+
+Notice the `log` keyword, BusyBox `ntpd` uses `stderr` for logging when
+run in the foreground.  With `log` Finit redirects `stdout` + `stderr`
+to the system log daemon using the command line `logger(1)` tool.
+
+A service, or task, can have multiple dependencies listed.  Here we wait
+for *both* `syslogd` to have started and basic networking to be up:
+
+    service [2345] log <pid/syslogd,net/route/default> ntpd -n -N -p pool.ntp.org
+
+If either condition fails, e.g. loss of networking, `ntpd` is stopped
+and as soon as it comes back up again `ntpd` is restarted automatically.
+
+**Note:** Make sure daemons *do not* fork and detach themselves from the
+  controlling TTY, usually an `-n` or `-f` flag, or `-D` as in the case
+  of OpenSSH above.  If it detaches itself, Finit cannot monitor it and
+  will instead try to restart it.
+
+
+Features
+--------
+
+**Process Supervision**
+
+Start, monitor and restart services should they fail.
+
+
+**Getty**
+
+Finit supports external getty but also comes with a limited built-in
+Getty, useful for really small systems.  A getty sets up the TTY and
+waits for user input before handing over to `/bin/login`, which is
+responsible for handling the actual authentication.
+
+```conf
+tty [12345] /dev/tty1    nowait  linux
+tty [12345] /dev/ttyAMA0 noclear vt100
+tty [12345] /sbin/getty  -L /dev/ttyAMA0 vt100
+```
+
+Users of embedded systems may want to enable automatic serial console
+with the special `@console` device.  This works regardless weather the
+system uses `ttyS0`, `ttyAMA0`, `ttyMXC0`, or anything else.  Finit
+figures it out by querying sysfs: `/sys/class/tty/console/active`.
+
+```conf
+tty [12345] @console linux noclear
+```
+
+Notice the optional `noclear`, `nowait`, and `nologin` flags.  The
+latter is for skipping the login process entirely. For more information,
+see [doc/config.md](doc/config.md#syntax).
+
+
+**Runlevels**
+
+Support for SysV init-style [runlevels][5] is available, in the same
+minimal style as everything else in Finit.  The `[2345]` syntax can be
+applied to service, task, run, and TTY stanzas.
+
+Reserved runlevels are 0 and 6, halt and reboot, respectively just like
+SysV init.  Runlevel 1 can be configured freely, but is recommended to
+be kept as the system single-user runlevel since Finit will not start
+networking here.  The configured `runlevel NUM` from `/etc/finit.conf`
+is what Finit changes to after bootstrap, unless 'single' (or 'S') is
+given on the kernel cmdline, in which case runlevel 1 is started.
+
+All services in runlevel S(0) are started first, followed by the desired
+run-time runlevel.  Run tasks in runlevel S can be started in sequence
+by using `run [S] cmd`.  Changing runlevels at runtime is done like any
+other init, e.g. <kbd>init 4</kbd>, but also using the more advanced
+`intictl` tool.
+
+
+**Plugins**
+
+Plugins can *extend* the functionality of Finit and *hook into* the
+different stages of the boot process and at runtime.  Plugins are
+written in C and compiled into a dynamic library loaded automatically by
+finit at boot.  A basic set of plugins are bundled in the `plugins/`
+directory.
+
+Capabilities:
+
+- **Hooks**  
+  Hook into the boot at predefined points to extend Finit
+- **I/O**  
+  Listen to external events and control Finit behavior/services
+
+Extensions and functionality not purely related to what an `/sbin/init`
+needs to start a system are available as a set of plugins that either
+hook into the boot process or respond to various I/O.
+
+For more information, see [doc/plugins.md](doc/plugins.md).
+
+
+**Automatic Reload**
+
+By default, Finit monitors `/etc/finit.d/` and `/etc/finit.d/enabled/`
+registering any changes to `.conf` files.  To activate a change the user
+must call `initctl reload`, which reloads all modified files, stops any
+removed services, starts new ones, and restarts any modified ones, with
+SIGHUP if the process supports it.
+
+For some use-cases the extra step of calling `initctl reload` creates an
+unnecessary overhead, which can be removed at build-time using:
+
+    configure --enable-auto-reload
+
+
+Runparts & /etc/rc.local
+------------------------
+
+At the end of the boot, when all bootstrap (`S`) tasks and services have
+started, but not networking, Finit calls its built-in [run-parts(8)][]
+command on any configured `runparts <DIR>` directory.  This happens just
+before changing to the configured runlevel (default 2).  (Networking is
+enabled just prior to changing from single user mode.)
+
+```shell
+runparts /etc/rc.d/
+```
+
+Right after the runlevel change when all services have started properly,
+`/etc/rc.local` is called.
+
+No configuration stanza in `/etc/finit.conf` is required for `rc.local`.
+If it exists and is an executable shell script Finit calls it at the very
+end of the boot, before calling the `HOOK_SYSTEM_UP`.  See more on hooks
+in [doc/plugins.md](doc/plugins.md#hooks), and about the system bootstrap
+in [doc/bootstrap.md](doc/bootstrap.md).
+
+
+Runlevels
+---------
+
+Basic support for [runlevels][5] is included in Finit from v1.8.  By
+default all services, tasks, run commands and TTYs listed without a set
+of runlevels get a default set `[234]` assigned.  The default runlevel
+after boot is 2.
+
+Finit supports runlevels 0-9, and S, with 0 reserved for halt, 6 reboot
+and S for services to only run at bootstrap.  Runlevel 1 is the single
+user level, where usually no networking is enabled.  In Finit this is
+more of a policy for the user to define.  Normally only runlevels 1-6
+are used, and even more commonly, only the default runlevel is used.
+
+To specify an allowed set of runlevels for a `service`, `run` command,
+`task`, or `tty`, add `[NNN]` to your `/etc/finit.conf`, like this:
+
+```
+service [S12345] syslogd -n -x             -- System log daemon
+run     [S]      /etc/init.d/acpid start   -- Starting ACPI Daemon
+task    [S]      /etc/init.d/kbd start     -- Preparing console
+service [S12345] <pid/syslogd> klogd -n -x -- Kernel log daemon
+
+tty     [12345]  /dev/tty1
+tty     [2]      /dev/tty2
+tty     [2]      /dev/tty3
+tty     [2]      /dev/tty4
+tty     [2]      /dev/tty5
+tty     [2]      /dev/tty6
+```
+
+In this example syslogd is first started, in parallel, and then acpid is
+called using a conventional SysV init script.  It is called with the run
+command, meaning the following task command to start the kbd script is
+not called until the acpid init script has fully completed.  Then the
+keyboard setup script is called in parallel with klogd as a monitored
+service.
+
+Again, tasks and services are started in parallel, while run commands
+are called in the order listed and subsequent commands are not started
+until a run command has completed.  Also, task and run commands are run
+in a shell, so pipes and redirects can be used.
+
+The following examples illustrate this.  Bootstrap task and run commands
+are also removed when they have completed, `initctl show` will not list
+them.
+
+```
+task [S] echo "foo" | cat >/tmp/bar
+run  [S] echo "$HOME" >/tmp/secret
+```
+
+Switching between runlevels can be done by calling init with a single
+argument, e.g. <kbd>init 5</kbd>, or using `initctl runlevel 5`, both
+switch to runlevel 5.  When changing runlevels Finit also automatically
+reloads all `.conf` files in the `/etc/finit.d/` directory.  So if you
+want to set a new system config, switch to runlevel 1, change all config
+files in the system, and touch all `.conf` files in `/etc/finit.d`
+before switching back to the previous runlevel again — that way Finit
+can both stop old services and start any new ones for you, without
+rebooting the system.
+
+
+Rebooting & Halting
+-------------------
+
+Traditionally, rebooting and halting a UNIX system is done by changing
+its runlevel.  Finit comes with its own tooling providing: `shutdown`,
+`reboot`, `poweroff`, and `suspend`, but also the `initctl` tool,
+detailed in the next section.
+
+For compatibility reasons Finit listens to the same set of signals as
+BusyBox init.  This is not 100% compatible with SysV init, but clearly
+the more common combination for Finit.  For more details, see
+[doc/signals.md](doc/signals.md).
+
+
+Commands & Status
+-----------------
+
+Finit also implements a modern API to query status, and start/stop
+services, called `initctl`.  Unlike `telinit` the `initctl` tool does
+not return until the given command has fully completed.
+
+```shell
+~ $ initctl -h
+Usage: initctl [OPTIONS] [COMMAND]
+
+Options:
+  -v, --verbose             Verbose output
+  -h, --help                This help text
+
+Commands:
+  debug                     Toggle Finit (daemon) debug
+  help                      This help text
+  version                   Show Finit version
+  
+  list                      List all .conf in /etc/finit.d/
+  enable   <CONF>           Enable   .conf in /etc/finit.d/available/
+  disable  <CONF>           Disable  .conf in /etc/finit.d/[enabled/]
+  touch    <CONF>           Mark     .conf in /etc/finit.d/ for reload
+  reload                    Reload  *.conf in /etc/finit.d/ (activates changes)
+  
+  cond     show             Show condition status
+  cond     dump             Dump all conditions and their status
+  
+  log      [NAME]           Show ten last Finit, or NAME, messages from syslog
+  start    <JOB|NAME>[:ID]  Start service by job# or name, with optional ID
+  stop     <JOB|NAME>[:ID]  Stop/Pause a running service by job# or name
+  restart  <JOB|NAME>[:ID]  Restart (stop/start) service by job# or name
+  status   <JOB|NAME>[:ID]  Show service status, by job# or name
+  status | show             Show status of services, default command
+  
+  runlevel [0-9]            Show or set runlevel: 0 halt, 6 reboot
+  reboot                    Reboot system
+  halt                      Halt system
+  poweroff                  Halt and power off system
+  
+  utmp     show             Raw dump of UTMP/WTMP db
+```
+
+For services *not* supporting `SIGHUP` the `<!>` notation in the .conf
+file must be used to tell Finit to stop and start it on `reload` and
+`runlevel` changes.  If `<>` holds more [conditions](doc/conditions.md),
+these will also affect how a service is maintained.
+
+**Note:** even though it is possible to start services not belonging in
+the current runlevel these services will not be respawned automatically
+by Finit if they exit (crash).  Hence, if the runlevel is 2, the below
+Dropbear SSH service will not be restarted if it is killed or exits.
+
+```shell
+~ $ initctl status -v
+1       running  476     [S12345]   /sbin/watchdog -T 16 -t 2 -F /dev/watchdog
+2       running  477     [S12345]   /sbin/syslogd -n -b 3 -D
+3       running  478     [S12345]   /sbin/klogd -n
+4:1       inetd  0       [2345]     internal time allow *:37,!eth0
+4:2       inetd  0       [2345]     internal time allow eth0:3737
+5:1       inetd  0       [2345]     /sbin/telnetd allow *:23 deny eth0,eth1
+5:2       inetd  0       [2345]     /sbin/telnetd allow eth0:2323,eth2:2323,eth1:2323
+6:1       inetd  0       [345]      /sbin/dropbear allow eth0:222
+6:2       inetd  0       [345]      /sbin/dropbear allow *:22 deny eth0
+```
+
+
+Requirements
+------------
+
+Finit is capable of running on both desktop/server systems with udev and
+embedded systems that usually come with BusyBox mdev.  Some systems have
+systemd-udev or eudev today instead of the original udev, Finit probes
+for all of them at runtime and expects `/dev/` to be a writable file
+system using `devtmpfs`.  It is also possible to run on a statically set
+up `/dev` if needed.  It is however not a good idea to have both udev
+and mdev installed at the same time, this will lead to unpredictable
+results.
+
+At boot Finit calls either `mdev` or `udevd` to populate `/dev`, this is
+done slightly differently and on systems with udev you might want to add
+the following one-shot task early in your `/etc/finit.conf`:
+
+```conf
+run [S] udevadm settle --timeout=120 -- Waiting for udev
+```
+
+Finit has a built-in Getty for TTYs, but requires a working `/bin/login`
+or `/bin/sh`, if no TTYs are configured in `/etc/finit.conf`.
+
+For a fully operational system `/var`, `/run` and `/tmp` must be set up
+properly in `/etc/fstab` -- which is iterated over at boot.
+
+
+Origin & References
+-------------------
+
+This project is based on the [original finit][] by [Claudio Matsuoka][]
+which was reverse engineered from syscalls of the [EeePC fastinit][] —
+"gaps filled with frog DNA …"
+
+Finit is developed and maintained by [Joachim Wiberg][] at [GitHub][].
+Please file bug reports, clone it, or send pull requests for bug fixes
+and proposed extensions.
+
+
+[1]:  https://en.wikipedia.org/wiki/Process_supervision
+[2]:  http://cr.yp.to/daemontools.html
+[3]:  http://smarden.org/runit/
+[4]:  http://en.wikipedia.org/wiki/Init
+[5]:  http://en.wikipedia.org/wiki/Runlevel
+[6]:  https://www.freedesktop.org/wiki/Software/systemd/
+[9]:  https://github.com/troglobit/troglos
+[RFC862]:           https://tools.ietf.org/html/rfc862
+[RFC863]:           https://tools.ietf.org/html/rfc863
+[RFC864]:           https://tools.ietf.org/html/rfc864
+[RFC867]:           https://tools.ietf.org/html/rfc867
+[RFC868]:           https://tools.ietf.org/html/rfc868
+[init]:             http://en.wikipedia.org/wiki/Init
+[upstart]:          http://upstart.ubuntu.com/
+[systemd]:          http://www.freedesktop.org/wiki/Software/systemd/
+[openrc]:           http://www.gentoo.org/proj/en/base/openrc/
+[run-parts(8)]:     http://manpages.debian.org/cgi-bin/man.cgi?query=run-parts
+[original finit]:   http://helllabs.org/finit/
 [EeePC fastinit]:   https://web.archive.org/web/20071208212450/http://wiki.eeeuser.com/boot_process:the_boot_process
 [Claudio Matsuoka]: https://github.com/cmatsuoka
+[Joachim Wiberg]:   http://troglobit.com
+[GitHub]:           https://github.com/troglobit/finit
 [License]:          https://en.wikipedia.org/wiki/MIT_License
 [License Badge]:    https://img.shields.io/badge/License-MIT-teal.svg
-[Release]:          https://github.com/finit-project/finit/releases
+[Travis]:           https://travis-ci.org/troglobit/finit
-[Release Badge]:    https://img.shields.io/github/v/release/finit-project/finit
+[Travis Status]:    https://travis-ci.org/troglobit/finit.png?branch=master
-[GitHub]:           https://github.com/finit-project/finit/actions/workflows/build.yml/
-[GitHub Status]:    https://github.com/finit-project/finit/actions/workflows/build.yml/badge.svg
 [Coverity Scan]:    https://scan.coverity.com/projects/3545
 [Coverity Status]:  https://scan.coverity.com/projects/3545/badge.svg
-[br2-finit-demo]:   https://github.com/finit-project/br2-finit-demo

configure.ac

@@ -1,28 +1,20 @@
-AC_INIT([Finit], [5.0-rc1], [https://github.com/finit-project/finit/issues],
+AC_INIT(Finit, 4.0-rc1, https://github.com/troglobit/finit/issues, finit, https://troglobit.com/finit.html)
-	[finit], [https://http://finit-project.github.io/])
 AC_CONFIG_AUX_DIR(aux)
-AM_INIT_AUTOMAKE([1.11 foreign subdir-objects])
+AM_INIT_AUTOMAKE([1.11 foreign dist-xz subdir-objects])
 AM_SILENT_RULES([yes])
 
 AC_CONFIG_SRCDIR([src/finit.c])
-AC_CONFIG_HEADERS([config.h])
+AC_CONFIG_HEADER([config.h])
 AC_CONFIG_FILES([Makefile
 	contrib/Makefile
 	contrib/alpine/Makefile contrib/alpine/finit.d/Makefile contrib/alpine/finit.d/available/Makefile
-	contrib/debian/Makefile contrib/debian/finit.d/Makefile contrib/debian/finit.d/available/Makefile
+	contrib/debian/Makefile contrib/debian/finit.d/Makefile contrib/debian/finit.d/available/Makefile contrib/debian/grub.d/Makefile
 	contrib/void/Makefile   contrib/void/finit.d/Makefile   contrib/void/finit.d/available/Makefile
-	doc/Makefile doc/config/Makefile
+	doc/Makefile
-	dbus-1/Makefile
-	libink/Makefile
-	libsystemd/Makefile libsystemd/libsystemd.pc
-	man/Makefile
 	plugins/Makefile
 	src/Makefile
-	keventd/Makefile
+	test/test.env
-	system/Makefile system/10-hotplug.conf
+	test/Makefile])
-	test/test.env test/Makefile
-	test/lib/Makefile test/src/Makefile
-	tmpfiles.d/Makefile])
 
 # Older versions of autoconf (<2.58) do not have AC_CONFIG_MACRO_DIR()
 #m4_include([m4/plugin.m4])
@@ -39,8 +31,9 @@ AC_PROG_INSTALL
 AC_PROG_MKDIR_P
 
 # Configuration.
-AC_CHECK_HEADERS([termios.h sys/ioctl.h mntent.h sys/sysmacros.h])
+AC_HEADER_STDC
-AC_CHECK_FUNCS([strstr getopt getmntent getmntent_r close_range])
+AC_CHECK_HEADERS([fstaby.h termios.h])
+AC_CHECK_FUNCS([strstr getopt getfsenty])
 
 # Check for uint[8,16,32]_t
 AC_TYPE_UINT8_T
@@ -51,61 +44,39 @@ AC_TYPE_UINT32_T
 PKG_PROG_PKG_CONFIG
 
 # Check for required libraries
-PKG_CHECK_MODULES([uev],  [libuev >= 2.4.1])
+PKG_CHECK_MODULES([uev],  [libuev >= 2.2.0])
-PKG_CHECK_MODULES([lite], [libite >= 2.6.1])
+PKG_CHECK_MODULES([lite], [libite >= 2.2.0])
-# 3.3 is the floor: CFGF_KEYSTRVAL, which environment {} and the
-# free-form cgroup keys are built on, does not exist before it.  3.3
-# parses both correctly.  Two workarounds hang off this number, the
-# spurious KEYSTRVAL warning and cfg_parse_buf() losing the file name
-# of a template; grep the XXX notes in src/conf.c before raising it.
-PKG_CHECK_MODULES([confuse], [libconfuse >= 3.3])
 
 # Check for configured Finit features
+AC_ARG_ENABLE(emergency_shell,
+	AS_HELP_STRING([--enable-emergency-shell], [Experimental emergency fallback at boot.
+	                Use only for debugging very early boot problems with Finit]),,[
+	enable_emergency_shell=no])
+
+AC_ARG_ENABLE(fallback_shell,
+        AS_HELP_STRING([--enable-fallback-shell], [Start a shell if no TTYs can start]),,[
+	enable_fallback_shell=no])
+
 AC_ARG_ENABLE(auto_reload,
         AS_HELP_STRING([--enable-auto-reload], [Automatic reload on any .conf change]),,[
 	enable_auto_reload=no])
 
-AC_ARG_ENABLE(kernel_cmdline,
+AC_ARG_ENABLE(watchdog,
-        AS_HELP_STRING([--enable-kernel-cmdline], [Parse init args from /proc/cmdline (don't use!)]),,[
+        AS_HELP_STRING([--enable-watchdog], [Enable built-in watchdog, uses /dev/watchdog]),,[
-	enable_kernel_cmdline=no])
+	enable_watchdog=no])
-
-AC_ARG_ENABLE(fastboot,
-        AS_HELP_STRING([--enable-fastboot], [Skip fsck check on filesystems listed in /etc/fstab]),,[
-	enable_fastboot=no])
-
-AC_ARG_ENABLE(fsckfix,
-        AS_HELP_STRING([--enable-fsckfix], [Run fsck fix mode (options: -yf) on filesystems listed in /etc/fstab]),,[
-	enable_fsckfix=no])
-
-AC_ARG_ENABLE(cgroup,
-        AS_HELP_STRING([--disable-cgroup], [Disable cgroup v2 support, default: autodetect from /sys/fs/cgroup]),,[
-        enable_cgroup=yes])
-
-AC_ARG_ENABLE(libcap,
-        AS_HELP_STRING([--disable-libcap], [Disable Linux capabilities support]),,[
-				enable_libcap=yes])
-
-AC_ARG_ENABLE(pam,
-        AS_HELP_STRING([--disable-pam], [Disable PAM session support for services]),
-        [pam_explicit=yes],
-        [enable_pam=yes])
 
 AC_ARG_ENABLE(redirect,
-        AS_HELP_STRING([--disable-redirect], [Disable redirection of service output to /dev/null]),,[
+        AS_HELP_STRING([--enable-redirect], [Redirect service output to /dev/null, default: no]),,[
-	enable_redirect=yes])
+	enable_redirect_output=no])
 
-AC_ARG_ENABLE(kernel_logging,
+AC_ARG_ENABLE(logit,
-        AS_HELP_STRING([--disable-kernel-logging], [Disable kernel logging to console (use 'quiet' instead!]),,[
+     AS_HELP_STRING([--disable-logit], [Disable logit, used for log redirection, default: enable]),,[
-	enable_kernel_logging=yes])
+     enable_logit=yes])
 
 AC_ARG_ENABLE(logrotate,
-        AS_HELP_STRING([--disable-logrotate], [Disable built-in rotation of /var/log/wtmp]),,[
+        AS_HELP_STRING([--disable-logrotate], [Disable built-in rotation of /var/log/wtmp, default enabled]),,[
 	enable_logrotate=yes])
 
-AC_ARG_ENABLE(dbus,
-        AS_HELP_STRING([--disable-dbus], [Disable D-Bus support (libink + Finit object tree)]),,[
-	enable_dbus=yes])
-
 AC_ARG_ENABLE(doc,
         AS_HELP_STRING([--disable-doc], [Disable build and install of doc/ section]),,[
 	enable_doc=yes])
@@ -114,40 +85,19 @@ AC_ARG_ENABLE(contrib,
         AS_HELP_STRING([--disable-contrib], [Disable build and install of contrib section]),,[
 	enable_contrib=yes])
 
-AC_ARG_ENABLE([rescue],
-	AS_HELP_STRING([--disable-rescue], [Disable potentially unsafe rescue mode]),,
-	[enable_rescue=yes])
-
 # Check for extra plugins to enable
-AC_ARG_ENABLE(all_plugins,
+enable_all_plugins=auto
-    AS_HELP_STRING([--enable-all-plugins], [Enable all plugins, default: auto]),
-	enable_all_plugins=$enableval, enable_all_plugins=auto)
 AC_PLUGIN([alsa-utils],    [no],  [Save and restore ALSA sound settings using alsactl])
-AC_PLUGIN([dbus],          [yes], [Setup and start system message bus, D-Bus])
+AC_PLUGIN([dbus],          [no],  [Setup and start system message bus, D-Bus])
 AC_PLUGIN([modules-load],  [no],  [Scans /etc/modules-load.d for modules to load])
-AC_PLUGIN([modprobe],      [no],  [Coldplug modules using modalias magic])
 AC_PLUGIN([resolvconf],    [no],  [Setup necessary files for resolvconf])
 AC_PLUGIN([x11-common],    [no],  [Console setup (for X)])
 AC_PLUGIN([netlink],       [yes], [Basic netlink plugin for IFUP/IFDN and GW events. Can be replaced with externally built plugin that links with libnl or similar.])
-AC_PLUGIN([hook-scripts],  [no],  [Trigger script execution from hook points])
+AC_PLUGIN([hotplug],       [yes], [Setup and start udev or mdev hotplug daemon])
-AC_PLUGIN([hotplug],       [no],  [Start udevd or mdev kernel event datamon])
-AC_PLUGIN([rtc],           [yes], [Save and restore RTC using hwclock])
-AC_PLUGIN([tty],           [yes], [Automatically activate new TTYs, e.g. USB-to-serial])
-AC_PLUGIN([urandom],       [yes], [Setup and save random seed at boot/shutdown])
-AC_PLUGIN([plymouth],      [no],  [Plymouth boot splash integration])
-AC_PLUGIN([testserv],      [no],  [Test plugin to start test serv daemon])
 
 # Check for extra arguments or packages
-AC_ARG_WITH([bash-completion-dir],
-	AS_HELP_STRING([--with-bash-completion-dir[=PATH]], [Directory to install Bash completion, default: auto]),
-	[bash_dir=$withval], [bash_dir=yes])
-
-AC_ARG_WITH(fstab,
-        AS_HELP_STRING([--with-fstab=FILE], [System default fstab, default $sysconfdir/fstab]),
-	[fstab=$withval], [fstab=yes])
-
 AC_ARG_WITH(heading,
-        AS_HELP_STRING([--with-heading=GREET], [Heading for boot progress. Default: PRETTY_NAME from /etc/os-release, fallback to "Finit vX.YY"]),
+        AS_HELP_STRING([--with-heading=GREET], [Display GREET instead of Finit version at boot]),
 	[heading=$withval], [heading=yes])
 
 AC_ARG_WITH(config,
@@ -166,137 +116,44 @@ AC_ARG_WITH(sysconfig,
         AS_HELP_STRING([--with-sysconfig=DIR], [System environment directory, sourced by .conf files, default /etc/default & /etc/conf.d]),
 	[sysconfig=$withval], [sysconfig=default])
 
-AC_ARG_WITH(group,
-	AS_HELP_STRING([--with-group=NAME], [Group for /run/finit/socket and /run/finit/bus, default: root]),
-	[group=$withval], [group=root])
-
 AC_ARG_WITH(hostname,
         AS_HELP_STRING([--with-hostname=NAME], [If /etc/hostname is missing, default: noname]),
 	[hostname=$withval], [hostname=yes])
 
 AC_ARG_WITH(runlevel,
-        AS_HELP_STRING([--with-runlevel=N], [Runlevel to switch to after bootstrap [1-9], default: 2]),
+        AS_HELP_STRING([--with-runlevel=N], [Runlevel to switch to after bootstrap, default: 2]),
 	[runlevel=$withval], [runlevel=yes])
 
 AC_ARG_WITH(random-seed,
         AS_HELP_STRING([--with-random-seed=FILE], [Save a random seed for /dev/urandom across reboots, default /var/lib/misc/random-seed]),
 	[random_seed=$withval], [random_seed=yes])
 
-AC_ARG_WITH(keventd,
-        AS_HELP_STRING([--with-keventd], [Enable built-in keventd device manager, default: yes]),, [with_keventd=yes])
-
-AC_ARG_WITH(udev-rules,
-        AS_HELP_STRING([--without-udev-rules], [Skip install of curated udev rules under /lib/udev/rules.d, default: yes when keventd enabled]),, [with_udev_rules=yes])
-
-AC_ARG_WITH(sulogin,
-        AS_HELP_STRING([--with-sulogin@<:@=USER@:>@], [Built-in sulogin, optional USER to request password for, default: yes (root)]),[sulogin=$withval],[with_sulogin=yes sulogin=yes])
-
-AC_ARG_WITH(watchdog,
-        AS_HELP_STRING([--with-watchdog@<:@=DEV@:>@], [Built-in watchdog, default: yes (/dev/watchdog)]),
-	[watchdog=$withval], [with_watchdog=yes watchdog=yes])
-
-AC_ARG_WITH(libsystemd,
-        AS_HELP_STRING([--with-libsystemd], [Build replacement libsystemd library, default: no]),
-	[with_libsystemd=$withval], [with_libsystemd=no])
-
-AC_ARG_WITH(hook-scripts-path,
-        AS_HELP_STRING([--with-hook-scripts-path=DIR], [Base directory for hook scripts, default $libexecdir/finit/hook]),
-	[hook_scripts_path=$withval], [hook_scripts_path=yes])
-
-AC_ARG_WITH(plugin-path,
-        AS_HELP_STRING([--with-plugin-path=DIR], [Search path for external plugins, default /usr/lib/finit/plugins:/usr/local/lib/finit/plugins]),
-	[plugin_path=$withval], [plugin_path=yes])
-
-AC_ARG_WITH(rtc-date,
-	AS_HELP_STRING([--with-rtc-date=DATE], [If RTC date/time is too old, restore to DATE, format "YYYY-MM-DD HH:MM:SS", default "2000-01-01 00:00:00"]),
-	[rtc_date=$withval], [rtc_date=no])
-
-AC_ARG_WITH(rtc-file,
-        AS_HELP_STRING([--with-rtc-file=FILE], [If RTC is missing, save and restore system clock from this file, default: no]),
-	[rtc_file=$withval], [rtc_file=no])
-
 ### Enable features ###########################################################################
 
-# Create config.h from selected features and fallback defaults
+# Create config.h from selected features and fallback defautls
+AS_IF([test "x$enable_emergency_shell" = "xyes"], [
+        AC_DEFINE(EMERGENCY_SHELL,  1, [Fork off init and let PID 1 wait and start /bin/sh if init crashes.])])
+
+AS_IF([test "x$enable_fallback_shell" = "xyes"], [
+        AC_DEFINE(FALLBACK_SHELL,  1, [Start /bin/sh on console if no TTYs.])])
+
 AS_IF([test "x$enable_auto_reload" = "xyes"], [
         AC_DEFINE(AUTO_RELOAD, 1, [Finit automatically does `initctl reload` on any .conf change])])
 
-AS_IF([test "x$enable_kernel_cmdline" = "xyes"], [
+AS_IF([test "x$enable_watchdog" = "xyes"], [
-        AC_DEFINE(KERNEL_CMDLINE, 1, [Dumpster diving after init args from /proc/cmdline])])
+        AC_DEFINE(BUILTIN_WATCHDOG,  1, [Enable built-in watchdog, kicks on /dev/watchdog])])
-
-AS_IF([test "x$enable_kernel_logging" = "xyes"], [
-        AC_DEFINE(KERNEL_LOGGING, 1, [Keep kernel warn/err logs to console])])
-
-AS_IF([test "x$enable_cgroup" = "xyes"], [
-        AC_DEFINE(CGROUP2_ENABLED, 1, [Autodetect cgroup v2 support from /sys/fs/cgroup])])
-
-AS_IF([test "x$enable_libcap" = "xyes"], [
-	AC_CHECK_LIB([cap], [cap_from_text], [
-		AC_DEFINE(HAVE_LIBCAP, 1, [Have libcap for Linux capabilities support])
-		LIBS="$LIBS -lcap"
-	], [
-		AC_MSG_WARN([libcap not found, capabilities support disabled])
-		enable_libcap=no
-	])
-])
-
-AS_IF([test "x$enable_pam" = "xyes"], [
-	AS_IF([test "x$enable_static" = "xyes"], [
-		AS_IF([test "x$pam_explicit" = "xyes"], [
-			AC_MSG_ERROR([--enable-pam does not work with --enable-static, PAM dlopen()s its modules])], [
-			AC_MSG_NOTICE([PAM disabled for static build, PAM dlopen()s its modules])
-			enable_pam=no])])
-])
-AS_IF([test "x$enable_pam" = "xyes"], [
-	AC_CHECK_HEADER([security/pam_appl.h], [], [
-		AC_MSG_WARN([PAM headers not found, PAM support disabled])
-		enable_pam=no])
-	AS_IF([test "x$enable_pam" = "xyes"], [
-		AC_CHECK_LIB([pam], [pam_start], [
-			AC_DEFINE(HAVE_LIBPAM, 1, [Have Linux-PAM for per-service session support])
-			LIBS="$LIBS -lpam"
-		], [
-			AC_MSG_WARN([libpam not found, PAM support disabled])
-			enable_pam=no])])
-])
-
-AS_IF([test "x$enable_fastboot" = "xyes"], [
-	AC_DEFINE(FAST_BOOT, 1, [Skip fsck check on filesystems listed in /etc/fstab])])
-
-AS_IF([test "x$enable_fsckfix" = "xyes"], [
-	AC_DEFINE(FSCK_FIX, 1, [Run fsck fix mode (options: -yf) on filesystems listed in /etc/fstab])])
 
 AS_IF([test "x$enable_redirect" = "xyes"], [
 	AC_DEFINE(REDIRECT_OUTPUT, 1, [Enable redirection of service output to /dev/null])])
 
 ### Disable features ###########################################################################
+AS_IF([test "x$enable_logit" != "xno"], [
+	AC_DEFINE(LOGIT_ENABLED,  1, [Enable logit tool, used for log redirection by Finit])])
+
 AS_IF([test "x$enable_logrotate" != "xno"], [
 	AC_DEFINE(LOGROTATE_ENABLED, 1, [Enable built-in rotation of /var/log/wtmp et al.])])
 
-AS_IF([test "x$enable_rescue" != "xno"], [
-	AC_DEFINE([RESCUE_MODE], 1, [Define to enable support for rescue mode.])])
-
-AM_CONDITIONAL(LOGROTATE, [test "x$enable_logrotate" = "xyes"])
-
-AS_IF([test "x$enable_dbus" = "xyes"], [
-	AC_DEFINE(HAVE_DBUS, 1, [Build D-Bus support via libink])])
-AM_CONDITIONAL(DBUS, [test "x$enable_dbus" = "xyes"])
-
-AM_CONDITIONAL(PAM, [test "x$enable_pam" = "xyes"])
-
 ### With features ##############################################################################
-AS_IF([test "x$bash_dir" = "xyes"], [
-	PKG_CHECK_MODULES([BASH_COMPLETION], [bash-completion >= 2.0],
-		[BASH_DIR="$(pkg-config --variable=completionsdir bash-completion)"],
-		[BASH_DIR="$datadir/bash-completion/completions"])], [
-	BASH_DIR="$bash_dir"])
-
-AS_IF([test "x$with_fstab" != "xno"], [
-	AS_IF([test "x$fstab" = "xyes"], [fstab=$sysconfdir/fstab])
-	AC_EXPAND_DIR(fstab_path, "$fstab")
-	AC_DEFINE_UNQUOTED(FINIT_FSTAB, "$fstab_path", [Built-in default: /etc/fstab])],[
-	AC_DEFINE_UNQUOTED(FINIT_FSTAB, NULL, [No built-in default fstab])])
-
 AS_IF([test "x$with_config" != "xno"], [
 	AS_IF([test "x$conf" = "xyes"], [
 		conf=$sysconfdir/finit.conf])])
@@ -312,9 +169,10 @@ AC_DEFINE_UNQUOTED(FINIT_RCSD, "$rcsd_path", [Finit rcS.d/, default /etc/finit.d
 AC_SUBST(FINIT_RCSD, "$rcsd_path")
 
 AS_IF([test "x$with_rc_local" != "xno"], [
-	AS_IF([test "x$rclocal" = "xyes"], [rclocal=$sysconfdir/rc.local])
+	AS_IF([test "x$rclocal" = "xyes"], [
-	AC_EXPAND_DIR(rclocal_path, "$rclocal")
+		rclocal=$sysconfdir/rc.local])])
-	AC_DEFINE_UNQUOTED(FINIT_RC_LOCAL, "$rclocal_path", [Compat SysV /etc/rc.local file to run last at boot.])])
+AC_EXPAND_DIR(rclocal_path, "$rclocal")
+AC_DEFINE_UNQUOTED(FINIT_RC_LOCAL, "$rclocal_path", [Compat SysV /etc/rc.local file to run last at boot.])
 
 AS_IF([test "x$with_sysconfig" != "xno"], [
 	AS_IF([test "x$sysconfig" != "xdefault"], [
@@ -323,13 +181,9 @@ AS_IF([test "x$with_sysconfig" != "xno"], [
 			    [System environment, default /etc/default & /etc/conf.d])])])
 
 AS_IF([test "x$with_heading" != "xno"], [
-	AS_IF([test "x$heading" = "xyes"], [heading=""])
+	AS_IF([test "x$heading" = "xyes"], [
-	AC_DEFINE_UNQUOTED(INIT_OSHEADING, "$heading", [Displayed by Finit at boot, defaults to /etc/os-release PRETTY_NAME])])
+		heading="$PACKAGE_NAME v$PACKAGE_VERSION"])])
-
+AC_DEFINE_UNQUOTED(INIT_HEADING, "$heading", [Displayed by Finit at boot])
-AS_IF([test "x$with_group" != "xno"], [
-	AS_IF([test "x$group" = "xyes"], [
-		group=root])])
-AC_DEFINE_UNQUOTED(DEFGROUP, "$group", [For /run/finit/socket and /run/finit/bus])
 
 AS_IF([test "x$with_hostname" != "xno"], [
 	AS_IF([test "x$hostname" = "xyes"], [
@@ -348,105 +202,30 @@ AS_IF([test "x$with_random_seed" != "xno"], [
 	AC_EXPAND_DIR(random_path, "$random_seed")
 	AC_DEFINE_UNQUOTED(RANDOMSEED, "$random_path", [Improve random at boot by seeding it with sth from before.])])
 
-AS_IF([test "x$rtc_date" != "xno"], [
-	AC_DEFINE_UNQUOTED(RTC_TIMESTAMP_CUSTOM, "$rtc_date", [Custom RTC restore date, default: 2000-01-01 00:00])], [
-	rtc_date=""])
-
-AS_IF([test "x$rtc_file" != "xno"], [
-	AS_IF([test "x$rtc_file" = "xyes"], [
-		rtc_file=/var/lib/misc/rtc])
-	AC_EXPAND_DIR(rtcfile_path, "$rtc_file")
-	AC_DEFINE_UNQUOTED(RTC_FILE, "$rtcfile_path", [Save and restore system time from this file if /dev/rtc is missing.])],[
-	AC_DEFINE_UNQUOTED(RTC_FILE, NULL)])
-
-AS_IF([test "x$with_keventd" != "xno"], [
-	with_keventd=yes
-	PKG_CHECK_MODULES([blkid], [blkid],, [
-		AC_MSG_ERROR([libblkid (util-linux) is required to build keventd.
-		Install the dev package (e.g. libblkid-dev) or disable keventd with --without-keventd])])])
-
-AS_IF([test "x$with_sulogin" != "xno"], [
-	AS_IF([test "x$sulogin" = "xyes"], [
-		sulogin=root])
-	with_sulogin=yes
-        AC_DEFINE_UNQUOTED(SULOGIN_USER, "$sulogin", [Built-in sulogin user, default: root])], [
-	sulogin=])
-
-AS_IF([test "x$with_watchdog" != "xno"], [
-	AS_IF([test "x$watchdog" = "xyes"], [
-		watchdog=/dev/watchdog])
-	with_watchdog=yes
-        AC_DEFINE_UNQUOTED(WDT_DEVNODE, "$watchdog", [Built-in watchdog device node])], [
-	watchdog=])
-
-AS_IF([test "x$with_libsystemd" != "xno"], [
-        AC_DEFINE(HAVE_LIBSYSTEMD, 1, [Build replacement libsystemd library support])])
-
-AS_IF([test "x$enable_hook_scripts_plugin" != "xno"], [
-	AS_IF([test "x$hook_scripts_path" = "xyes"], [hook_scripts_path=$libexecdir/finit/hook])
-	AC_EXPAND_DIR(hook_scripts_path, "$hook_scripts_path")
-	AC_DEFINE_UNQUOTED(PLUGIN_HOOK_SCRIPTS_PATH, "$hook_scripts_path", [Built-in default: $libexecdir/finit])])
-
-AS_IF([test "x$with_plugin_path" != "xno"], [
-	AS_IF([test "x$plugin_path" = "xyes"], [plugin_path=/usr/lib/finit/plugins:/usr/local/lib/finit/plugins])
-	AC_EXPAND_DIR(plugin_path, "$plugin_path")
-	AC_DEFINE_UNQUOTED(EXTERNAL_PLUGIN_PATH, "$plugin_path", [Built-in default: /usr/lib/finit/plugins:/usr/local/lib/finit/plugins])])
-
 # Control build with automake flags
-AM_CONDITIONAL(BASH,        [test "x$bash_dir"        != "xno"])
+AM_CONDITIONAL(STATIC,    [test "x$enable_static" = "xyes"])
-AM_CONDITIONAL(STATIC,      [test "x$enable_static"    = "xyes"])
+AM_CONDITIONAL(WATCHDOGD, [test "x$enable_watchdog" = "xyes"])
-AM_CONDITIONAL(KEVENTD,     [test "x$with_keventd"    != "xno"])
+AM_CONDITIONAL(LOGIT,     [test "x$enable_logit" = "xyes"])
-AM_CONDITIONAL(UDEV_RULES,  [test "x$with_keventd"    != "xno" -a "x$with_udev_rules" != "xno"])
+AM_CONDITIONAL(DOC,       [test "x$enable_doc" = "xyes"])
-AM_CONDITIONAL(SULOGIN,     [test "x$with_sulogin"    != "xno"])
+AM_CONDITIONAL(CONTRIB,   [test "x$enable_contrib" = "xyes"])
-AM_CONDITIONAL(WATCHDOGD,   [test "x$with_watchdog"   != "xno"])
-AM_CONDITIONAL(LIBSYSTEMD,  [test "x$with_libsystemd" != "xno"])
-AM_CONDITIONAL(DOC,         [test "x$enable_doc"       = "xyes"])
-AM_CONDITIONAL(CONTRIB,     [test "x$enable_contrib"   = "xyes"])
-AM_CONDITIONAL(TESTSERV,    [test "x$enable_testserv_plugin" = "xyes"])
-
-# Workaround for as-of-yet unreleased runstatedir support, planned for
-# autoconf 2.70, which some major distros have backported.
-AS_IF([test -z "$runstatedir"], runstatedir="$localstatedir/run")
-AC_SUBST(runstatedir)
 
 # Override default libdir, used for plugins and rescue.conf
 pkglibdir=$libdir/finit
 AC_SUBST(pkglibexecdir)
 AC_EXPAND_DIR(pkglibexecdir, "$libexecdir/finit")
-AC_DEFINE_UNQUOTED(FINIT_EXECPATH_, "$pkglibexecdir", [Finit libexec path])
+AC_DEFINE_UNQUOTED(FINIT_LIBPATH_, "$pkglibexecdir", [Finit libexec path])
-AC_EXPAND_DIR(finit_runpath, "$runstatedir/finit/system")
-AC_DEFINE_UNQUOTED(FINIT_RUNPATH_, "$finit_runpath", [Finit runtime dynamic system services])
 
-AC_EXPAND_DIR(plugin_path, "$pkglibdir/plugins")
+AC_EXPAND_DIR(plugin_path, "$libdir/finit/plugins")
 AC_SUBST(plugin_path)
 AC_DEFINE_UNQUOTED(PLUGIN_PATH, "$plugin_path", [Finit plugin path])
 
-AC_EXPAND_DIR(tmpfiles_path, "$libdir/tmpfiles.d")
+AC_EXPAND_DIR(rescue_conf, "$libdir/finit/rescue.conf")
-AC_SUBST(tmpfiles_path)
-AC_DEFINE_UNQUOTED(TMPFILES_PATH_, "$tmpfiles_path", [Main tmpfiles.d/, override in /etc])
-
-AC_EXPAND_DIR(finit_tmpfiles, "$pkglibdir/tmpfiles.d")
-AC_SUBST(finit_tmpfiles)
-AC_DEFINE_UNQUOTED(FINIT_TMPFILES, "$finit_tmpfiles", [Finit tmpfiles.d/ .conf path])
-
-AC_EXPAND_DIR(system_path, "$pkglibdir/system")
-AC_SUBST(system_path)
-AC_DEFINE_UNQUOTED(FINIT_SYSPATH_, "$system_path", [Static services, previously generated at runtime by plugins])
-
-AC_EXPAND_DIR(rescue_conf, "$pkglibdir/rescue.conf")
 AC_DEFINE_UNQUOTED(RESCUE_CONF, "$rescue_conf", [Finit rescue mode .conf])
-AC_EXPAND_DIR(sample_conf, "$pkglibdir/sample.conf")
+AC_EXPAND_DIR(sample_conf, "$libdir/finit/sample.conf")
 AC_DEFINE_UNQUOTED(SAMPLE_CONF, "$sample_conf", [Finit sameple.conf for initctl create])
 
-AC_EXPAND_DIR(bash_completion_dir, "$BASH_DIR")
+AC_EXPAND_DIR(path_stdpath, "$sbindir:$bindir:/usr/sbin:/usr/bin:/sbin:/bin")
-AC_SUBST(BASH_DIR, "$bash_completion_dir")
+AC_DEFINE_UNQUOTED(_PATH_STDPATH, "$path_stdpath", [Default PATH])
-
-AS_IF([test "$heading" = ""],   [heading="<DEFAULT>"])
-AS_IF([test "$heading" = "no"], [heading="<NONE>"])
-
-RTC_DATE=$rtc_date
-AS_IF([test "$rtc_date" = ""],   [RTC_DATE="<DEFAULT>"])
-AS_IF([test "$rtc_date" = "no"], [RTC_DATE="<DEFAULT>"])
 
 # Generate all files
 AC_OUTPUT
@@ -455,16 +234,14 @@ cat <<EOF
 
 ------------------ Summary ------------------
  $PACKAGE_NAME version $PACKAGE_VERSION
-  Prefix................: $(eval echo $prefix)
+  Prefix................: $prefix
-  Exec prefix...........: $(eval echo $exec_prefix)
+  Exec prefix...........: `eval echo $exec_prefix`
-  Libdir................: $(eval echo $libdir)
   Sysconfdir............: `eval echo $sysconfdir`
   Localstatedir.........: `eval echo $localstatedir`
-  Default fstab.........: `eval echo $fstab`
   Finit config file.....: $conf_path
   Finit config.d path...: $rcsd_path
   Finit plugin path.....: $plugin_path
-  Compat rc.local path..: `eval echo $rclocal`
+  Compat rc.local path..: $rclocal_path
   System environment....: ${sysconfig_path:-${sysconfig}}
   Random seed path......: $random_path
   C Compiler............: $CC $CFLAGS $CPPFLAGS $LDFLAGS $LIBS
@@ -473,30 +250,16 @@ cat <<EOF
 Behavior:
   Boot heading..........: $heading
   Plugins...............: $plugins
-  RTC restore date......: $RTC_DATE
-  RTC fallback file.....: $rtc_file
 
 Optional features:
   Install doc/..........: $enable_doc
   Install contrib/......: $enable_contrib
-  Bash completion.......: $bash_completion_dir
+  Built-in watchdogd....: $enable_watchdog
-  Built-in keventd......: $with_keventd (blkid: $blkid_LIBS)
-  Built-in sulogin......: $with_sulogin $sulogin
-  Built-in watchdogd....: $with_watchdog $watchdog
   Built-in logrotate....: $enable_logrotate
-  D-Bus support (libink): $enable_dbus
+  Scripting tool logit..: $enable_logit
-  Replacement libsystemd: $with_libsystemd
+  Emergency shell.......: $enable_emergency_shell
-  Use cgroup v2.........: $enable_cgroup
+  Fallback shell........: $enable_fallback_shell
-  Use libcap............: $enable_libcap
-  Use PAM...............: $enable_pam
-  Parse kernel cmdline..: $enable_kernel_cmdline
-  Keep kernel logging...: $enable_kernel_logging
-  Skip fsck check.......: $enable_fastboot
-  Run fsck fix mode.....: $enable_fsckfix
-  Redirect output.......: $enable_redirect
-  Rescue mode...........: $enable_rescue
   Default hostname......: $hostname
-  Default group.........: $group
   Default runlevel......: $runlevel
 
 ------------- Compiler version --------------

contrib/Makefile.am

@@ -3,8 +3,3 @@ bin_SCRIPT = service
 docsdir   := @docdir@/contrib
 docs_DATA  = README.md finit.conf procmon.sh
 EXTRA_DIST = $(docs_DATA)
-
-if BASH
-bashdir            = $(BASH_DIR)
-dist_bash_DATA     = initctl
-endif

contrib/README.md

@@ -6,7 +6,6 @@ install and try out Finit on various Linux distributions.
 
 * [Alpine](alpine/)
 * [Debian](debian/)
-* [Void](void/)
 
 If you have ideas on how to simplify, extend, or even add new example
 configurations for other distributions you are most welcome! :)

contrib/alpine/Makefile.am

@@ -1,5 +1,5 @@
 SUBDIRS    = finit.d
 docsdir   := @docdir@/contrib/alpine
-docs_DATA  = README.md finit.conf build.sh install.sh rc.local
+docs_DATA  = README.md finit.conf alpine-release build.sh install.sh rc.local
 EXTRA_DIST = $(docs_DATA)
 

contrib/alpine/README.md

@@ -1,8 +1,5 @@
-HowTo: Finit on Alpine Linux 3.4...3.19
+HowTo: Finit on Alpine Linux 3.4-3.6
-=======================================
+====================================
-
-> [!TIP]
-> https://troglobit.com/post/2021-02-12-alpine-linux-with-finit/
 
 HowTo use Finit to boot an [Alpine Linux][] system.  It is assumed that
 the user has already installed make, a compiler, C library header files,

contrib/alpine/alpine-release

@@ -0,0 +1 @@
+3.6.2

contrib/alpine/build.sh

@@ -17,8 +17,8 @@ PKG_CONFIG_LIBDIR=/usr/lib/pkgconfig:/usr/local/lib/pkgconfig ./configure	\
 		 --prefix=/usr			--exec-prefix=			\
 		 --sysconfdir=/etc		--localstatedir=/var		\
 		 --enable-dbus-plugin		--enable-x11-common-plugin	\
-		 --enable-alsa-utils-plugin	--without-watchdog		\
+		 --enable-alsa-utils-plugin	--enable-watchdog		\
-		 --with-keventd			--with-sulogin
+		 --with-heading="Alpine Linux 3.13"
 
 echo
 echo "*** Building ..."
@@ -35,3 +35,4 @@ fi
 echo
 echo "*** Done"
 echo
+

contrib/alpine/finit.conf

@@ -3,34 +3,8 @@
 
 ## Runlevel to start after bootstrap, runlevel 'S'
 # Default is 2
-#runlevel = 2
+#runlevel 2
-
-# Top-level cgroups and their default settings.  All groups mandatory
-# but more can be added, max 8 groups in total currently.  The cgroup
-# 'root' is also available, reserved for RT processes.  Settings are
-# as-is, only one shorthand 'mem.' exists, other than that it's the
-# cgroup v2 controller default names.
-#cgroup init   { cpu.weight = 100  }
-#cgroup user   { cpu.weight = 100  }
-#cgroup system { cpu.weight = 9700 }
-
-# Task to run if ctrl-alt-del is pressed.  This condition is asserted by
-# Finit upon receiving SIGINT (from the kernel).
-#task reboot {
-#	description = "Rebooting system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/key/ctrlaltdel" }
-#	command     = "initctl reboot"
-#}
-
-# Task to run if the kernel gets a power fail condition is pressed.
-# Asserted by Finit upon receiving SIGPWR (from the kernel).
-#task poweroff {
-#	description = "Shutting down system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/pwr/fail" }
-#	command     = "initctl poweroff"
-#}
 
 ## Bootstrap services and tasks
 # Can be listed here or in /etc/finit.d/*.conf
+

contrib/alpine/finit.d/Makefile.am

@@ -1,7 +1,8 @@
 SUBDIRS    = available
 docsdir   := @docdir@/contrib/alpine/finit.d
 d_LINKS    = acpid.conf crond.conf dropbear.conf getty.conf	\
-	     keymap.conf modules.conf ntpd.conf syslogd.conf
+	     keymap.conf modules.conf ntpd.conf			\
+	     klogd.conf syslogd.conf
 
 install-exec-hook:
 	@$(MKDIR_P) $(DESTDIR)$(docsdir)/available

contrib/alpine/finit.d/available/Makefile.am

@@ -1,4 +1,5 @@
 docsdir   := @docdir@/contrib/alpine/finit.d/available
 docs_DATA  = acpid.conf crond.conf dropbear.conf getty.conf keymap.conf	\
-             lxdm.conf modules.conf ntpd.conf syslogd.conf watchdog.conf
+             lxdm.conf modules.conf ntpd.conf klogd.conf syslog.conf	\
+	     watchdog.conf
 EXTRA_DIST = $(docs_DATA)

contrib/alpine/finit.d/available/acpid.conf

@@ -1,9 +1,3 @@
 # Handle PWR button to shutdown/reboot -- useful in Qemu (virt-manager)
 # Depends on syslogd having started. Redirect any output to log.
-service acpid {
+service [2345] <pid/syslogd> log acpid -f -- ACPI daemon
-	description = "ACPI daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	log { }
-	command     = "acpid -f"
-}

contrib/alpine/finit.d/available/crond.conf

@@ -1,7 +1 @@
-service crond {
+service [2345] <pid/syslogd> env:-/etc/conf.d/crond crond -f -S $CRON_OPTS -- Cron daemon
-	description = "Cron daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	envfile     = "-/etc/conf.d/crond"
-	command     = "crond -f -S $CRON_OPTS"
-}

contrib/alpine/finit.d/available/dropbear.conf

@@ -1,7 +1,2 @@
 # Start SSH daemon as soon as basic networking comes up
-service dropbear {
+service [2345] env:-/etc/conf.d/dropbear dropbear -R -F $DROPBEAR_OPTS -- Dropbear SSH daemon
-	description = "Dropbear SSH daemon"
-	runlevel    = "2345"
-	envfile     = "-/etc/conf.d/dropbear"
-	command     = "dropbear -R -F $DROPBEAR_OPTS"
-}

contrib/alpine/finit.d/available/getty.conf

@@ -1,24 +1,4 @@
 # Consoles to start getty on when system is up
-tty ttyS0 {
+tty [12345] /dev/tty1 noclear nowait
-	runlevel = "12345"
+tty [2345]  /dev/tty2 noclear nowait
-	device   = "/dev/ttyS0"
+tty [2345]  /dev/tty3 noclear nowait
-	noclear  = true
-}
-tty tty1 {
-	runlevel = "12345"
-	device   = "/dev/tty1"
-	noclear  = true
-	nowait   = true
-}
-tty tty2 {
-	runlevel = "2345"
-	device   = "/dev/tty2"
-	noclear  = true
-	nowait   = true
-}
-tty tty3 {
-	runlevel = "2345"
-	device   = "/dev/tty3"
-	noclear  = true
-	nowait   = true
-}

contrib/alpine/finit.d/available/keymap.conf

@@ -1,7 +1,2 @@
 # Oneshot task to run once at bootstrap
-task keymap {
+task [S] env:/etc/conf.d/loadkmap zcat $KEYMAP | loadkmap -- Loading keymap
-	description = "Loading keymap"
-	runlevel    = "S"
-	envfile     = "/etc/conf.d/loadkmap"
-	command     = "zcat $KEYMAP | loadkmap"
-}

contrib/alpine/finit.d/available/klogd.conf

@@ -0,0 +1,2 @@
+# Start klogd as soon as possible, after syslogd, should always run
+service [S12345] <pid/syslogd> env:-/etc/conf.d/klogd klogd -n $KLOGD_OPTS -- Kernel log daemon

contrib/alpine/finit.d/available/lxdm.conf

@@ -1,5 +1 @@
-service lxdm {
+service [2345] lxdm -- Lightweight Login Manager
-	description = "Lightweight Login Manager"
-	runlevel    = "2345"
-	command     = "lxdm"
-}

contrib/alpine/finit.d/available/modules.conf

@@ -1,2 +1,6 @@
 ## Linux kernel modules to load
-#modules = { "fbcon", "button", "evdev", "mousedev", "8139cp", "softdog" }
+#module fbcon
+#module button
+#module evdev
+#module mousedev
+#module 8139cp

contrib/alpine/finit.d/available/ntpd.conf

@@ -1,9 +1,2 @@
 # Busybox ntpd has no option to use syslog when running in foreground
-service ntpd {
+service [2345] <pid/syslogd> env:-/etc/conf.d/ntpd log ntpd -n $NTPD_OPTS -- NTP daemon
-	description = "NTP daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	envfile     = "-/etc/conf.d/ntpd"
-	log { }
-	command     = "ntpd -n $NTPD_OPTS"
-}

contrib/alpine/finit.d/available/syslog.conf

@@ -0,0 +1,2 @@
+# Start syslogd as soon as possible, should always run
+service [S12345] env:-/etc/conf.d/syslog syslogd -n $SYSLOGD_OPTS -- Syslog daemon

contrib/alpine/finit.d/available/syslogd.conf

@@ -1,15 +0,0 @@
-# Start syslogd as soon as possible, should always run
-# Start klogd as soon as possible, but after syslogd
-service syslogd {
-	description = "Syslog daemon"
-	runlevel    = "S12345"
-	envfile     = "-/etc/conf.d/syslog"
-	command     = "syslogd -n $SYSLOGD_OPTS"
-}
-service klogd {
-	description = "Kernel log daemon"
-	runlevel    = "S12345"
-	conditions  = { "pid/syslogd" }
-	envfile     = "-/etc/conf.d/klogd"
-	command     = "klogd -n $KLOGD_OPTS"
-}

contrib/alpine/finit.d/available/watchdog.conf

@@ -1,6 +1 @@
-service watchdog {
+service [S123456789] env:-/etc/conf.d/watchdog watchdog $WATCHDOG_OPTS $WATCHDOG_DEV -- System watchdog
-	description = "System watchdog"
-	runlevel    = "S123456789"
-	envfile     = "-/etc/conf.d/watchdog"
-	command     = "watchdog $WATCHDOG_OPTS $WATCHDOG_DEV"
-}

contrib/alpine/install.sh

@@ -1,53 +1,44 @@
 #!/bin/sh
 
-if [ "$(id -u)" != "0" ]; then
+if [ "x`id -u`" != "x0" ]; then
-    printf "\n\e[1m*** This script must run as root\e[0m\n\n"
+    echo
+    echo "*** This script must run as root"
+    echo
     exit 1
 fi
 
-# shellcheck disable=SC3037,SC3045,SC2154
-yorn()
-{
-    printf "\e[1m> %s (y/N)?\e[0m " "$*"
-    read -rn1 yorn
-    echo
-
-    if [ "$yorn" = "y" ] || [ "$yorn" = "Y" ]; then
-	return 0
-    fi
-
-    return 1
-}
-
 # Adjust base directory
-if grep -q contrib/alpine Makefile 2>/dev/null; then
+if [ -e alpine-release ]; then
     cd ../..
-fi
+elif [ ! -e autogen.sh ]; then
-
+    echo "*** Please run this script from the Finit base directory."
-if [ ! -e configure.ac ]; then
-    printf "\n\e[1m*** Please run this script from the Finit base directory.\e[0m\n"
     exit 1
 fi
 
-printf "\n\e[1mInstall Finit on Alpine Linux\n"
+echo
-printf "========================================================================\e[0m\n"
+echo "*** Install Finit on Alpine Linux"
-printf "/sbin/finit           - PID 1\n"
+echo "========================================================================"
-printf "/lib/finit/plugins/*  - All enabled Finit plugins\n"
+echo "/sbin/finit           - PID 1"
-printf "/etc/finit.conf       - Finit configuration file\n"
+echo "/lib/finit/plugins/*  - All enabled Finit plugins"
-printf "/etc/finit.d/         - Finit services\n"
+echo "/etc/finit.conf       - Finit configuration file"
+echo "/etc/finit.d/         - Finit services"
+echo
+read -p "Do you want to continue (y/N)? " yorn
 
-if yorn "Do you want to continue"; then
+if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
-    printf "\n\e[1m*** Installing Finit files ...\e[0m\n"
+    echo
+    echo "*** Installing Finit files ..."
     make install
-    cd /usr/share/doc/finit/contrib/alpine || exit 1
+    cd /usr/share/doc/finit/contrib/alpine
     for file in finit.conf rc.local; do
 	install -vbD $file /etc/$file
     done
     cp -va finit.d /etc/
 
-    if yorn "Install Finit as the system default Init"; then
+    read -p "*** Install Finit as the system default Init (y/N)? " yorn
-	printf "\e[1m*** Updating /sbin/init symlink --> finit ...\e[0m\n"
+    if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
-	cd /sbin || exit 1
+	echo "*** Updating /sbin/init symlink --> finit ..."
+	cd /sbin
 	rm init
 	ln -s finit init
 
@@ -56,8 +47,10 @@ if yorn "Do you want to continue"; then
 	ln -s reboot shutdown
 	ln -s reboot suspend
     fi
-    printf "\n\e[1m*** Done\e[0m\n"
+    echo "*** Done"
     echo
 else
-    printf "\n\e[1m*** Aborting install.\e[0m\n\n"
+    echo
+    echo "*** Aborting install."
+    echo
 fi

contrib/alpine/rc.local

@@ -4,5 +4,5 @@
 #
 # Each line is run in sequence.
 #
-# NOTE: Remember to set the executable bit!
+# NOTE: Remeber to set the executable bit!
 #

contrib/debian/Makefile.am

@@ -1,4 +1,4 @@
-SUBDIRS    = finit.d
+SUBDIRS    = finit.d grub.d
 docsdir   := @docdir@/contrib/debian
-docs_DATA  = README.md finit.conf build.sh install.sh
+docs_DATA  = README.md finit.conf os-release build.sh install.sh
 EXTRA_DIST = $(docs_DATA)

contrib/debian/README.md

@@ -20,44 +20,29 @@ tools pre-systemd work as intended.
 
     root@debian:~# apt install initscripts console-setup
 
-> [!TIP]
-> As of Debian 11 (Bullseye), libuev and libite are part of the main
-> section of Debian.  So just install the -dev packages :)
-
 The following script can then be used to configure, build, install and
 set up your system to run Finit:
 
     user@debian:~/finit$ contrib/debian/build.sh
 
 However, since `/sbin/init` already exists on your system, the script
-creates another entry in your GRUB config by updating `$SUPPORTED_INITS`
+creates another entry in your GRUB config, in `/etc/grub.d/40_custom`,
-in `/etc/grub.d/10_inux` and run `update-grub`.  On reboot you will find
+where `init=/sbin/finit` is added to your kernel line.  It is of course
-a (finit) entry in the "Advanced options for Debian GNU/Linux" section.
+also possible to change the default init to Finit, if you do you can
-It is of course also possible to change the default init to Finit:
+remove the custom Grub entry:
 
     user@debian:~/finit# cd /sbin
-    user@debian:/sbin# sudo mv init oldinit
+    user@debian:/sbin# sudo rm init
     user@debian:/sbin# sudo ln -s finit init
 
 Before rebooting, check the default [/etc/finit.conf](finit.conf) and
 `/etc/finit.d/*.conf` files.  The build + install script above provides
-a few sample `.conf` files.  See `initctl ls` after boot for a list of
+a few sample `.conf` files. See `initctl list` after boot for a list of
-enabled and available services, you can then use `enable` and `disable`
+enabled and available services.
-comands to `initctl`, followed by `reload` to activate your changes.
 
 You can also use a standard [/etc/rc.local](rc.local) for one-shot tasks
 and initialization like keyboard language etc.
 
-> [!NOTE]
-> For the X Window system, you may need to `sudo apt install elogind`
-> (Bullseye and later), followed by `initctl reload` to activate it (it
-> is enabled by default), and logout/login again.  The elogind daemon
-> ensures a regular non-root user can start and interact with an X
-> session, otherwise keyboard and mouse won't work.  When you're happy,
-> you can enable the lightdm.conf, change the default runlevel to 3, and
-> presto!  you have a desktop again.
-
-
 Have fun!  
  /Joachim ツ
 

contrib/debian/build.sh

@@ -25,8 +25,9 @@ echo
     --prefix=/usr                     --exec-prefix=			\
     --sysconfdir=/etc                 --localstatedir=/var		\
     --enable-dbus-plugin              --enable-x11-common-plugin	\
-    --enable-alsa-utils-plugin	      --with-keventd			\
+    --enable-alsa-utils-plugin						\
-    --with-random-seed=/var/lib/urandom/random-seed
+    --with-random-seed=/var/lib/urandom/random-seed			\
+    --with-heading="Debian GNU/Linux"
 
 if [ $? -ne 0 ]; then
     echo
@@ -59,3 +60,6 @@ else
     echo "*** Use 'sudo contrib/debian/install.sh' later to install Finit"
     echo
 fi
+
+
+    

contrib/debian/finit.conf

@@ -3,34 +3,8 @@
 
 ## Runlevel to start after bootstrap, runlevel 'S'
 # Default is 2
-#runlevel = 2
+#runlevel 2
-
-# Top-level cgroups and their default settings.  All groups mandatory
-# but more can be added, max 8 groups in total currently.  The cgroup
-# 'root' is also available, reserved for RT processes.  Settings are
-# as-is, only one shorthand 'mem.' exists, other than that it's the
-# cgroup v2 controller default names.
-#cgroup init   { cpu.weight = 100  }
-#cgroup user   { cpu.weight = 100  }
-#cgroup system { cpu.weight = 9700 }
-
-# Task to run if ctrl-alt-del is pressed.  This condition is asserted by
-# Finit upon receiving SIGINT (from the kernel).
-#task reboot {
-#	description = "Rebooting system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/key/ctrlaltdel" }
-#	command     = "initctl reboot"
-#}
-
-# Task to run if the kernel gets a power fail condition is pressed.
-# Asserted by Finit upon receiving SIGPWR (from the kernel).
-#task poweroff {
-#	description = "Shutting down system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/pwr/fail" }
-#	command     = "initctl poweroff"
-#}
 
 ## Bootstrap services and tasks
 # Can be listed here or in /etc/finit.d/*.conf
+

contrib/debian/finit.d/Makefile.am

@@ -1,9 +1,7 @@
 SUBDIRS    = available
 docsdir   := @docdir@/contrib/debian/finit.d
-d_LINKS    = acpid.conf apparmor.conf avahi-daemon.conf		\
+d_LINKS    = console-setup.conf getty.conf keyboard-setup.conf	\
-	     bluetooth.conf console-setup.conf elogind.conf 	\
+	     modules.conf rsyslogd.conf sshd.conf
-	     getty.conf keyboard-setup.conf modules.conf	\
-	     plymouth-quit.conf rsyslogd.conf sshd.conf
 
 install-exec-hook:
 	@$(MKDIR_P) $(DESTDIR)$(docsdir)/available

contrib/debian/finit.d/available/Makefile.am

@@ -1,8 +1,5 @@
 docsdir   := @docdir@/contrib/debian/finit.d/available
-docs_DATA  = acpid.conf apparmor.conf avahi-daemon.conf bluetooth.conf	\
+docs_DATA  = acpid.conf console-setup.conf getty.conf keyboard-setup.conf \
-	     console-setup.conf elogind.conf getty.conf			\
+	     lightdm.conf modules.conf rsyslogd.conf sntpd.conf		  \
-	     keyboard-setup.conf lightdm.conf modules.conf sntpd.conf	\
+	     sshd.conf syslogd.conf xdm.conf
-	     plymouth-quit.conf rsyslogd.conf sshd.conf syslogd.conf	\
-	     xdm.conf
 EXTRA_DIST = $(docs_DATA)
-

contrib/debian/finit.d/available/acpid.conf

@@ -1,10 +1,3 @@
 # Handle PWR button to shutdown/reboot -- useful in Qemu (virt-manager)
 # Depends on a syslog daemon having started. Redirect any output to log.
-service acpid {
+service [2345] <pid/syslogd> env:-/etc/default/acpid log acpid -f $OPTIONS -- ACPI daemon
-	description = "ACPI daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	envfile     = "-/etc/default/acpid"
-	log { }
-	command     = "acpid -f $OPTIONS"
-}

contrib/debian/finit.d/available/anacron.conf

@@ -1,8 +0,0 @@
-task anacron {
-	description = "Anacron jobs"
-	runlevel    = "2345"
-	conditions  = { "sys/pwr/ac", "pid/syslogd" }
-	envfile     = "-/etc/default/anacron"
-	stop-signal = "usr1"
-	command     = "anacron -d -q $ANACRON_ARGS"
-}

contrib/debian/finit.d/available/apparmor.conf

@@ -1,6 +0,0 @@
-sysv apparmor {
-	description = "AppArmor initialization"
-	runlevel    = "S"
-	command     = "/etc/init.d/apparmor"
-}
-

contrib/debian/finit.d/available/avahi-daemon.conf

@@ -1,6 +0,0 @@
-service avahi-daemon {
-	description = "Avahi mDNS/DNS-SD Stack"
-	runlevel    = "2345"
-	envfile     = "-/etc/default/avahi-daemon"
-	command     = "avahi-daemon -s $AVAHI_DAEMON_OPTS"
-}

contrib/debian/finit.d/available/bluetooth.conf

@@ -1,9 +0,0 @@
-# To ignore errors like "org.freedesktop.hostname1", update the env file with
-# "--noplugin=hostname", i.e. append to BLUETOOTHD_OPTS
-service bluetoothd {
-	description = "Bluetooth service"
-	runlevel    = "2345"
-	envfile     = "-/etc/default/bluetooth"
-	log { file = "/dev/null" }
-	command     = "/usr/libexec/bluetooth/bluetoothd -n $BLUETOOTHD_OPTS"
-}

contrib/debian/finit.d/available/console-setup.conf

@@ -1,6 +1,2 @@
 # Oneshot task to run once at bootstrap
-task console-setup {
+task [S] /lib/console-setup/console-setup.sh -- Setting up console font and keymap
-	description = "Setting up console font and keymap"
-	runlevel    = "S"
-	command     = "/lib/console-setup/console-setup.sh"
-}

contrib/debian/finit.d/available/cron.conf

@@ -1,7 +0,0 @@
-service cron {
-	description = "Background job processing daemon"
-	runlevel    = "2345"
-	conditions  = { "sys/pwr/ac", "pid/syslogd" }
-	envfile     = "-/etc/default/cron"
-	command     = "cron -f $EXTRA_OPTS"
-}

contrib/debian/finit.d/available/elogind.conf

@@ -1,9 +0,0 @@
-# On some systems, bootstrap can be really quick and cause elogind
-# to not start before a user has managed to log in.  To prevent
-# this, add <pid/elogind> as condition to your TTYs in getty.conf
-service elogind {
-	description = "Login manager"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	command     = "/usr/libexec/elogind"
-}

contrib/debian/finit.d/available/getty.conf

@@ -1,38 +1,4 @@
 # Consoles to start getty on when system is up
-tty tty1 {
+tty [12345] /dev/tty1 linux noclear nowait
-	runlevel = "12345"
+tty [2345]  /dev/tty2 linux noclear nowait
-	device   = "/dev/tty1"
+tty [2345]  /dev/tty3 linux noclear nowait
-	term     = "linux"
-	noclear  = true
-	nowait   = true
-}
-tty tty2 {
-	runlevel = "2345"
-	device   = "/dev/tty2"
-	term     = "linux"
-	nowait   = true
-}
-tty tty3 {
-	runlevel = "2345"
-	device   = "/dev/tty3"
-	term     = "linux"
-	nowait   = true
-}
-tty tty4 {
-	runlevel = "2345"
-	device   = "/dev/tty4"
-	term     = "linux"
-	nowait   = true
-}
-tty tty5 {
-	runlevel = "2345"
-	device   = "/dev/tty5"
-	term     = "linux"
-	nowait   = true
-}
-tty tty6 {
-	runlevel = "2345"
-	device   = "/dev/tty6"
-	term     = "linux"
-	nowait   = true
-}

contrib/debian/finit.d/available/keyboard-setup.conf

@@ -1,6 +1,2 @@
 # Oneshot task to run once at bootstrap
-task keyboard-setup {
+task [S] /lib/console-setup/keyboard-setup.sh -- Setting up console keyboard layout
-	description = "Setting up console keyboard layout"
-	runlevel    = "S"
-	command     = "/lib/console-setup/keyboard-setup.sh"
-}

contrib/debian/finit.d/available/lightdm.conf

@@ -1,5 +1 @@
-service lightdm {
+service [3] lightdm -- Light Display Manager
-	description = "Light Display Manager"
-	runlevel    = "3"
-	command     = "lightdm"
-}

contrib/debian/finit.d/available/modules.conf

@@ -1,2 +1,8 @@
 ## Linux kernel modules to load
-#modules = { "fbcon", "button", "evdev", "loop", "psmouse", "mousedev", "8139cp" }
+#module fbcon
+#module button
+#module evdev
+#module loop
+#module psmouse
+#module mousedev
+#module 8139cp

contrib/debian/finit.d/available/plymouth-quit.conf

@@ -1,6 +0,0 @@
-# Need to stop plymouth, or it'll block stdin on tty1
-task plymouth {
-	description = "Stopping Plymouth Boot Screen"
-	runlevel    = "S"
-	command     = "/usr/bin/plymouth quit"
-}

contrib/debian/finit.d/available/rsyslogd.conf

@@ -1,8 +1,3 @@
 # Start rsyslogd as soon as possible, should always run
 # Provides pid/syslogd condition
-service syslogd {
+service [S12345] name:syslogd env:-/etc/default/rsyslog rsyslogd -n $RSYSLOGD_OPTIONS -- Reliable syslog daemon
-	description = "Reliable syslog daemon"
-	runlevel    = "S12345"
-	envfile     = "-/etc/default/rsyslog"
-	command     = "rsyslogd -n $RSYSLOGD_OPTIONS"
-}

contrib/debian/finit.d/available/sntpd.conf

@@ -1,8 +1,2 @@
 # Simple NTP client (SNTP)
-service sntpd {
+service [2345] <net/route/default> env:-/etc/default/sntpd sntpd -n $SNTPD_OPTIONS -- SNTP client
-	description = "SNTP client"
-	runlevel    = "2345"
-	conditions  = { "net/route/default" }
-	envfile     = "-/etc/default/sntpd"
-	command     = "sntpd -n $SNTPD_OPTIONS"
-}

contrib/debian/finit.d/available/sshd.conf

@@ -1,8 +1,2 @@
 # Start SSH daemon as soon as basic networking comes up
-service sshd {
+service [2345] <net/lo/up> env:-/etc/default/ssh /usr/sbin/sshd -D $SSHD_OPTS -- OpenSSH daemon
-	description = "OpenSSH daemon"
-	runlevel    = "2345"
-	conditions  = { "net/lo/up" }
-	envfile     = "-/etc/default/ssh"
-	command     = "/usr/sbin/sshd -D $SSHD_OPTS"
-}

contrib/debian/finit.d/available/syslogd.conf

@@ -1,7 +1,2 @@
 # Start sysklogd as soon as possible, should always run if enabled
-service syslogd {
+service [S123456789] env:-/etc/default/syslogd syslogd -F $SYSLOGD_OPTIONS -- System logging daemon
-	description = "System logging daemon"
-	runlevel    = "S123456789"
-	envfile     = "-/etc/default/syslogd"
-	command     = "syslogd -F $SYSLOGD_OPTIONS"
-}

contrib/debian/finit.d/available/xdm.conf

@@ -1,8 +1,4 @@
 # Here we use XDM since it has few dependencies (relatively speaking).
 # It is also an example of a service without a -- description.
 # service [3] lxdm -- Lightweight Login Manager
-service xdm {
+service [3] xdm -nodaemon -- X Display Manager
-	description = "X Display Manager"
-	runlevel    = "3"
-	command     = "xdm -nodaemon"
-}

contrib/debian/grub.d/40_custom

@@ -0,0 +1,14 @@
+#!/bin/sh
+exec tail -n +3 $0
+# This file provides an easy way to add custom menu entries.  Simply type the
+# menu entries you want to add after this comment.  Be careful not to change
+# the 'exec tail' line above.
+
+menuentry '$MENU with Finit' --class $TYPE --class gnu-linux --class gnu --class os --user {
+	insmod gzio
+	insmod part_msdos
+	insmod ext2
+	search --no-floppy --fs-uuid --set=root $BOOT
+	linux	/vmlinuz root=UUID=$ROOT ro quiet init=/sbin/finit
+	initrd	/initrd.img
+}

contrib/debian/grub.d/Makefile.am

@@ -0,0 +1,3 @@
+docsdir   := @docdir@/contrib/debian/grub.d
+docs_DATA  = 40_custom
+EXTRA_DIST = $(docs_DATA)

contrib/debian/install.sh

@@ -8,10 +8,10 @@ if [ "x`id -u`" != "x0" ]; then
 fi
 
 # Adjust base directory
-grep -q debian Makefile 2>/dev/null
+grep -q Debian os-release 2>/dev/null
 if [ $? -eq 0 ]; then
     cd ../..
-elif [ ! -e configure.ac ]; then
+elif [ ! -e autogen.sh ]; then
     echo "*** Please run this script from the Finit base directory."
     exit 1
 fi
@@ -23,7 +23,7 @@ echo "/sbin/finit           - PID 1"
 echo "/lib/finit/plugins/*  - All enabled Finit plugins"
 echo "/etc/finit.conf       - Finit configuration file"
 echo "/etc/finit.d/         - Finit services"
-echo "/etc/grub.d/10_linux  - Add Finit to Grub's SUPPORTED_INITS"
+echo "/etc/grub.d/40_custom - Add menu entry to the Grub boot loader"
 echo
 read -p "Do you want to continue (y/N)? " yorn
 echo
@@ -38,18 +38,12 @@ if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
     cp -va finit.d /etc/
 
     echo "*** Setting up a GRUB boot entry ..."
-    fn=/etc/grub.d/10_linux
+    MENU=`grep gnu-linux /boot/grub/grub.cfg |head -1 |sed "s/menuentry '\([^']*\).*/\1/"`
-    if [ -e $fn ]; then
+    TYPE=`grep gnu-linux /boot/grub/grub.cfg |head -1 |sed "s/.*' --class \([a-z]*\).*/\1/"`
-	if `grep SUPPORTED_INITS $fn |head -1 |grep -q finit`; then
+    BOOT=`grep set=root /boot/grub/grub.cfg |head -1 |sed 's/.* \([a-f0-9]*-[a-f0-9]*-[a-f0-9]*-[a-f0-9]*-[a-f0-9]*\).*/\1/'`
-	    echo "Already installed, done."
+    ROOT=`grep root=UUID /boot/grub/grub.cfg |head -1 |sed 's/.*UUID=\([a-f0-9]*-[a-f0-9]*-[a-f0-9]*-[a-f0-9]*-[a-f0-9]*\).*/\1/'`
-	else
+    cat grub.d/40_custom | sed "s,\$BOOT,$BOOT,;s,\$ROOT,$ROOT,;s,\$TYPE,$TYPE,;s,\$MENU,$MENU," >/etc/grub.d/40_custom
-	    echo "Adding Finit to list of SUPPORTED_INITS ..."
+    update-grub
-	    sed -i 's/SUPPORTED_INITS="[^"]*/& finit:\/sbin\/finit/' $fn
-	    update-grub
-	fi
-    else
-	echo "Cannot find $fn, you'll have to set up your bootloader on your own."
-    fi
 
     echo
     echo "*** Done"

contrib/debian/os-release

@@ -0,0 +1,8 @@
+PRETTY_NAME="Debian GNU/Linux 8 (jessie)"
+NAME="Debian GNU/Linux"
+VERSION_ID="8"
+VERSION="8 (jessie)"
+ID=debian
+HOME_URL="http://www.debian.org/"
+SUPPORT_URL="http://www.debian.org/support"
+BUG_REPORT_URL="https://bugs.debian.org/"

contrib/finit.conf

@@ -1,149 +1,50 @@
 # Sample finit.conf to demonstrate the syntax
 #
-hostname = "testbed"
+host testbed
 
 # Linux kernel modules to load
-modules = { "button", "evdev", "loop", "psmouse" }
+module button
-
+module evdev
-# Top-level cgroups and their default settings.  All groups mandatory
+module loop
-# but more can be added, max 8 groups in total currently.  The cgroup
+module psmouse
-# 'root' is also available, reserved for RT processes.  Settings are
-# as-is, only one shorthand 'mem.' exists, other than that it's the
-# cgroup v2 controller default names.
-cgroup init   { cpu.weight = 100 }
-cgroup user   { cpu.weight = 100 }
-cgroup system { cpu.weight = 9700  cpu.max = 50000 }
-
-# Example extra cgroup
-cgroup maint  { cpu.weight = 100 }
 
 # Runlevel to start after bootstrap, runlevel 'S'
-runlevel = 2
+runlevel 2
 
 # Network bringup script
-network = "service networking start"
+network service networking start
 
 # Max file size for each log file: 100 kiB, rotate max 4 copies:
 # log => log.1 => log.2.gz => log.3.gz => log.4.gz
-log {
+log size=100k count=4
-	size  = 100k
-	count = 4
-}
 
 # Virtual consoles to start getty on
-tty tty1 { device = "/dev/tty1" }
+tty /dev/tty1
-tty tty2 { device = "/dev/tty2" }
+tty /dev/tty2
-tty tty3 { device = "/dev/tty3" }
+tty /dev/tty3
-
-# Task to run if ctrl-alt-del is pressed.  This condition is asserted by
-# Finit upon receiving SIGINT (from the kernel).
-task reboot {
-	description = "Rebooting system"
-	runlevel    = "12345789"
-	conditions  = { "sys/key/ctrlaltdel" }
-	command     = "initctl reboot"
-}
-
-# Task to run if the kernel gets a power fail condition is pressed.
-# Asserted by Finit upon receiving SIGPWR (from the kernel).
-task poweroff {
-	description = "Shutting down system"
-	runlevel    = "12345789"
-	conditions  = { "sys/pwr/fail" }
-	command     = "initctl poweroff"
-}
 
 # Alternative method instead of runparts
-#task keyboard-setup {
+#task [S] /etc/init.d/keyboard-setup start -- Setting up preliminary keymap
-#	description = "Setting up preliminary keymap"
+#task [S] /etc/init.d/acpid start          -- Starting ACPI Daemon
-#	runlevel    = "S"
+#task [S] /etc/init.d/kbd start            -- Preparing console
-#	command     = "/etc/init.d/keyboard-setup start"
+#run [2] /etc/init.d/networking start      -- Start networking
-#}
-#task acpid {
-#	description = "Starting ACPI Daemon"
-#	runlevel    = "S"
-#	command     = "/etc/init.d/acpid start"
-#}
-#task kbd {
-#	description = "Preparing console"
-#	runlevel    = "S"
-#	command     = "/etc/init.d/kbd start"
-#}
-#run networking {
-#	description = "Start networking"
-#	runlevel    = "2"
-#	command     = "/etc/init.d/networking start"
-#}
 
 # Services to be monitored and respawned as needed
-
+service [2345] <pid/syslogd> klogd -n     -- Kernel logging server
-# klogd and syslogd are placed in the maint cgroup.  There is no
+service [2345] syslogd -n                 -- Syslog server
-# "current cgroup" to switch in this format, every block names its own.
+service [3]    gdm                        -- GNOME Display Manager
-service klogd {
-	description = "Kernel logging server"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	cgroup maint {}
-	command     = "klogd -n"
-}
-service syslogd {
-	description = "Syslog server"
-	runlevel    = "2345"
-	cgroup maint {}
-	command     = "syslogd -n"
-}
-
-# gdm gets its own limits inside the system group, which is where
-# services end up when no cgroup block is given.
-service gdm {
-	description = "GNOME Display Manager"
-	runlevel    = "3"
-	cgroup system {
-		cpu.weight = 250
-		memory.max = 10M
-	}
-	command     = "gdm"
-}
-
-# Start SSH daemon with opts from /etc/default/ssh (if available), move
-# to user cgroup with cpu.weight 250.  Default weight in the user group
-# is 100 (above).
-service sshd {
-	description = "OpenSSH daemon"
-	runlevel    = "2345"
-	envfile     = "-/etc/default/ssh"
-	cgroup user {
-		cpu.weight = 250
-		memory.max = 10M
-	}
-	command     = "/usr/sbin/sshd -D $SSHD_OPTS"
-}
 
 # The BusyBox ntpd does not use syslog when running in the foreground
 # So we use this trick to redirect stdout/stderr to a log file.  The
 # log file is rotated with the above settings.  The condition declares
-# a dependency on a system default route (gateway) to be set.  ntpd
+# a dependency on a system default route (gateway) to be set.  A single
-# does not respect SIGHUP, so Finit restarts it on reload instead.
+# <!> at the beginning means ntpd does not respect SIGHUP for restart.
-service ntpd {
+service [2345] <!net/route/default> log:/var/log/ntpd.log ntpd -n -l -I eth0 -- NTP daemon
-	description   = "NTP daemon"
-	runlevel      = "2345"
-	conditions    = { "net/route/default" }
-	reload-signal = "none"
-	log { file = "/var/log/ntpd.log" }
-	command       = "ntpd -n -l -I eth0"
-}
 
 # Run start scripts from this directory
-#runparts = "/etc/start.d"
+# runparts /etc/start.d
 
-# For multiple instances of the same service, add :ID to the block title.
+# For multiple instances of the same service, add :ID somewhere between
-service httpd:80 {
+# the service/run/task keyword and the command.
-	description = "Web server"
+service :80   [2345] /sbin/httpd -f -h /http -p 80   -- Web server
-	runlevel    = "2345"
+service :8080 [2345] /sbin/httpd -f -h /http -p 8080 -- Old web server
-	command     = "/sbin/httpd -f -h /http -p 80"
-}
-service httpd:8080 {
-	description = "Old web server"
-	runlevel    = "2345"
-	command     = "/sbin/httpd -f -h /http -p 8080"
-}

contrib/initctl

@@ -1,141 +0,0 @@
-_cond()
-{
-    initctl -pt cond dump |  awk '{print $4}' | sed 's/<\(.*\)>/\1/'
-}
-
-_ident()
-{
-    if [ -n "$1" ]; then
-	initctl ident | grep -q $1
-    else
-	initctl ident
-    fi
-}
-
-_svc()
-{
-    initctl ls -pt | grep $1 | sed "s/.*\/\(.*\)/\1/g" | sort -u
-}
-
-_enabled()
-{
-    echo "$(_svc enabled)"
-}
-
-_available()
-{
-    all=$(mktemp)
-    ena=$(mktemp)
-    echo "$(_svc available)" >$all
-    echo "$(_svc enabled)"   >$ena
-    grep -v -f $ena $all
-    rm $all $ena
-}
-
-# Determine first non-option word. Usually the command
-_firstword() {
-	local firstword i
-
-	firstword=
-	for ((i = 1; i < ${#COMP_WORDS[@]}; ++i)); do
-		if [[ ${COMP_WORDS[i]} != -* ]]; then
-			firstword=${COMP_WORDS[i]}
-			break
-		fi
-	done
-
-	echo $firstword
-}
-
-# Determine last non-option word. Uusally a sub-command
-_lastword() {
-	local lastword i
-
-	lastword=
-	for ((i = 1; i < ${#COMP_WORDS[@]}; ++i)); do
-		if [[ ${COMP_WORDS[i]} != -* ]] && [[ -n ${COMP_WORDS[i]} ]] && [[ ${COMP_WORDS[i]} != $cur ]]; then
-			lastword=${COMP_WORDS[i]}
-		fi
-	done
-
-	echo $lastword
-}
-
-_initctl()
-{
-    local cur command
-
-    cur=${COMP_WORDS[COMP_CWORD]}
-    prev="${COMP_WORDS[COMP_CWORD-1]}"
-    firstword=$(_firstword)
-    lastword=$(_lastword)
-
-    commands="status cond debug help kill ls log version  list enable	\
-	      disable touch show cat edit create delete reload start	\
-	      stop restart signal cgroup ps top plugins runlevel reboot	\
-	      halt poweroff suspend utmp"
-    cond_cmds="set get clear status dump"
-    cond_types="hook net pid service task usr"
-    signals="int term hup stop tstp cont usr1 usr2 pwr"
-    options="-b --batch				\
-	     -c --create			\
-	     -d --debug				\
-	     -f --force				\
-	     -h --help				\
-	     -j --json				\
-	     -n --noerr				\
-	     -1 --once				\
-	     -p --plain				\
-	     -q --quiet				\
-	     -t --no-heading			\
-	     -v --verbose			\
-	     -V --version"
-
-    case "${firstword}" in
-	enable)
-	    COMPREPLY=($(compgen -W "$(_available)" -- $cur))
-	    ;;
-	disable|touch)
-	    COMPREPLY=($(compgen -W "$(_enabled)" -- $cur))
-	    ;;
-	show|cat|edit|delete)
-	    COMPREPLY=($(compgen -W "$(_svc .)" -- $cur))
-	    ;;
-	start|stop|restart|log|status)
-	    COMPREPLY=($(compgen -W "$(_ident)" -- $cur))
-	    ;;
-	signal|kill)
-	    if $(_ident "${prev}"); then
-		COMPREPLY=($(compgen -W "$signals" -- $cur))
-	    else
-		COMPREPLY=($(compgen -W "$(_ident)" -- $cur))
-	    fi
-	    ;;
-	cond)
-	    case "${lastword}" in
-		set|clear)
-		    compopt -o nospace
-		    COMPREPLY=($(compgen -W "usr/" -- $cur))
-		    ;;
-		get)
-		    COMPREPLY=($(compgen -W "$(_cond)" -- $cur))
-		    ;;
-		dump)
-		    COMPREPLY=($(compgen -W "$cond_types" -- $cur))
-		    ;;
-		*)
-		    COMPREPLY=($(compgen -W "$cond_cmds" -- $cur))
-		    ;;
-	    esac
-	    ;;
-	*)
-	    COMPREPLY=($(compgen -W "$commands" -- $cur))
-	    ;;
-    esac
-
-    if [[ $cur == -* ]]; then
-	COMPREPLY=($(compgen -W "$options" -- $cur))
-    fi
-}
-
-complete -F _initctl initctl

contrib/patches/linux-4.9-inotify-in-mask-create.patch

@@ -1,75 +0,0 @@
-In Finit issue #196 we were reminded [1] of a missing inotify flag in
-Linux older kernels, IN_MASK_CREATE.  Finit makes use of this internally
-for monitoring PID conditions, and more.  This is a central mechanism to
-synchronize services at boot and reload at runtime.
-
-The following patch for Linux 4.9.0, was provided by Andy Savage for
-other people that may want to run Finit on slightly older kernels.
-
-[1]: https://github.com/troglobit/finit/issues/196
-
-Index: fs/notify/inotify/inotify_user.c
-===================================================================
---- fs.orig/notify/inotify/inotify_user.c
-+++ fs/notify/inotify/inotify_user.c
-@@ -522,6 +522,7 @@ static int inotify_update_existing_watch
- 	__u32 old_mask, new_mask;
- 	__u32 mask;
- 	int add = (arg & IN_MASK_ADD);
-+	int create = (arg & IN_MASK_CREATE);
- 	int ret;
-
- 	mask = inotify_arg_to_mask(arg);
-@@ -529,6 +530,8 @@ static int inotify_update_existing_watch
- 	fsn_mark = fsnotify_find_inode_mark(group, inode);
- 	if (!fsn_mark)
- 		return -ENOENT;
-+	else if (create)
-+		return -EEXIST;
-
- 	i_mark = container_of(fsn_mark, struct inotify_inode_mark, fsn_mark);
-
-@@ -726,6 +729,10 @@ SYSCALL_DEFINE3(inotify_add_watch, int,
- 	if (unlikely(!f.file))
- 		return -EBADF;
-
-+	/* IN_MASK_ADD and IN_MASK_CREATE don't make sense together */
-+	if (unlikely((mask & IN_MASK_ADD) && (mask & IN_MASK_CREATE)))
-+		return -EINVAL;
-+
- 	/* verify that this is indeed an inotify instance */
- 	if (unlikely(f.file->f_op != &inotify_fops)) {
- 		ret = -EINVAL;
-@@ -814,7 +821,7 @@ static int __init inotify_user_setup(voi
- 	BUILD_BUG_ON(IN_ISDIR != FS_ISDIR);
- 	BUILD_BUG_ON(IN_ONESHOT != FS_IN_ONESHOT);
-
--	BUG_ON(hweight32(ALL_INOTIFY_BITS) != 21);
-+	BUG_ON(hweight32(ALL_INOTIFY_BITS) != 22);
-
- 	inotify_inode_mark_cachep = KMEM_CACHE(inotify_inode_mark, SLAB_PANIC);
-
-Index: include/linux/inotify.h
-===================================================================
---- include.orig/linux/inotify.h
-+++ include/linux/inotify.h
-@@ -17,6 +17,6 @@ extern struct ctl_table inotify_table[];
- 			  IN_DELETE_SELF | IN_MOVE_SELF | IN_UNMOUNT | \
- 			  IN_Q_OVERFLOW | IN_IGNORED | IN_ONLYDIR | \
- 			  IN_DONT_FOLLOW | IN_EXCL_UNLINK | IN_MASK_ADD | \
--			  IN_ISDIR | IN_ONESHOT)
-+			  IN_MASK_CREATE | IN_ISDIR | IN_ONESHOT)
-
- #endif	/* _LINUX_INOTIFY_H */
-Index: include/uapi/linux/inotify.h
-===================================================================
---- include.orig/uapi/linux/inotify.h
-+++ include/uapi/linux/inotify.h
-@@ -52,6 +52,7 @@ struct inotify_event {
- #define IN_ONLYDIR		0x01000000	/* only watch the path if it is a directory */
- #define IN_DONT_FOLLOW		0x02000000	/* don't follow a sym link */
- #define IN_EXCL_UNLINK		0x04000000	/* exclude events on unlinked objects */
-+#define IN_MASK_CREATE		0x10000000	/* only create watches */
- #define IN_MASK_ADD		0x20000000	/* add to the mask of an already existing watch */
- #define IN_ISDIR		0x40000000	/* event occurred against dir */
- #define IN_ONESHOT		0x80000000	/* only send event once */

contrib/void/Makefile.am

@@ -1,4 +1,4 @@
 SUBDIRS    = finit.d
 docsdir   := @docdir@/contrib/void
-docs_DATA  = README.md finit.conf build.sh install.sh rc.local
+docs_DATA  = README.md finit.conf build.sh install.sh rc.local xbps
 EXTRA_DIST = $(docs_DATA)

contrib/void/build.sh

@@ -17,8 +17,8 @@ PKG_CONFIG_LIBDIR=/usr/lib/pkgconfig:/usr/local/lib/pkgconfig ./configure	\
 		 --prefix=/usr                  --exec-prefix=			\
 		 --sysconfdir=/etc              --localstatedir=/var		\
                  --enable-dbus-plugin           --enable-x11-common-plugin	\
-		 --enable-alsa-utils-plugin	--with-watchdog			\
+		 --enable-alsa-utils-plugin	--enable-watchdog		\
-		 --with-keventd			--with-sulogin
+		 --with-heading="Void Linux"
 
 echo
 echo "*** Building ..."
@@ -35,3 +35,4 @@ fi
 echo
 echo "*** Done"
 echo
+

contrib/void/finit.conf

@@ -3,34 +3,7 @@
 
 ## Runlevel to start after bootstrap, runlevel 'S'
 # Default is 2
-#runlevel = 2
+#runlevel 2
-
-# Top-level cgroups and their default settings.  All groups mandatory
-# but more can be added, max 8 groups in total currently.  The cgroup
-# 'root' is also available, reserved for RT processes.  Settings are
-# as-is, only one shorthand 'mem.' exists, other than that it's the
-# cgroup v2 controller default names.
-#cgroup init   { cpu.weight = 100  }
-#cgroup user   { cpu.weight = 100  }
-#cgroup system { cpu.weight = 9700 }
-
-# Task to run if ctrl-alt-del is pressed.  This condition is asserted by
-# Finit upon receiving SIGINT (from the kernel).
-#task reboot {
-#	description = "Rebooting system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/key/ctrlaltdel" }
-#	command     = "initctl reboot"
-#}
-
-# Task to run if the kernel gets a power fail condition is pressed.
-# Asserted by Finit upon receiving SIGPWR (from the kernel).
-#task poweroff {
-#	description = "Shutting down system"
-#	runlevel    = "12345789"
-#	conditions  = { "sys/pwr/fail" }
-#	command     = "initctl poweroff"
-#}
 
 ## Bootstrap services and tasks
 # Can be listed here or in /etc/finit.d/*.conf

contrib/void/finit.d/available/Makefile.am

@@ -1,5 +1,5 @@
 docsdir   := @docdir@/contrib/void/finit.d/available
 docs_DATA  = acpid.conf crond.conf dhcpcd.conf dmeventd.conf getty.conf	\
-             keymap.conf lxdm.conf modules.conf ntpd.conf		\
+             keymap.conf klogd.conf lxdm.conf modules.conf ntpd.conf	\
-             sshd.conf syslog.conf uuidd.conf
+             sshd.conf syslogd.conf uuidd.conf
 EXTRA_DIST = $(docs_DATA)

contrib/void/finit.d/available/acpid.conf

@@ -1,7 +1,3 @@
 # Handle PWR button to shutdown/reboot -- useful in Qemu (virt-manager)
 # Depends on syslogd having started. Redirect any output to log.
-service acpid {
+service [2345] acpid -f -- ACPI daemon
-	description = "ACPI daemon"
-	runlevel    = "2345"
-	command     = "acpid -f"
-}

contrib/void/finit.d/available/crond.conf

@@ -1,6 +1 @@
-service crond {
+service [2345] <pid/syslogd> crond -f -S -c /etc/crontabs -- Cron daemon
-	description = "Cron daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	command     = "crond -f -S -c /etc/crontabs"
-}

contrib/void/finit.d/available/dhcpcd.conf

@@ -1,5 +1 @@
-service dhcpcd {
+service [2345] dhcpcd -B -M -- DHCP client
-	description = "DHCP client"
-	runlevel    = "2345"
-	command     = "dhcpcd -B -M"
-}

contrib/void/finit.d/available/dmeventd.conf

@@ -1,5 +1 @@
-service dmeventd {
+service [S12345] dmeventd -f -- Device mapper event daemon
-	description = "Device mapper event daemon"
-	runlevel    = "S12345"
-	command     = "dmeventd -f"
-}

contrib/void/finit.d/available/getty.conf

@@ -1,19 +1,4 @@
 # Consoles to start Finit built-in getty on when system is up
-tty tty1 {
+tty [12345] /dev/tty1 noclear nowait
-	runlevel = "12345"
+tty [2345]  /dev/tty2 noclear nowait
-	device   = "/dev/tty1"
+tty [2345]  /dev/tty3 noclear nowait
-	noclear  = true
-	nowait   = true
-}
-tty tty2 {
-	runlevel = "2345"
-	device   = "/dev/tty2"
-	noclear  = true
-	nowait   = true
-}
-tty tty3 {
-	runlevel = "2345"
-	device   = "/dev/tty3"
-	noclear  = true
-	nowait   = true
-}

contrib/void/finit.d/available/keymap.conf

@@ -1,6 +1,2 @@
 # Oneshot task to run once at bootstrap
-task keymap {
+task [S] zcat /etc/keymap/se.bmap.gz | loadkmap -- Loading keymap
-	description = "Loading keymap"
-	runlevel    = "S"
-	command     = "zcat /etc/keymap/se.bmap.gz | loadkmap"
-}

contrib/void/finit.d/available/klogd.conf

@@ -0,0 +1,2 @@
+# Start klogd as soon as possible, should always run
+service [S12345] <pid/syslogd> klogd -n -- Kernel log daemon

contrib/void/finit.d/available/lxdm.conf

@@ -1,5 +1 @@
-service lxdm {
+service [2345] lxdm -- Lightweight Login Manager
-	description = "Lightweight Login Manager"
-	runlevel    = "2345"
-	command     = "lxdm"
-}

contrib/void/finit.d/available/modules.conf

@@ -1,3 +1,6 @@
 ## Linux kernel modules to load
-# Other candidates: fbcon, button, evdev, mousedev, 8139cp
+#module fbcon
-modules = { "softdog" }
+#module button
+#module evdev
+#module mousedev
+#module 8139cp

contrib/void/finit.d/available/ntpd.conf

@@ -1,8 +1,2 @@
 # Silly Busybox ntpd has no option to use syslog when running in foreground
-service ntpd {
+service [2345] <pid/syslogd> log ntpd -n -N -p pool.ntp.org -- NTP daemon
-	description = "NTP daemon"
-	runlevel    = "2345"
-	conditions  = { "pid/syslogd" }
-	log { }
-	command     = "ntpd -n -N -p pool.ntp.org"
-}

contrib/void/finit.d/available/sshd.conf

@@ -1,6 +1,2 @@
 # Start SSH daemon as soon as basic networking comes up
-service sshd {
+service [2345] /usr/sbin/sshd -D -- OpenSSH daemon
-	description = "OpenSSH daemon"
-	runlevel    = "2345"
-	command     = "/usr/sbin/sshd -D"
-}

contrib/void/finit.d/available/syslog.conf

@@ -1,13 +0,0 @@
-# Start syslogd as soon as possible, should always run
-# Start klogd as soon as possible, but after syslogd
-service syslogd {
-	description = "Syslog daemon"
-	runlevel    = "S12345"
-	command     = "syslogd -n"
-}
-service klogd {
-	description = "Kernel log daemon"
-	runlevel    = "S12345"
-	conditions  = { "pid/syslogd" }
-	command     = "klogd -n"
-}

contrib/void/finit.d/available/syslogd.conf

@@ -0,0 +1,2 @@
+# Start syslogd as soon as possible, should always run
+service [S12345] syslogd -n -- Syslog daemon

contrib/void/finit.d/available/uuidd.conf

@@ -1,7 +1 @@
-service uuidd {
+service @uuidd:uuidd [2345] uuidd -F -- UUID generation daemon
-	description = "UUID generation daemon"
-	runlevel    = "2345"
-	user        = "uuidd"
-	group       = "uuidd"
-	command     = "uuidd -F"
-}

contrib/void/install.sh

@@ -8,10 +8,9 @@ if [ "x`id -u`" != "x0" ]; then
 fi
 
 # Adjust base directory
-grep -q void Makefile 2>/dev/null
+if [ -e xbps ]; then
-if [ $? -eq 0 ]; then
     cd ../..
-elif [ ! -e configure.ac ]; then
+elif [ ! -e autogen.sh ]; then
     echo "*** Please run this script from the Finit base directory."
     exit 1
 fi

contrib/void/rc.local

@@ -4,4 +4,4 @@
 #
 # Each line is run in sequence.
 #
-# NOTE: Remember to set the executable bit!
+# NOTE: Remeber to set the executable bit!

dbus-1/.gitignore

@@ -1,2 +0,0 @@
-/Makefile
-/Makefile.in

dbus-1/Makefile.am

@@ -1,6 +0,0 @@
-EXTRA_DIST          = org.finit.conf
-
-if DBUS
-dbuspolicydir       = $(datadir)/dbus-1/system.d
-dist_dbuspolicy_DATA = org.finit.conf
-endif

dbus-1/org.finit.conf

@@ -1,63 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE busconfig PUBLIC
- "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
- "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
-<!--
-  System-bus policy for finit.
-
-  finit (PID 1, root) owns the `org.finit` well-known name.  The
-  policy below lets unprivileged callers introspect, read
-  properties, and query service / condition state, but disallows
-  every state-changing method at the broker.  finit *also* enforces
-  per-method authorisation itself (LINK_METHOD_PRIVILEGED), so
-  defense-in-depth: even if a permissive policy is installed by
-  mistake, finit rejects unprivileged state changes.  It reads the
-  caller from SO_PEERCRED on the local bus, and on the system bus it
-  asks the broker who sent each privileged call, via
-  GetConnectionUnixUser.
--->
-<busconfig>
-
-  <!-- Only finit (root) may own the org.finit bus name. -->
-  <policy user="root">
-    <allow own="org.finit"/>
-    <allow send_destination="org.finit"/>
-    <allow receive_sender="org.finit"/>
-  </policy>
-
-  <!-- Everyone may introspect, read properties, and call the
-       read-only Manager1 / Cond1 methods.  Signals fan out
-       unconditionally. -->
-  <policy context="default">
-    <allow send_destination="org.finit"
-           send_interface="org.freedesktop.DBus.Introspectable"/>
-    <allow send_destination="org.finit"
-           send_interface="org.freedesktop.DBus.Peer"/>
-    <allow send_destination="org.finit"
-           send_interface="org.freedesktop.DBus.Properties"
-           send_member="Get"/>
-    <allow send_destination="org.finit"
-           send_interface="org.freedesktop.DBus.Properties"
-           send_member="GetAll"/>
-
-    <allow send_destination="org.finit"
-           send_interface="org.finit.Manager1"
-           send_member="ListServices"/>
-    <allow send_destination="org.finit"
-           send_interface="org.finit.Manager1"
-           send_member="GetService"/>
-
-    <allow send_destination="org.finit"
-           send_interface="org.finit.Cond1"
-           send_member="Get"/>
-    <allow send_destination="org.finit"
-           send_interface="org.finit.Cond1"
-           send_member="List"/>
-    <allow send_destination="org.finit"
-           send_interface="org.finit.Cond1"
-           send_member="Dump"/>
-
-    <allow receive_sender="org.finit"/>
-  </policy>
-
-</busconfig>

doc/Makefile.am

@@ -1,12 +1,4 @@
-SUBDIRS         = config
+docsdir   := @docdir@/doc
-EXTRA_DIST      = AUTHORS ChangeLog.md
+docs_DATA  = config.md conditions.md distro.md plugins.md	\
-
+	     service.md signals.md svc-machine.png cmdline.md
-docsdir        := @docdir@/doc
+EXTRA_DIST = $(docs_DATA)
-dist_docs_DATA  = build.md cmdline.md commands.md conditions.md 	\
-		  dbus.md						\
-		  distro.md example.md features.md index.md initctl.md	\
-		  keventd.md plugins.md requirements.md runlevels.md	\
-		  runparts.md service.md signals.md state-machine.md	\
-		  watchdog.md
-dist_docs_DATA += img/logo.png img/svc-machine.png img/svc-machine.svg	\
-		  img/alpine-screenshot2.png

doc/README.md

@@ -1 +1 @@
-index.md
+config.md

doc/TODO.md

@@ -19,31 +19,19 @@ Some of these are also registered in the issue tracker on GitHub.
 * Add new (complimentary) .svc file format to slowly migrate away
   from the very terse one-liner format currently used
 * Allow running as non-pid1 => read .conf and RCSD form cmdline
+* When a process dies, and Finit does not restart it, we should collect
+  a `siginfo_t` from the SIGCHLD signal and supply to the user in case
+  `initctl status <process>` is called to debug the issue.
 * Add `finit.conf` support for UPS notification (SIGPWR) to start a task
   using, e.g. <sys/power/{ok,fail,low}> conditions.  More info in sig.c
-
-  As of Finit v4.1 SIGPWR generates <sys/power/fail> condition and it
-  is up to a task to check why and take appropriate action.
 * Add `finit.conf` support for ctrl-alt-delete (SIGINT) and kbrequest,
   i.e. KeyboardSignal, (SIGWINCH) behavior.  Using conditions to a task,
   e.g, <sys/key/ctrlaltdel> and <sys/key/signal> like SIGPWR handling.
-
+* Write man pages for finit and `finit.conf`, steal from the excellent
-  As of Finit v4.1 SIGINT generates <sys/key/ctrlaltdel>, but there is
+  `pimd` man pages ...
-  no check if the signal actually originates from the kernel.  To get
+* Add support for timed shutdown in Finit, including cancelled shutdown
-  this verification, a new libuEv release is needed.  As of June 6 -21
-  that functionality is not yet released.
-
-
-Initctl
--------
-
-* Add support for timed shutdown in Finit, including cancelled shutdown:
-
-        shutdown -h 03:35 "foobar was here"
-
 * Add support for JSON output, or similar, from `initctl show`, e.g.
   `initctl show --json`
-* Add support for `-s` to redirect all output to syslog, for scripting
 
 
 Init

doc/bootstrap.md

@@ -0,0 +1,56 @@
+Bootstrap
+=========
+
+1. Prepare emergency shell, if enabled
+2. Set up initial signal handlers
+3. Set up default $PATH early
+4. Mount `/proc` and `/sys`
+5. Check kernel command line for `debug` to figure out log level
+6. Load all `.so` plugins
+7. Call `fsck` on file systems listed in `/etc/fstab`
+8. Populate `/dev` using either udev or mdev, depending on system type
+9. Parse `/etc/finit.conf` and all `/etc/finit.d/*.conf` files
+10. Start built-in watchdog, if enabled
+11. Set hostname
+12. Remount `/` read-write if `/` is listed in `/etc/fstab` without `ro`
+13. Call 1st level hooks, `HOOK_ROOTFS_UP`
+14. Mount all file systems listed in `/etc/fstab` and swap, if available
+15. Enable SysV init signals
+16. Call 2nd level hooks, `HOOK_BASEFS_UP`
+17. Cleanup stale files from `/tmp/*` et al, handled by `bootmisc` plugin
+18. Load kernel params from `/etc/sysctl.d/*.conf`, `/etc/sysctl.conf`
+    et al. (Supports all locations that SysV init does.), handled by
+    `procps` plugin
+19. Start all 'S' runlevel tasks and services
+20. Bring up loopback interface and all `/etc/network/interfaces`, if
+    the `.conf` setting `network <SCRIPT>` is set, it is called instead
+21. Call 3rd level hooks, `HOOK_NETWORK_UP`
+22. If `runparts <DIR>` is set, [run-parts(8)][] is called on `<DIR>`
+23. Switch to the configured runlevel from `/etc/finit.conf`, default 2.
+    At every runlevel change all `*.conf` files in `/etc/finit.d/` are
+    (re)loaded and new services, tasks, and blocking run commands are
+    started.  Provided they are allowed in the new runlevel and all of
+    their conditions, if any, are set.
+24. Call 4th level hooks, `HOOK_SVC_UP`
+25. Call `/etc/rc.local`, if it exists and is an executable shell script
+26. Call 5th level (last) hooks, `HOOK_SYSTEM_UP`
+27. Start all configured TTYs, or a fallback shell on `/dev/console`
+
+In (19) and (22) tasks and services defined in `/etc/finit.conf` and
+`/etc/sysctl.d/*.conf` are started.  Remember, all `service` and `task`
+stanzas are started in parallel and `run` in sequence, and in the order
+listed.  Hence, to emulate a SysV `/etc/init.d/rcS` one could write a
+long `finit.conf` with only `run` statements.
+
+Notice the five hook points that are called at various point in the
+bootstrap process.  This is where plugins can extend the boot in any way
+they please.  There are other hook points, e.g. `HOOK_MOUNT_ERROR`, for
+more on this see [plugins.md](plugins.md).
+
+For instance, at `HOOK_BASEFS_UP` a plugin could read an XML file from a
+USB stick, convert/copy its contents to the system's `/etc/` directory,
+well before all 'S' runlevel tasks are started.  This could be used with
+system images that are created read-only and all configuration is stored
+on external media.
+
+[run-parts(8)]: http://manpages.debian.org/cgi-bin/man.cgi?query=run-parts