Update ChangeLog and bump version for v4.5-rc1

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>

.github/CODE-OF-CONDUCT.md

@@ -0,0 +1,45 @@
+Contributor Code of Conduct
+===========================
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all
+people who contribute through reporting issues, posting feature
+requests, updating documentation, submitting pull requests or patches,
+and other activities.
+
+We are committed to making participation in this project a
+harassment-free experience for everyone, regardless of level of
+experience, gender, gender identity and expression, sexual orientation,
+disability, personal appearance, body size, race, ethnicity, age,
+religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit,
+or reject comments, commits, code, wiki edits, issues, and other
+contributions that are not aligned to this Code of Conduct. By adopting
+this Code of Conduct, project maintainers commit themselves to fairly
+and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code
+of Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public
+spaces when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may
+be reported by opening an issue or contacting one or more of the project
+maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant][1],
+[version 1.2.0][2].
+
+[1]: http://contributor-covenant.org
+[2]: http://contributor-covenant.org/version/1/2/0/

.github/CONTRIBUTING.md

@@ -0,0 +1,78 @@
+Contributing to Finit
+=====================
+
+We welcome any and all help in the form of bug reports, fixes, patches
+for new features -- *preferably as GitHub pull requests*.  Other methods
+are of course also possible: emailing the maintainer a patch or even a
+raw file, or simply emailing a feature request or an alert of a problem.
+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
+GitHub discussions forum, so we can discuss it.  Talking about the code
+first is the best way to 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.
+
+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:** 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 [KNF][].
+
+
+Commit Messages
+---------------
+
+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:
+
+    git config --global user.name "Jane Doe"
+    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
+    
+    More detailed explanatory text, if necessary.  Wrap it to about 72
+    characters or so.  In some contexts, the first line is treated as
+    the subject of an email and the rest of the text as the body.  The
+    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.
+    
+    Further paragraphs come after blank lines.
+    
+     - 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
+    
+    Signed-off-by: Jane Doe <jane.doe@example.com>
+
+
+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://en.wikipedia.org/wiki/Kernel_Normal_Form
+[gitbook]:  https://git-scm.com/book/ch5-2.html
+[conduct]:  CODE-OF-CONDUCT.md

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [troglobit]

.github/SECURITY.md

@@ -0,0 +1,12 @@
+# Security Policy
+
+## Supported Versions
+
+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/troglobit/finit/releases>
+
+## Reporting a Vulnerability
+
+Contact the project's main author and owner to report and discuss vulnerabilities.

.github/workflows/build.yml

@@ -0,0 +1,67 @@
+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:
+    branches:
+      - '**'
+
+jobs:
+  build:
+    # Verify we can build on latest Ubuntu with both gcc and clang
+    name: ${{ matrix.compiler }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        compiler: [gcc, clang]
+      fail-fast: false
+    env:
+      MAKEFLAGS: -j3
+      CC: ${{ matrix.compiler }}
+    steps:
+      - name: Install dependencies
+        run: |
+          sudo apt-get -y update
+          sudo apt-get -y install pkg-config tree jq libuev-dev libite-dev
+      - uses: actions/checkout@v3
+      - name: Static Finit
+        run: |
+          ./autogen.sh
+          ./configure --prefix= --enable-static
+          make V=1
+      - name: Regular Finit
+        run: |
+          ./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var \
+                      --enable-x11-common-plugin --enable-testserv-plugin --with-watchdog \
+                      --with-keventd
+          make clean
+          make 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: Run Unit Tests
+        run: |
+          make check || (cat test/test-suite.log; false)
+      - name: Upload Test Results
+        uses: actions/upload-artifact@v3
+        with:
+          name: finit-test-${{ matrix.compiler }}
+          path: test/*.log

.github/workflows/coverity.yml

@@ -0,0 +1,63 @@
+name: Coverity Scan
+
+on:
+  push:
+    branches:
+      - 'dev'
+
+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@v3
+      - uses: actions/cache@v3
+        id: coverity-toolchain-cache
+        with:
+          path: cov-analysis-linux64
+          key: ${{ runner.os }}-coverity
+      - name: Download Coverity Scan
+        if: steps.coverity-toolchain-cache.outputs.cache-hit != 'true'
+        env:
+          TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
+        run: |
+          wget -q https://scan.coverity.com/download/cxx/linux64 \
+               --post-data "token=$TOKEN&project=${COVERITY_PROJ}" \
+               -O cov-analysis-linux64.tar.gz
+          mkdir cov-analysis-linux64
+          tar xzf cov-analysis-linux64.tar.gz --strip 1 -C cov-analysis-linux64
+      - name: Install dependencies
+        run: |
+          sudo apt-get -y update
+          sudo apt-get -y install pkg-config
+          wget https://github.com/troglobit/libuev/releases/download/v2.4.0/libuev-2.4.0.tar.xz
+          wget https://github.com/troglobit/libite/releases/download/v2.5.2/libite-2.5.2.tar.gz
+          tar xf libuev-2.4.0.tar.xz
+          tar xf libite-2.5.2.tar.gz
+          (cd libuev-2.4.0 && ./configure --prefix=/usr && make && sudo make install-strip)
+          (cd libite-2.5.2 && ./configure --prefix=/usr && make && sudo make install-strip)
+          sudo ldconfig
+      - name: Build
+        run: |
+          ./autogen.sh
+          ./configure --prefix= --enable-x11-common-plugin --with-watchdog --with-keventd
+          export PATH=`pwd`/cov-analysis-linux64/bin:$PATH
+          cov-build --dir cov-int make
+      - name: Submit result 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}

.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release General
+
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+*'
+
+jobs:
+  release:
+    name: Build and upload release tarball
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Installing dependencies ...
+        run: |
+          sudo apt-get -y update
+          sudo apt-get -y install pkg-config jq libuev-dev libite-dev
+      - name: Creating Makefiles ...
+        run: |
+          ./autogen.sh
+          ./configure  --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var \
+                       --enable-x11-common-plugin --enable-testserv-plugin --with-watchdog \
+                       --with-keventd
+      - name: Build release ...
+        run: |
+          make release || (cat test/test-suite.log; false)
+          ls -lF ../
+          mkdir -p artifacts/
+          mv ../*.tar.* artifacts/
+      - name: Extract ChangeLog entry ...
+        run: |
+          awk '/-----*/{if (x == 1) exit; x=1;next}x' ChangeLog.md \
+              |head -n -1 > release.md
+          cat release.md
+      - uses: ncipollo/release-action@v1
+        with:
+          name: Finit v${{ github.ref_name }}
+          bodyFile: "release.md"
+          artifacts: "artifacts/*"

.github/workflows/weekly.yml

@@ -0,0 +1,48 @@
+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:
+
+jobs:
+  schedule:
+    runs-on: ubuntu-latest
+    outputs:
+      run: ${{ steps.check.outputs.run }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: Check for any commits since last week
+        run: |
+          commits="$(git log --format=%H --since='1 week ago')"
+          if [ -n "$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 libuev-dev libite-dev
+      - uses: actions/checkout@v3
+      - 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: 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)

.gitignore

@@ -1,6 +1,50 @@
+*~
 *.o
-.*.d
 *.so
 *.gz
-*.map
-finit
+ID
+GPATH
+GRTAGS
+GSYMS
+GTAGS
+
+# GNU configure and build system
+/aux
+/.deps
+/autom4te.cache
+/aclocal.m4
+/ar-lib
+/compile
+/config.cache
+/config.h
+/config.mk
+/config.guess
+/config.h.in
+/config.log
+/config.status
+/config.sub
+/configure
+/depcomp
+/install-sh
+/libtool
+/ltmain.sh
+/missing
+/Makefile
+/Makefile.in
+/stamp-h1
+
+/test-driver
+/test-suite.log
+
+# TroglOS build system
+/.config
+/.stamp
+/.unpacked
+
+# WeOS build system
+/.autoconf
+/.automake
+/.built
+
+# VS Code user settings
+.vscode

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "libuev"]
-	path = libuev
-	url = https://github.com/troglobit/libuev.git

.globalrc

@@ -0,0 +1,7 @@
+# GNU Global .conf file, see /etc/gtags/gtags.conf for details.
+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,*.zip,*.gz,*.bz2,*.xz,*.lzh,*.Z,*.tgz,*.min.js,*min.css,sysroot/:

.travis.yml

@@ -1,21 +0,0 @@
-# Travis CI integration -- https://travis-ci.org/troglobit/finit
-language: c
-compiler:
-  - gcc
-
-env:
-  global:
-   # The next declaration is the encrypted COVERITY_SCAN_TOKEN, created
-   #   via the "travis encrypt" command using the project repo's public key
-   - secure: "eOiuHs02lG2Uv146K9dMqucGTWUJFEhpz1oAtwe+kPrRXsXWc20hYMO+DSpMgD05vSvNeQA6p7h7LdRFQ+/g/Obj27TsOE+RKkUvRAtdwzxnKVyii9C/nmML8cFw7rIA0VS8O9mAkVYeyDxNDupBp3e9DPCibhKPvqCvioTnyy4="
-
-addons:
-  coverity_scan:
-    project:
-      name: "troglobit/finit"
-      description: "finit | Fast & Extensible init for Linux"
-    notification_email: troglobit@gmail.com
-    build_command:      "make"
-    branch_pattern:     dev
-
-script: make

AUTHORS

@@ -1,5 +1,12 @@
 Current Maintainer(s):
- * Joachim Nilsson <troglobit@gmail.com>
+ * Joachim Wiberg <troglobit@gmail.com>
+
+Major Contributors:
+ * Tobias Waldekranz <tobias@waldekranz.com>
+ * Mattias Walström <mattias.walstrom@westermo.se>
+ * Jonas Johansson <jonas.johansson@westermo.se>
+ * Jacques de Laval <jacques@de-laval.se>
+ * Magnus Malm <magnusmalm@gmail.com>
 
 Original Author(s):
  * Claudio Matsuoka <cmatsuoka@gmail.com>

CHANGELOG

@@ -1 +0,0 @@
-CHANGELOG.md

CHANGELOG.md

@@ -1,320 +0,0 @@
-Change Log
-==========
-
-All notable changes to the project are documented in this file.
-
-
-[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
-
-[libuEv]: https://github.com/troglobit/libuev
-[dea3ae8]: https://github.com/troglobit/finit/commit/dea3ae8
-[UNRELEASED]: https://github.com/troglobit/finit/compare/1.12...HEAD
-[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
-

LICENSE

@@ -1,5 +1,5 @@
 Copyright (c) 2008-2010  Claudio Matsuoka <cmatsuoka@gmail.com>
-Copyright (c) 2008-2014  Joachim Nilsson <troglobit@gmail.com>
+Copyright (c) 2008-2023  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

@@ -1,180 +0,0 @@
-# Finit - Extremely fast /sbin/init replacement w/ I/O, hook & service plugins
-#
-# Copyright (c) 2008-2010  Claudio Matsuoka <cmatsuoka@gmail.com>
-# Copyright (c) 2008-2014  Joachim Nilsson <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
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-.PHONY: all install clean distclean dist		\
-	install-exec install-data install-dev		\
-	uninstall-exec uninstall-data uninstall-dev
-
-#VERSION    ?= $(shell git tag -l | tail -1)
-VERSION    ?= 1.12
-NAME        = finit
-PKG         = $(NAME)-$(VERSION)
-DEV         = $(NAME)-dev
-ARCHTOOL    = `which git-archive-all`
-ARCHIVE     = $(PKG).tar
-ARCHIVEZ    = ../$(ARCHIVE).xz
-EXEC        = finit reboot
-HEADERS     = plugin.h svc.h helpers.h queue.h
-DISTFILES   = LICENSE README CHANGELOG finit.conf services
-OBJS        = finit.o conf.o helpers.o sig.o svc.o plugin.o tty.o inetd.o
-SRCS        = $(OBJS:.o=.c)
-DEPS        = $(addprefix .,$(SRCS:.c=.d))
-
-# Installation paths, always prepended with DESTDIR if set
-TOPDIR      = $(shell pwd)
-prefix     ?= /usr
-sysconfdir ?= /etc
-sbindir    ?= /sbin
-libdir     ?= /lib
-plugindir  ?= $(libdir)/finit/plugins
-incdir      = $(prefix)/include/finit
-datadir     = $(prefix)/share/doc/finit
-mandir      = $(prefix)/share/man/man8
-
-# The initctl FIFO, should probably be in /run, not /dev
-FINIT_FIFO ?= /dev/initctl
-FINIT_CONF ?= $(sysconfdir)/finit.conf
-FINIT_RCSD ?= $(sysconfdir)/finit.d
-
-CFLAGS     += -W -Wall -Werror -Os
-# Disable annoying gcc warning for "warn_unused_result", see GIT 37af997
-CPPFLAGS   += -U_FORTIFY_SOURCE
-CPPFLAGS   += -Ilibite -Ilibuev
-CPPFLAGS   += -D_XOPEN_SOURCE=600 -D_BSD_SOURCE -D_GNU_SOURCE
-CPPFLAGS   += -DVERSION=\"$(VERSION)\" -DWHOAMI=\"`whoami`@`hostname`\"
-CPPFLAGS   += -DFINIT_FIFO=\"$(FINIT_FIFO)\" -DFINIT_CONF=\"$(FINIT_CONF)\"
-CPPFLAGS   += -DFINIT_RCSD=\"$(FINIT_RCSD)\" -DPLUGIN_PATH=\"$(plugindir)\"
-LDFLAGS    += -rdynamic -L$(TOPDIR)/libite
-DEPLIBS     = libite/libite.so libuev/libuev.a
-LDLIBS     += -ldl -lite
-
-include common.mk
-export libdir plugindir incdir ROOTDIR CPPFLAGS LDFLAGS LDLIBS
-
-all: $(DEPLIBS) $(EXEC)
-	+$(MAKE) -C plugins $@
-
-$(DEPLIBS): Makefile
-	+$(MAKE) -C libite all
-	+$(MAKE) -C libuev all
-
-$(OBJS): Makefile
-
-finit: $(OBJS) $(DEPLIBS)
-
-reboot: reboot.o $(DEPLIBS)
-
-install-exec: all
-	@$(INSTALL) -d $(DESTDIR)$(FINIT_RCSD)
-	@$(INSTALL) -d $(DESTDIR)$(sbindir)
-	@for file in $(EXEC); do                                        \
-		printf "  INSTALL $(DESTDIR)$(sbindir)/$$file\n";   	\
-		$(STRIPINST) $$file $(DESTDIR)$(sbindir)/$$file; 	\
-	done
-	$(MAKE) -C libite  install-exec
-	$(MAKE) -C plugins install
-
-install-data:
-	@$(INSTALL) -d $(DESTDIR)$(datadir)
-	@$(INSTALL) -d $(DESTDIR)$(mandir)
-	@for file in $(DISTFILES); do	                                \
-		printf "  INSTALL $(DESTDIR)$(datadir)/$$file\n";	\
-		$(INSTALL) -m 0644 $$file $(DESTDIR)$(datadir)/$$file;	\
-	done
-
-install-dev:
-	@$(INSTALL) -d $(DESTDIR)$(incdir)
-	@for file in $(HEADERS); do	                                \
-		printf "  INSTALL $(DESTDIR)$(incdir)/$$file\n";	\
-		$(INSTALL) -m 0644 $$file $(DESTDIR)$(incdir)/$$file;	\
-	done
-	$(MAKE) -C libite install-dev install-exec
-
-install: install-exec install-data install-dev
-
-uninstall-exec:
-	-@for file in $(EXEC); do 					\
-		printf "  REMOVE  $(DESTDIR)$(sbindir)/$$file\n";   	\
-		rm $(DESTDIR)$(sbindir)/$$file 2>/dev/null; 		\
-	done
-	-@rmdir $(DESTDIR)$(sbindir) 2>/dev/null
-	-@rmdir $(DESTDIR)$(FINIT_RCSD) 2>/dev/null
-	$(MAKE) -C libite  uninstall
-	$(MAKE) -C plugins uninstall
-
-uninstall-data:
-	@for file in $(DISTFILES); do	                                \
-		printf "  REMOVE  $(DESTDIR)$(datadir)/$$file\n";	\
-		rm $(DESTDIR)$(datadir)/$$file 2>/dev/null;		\
-	done
-	-@rmdir $(DESTDIR)$(mandir)
-	-@rmdir $(DESTDIR)$(datadir)
-
-uninstall-dev:
-	-@$(RM) -rf $(DESTDIR)$(incdir)
-
-uninstall: uninstall-exec uninstall-data uninstall-dev
-
-clean:
-	-@$(RM) $(OBJS) $(DEPS) $(EXEC)
-	+$(MAKE) -C plugins $@
-	+$(MAKE) -C libite  $@
-	+$(MAKE) -C libuev  $@
-
-distclean: clean
-	-@$(RM) $(JUNK) unittest *.o .*.d
-	+$(MAKE) -C plugins $@
-	+$(MAKE) -C libite  $@
-	+$(MAKE) -C libuev  $@
-
-check:
-	$(CHECK) *.c plugins/*.c libite/*.c
-
-dist:
-	@if [ x"$(ARCHTOOL)" = x"" ]; then \
-		echo "Missing git-archive-all from https://github.com/Kentzo/git-archive-all"; \
-		exit 1; \
-	fi
-	@if [ -e $(ARCHIVEZ) ]; then \
-		echo "Distribution already exists."; \
-		exit 1; \
-	fi
-	@echo "Building xz tarball of $(PKG) in parent dir..."
-	@$(ARCHTOOL) ../$(ARCHIVE)
-	@xz ../$(ARCHIVE)
-	@md5sum $(ARCHIVEZ) | tee $(ARCHIVEZ).md5
-
-dev: distclean
-	@echo "Building unstable xz $(DEV) in parent dir..."
-	-@$(RM) -f ../$(DEV).tar.xz*
-	@(dir=`mktemp -d`; mkdir $$dir/$(DEV); cp -a . $$dir/$(DEV); \
-	  cd $$dir; tar --exclude=.git --exclude=contrib             \
-                        -c -J -f $(DEV).tar.xz $(DEV);               \
-	  cd - >/dev/null; mv $$dir/$(DEV).tar.xz ../; cd ..;        \
-	  rm -rf $$dir; md5sum $(DEV).tar.xz | tee $(DEV).tar.xz.md5)
-
-ifneq ($(MAKECMDGOALS),clean)
-ifneq ($(MAKECMDGOALS),distclean)
--include $(DEPS)
-endif
-endif

Makefile.am

@@ -0,0 +1,35 @@
+ACLOCAL_AMFLAGS    = -I m4
+SUBDIRS            = man plugins src system test tmpfiles.d
+doc_DATA           = README.md LICENSE contrib/finit.conf
+EXTRA_DIST         = README.md LICENSE ChangeLog.md contrib/finit.conf
+
+if CONTRIB
+SUBDIRS           += contrib
+endif
+if DOC
+SUBDIRS           += doc
+endif
+
+# Compat hook
+install-dev:
+	@make -C src install-pkgincludeHEADERS
+
+# 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 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 \
+			    --enable-testserv-plugin --enable-x11-common-plugin  \
+			    --with-watchdog --with-keventd --with-fstab=/etc/fstab

README

@@ -1 +0,0 @@
-README.md

TODO

@@ -1 +0,0 @@
-TODO.md

TODO.md

@@ -1,288 +0,0 @@
-Goals of Finit
-==============
-
-The intent of finit is to monitor not just processes, but to supervise
-an entire system and the behavior of certain processes that declare
-themselves to be finit compliant.  Similar to launchd, the goal of
-finit is to be a replacement for:
-
-* init
-* inetd
-* crond
-* watchdogd
-
-A small and simple replacement, primarily for embedded systems, with a
-very low dependency on external packages.
-
-
-General
--------
-
-* Add compile-time supoprt for running `/bin/sh` instead of `getty`
-* Add support for `init <q | reload-configuration>` and `SIGHUP` to
-  have finit reload its `finit.conf`, but also
-* Add support for inotify to automatically reload `finit.conf`
-* Implement `initctl stop|start|restart|reload|status <SVC>` and
-  `service <SVC> stop|start|restart|reload|status` on top
-* Add PRE and POST hooks for when switching between runlevels
-* Add support for `init -v,--version | version`
-* Cleanup move sources from top-level directory to `src/` and `include/`
-* Make sure to install `queue.h` to `$(PREFIX)/include/finit/queue.h`
-* Move `finit.conf` "check" command to plugin which checks `/etc/fstab`
-  instead.  This is the de-facto practice.  But keep the check command
-  for really low-end systems w/o `/etc/fstab`.
-
-
-Init
-----
-
-Finit in itself is not SysV Init compatible, it doesn't use `/etc/rc.d`
-and `/etc/inet.d` scripts to boot the system.  However, a plausible way
-to achieve compatibility would be to add a plugin to finit which reads
-`/etc/inittab` to be able to start standard Linux systems.
-
-
-Inetd
------
-
-Simple way of running Internet services on demand, like the old inetd:
-
-    inetd PORT/PROTO <wait|nowait> [@USER[:GROUP]] /path/to/daemon args -- desc
-
-Examples:
-
-    # Inetd services, launched on demand
-    inetd ssh/tcp nowait [2345] @root:root /usr/sbin/sshd -i -- SSH daemon
-
-In keeping with the finit tradition, an optional callback can be setup
-to each inetd service.  When a client connects the finit will call the
-callback with a `struct in_pktinfo` argument which the callback then can
-allowed or deny.
-
-Alternatively, borrowing slightly from TCP wrappers by Wietse Venema, a
-set of `allow` and `deny` directives can be added to `finit.conf` to
-control inetd services.  It could be what IP addreses, networks or
-interfaces are allowed to connect to the given inetd services.  To start
-with the easiest (and what we need for WeOS at Westermo) is allow/deny
-per iface.
-
-    # Disable access to SSH
-    deny  ssh all
-    # Allow SSH connections originating from eth0
-    allow ssh eth0
-
-Another option, to further extend the Inetd capabilities, is a separate
-`finetd.conf` to list services.  This would be beneficial when running
-an SSH service on different ports on different interfaces:
-
-    # Run SSH on port 22 on all interfaces except upstream
-    tcp ssh {
-       listen = *, !wan0
-       exec   = dropbear -i
-    }
-    
-    # Run SSH on non-standard port 222 for upstream interface
-    tcp ssh {
-       port   = 222
-       listen = wan0
-       exec   = dropbear -i
-       wait   = yes
-    }
-    
-    # Run TFTP service on all interfaces except upstream interface
-    udp tftp {
-       listen = *, !wan0
-       exec   = uftpd -i -t
-       user   = root
-    }
-
-or, more concise
-
-    # System has four interfaces: wan0, eth0, eth1, eth2
-    # This runs SSH on only three, with various ports
-    tcp ssh {
-       listen = wan0:222 eth0:22 eth1:22
-       exec   = /usr/sbin/dropbear -i
-       wait   = yes
-    }
-
-this would be equivalent
-
-    tcp ssh {
-       listen = wan0:222 !eth2
-       exec   = /usr/sbin/dropbear -i
-       wait   = yes
-    }
-
-Syntax similar to [xinetd](http://en.wikipedia.org/wiki/Xinetd)
-
-### Custom Inet Port for Common Services
-
-- How to do this, without an obtrusive syntax?
-
-Maybe like this?  Then we can still refer to it as the time protocol,
-and have multiple entries.
-
-    inetd time:8037/udp wait [2345] @root:root internal
-    inetd time:3737/udp wait [2345] @root:root internal
-
-But what if we want to have different allow/deny rules per service?
-Here's a proposal, similar to user/pass encoding in URI's.  This variant
-could potentially be a lot easier to implement and also to maintain for
-users, compared to the above allow/deny/xinetd variants.
-
-    inetd ssh@eth0:222/tcp nowait [2345] /usr/sbin/sshd -i
-    inetd ssh@eth1:22/tcp  nowait [2345] /usr/sbin/sshd -i
-
-or
-
-    inetd ssh@eth0:222/tcp nowait [2345] /usr/sbin/sshd -i
-    inetd ssh@*:22/tcp     nowait [2345] /usr/sbin/sshd -i
-
-or
-
-    inetd ssh@eth0:222/tcp nowait [2345] /usr/sbin/sshd -i
-    inetd ssh/tcp          nowait [2345] /usr/sbin/sshd -i
-
-All three versions would be equivalent, except for the first one when
-there are more interfaces than just eth0 and eth1.  The latter two would
-however be equivalent.
-
-Multiple `inetd ssh` entries with the same port will not be unique, they
-will reuse all settings of the first listed entry.  However, an entry
-with a unique port and interface will be registered as a unique service.
-
-**Note:** Also, there is currently no verification that the same port is
-  used more than once.  So a standard http service will clash with an
-  ssh entry ssh@*:80/tcp ... why you would ever want that?
-
-Inetd callbacks are no different from other callbacks.  They match to an
-inetd line using the command.  So multiple `/usr/bin/sshd` inetd lines
-in `finit.conf` will all use the same callback.  However, the callback
-will be called with the Internet port and interface as arguments.  Like
-this:
-
-    svc_cmd_t sshd_callback(svc_t *svc, int port, char *ifname)
-    {
-        if (!cfg_is_ssh_enabled(ifname, port))
-            return SVC_STOP;
-    
-        return SVC_START;
-    }
-
-As usual, the callback is run in a separate process context and it is up
-to the implementer to return `SVC_STOP` or `SVC_START` (`SVC_RELOAD` is
-not applicable for inetd services).
-
-
-### Internal inetd services
-
-There are a few standard services that inetd usually had built-in:
-
-- time
-- echo
-- chargen
-- discard
-
-At least 'time' will be implemented in finit, as a plugin, to serve as a
-simple means of testing inetd functionality stand-alone, but also as a
-very rudimentary time server for rdate clients.
-
-Example:
-
-    # Built-in inetd time service, launched on demand
-    inetd time/udp wait [2345] @root:root internal
-
-
-Crond
------
-
-Requirements are quite rudimentary, basic cron functionality, mainly
-system-level timed periodic tasks:
-
-* Periodically run a task, in a matching runlevel
-* Optionally run as non-root (`crontab -e` as operator)
-
-Proposed syntax:
-
-    # Crontab
-    cron @YY-mm-ddTHH:MM [LVLS] /path/to/cmd [ARGS] -- Optional descr
-    
-    # One-shot 'at' command
-    at @YY-mm-ddTHH:MM [LVLS] /path/to/cmd [ARGS] -- Optional descr
-
-Notice the ISO date in notation.  The runlevels is extra filtering
-sugar.  E.g., if cron service is only allowed in runlevels two or three
-it will not start if system currently is in runlevel four.
-
-To run a command as another user the `.conf` file must have a that
-owner.  E.g., `/etc/finit.d/extra.conf` may be owned by operator and
-only hold `cron ...` lines.
-
-What would be extremely useful is if `initctl`, or a homegrown `at`,
-could support the basic functionality of the `at` command directly from
-the shell -- that way setting up one-time jobs would not entail
-re-reading `/etc/finit.conf`
-
-
-Watchdog
---------
-
-Support for monitoring the health of the system and its processes.
-
-* Add support for a `/dev/watchdog` built-in to replace both the BusyBox
-  watchdogd and my own refreshed uClinux-dist adaptation,
-  [watchdogd](https://github.com/troglobit/watchdogd)
-* Add a system supervisor (pmon) to optionally reboot the system when a
-  process stops responding, or when a respawn limit has been reached, as
-  well as when system load gets too high.  For details on UNIX loadavg,
-  see http://stackoverflow.com/questions/11987495/linux-proc-loadavg
-  - Default to 0.7 as MAX recommended load before warning and 0.9 reboot
-* API for processes to register with the watchdog, libwdt
-  - Deeper monitoring of a process' main loop by instrumenting
-  - If a process is not heard from within its subscribed period time
-    reboot system or restart process.
-  - Add client libwdt library, inspired by old Westermo API and the
-    [libwdt] API published in the [Fritz!Box source dump], take for
-    instance the `fritzbox7170-source-files-04.87-tar.gz` drop and see
-    the `GPL-release_kernel.tgz` in `drivers/char/avm_new/` for the
-    kernel driver, and the `LGPL-GPL-release_target_tools.tgz` in `wdt/`
-    for the userland API.
-  - When a client process (a standard app/daemon instrumented with
-    libwdt calls in its main loop) registers with the watchdog, we raise
-    the RT priority to 98 (just below the kernel watchdog in prio).
-    This to ensure that system monitoring goes before anything else in
-    the system.
-  - Use UNIX domain sockets for communication between daemon and clients
-* Separate `/etc/watchdog.conf` configuration file, or a perhaps
-  support for a more generic `/etc/finit.d/PLUGIN.conf`?
-* Support enable/disable watchdog features:
-  - Supervise processes,
-  - CPU loadavg,
-  - Watch for file descriptor leaks,
-  - etc.
-
-
-Documentation
--------------
-
-* Write man pages for finit and `finit.conf`, steal from the excellent
-  `pimd` man pages ...
-* Update Debian `finit.conf` example with runlevels, `tty/console` and
-  dependency handling for Debian 8 (the dreaded systemd release).
-
-
-Investigation
--------------
-
-* [FHS changes](http://askubuntu.com/questions/57297/why-has-var-run-been-migrated-to-run)
-  affecting runtime status, plugins, etc.
-
-[libwdt]:                http://www.wehavemorefun.de/fritzbox/Libwdt.so
-[Fritz!Box source dump]: ftp://ftp.avm.de/fritz.box/fritzbox.fon_wlan_7170/x_misc/opensrc/
-
-<!--
-  -- Local Variables:
-  -- mode: markdown
-  -- End:
-  -->

autogen.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+autoreconf -W portability -vifm

check.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+# Run test suite with the correct configure params
+
+make distclean
+./configure --prefix=/usr --exec-prefix= --sysconfdir=/etc --localstatedir=/var \
+	    --enable-x11-common-plugin --with-watchdog --with-keventd
+make -j17 clean check

common.mk

@@ -1,29 +0,0 @@
-# Top directory for building complete system, fall back to this directory
-ROOTDIR    ?= $(TOPDIR)
-
-# Some junk files we always want to be removed when doing a make clean.
-JUNK        = *~ *.bak *.aux *.dvi *.idx *.ind *.log *.ps *.map .*.d DEADJOE semantic.cache *.gdb *.elf core core.*
-MAKE       := @$(MAKE)
-MAKEFLAGS   = --no-print-directory --silent
-CHECK      := cppcheck $(CPPFLAGS) --quiet --enable=all
-INSTALL    := install --backup=off
-STRIPINST  := $(INSTALL) -s --strip-program=$(CROSS)strip -m 0755
-
-# Smart autodependecy generation via GCC -M.
-.%.d: %.c
-	@$(SHELL) -ec "$(CC) -MM $(CFLAGS) $(CPPFLAGS) $< \
-		| sed 's,.*: ,$*.o $@ : ,g' > $@; \
-                [ -s $@ ] || rm -f $@"
-
-# Override default implicit rules
-%.o: %.c
-	@printf "  CC      $(subst $(ROOTDIR)/,,$(shell pwd)/$@)\n"
-	@$(CC) $(CFLAGS) $(CPPFLAGS) -c -o $@ $<
-
-%: %.o
-	@printf "  LINK    $(subst $(ROOTDIR)/,,$(shell pwd)/$@)\n"
-	@$(CC) $(CFLAGS) $(LDFLAGS) -Wl,-Map,$@.map -o $@ $^ $(LDLIBS$(LDLIBS-$(@)))
-
-%.so: %.o
-	@printf "  PLUGIN  $(subst $(ROOTDIR)/,,$(shell pwd)/$@)\n"
-	@$(CC) $(LDFLAGS) -o $@ $^ $(LDLIBS)

conf.c

@@ -1,297 +0,0 @@
-/* Parser for finit.conf
- *
- * Copyright (c) 2012  Joachim Nilsson <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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <ctype.h>
-#include <string.h>
-
-#include "finit.h"
-#include "svc.h"
-#include "tty.h"
-#include "lite.h"
-#include "helpers.h"
-
-#define MATCH_CMD(l, c, x) \
-	(!strncasecmp(l, c, strlen(c)) && (x = (l) + strlen(c)))
-
-static char *strip_line(char *line)
-{
-	char *ptr;
-
-	/* Trim leading whitespace */
-	while (*line && isblank(*line))
-		line++;
-
-	/* Strip any comment at end of line */
-	ptr = line;
-	while (*ptr && *ptr != '#')
-		ptr++;
-	*ptr = 0;
-
-	return line;
-}
-
-/* Convert optional "[!123456789S]" string into a bitmask */
-int parse_runlevels(char *runlevels)
-{
-	int i, not = 0, bitmask = 0;
-
-	if (!runlevels)
-		runlevels = "[234]";
-	i = 1;
-	while (i) {
-		int level;
-		char lvl = runlevels[i++];
-
-		if (']' == lvl || 0 == lvl)
-			break;
-		if ('!' == lvl) {
-			not = 1;
-			bitmask = 0x3FE;
-			continue;
-		}
-
-		if ('s' == lvl || 'S' == lvl)
-			lvl = '0';
-
-		level = lvl - '0';
-		if (level > 9 || level < 0)
-			continue;
-
-		if (not)
-			CLRBIT(bitmask, level);
-		else
-			SETBIT(bitmask, level);
-	}
-
-	return bitmask;
-}
-
-static int parse_conf(char *file)
-{
-	FILE *fp;
-	char line[LINE_SIZE] = "";
-	char cmd[CMD_SIZE];
-	char *x;
-	const char *err = NULL;
-
-	fp = fopen(file, "r");
-	if (!fp)
-		return 1;
-
-	/*
-	 * If not standard finit.conf, then we want to show just the base name
-	 * Loading configuration ............. vs
-	 * Loading services configuration ....
-	 */
-	if (!string_match (file, FINIT_CONF)) {
-		/* Remove leading path */
-		x = strrchr(file, '/');
-		if (!x) x = file;
-		else	x++;
-
-		/* Remove ending .conf */
-		strlcpy(line, x, sizeof(line));
-		x = strstr(line, ".conf");
-		if (x) *x = 0;
-
-		/* Add empty space. */
-		strcat(line, " ");
-	}
-
-	print(0, "Loading %sconfiguration", line);
-	while (!feof(fp)) {
-		if (!fgets(line, sizeof(line), fp))
-			continue;
-		chomp(line);
-		_d("conf: %s", line);
-
-		/* Skip comments. */
-		if (MATCH_CMD(line, "#", x))
-			continue;
-
-		/* Do this before mounting / read-write
-		 * XXX: Move to plugin which checks /etc/fstab instead */
-		if (MATCH_CMD(line, "check ", x)) {
-			char *dev = strip_line(x);
-
-			strcpy(cmd, "/sbin/fsck -C -a ");
-			strlcat(cmd, dev, sizeof(cmd));
-			run_interactive(cmd, "Checking file system %s", dev);
-
-			continue;
-		}
-
-		if (MATCH_CMD(line, "user ", x)) {
-			if (username) free(username);
-			username = strdup(strip_line(x));
-			continue;
-		}
-		if (MATCH_CMD(line, "host ", x)) {
-			if (hostname) free(hostname);
-			hostname = strdup(strip_line(x));
-			continue;
-		}
-
-		if (MATCH_CMD(line, "module ", x)) {
-			char *mod = strip_line(x);
-
-			strcpy(cmd, "/sbin/modprobe ");
-			strlcat(cmd, mod, sizeof(cmd));
-			run_interactive(cmd, "Loading kernel module %s", mod);
-
-			continue;
-		}
-		if (MATCH_CMD(line, "mknod ", x)) {
-			char *dev = strip_line(x);
-
-			strcpy(cmd, "/bin/mknod ");
-			strlcat(cmd, dev, sizeof(cmd));
-			run_interactive(cmd, "Creating device node %s", dev);
-
-			continue;
-		}
-
-		if (MATCH_CMD(line, "network ", x)) {
-			if (network) free(network);
-			network = strdup(strip_line(x));
-			continue;
-		}
-		/* This is the directory from which executable scripts and
-		 * any finit include files are read, default /etc/finit.d/ */
-		if (MATCH_CMD(line, "runparts ", x)) {
-			if (rcsd) free(rcsd);
-			rcsd = strdup(strip_line(x));
-			continue;
-		}
-		/* Parse any include file, use rcsd if absolute path not given */
-		if (MATCH_CMD(line, "include ", x)) {
-			char *file = strip_line(x);
-
-			strlcpy(cmd, file, sizeof(cmd));
-			if (!fexist(cmd)) {
-				/* ... try /etc/finit.d/ as prefix */
-				snprintf(cmd, sizeof(cmd), "%s/%s", rcsd, file);
-				if (!fexist(cmd))
-					continue;
-			}
-
-			parse_conf(cmd);
-			continue;
-		}
-		if (MATCH_CMD(line, "startx ", x)) {
-			svc_register(SVC_CMD_SERVICE, strip_line(x), username);
-			continue;
-		}
-		if (MATCH_CMD(line, "shutdown ", x)) {
-			if (sdown) free(sdown);
-			sdown = strdup(strip_line(x));
-			continue;
-		}
-
-		/* The desired runlevel to start when leaving
-		 * bootstrap (S).  Finit supports 1-9, but most
-		 * systems only use 1-6, where 6 is reserved for
-		 * reboot */
-		if (MATCH_CMD(line, "runlevel ", x)) {
-			char *token = strip_line(x);
-
-			cfglevel = strtonum(token, 1, 9, &err);
-			if (err)
-				cfglevel = RUNLEVEL;
-			if (cfglevel < 1 || cfglevel > 9 || cfglevel == 6)
-				cfglevel = 2; /* Fallback */
-			continue;
-		}
-
-		/* Monitored daemon, will be respawned on exit, as
-		 * long as the (optional) service callback returns
-		 * non-zero */
-		if (MATCH_CMD(line, "service ", x)) {
-			svc_register(SVC_CMD_SERVICE, x, NULL);
-			continue;
-		}
-
-		/* One-shot task, will not be respawned. Only runs if
-		 * the (optional) service callback returns true */
-		if (MATCH_CMD(line, "task ", x)) {
-			svc_register(SVC_CMD_TASK, x, NULL);
-			continue;
-		}
-
-		/* Like task but waits for completion, useful w/ [S] */
-		if (MATCH_CMD(line, "run ", x)) {
-			svc_register(SVC_CMD_RUN, x, NULL);
-			continue;
-		}
-
-		/* Classic inetd service */
-		if (MATCH_CMD(line, "inetd ", x)) {
-			svc_register(SVC_CMD_INETD, x, NULL);
-			continue;
-		}
-
-		if (MATCH_CMD(line, "console ", x)) {
-			if (console) free(console);
-			console = strdup(strip_line(x));
-			continue;
-		}
-		if (MATCH_CMD(line, "tty ", x)) {
-			tty_register(strip_line(x));
-			continue;
-		}
-	}
-
-	fclose(fp);
-
-	return 0;
-}
-
-int parse_finit_conf(char *file)
-{
-	int result;
-
-	username = strdup(DEFUSER);
-	hostname = strdup(DEFHOST);
-	rcsd     = strdup(FINIT_RCSD);
-
-	result = parse_conf(file);
-	if (!tty_num()) {
-		char *fallback = FALLBACK_SHELL;
-
-		if (console)
-			fallback = console;
-
-		tty_register(fallback);
-	}
-
-	return result;
-}
-
-
-/**
- * Local Variables:
- *  version-control: t
- *  indent-tabs-mode: t
- *  c-file-style: "linux"
- * End:
- */

configure.ac

@@ -0,0 +1,379 @@
+AC_INIT([Finit],[4.5-rc1],[https://github.com/troglobit/finit/issues],[finit],[https://troglobit.com/projects/finit/])
+AC_CONFIG_AUX_DIR(aux)
+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_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/void/Makefile   contrib/void/finit.d/Makefile   contrib/void/finit.d/available/Makefile
+	doc/Makefile
+	man/Makefile
+	plugins/Makefile
+	src/Makefile
+	system/Makefile
+	tmpfiles.d/Makefile
+	test/test.env test/Makefile
+	test/lib/Makefile test/src/Makefile])
+
+# Older versions of autoconf (<2.58) do not have AC_CONFIG_MACRO_DIR()
+#m4_include([m4/plugin.m4])
+#m4_include([m4/expand.m4])
+AC_CONFIG_MACRO_DIR([m4])
+
+# Handle building plugins either as dynamically loadable, or built-in
+LT_INIT([shared disable-static dlopen aix-soname=both disable-fast-install])
+
+# Checks for programs.
+AC_PROG_CC
+AC_PROG_LN_S
+AC_PROG_INSTALL
+AC_PROG_MKDIR_P
+
+# Configuration.
+AC_CHECK_HEADERS([termios.h sys/ioctl.h mntent.h sys/sysmacros.h])
+AC_CHECK_FUNCS([strstr getopt getmntent getmntent_r])
+
+# Check for uint[8,16,32]_t
+AC_TYPE_UINT8_T
+AC_TYPE_UINT16_T
+AC_TYPE_UINT32_T
+
+# Check for pkg-config first, warn if it's not installed
+PKG_PROG_PKG_CONFIG
+
+# Check for required libraries
+PKG_CHECK_MODULES([uev],  [libuev >= 2.2.0])
+PKG_CHECK_MODULES([lite], [libite >= 2.2.0])
+
+# Check for configured Finit features
+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,
+        AS_HELP_STRING([--enable-kernel-cmdline], [Parse init args from /proc/cmdline (don't use!)]),,[
+	enable_kernel_cmdline=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(redirect,
+        AS_HELP_STRING([--disable-redirect], [Disable redirection of service output to /dev/null]),,[
+	enable_redirect=yes])
+
+AC_ARG_ENABLE(logrotate,
+        AS_HELP_STRING([--disable-logrotate], [Disable built-in rotation of /var/log/wtmp]),,[
+	enable_logrotate=yes])
+
+AC_ARG_ENABLE(doc,
+        AS_HELP_STRING([--disable-doc], [Disable build and install of doc/ section]),,[
+	enable_doc=yes])
+
+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,
+    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],          [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],      [yes], [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([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([testserv],      [no],  [Test plugin to start test serv daemon])
+
+# Check for extra arguments or packages
+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"]),
+	[heading=$withval], [heading=yes])
+
+AC_ARG_WITH(config,
+        AS_HELP_STRING([--with-config=CONFIG], [Finit bootstrap config file, default /etc/finit.conf]),
+	[conf=$withval], [conf=yes])
+
+AC_ARG_WITH(rcsd,
+        AS_HELP_STRING([--with-rcsd=DIR], [Finit rcS.d/ directory, default /etc/finit.d]),
+	[rcsd=$withval], [rcsd=yes])
+
+AC_ARG_WITH(rc-local,
+        AS_HELP_STRING([--with-rc-local=FILE], [SysV init /etc/rc.local file, default /etc/rc.local]),
+	[rclocal=$withval], [rclocal=yes])
+
+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 (initctl), 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]),
+	[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, default: no]),, [with_keventd=no])
+
+AC_ARG_WITH(sulogin,
+        AS_HELP_STRING([--with-sulogin@<:@=USER@:>@], [Enable built-in sulogin, optional USER to request password for (default root), default: no.]),[sulogin=$withval],[with_sulogin=no])
+
+AC_ARG_WITH(watchdog,
+        AS_HELP_STRING([--with-watchdog@<:@=DEV@:>@], [Enable built-in watchdog, default: /dev/watchdog]),
+	[watchdog=$withval], [with_watchdog=no watchdog=])
+
+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", default "2000-01-01 00:00"]),
+	[rtc_date=$withval], [rtc_date=no])
+
+### Enable features ###########################################################################
+
+# Create config.h from selected features and fallback defaults
+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"], [
+        AC_DEFINE(KERNEL_CMDLINE, 1, [Dumpster diving after init args from /proc/cmdline])])
+
+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_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"])
+
+### With features ##############################################################################
+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])])
+AC_EXPAND_DIR(conf_path, "$conf")
+AC_DEFINE_UNQUOTED(FINIT_CONF, "$conf_path", [Main Finit configuration file, default /etc/finit.conf])
+AC_SUBST(FINIT_CONF, "$conf_path")
+
+AS_IF([test "x$with_rcsd" != "xno"], [
+	AS_IF([test "x$rcsd" = "xyes"], [
+		rcsd=$sysconfdir/finit.d])])
+AC_EXPAND_DIR(rcsd_path, "$rcsd")
+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])])
+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"], [
+		    AC_EXPAND_DIR(sysconfig_path, "$sysconfig")
+		    AC_DEFINE_UNQUOTED(FINIT_SYSCONFIG, "$sysconfig_path",
+			    [System environment, default /etc/default & /etc/conf.d])])])
+
+AS_IF([test "x$with_heading" != "xno"], [
+	AS_IF([test "x$heading" = "xyes"], [heading=""])
+	AC_DEFINE_UNQUOTED(INIT_OSHEADING, "$heading", [Displayed by Finit at boot, defaults to /etc/os-release PRETTY_NAME])])
+
+AS_IF([test "x$with_group" != "xno"], [
+	AS_IF([test "x$group" = "xyes"], [
+		group=root])])
+AC_DEFINE_UNQUOTED(DEFGROUP, "$group", [For /run/finit/socket])
+
+AS_IF([test "x$with_hostname" != "xno"], [
+	AS_IF([test "x$hostname" = "xyes"], [
+		hostname=noname])])
+AC_DEFINE_UNQUOTED(DEFHOST, "$hostname", [For /etc/hostname])
+
+AS_IF([test "x$with_runlevel" != "xno"], [
+	AS_IF([test "x$runlevel" = "xyes"], [
+		runlevel=2
+		AC_DEFINE_UNQUOTED(RUNLEVEL, $runlevel, [Default runlevel to start after S])])
+	AC_DEFINE_UNQUOTED(RUNLEVEL, $runlevel, [Runlevel to start after S])])
+
+AS_IF([test "x$with_random_seed" != "xno"], [
+	AS_IF([test "x$random_seed" = "xyes"], [
+		random_seed=/var/lib/misc/random-seed])
+	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(RTC_TIMESTAMP_CUSTOM, "$rtc_date", [Custom RTC restore date, default: 2000-01-01 00:00])], [
+	rtc_date=""])
+
+AS_IF([test "x$with_keventd" != "xno"], [with_keventd=yes])
+
+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$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(STATIC,    [test "x$enable_static" = "xyes"])
+AM_CONDITIONAL(KEVENTD,   [test "x$with_keventd"  != "xno"])
+AM_CONDITIONAL(SULOGIN,   [test "x$with_sulogin"  != "xno"])
+AM_CONDITIONAL(WATCHDOGD, [test "x$with_watchdog" != "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"])
+
+# 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_EXPAND_DIR(plugin_path, "$pkglibdir/plugins")
+AC_SUBST(plugin_path)
+AC_DEFINE_UNQUOTED(PLUGIN_PATH, "$plugin_path", [Finit plugin path])
+
+AC_EXPAND_DIR(tmpfiles_path, "$libdir/tmpfiles.d")
+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_DEFINE_UNQUOTED(SAMPLE_CONF, "$sample_conf", [Finit sameple.conf for initctl create])
+
+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
+
+cat <<EOF
+
+------------------ Summary ------------------
+ $PACKAGE_NAME version $PACKAGE_VERSION
+  Prefix................: $prefix
+  Exec prefix...........: $eprefix
+  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..: $rclocal_path
+  System environment....: ${sysconfig_path:-${sysconfig}}
+  Random seed path......: $random_path
+  C Compiler............: $CC $CFLAGS $CPPFLAGS $LDFLAGS $LIBS
+  Linker................: $LD $LLDP_LDFLAGS $LLDP_BIN_LDFLAGS $LDFLAGS $LIBS
+
+Behavior:
+  Boot heading..........: $heading
+  Plugins...............: $plugins
+  RTC restore date......: $RTC_DATE
+
+Optional features:
+  Install doc/..........: $enable_doc
+  Install contrib/......: $enable_contrib
+  Built-in keventd......: $with_keventd
+  Built-in sulogin......: $with_sulogin $sulogin
+  Built-in watchdogd....: $with_watchdog $watchdog
+  Built-in logrotate....: $enable_logrotate
+  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 --------------
+$($CC --version || true)
+-------------- Linker version ---------------
+$($LD --version || true)
+---------------------------------------------
+
+Check the above options and compile with:
+ ${MAKE-make}
+
+EOF

contrib/.gitignore

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

contrib/Makefile.am

@@ -0,0 +1,5 @@
+SUBDIRS    = alpine debian void
+bin_SCRIPT = service
+docsdir   := @docdir@/contrib
+docs_DATA  = README.md finit.conf procmon.sh
+EXTRA_DIST = $(docs_DATA)

contrib/README.md

@@ -0,0 +1,12 @@
+Finit Examples
+==============
+
+This section provides configuration examples and helpful tools to
+install and try out Finit on various Linux distributions.
+
+* [Alpine](alpine/)
+* [Debian](debian/)
+
+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

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

contrib/alpine/README.md

@@ -0,0 +1,48 @@
+HowTo: Finit on Alpine Linux 3.4-3.6
+====================================
+
+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,
+and other tools needed to build a GNU configure based project.
+
+To start with you need to first install [libuEv][] and [libite][].  They
+default to install to `/usr/local`, but unlike Debian and Ubuntu based
+distros, Alpine's `pkg-config` does not look for libraries and header
+files there.  So the `PKG_CONFIG_LIBDIR` environment variable must be
+used, or change the install prefix to `/usr`.
+
+The bundled [build.sh](build.sh) script can be used to configure and
+build finit:
+
+    alpine:~# cd finit
+    alpine:~/finit# ./contrib/alpine/build.sh
+
+Then run the [install.sh](install.sh) script to install all necessary
+files, including the sample `finit.conf` and `finit.d/*.conf` files.
+More on that below.
+
+    alpine:~/finit# ./contrib/alpine/install.sh
+
+The install script is non-destructive by default, you have to answer
+*Yes* twice to set up Finit as the system default init.  Pay close
+attention to the last question:
+
+    *** Install Finit as the system default Init (y/N)?
+
+If you answer `No`, simply by pressing enter, you can change the symlink
+yourself later on, to point to `finit` instead of `/bin/busybox`:
+
+    alpine:~/finit# cd /sbin
+    alpine:/sbin# rm init
+    alpine:/sbin# ln -s finit init
+
+Before rebooting, make sure to set up a [/etc/finit.conf](finit.conf),
+and [/etc/finit.d/](finit.d/) for your services.  Samples are included
+in this directory.  Notice the symlinks in `/etc/finit.d/`, which can be
+managed by the operator at runtime using `initctl enable SERVICE`.  You
+can also use a standard [/etc/rc.local](rc.local) for one-shot tasks and
+initialization like keyboard language etc.
+
+[libuEv]: https://github.com/troglobit/libuev
+[libite]: https://github.com/troglobit/libite
+[Alpine Linux]: https://www.alpinelinux.org/

contrib/alpine/build.sh

@@ -0,0 +1,37 @@
+#!/bin/sh -e
+
+echo
+echo "*** Configuring Finit for Alpine Linux"
+
+if [ ! -e configure ]; then
+    echo "    The configure script is missing, maybe you're using a version from GIT?"
+    echo "    Attempting to run the autogen.sh script, you will need these tools:"
+    echo "    autoconf, automake, libtool, pkg-config ..."
+    echo
+   ./autogen.sh
+fi
+
+# The plugins are optional, but you may need D-Bus and X11 if you want
+# to run X-Window, the other configure flags are however required.
+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			\
+		 --with-keventd			--with-sulogin
+
+echo
+echo "*** Building ..."
+echo
+make
+
+if [ $? -ne 0 ]; then
+    echo
+    echo "*** The build failed for some reason"
+    echo
+    exit 1
+fi
+
+echo
+echo "*** Done"
+echo

contrib/alpine/finit.conf

@@ -0,0 +1,26 @@
+# /etc/finit.conf: Example for Alpine Linux
+# See /etc/finit.d/*.conf and `initctl list` for other services
+
+## Runlevel to start after bootstrap, runlevel 'S'
+# Default is 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 <sys/key/ctrlaltdel> [12345789] initctl reboot -- Rebooting system
+
+# Task to run if the kernel gets a power fail condition is pressed.
+# Asserted by Finit upon receiving SIGPWR (from the kernel).
+#task <sys/pwr/fail> [12345789] initctl poweroff -- Shutting down system
+
+## Bootstrap services and tasks
+# Can be listed here or in /etc/finit.d/*.conf

contrib/alpine/finit.d/Makefile.am

@@ -0,0 +1,23 @@
+SUBDIRS    = available
+docsdir   := @docdir@/contrib/alpine/finit.d
+d_LINKS    = acpid.conf crond.conf dropbear.conf getty.conf	\
+	     keymap.conf modules.conf ntpd.conf			\
+	     klogd.conf syslogd.conf
+
+install-exec-hook:
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/available
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/enabled
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		rm -f $$lnk;					\
+		$(LN_S) ../$$src $$lnk;				\
+	done
+
+
+uninstall-hook:
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		$(RM) -f $$lnk;					\
+	done

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

@@ -0,0 +1,4 @@
+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 syslog.conf watchdog.conf
+EXTRA_DIST = $(docs_DATA)

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

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

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

@@ -0,0 +1 @@
+service [2345] <pid/syslogd> env:-/etc/conf.d/crond crond -f -S $CRON_OPTS -- Cron daemon

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

@@ -0,0 +1,2 @@
+# Start SSH daemon as soon as basic networking comes up
+service [2345] env:-/etc/conf.d/dropbear dropbear -R -F $DROPBEAR_OPTS -- Dropbear SSH daemon

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

@@ -0,0 +1,5 @@
+# Consoles to start getty on when system is up
+tty [12345] /dev/ttyS0 noclear
+tty [12345] /dev/tty1  noclear nowait
+tty [2345]  /dev/tty2  noclear nowait
+tty [2345]  /dev/tty3  noclear nowait

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

@@ -0,0 +1,2 @@
+# Oneshot task to run once at bootstrap
+task [S] env:/etc/conf.d/loadkmap zcat $KEYMAP | loadkmap -- Loading keymap

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

@@ -0,0 +1 @@
+service [2345] lxdm -- Lightweight Login Manager

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

@@ -0,0 +1,7 @@
+## Linux kernel modules to load
+#module fbcon
+#module button
+#module evdev
+#module mousedev
+#module 8139cp
+module softdog

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

@@ -0,0 +1,2 @@
+# Busybox ntpd has no option to use syslog when running in foreground
+service [2345] <pid/syslogd> env:-/etc/conf.d/ntpd log ntpd -n $NTPD_OPTS -- NTP daemon

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

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

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

@@ -0,0 +1 @@
+service [S123456789] env:-/etc/conf.d/watchdog watchdog $WATCHDOG_OPTS $WATCHDOG_DEV -- System watchdog

contrib/alpine/install.sh

@@ -0,0 +1,57 @@
+#!/bin/sh
+
+if [ "x`id -u`" != "x0" ]; then
+    echo
+    echo "*** This script must run as root"
+    echo
+    exit 1
+fi
+
+# Adjust base directory
+grep -q alpine Makefile 2>/dev/null
+if [ $? -eq 0 ]; then
+    cd ../..
+elif [ ! -e configure.ac ]; then
+    echo "*** Please run this script from the Finit base directory."
+    exit 1
+fi
+
+echo
+echo "*** Install Finit on Alpine Linux"
+echo "========================================================================"
+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
+read -p "Do you want to continue (y/N)? " yorn
+
+if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
+    echo
+    echo "*** Installing Finit files ..."
+    make install
+    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/
+
+    read -p "*** Install Finit as the system default Init (y/N)? " yorn
+    if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
+	echo "*** Updating /sbin/init symlink --> finit ..."
+	cd /sbin
+	rm init
+	ln -s finit init
+
+	rm halt shutdown suspend
+	ln -s reboot halt
+	ln -s reboot shutdown
+	ln -s reboot suspend
+    fi
+    echo "*** Done"
+    echo
+else
+    echo
+    echo "*** Aborting install."
+    echo
+fi

contrib/alpine/rc.local

@@ -0,0 +1,8 @@
+#!/bin/sh
+# This script is executed once at boot, at the very end,
+# right before starting the TTYs.
+#
+# Each line is run in sequence.
+#
+# NOTE: Remember to set the executable bit!
+#

contrib/alpine/uninstall.sh

@@ -0,0 +1,39 @@
+#!/bin/sh
+
+if [ "x`id -u`" != "x0" ]; then
+    echo
+    echo "*** This script must run as root"
+    echo
+    exit 1
+fi
+
+read -p "Do you really want to uninstall Finit (y/N)? " yorn
+
+if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
+    echo
+    echo "*** Removing all Finit files ..."
+    rm -rf /usr/share/doc/finit
+    rm -rf /etc/finit.conf
+    rm -rf /etc/finit.d
+    rm -rf /lib/finit
+    if [ -e /etc/rc.local ]; then
+	echo "*** Skipping /etc/rc.local, not sure if we installed it ..."
+    fi
+
+    echo "*** Restoring BusyBox as /sbin/init ..."
+    cd /sbin
+    rm init
+    ln -s /bin/busybox init
+
+    rm halt shutdown reboot suspend
+    ln -s /bin/busybox halt
+    ln -s /bin/busybox shutdown
+    ln -s /bin/busybox reboot
+    ln -s /bin/busybox suspend
+    echo "*** Done"
+    echo
+else
+    echo
+    echo "*** Aborting uninstall."
+    echo
+fi

contrib/debian/Makefile.am

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

contrib/debian/README.md

@@ -0,0 +1,63 @@
+HowTo: Finit on Debian GNU/Linux
+================================
+
+HowTo use Finit to boot a Debian GNU/Linux system.  It is assumed that
+the user has already installed a compiler, C library header files, and
+other tools needed to build a GNU configure based project.  I.e., at
+the very least:
+
+    root@debian:~# apt install build-essential
+
+Like the [Alpine HowTo](../alpine/), you need to install [libuEv][] and
+[libite][], but since this is Debian — which takes infinite care of its
+users ♥ ♥ ♥ we don't need to worry about `pkg-config`, except for having
+it installed so it can locate the uEv and lite libraries.
+
+> With Debian everything just works!™
+
+... just make sure to install the following, so `ifup` and other basic
+tools pre-systemd work as intended.
+
+    root@debian:~# apt install initscripts console-setup
+
+> **Note:** 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`
+in `/etc/grub.d/10_inux` and run `update-grub`.  On reboot you will find
+a (finit) entry in the "Advanced options for Debian GNU/Linux" section.
+It is of course also possible to change the default init to Finit:
+
+    user@debian:~/finit# cd /sbin
+    user@debian:/sbin# sudo mv init oldinit
+    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
+enabled and available services, you can then use `enable` and `disable`
+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:** 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 ツ
+
+[libuEv]: https://github.com/troglobit/libuev
+[libite]: https://github.com/troglobit/libite

contrib/debian/build.sh

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# This script configures Finit for Debian, which needs a few more plugins
+# and tweaks than an embedded system usually does.
+#
+# Usage:
+#         user@jessie:~/finit$ contrib/debian/build.sh
+#
+
+echo
+echo "*** Configuring Finit for Debian"
+
+if [ ! -e configure ]; then
+    echo "    The configure script is missing, maybe you're using a version from GIT?"
+    echo "    Attempting to run the autogen.sh script, you will need these tools:"
+    echo "    autoconf, automake, libtool, pkg-config ..."
+    echo
+    ./autogen.sh
+fi
+echo
+
+# The plugins are optional, but you may need D-Bus and X11 if you want
+# to run X-Window, the other configure flags are however required.
+./configure								\
+    --prefix=/usr                     --exec-prefix=			\
+    --sysconfdir=/etc                 --localstatedir=/var		\
+    --enable-dbus-plugin              --enable-x11-common-plugin	\
+    --enable-alsa-utils-plugin	      --with-keventd			\
+    --with-random-seed=/var/lib/urandom/random-seed
+
+if [ $? -ne 0 ]; then
+    echo
+    echo "*** Configure script failed, have you installed libuEv and libite?"
+    echo
+    exit 1
+fi
+
+echo
+echo "*** Building ..."
+echo
+make
+
+if [ $? -ne 0 ]; then
+    echo
+    echo "*** The build failed for some reason"
+    echo
+    exit 1
+fi
+
+echo
+echo "*** Done"
+echo
+
+read -p "*** Run (sudo) install script (y/N)? " yorn
+if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
+    sudo contrib/debian/install.sh
+else
+    echo
+    echo "*** Use 'sudo contrib/debian/install.sh' later to install Finit"
+    echo
+fi

contrib/debian/finit.conf

@@ -0,0 +1,26 @@
+# /etc/finit.conf: Example for Debian GNU/Linux
+# See /etc/finit.d/*.conf and `initctl list` for other services
+
+## Runlevel to start after bootstrap, runlevel 'S'
+# Default is 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 <sys/key/ctrlaltdel> [12345789] initctl reboot -- Rebooting system
+
+# Task to run if the kernel gets a power fail condition is pressed.
+# Asserted by Finit upon receiving SIGPWR (from the kernel).
+#task <sys/pwr/fail> [12345789] initctl poweroff -- Shutting down system
+
+## Bootstrap services and tasks
+# Can be listed here or in /etc/finit.d/*.conf

contrib/debian/finit.d/Makefile.am

@@ -0,0 +1,24 @@
+SUBDIRS    = available
+docsdir   := @docdir@/contrib/debian/finit.d
+d_LINKS    = acpid.conf apparmor.conf avahi-daemon.conf		\
+	     bluetooth.conf console-setup.conf elogind.conf 	\
+	     getty.conf keyboard-setup.conf modules.conf	\
+	     plymouth-quit.conf rsyslogd.conf sshd.conf
+
+install-exec-hook:
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/available
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/enabled
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		rm -f $$lnk;					\
+		$(LN_S) ../$$src $$lnk;				\
+	done
+
+
+uninstall-hook:
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		$(RM) -f $$lnk;					\
+	done

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

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

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

@@ -0,0 +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 [2345] <pid/syslogd> env:-/etc/default/acpid log acpid -f $OPTIONS -- ACPI daemon

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

@@ -0,0 +1 @@
+task [2345] <sys/pwr/ac,pid/syslogd> halt:usr1 env:-/etc/default/anacron anacron -d -q $ANACRON_ARGS -- Anacron jobs

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

@@ -0,0 +1,2 @@
+sysv [S] /etc/init.d/apparmor -- AppArmor initialization
+

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

@@ -0,0 +1 @@
+service [2345] env:-/etc/default/avahi-daemon avahi-daemon -s $AVAHI_DAEMON_OPTS -- Avahi mDNS/DNS-SD Stack

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

@@ -0,0 +1,3 @@
+# To ignore errors like "org.freedesktop.hostname1", update the env file with
+# "--noplugin=hostname", i.e. append to BLUETOOTHD_OPTS
+service [2345] log:null env:-/etc/default/bluetooth /usr/libexec/bluetooth/bluetoothd -n $BLUETOOTHD_OPTS -- Bluetooth service

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

@@ -0,0 +1,2 @@
+# Oneshot task to run once at bootstrap
+task [S] /lib/console-setup/console-setup.sh -- Setting up console font and keymap

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

@@ -0,0 +1 @@
+service [2345] <sys/pwr/ac,pid/syslogd> env:-/etc/default/cron cron -f $EXTRA_OPTS -- Background job processing daemon

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

@@ -0,0 +1,4 @@
+# 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 [2345] <pid/syslogd> /lib/elogind/elogind -- Login manager

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

@@ -0,0 +1,7 @@
+# Consoles to start getty on when system is up
+tty [12345] /dev/tty1 linux noclear nowait
+tty [2345]  /dev/tty2 linux nowait
+tty [2345]  /dev/tty3 linux nowait
+tty [2345]  /dev/tty4 linux nowait
+tty [2345]  /dev/tty5 linux nowait
+tty [2345]  /dev/tty6 linux nowait

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

@@ -0,0 +1,2 @@
+# Oneshot task to run once at bootstrap
+task [S] /lib/console-setup/keyboard-setup.sh -- Setting up console keyboard layout

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

@@ -0,0 +1 @@
+service [3] lightdm -- Light Display Manager

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

@@ -0,0 +1,8 @@
+## Linux kernel modules to load
+#module fbcon
+#module button
+#module evdev
+#module loop
+#module psmouse
+#module mousedev
+#module 8139cp

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

@@ -0,0 +1,2 @@
+# Need to stop plymouth, or it'll block stdin on tty1
+task [S] /usr/bin/plymouth quit -- Stopping Plymouth Boot Screen

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

@@ -0,0 +1,3 @@
+# Start rsyslogd as soon as possible, should always run
+# Provides pid/syslogd condition
+service [S12345] name:syslogd env:-/etc/default/rsyslog rsyslogd -n $RSYSLOGD_OPTIONS -- Reliable syslog daemon

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

@@ -0,0 +1,2 @@
+# Simple NTP client (SNTP)
+service [2345] <net/route/default> env:-/etc/default/sntpd sntpd -n $SNTPD_OPTIONS -- SNTP client

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

@@ -0,0 +1,2 @@
+# Start SSH daemon as soon as basic networking comes up
+service [2345] <net/lo/up> env:-/etc/default/ssh /usr/sbin/sshd -D $SSHD_OPTS -- OpenSSH daemon

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

@@ -0,0 +1,2 @@
+# Start sysklogd as soon as possible, should always run if enabled
+service [S123456789] env:-/etc/default/syslogd syslogd -F $SYSLOGD_OPTIONS -- System logging daemon

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

@@ -0,0 +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 [3] xdm -nodaemon -- X Display Manager

contrib/debian/install.sh

@@ -0,0 +1,61 @@
+#!/bin/sh
+
+if [ "x`id -u`" != "x0" ]; then
+    echo
+    echo "=> Unfortunately this script must run as root (sudo) <="
+    echo
+    exit 1
+fi
+
+# Adjust base directory
+grep -q debian Makefile 2>/dev/null
+if [ $? -eq 0 ]; then
+    cd ../..
+elif [ ! -e configure.ac ]; then
+    echo "*** Please run this script from the Finit base directory."
+    exit 1
+fi
+
+echo
+echo "*** Install Finit on Debian GNU/Linux"
+echo "========================================================================"
+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
+read -p "Do you want to continue (y/N)? " yorn
+echo
+
+if [ "x$yorn" = "xy" -o "x$yorn" = "xY" ]; then
+    echo "Installing Finit files ..."
+    make install
+    cd /usr/share/doc/finit/contrib/debian
+    for file in finit.conf; do
+	install -vbD $file /etc/$file
+    done
+    cp -va finit.d /etc/
+
+    echo "*** Setting up a GRUB boot entry ..."
+    fn=/etc/grub.d/10_linux
+    if [ -e $fn ]; then
+	if `grep SUPPORTED_INITS $fn |head -1 |grep -q finit`; then
+	    echo "Already installed, done."
+	else
+	    echo "Adding Finit to list of SUPPORTED_INITS ..."
+	    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"
+    echo
+else
+    echo
+    echo "*** Aborting install."
+    echo
+fi

contrib/finit.conf

@@ -0,0 +1,85 @@
+# Sample finit.conf to demonstrate the syntax
+#
+host testbed
+
+# Linux kernel modules to load
+module button
+module evdev
+module loop
+module psmouse
+
+# 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 cpu.max:50000
+
+# Example extra cgroup
+cgroup maint  cpu.weight:100
+
+# Runlevel to start after bootstrap, runlevel 'S'
+runlevel 2
+
+# Network bringup script
+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 size:100k count:4
+
+# Virtual consoles to start getty on
+tty /dev/tty1
+tty /dev/tty2
+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 <sys/key/ctrlaltdel> [12345789] initctl reboot -- Rebooting system
+
+# Task to run if the kernel gets a power fail condition is pressed.
+# Asserted by Finit upon receiving SIGPWR (from the kernel).
+task <sys/pwr/fail> [12345789] initctl poweroff -- Shutting down system
+
+# Alternative method instead of runparts
+#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 [2] /etc/init.d/networking start      -- Start networking
+
+# Services to be monitored and respawned as needed
+
+# klgod and syslogd are placed in the maint cgroup
+cgroup.maint
+service [2345] <pid/syslogd> klogd -n     -- Kernel logging server
+service [2345] syslogd -n                 -- Syslog server
+
+# gdm in the system cgroup (default when read from it's own .conf file)
+cgroup.system
+service [3] cgroup:cpu.weight:250,mem.max:10M gdm -- GNOME Display Manager
+
+# Start SSH daemon with opts from /etc/default/ssh (if available), move
+# to user cgroup with cpu.weight:250.  Default for services is system
+# group.  Default weight in user group is 100 (above).  Max length of
+# cgroup argument is (currently) 63 chars.
+#
+# Notice alternative syntax where current cgroup is only set for this
+# particular service.
+service [2345] cgroup.user:cpu.weight:250,mem.max:10M env:-/etc/default/ssh /usr/sbin/sshd -D $SSHD_OPTS -- OpenSSH daemon
+
+# 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] <!net/route/default> log:/var/log/ntpd.log ntpd -n -l -I eth0 -- NTP daemon
+
+# Run start scripts from this directory
+# runparts /etc/start.d
+
+# For multiple instances of the same service, add :ID somewhere between
+# the service/run/task keyword and the command.
+service :80   [2345] /sbin/httpd -f -h /http -p 80   -- Web server
+service :8080 [2345] /sbin/httpd -f -h /http -p 8080 -- Old web server

contrib/finit.d/S05keyboard-setup

@@ -1,65 +0,0 @@
-#!/bin/sh
-### BEGIN INIT INFO
-# Provides:          keyboard-setup
-# Required-Start:    mountkernfs
-# Required-Stop:
-# Should-Start:      keymap udev
-# X-Start-Before:    checkroot
-# Default-Start:     S
-# Default-Stop:
-# X-Interactive:     true
-# Short-Description: Set preliminary keymap
-# Description:       Set the console keyboard as early as possible
-#                    so during the file systems checks the administrator
-#                    can interact.  At this stage of the boot process
-#                    only the ASCII symbols are supported.
-### END INIT INFO
-
-set -e
-
-# This script is not used by keyboard-configuration.  It is used
-# jointly by console-setup and console-setup-mini
-
-test -f /bin/setupcon || exit 0
-
-if [ -f /lib/lsb/init-functions ]; then
-    . /lib/lsb/init-functions
-else
-    log_action_begin_msg () {
-	echo -n "$@... "
-    }
-
-    log_action_end_msg () {
-	if [ "$1" -eq 0 ]; then 
-	    echo done.
-	else
-	    echo failed.
-	fi
-    }
-fi
-
-case "$1" in
-    stop)
-        # keyboard-setup isn't a daemon
-        ;;
-    start|force-reload|restart|reload)
-	case `readlink /proc/self/fd/2` in
-	    /dev/tty[0-9]*|/dev/vc/[0-9]*|/dev/console)
-	        log_action_begin_msg "Setting preliminary keymap"
-		if setupcon -k; then
-		    log_action_end_msg 0
-		else
-		    log_action_end_msg $?
-		fi
-		;;
-	    *)
-		exit 0 
-		;;
-	esac
-	;;
-    *)
-        echo 'Usage: /etc/init.d/keyboard-setup {start|reload|restart|force-reload|stop}'
-        exit 1
-        ;;
-esac
-

contrib/finit.d/S18acpid

@@ -1,81 +0,0 @@
-#!/bin/sh
-### BEGIN INIT INFO
-# Provides:          acpid
-# Required-Start:    $remote_fs $syslog
-# Required-Stop:     $remote_fs $syslog
-# X-Start-Before:    kdm gdm xdm hal
-# X-Stop-After:      kdm gdm xdm hal
-# Default-Start:     2 3 4 5
-# Default-Stop:      
-# Short-Description: Start the Advanced Configuration and Power Interface daemon
-# Description:       Provide a socket for X11, hald and others to multiplex
-#                    kernel ACPI events.
-### END INIT INFO
-
-set -e
-
-ACPID="/usr/sbin/acpid"
-DEFAULTS="/etc/default/acpid"
-
-# Check for daemon presence
-[ -x "$ACPID" ] || exit 0
-
-OPTIONS=""
-MODULES=""
-# Include acpid defaults if available
-[ -r "$DEFAULTS" ] && . "$DEFAULTS"
-
-# Get lsb functions
-. /lib/lsb/init-functions
-
-# As the name says. If the kernel supports modules, it'll try to load
-# the ones listed in "MODULES".
-load_modules() {
-    [ -f /proc/modules ] || return 0
-    if [ "$MODULES" = "all" ]; then
-        MODULES="$(sed -rn 's#^(/lib/modules/[^/]+/)?kernel/(drivers|ubuntu)/acpi/([^/]+/)*(.*)\.ko:.*#\4#p' "/lib/modules/$(uname -r)/modules.dep")"
-    fi
-
-    if [ -z "$MODULES" ]; then
-        return
-    fi
-
-    log_begin_msg "Loading ACPI kernel modules..."
-    # work around a bug in initramfs which leaks this env var Launchpad #291619
-    # and a bug in modprobe --all --quiet which doesn't load all modules and
-    # exits with non-zero exit status Debian #504088
-    unset MODPROBE_OPTIONS
-    modprobe --all --use-blacklist $MODULES 2>/dev/null
-    log_end_msg $?
-}
-
-case "$1" in
-  start)
-    load_modules || true
-    log_begin_msg "Starting ACPI services..."
-    start-stop-daemon --start --quiet --oknodo --exec "$ACPID" -- $OPTIONS
-    log_end_msg $?
-    ;;
-  stop)
-    log_begin_msg "Stopping ACPI services..."
-    start-stop-daemon --stop --quiet --oknodo --retry 2 --exec "$ACPID"
-    log_end_msg $?
-    ;;
-  restart)
-    $0 stop
-    sleep 1
-    $0 start
-    ;;
-  reload|force-reload) 
-    log_begin_msg "Reloading ACPI services..."
-    start-stop-daemon --stop --signal 1 --exec "$ACPID"
-    log_end_msg $?
-    ;;
-  status)
-    status_of_proc "$ACPID" acpid
-    ;;
-  *)
-    log_success_msg "Usage: /etc/init.d/acpid {start|stop|restart|reload|force-reload|status}"
-    exit 1
-esac
-

contrib/finit.d/S18kbd

@@ -1,259 +0,0 @@
-#!/bin/sh
-### BEGIN INIT INFO
-# Provides:          kbd
-# Required-Start:    $remote_fs
-# Required-Stop:
-# Default-Start:     S
-# Default-Stop:
-# X-Interactive:     true
-# Description: Set console screen modes and fonts
-# Short-Description:    Prepare console
-### END INIT INFO
-
-# This is the boot script for the `kbd' package.
-# It loads parameters from /etc/kbd/config and maybe loads
-# default font and map.
-# (c) 1997 Yann Dirson
-
-PKG=kbd
-if [ -r /etc/$PKG/config ]; then
-    . /etc/$PKG/config
-fi
-
-if [ -d /etc/$PKG/config.d ]; then
-    for i in `run-parts --list /etc/$PKG/config.d `; do
-       . $i
-    done
-fi
-
-# do some magic with the variables for compatibility with the config
-# file of console-tools
-for vc in '' `set | grep "^.*_vc[0-9][0-9]*="  | sed 's/^.*\(_vc[0-9][0-9]*\)=.*/\1/'`
-do
-    eval [ '"'\${SCREEN_FONT$vc}'"' ] && eval CONSOLE_FONT$vc=\${CONSOLE_FONT$vc:-\${SCREEN_FONT$vc}}
-    eval [ '"'\${SCREEN_FONT_MAP$vc}'"' ] && eval FONT_MAP$vc=\${FONT_MAP$vc:-\${SCREEN_FONT_MAP$vc}}
-    eval [ '"'\${APP_CHARSET_MAP$vc}'"' ] && eval CONSOLE_MAP$vc=\${CONSOLE_MAP$vc:-\${APP_CHARSET_MAP$vc}}
-done
-
-. /lib/lsb/init-functions
-
-PATH=/sbin:/bin:/usr/sbin:/usr/bin
-SETFONT_OPT="-v"
-
-if which setupcon >/dev/null
-then
-    HAVE_SETUPCON=yes
-fi
-
-# set DEVICE_PREFIX depending on devfs/udev
-if [ -d /dev/vc ]; then
-    DEVICE_PREFIX="/dev/vc/"
-else
-    DEVICE_PREFIX="/dev/tty"
-fi
-
-# determine the system charmap
-ENV_FILE=''
-[ -r /etc/environment ] && ENV_FILE="/etc/environment"
-[ -r /etc/default/locale ] && ENV_FILE="/etc/default/locale"
-[ "$ENV_FILE" ] && CHARMAP=$(set -a && . "$ENV_FILE" && locale charmap)
-if [ "$CHARMAP" = "UTF-8" -a -z "$CONSOLE_MAP" ]
-then
-    UNICODE_MODE=yes
-fi
-
-reset_vga_palette ()
-{
-    if [ -f /proc/fb ]; then
-        # They have a framebuffer device.
-        # That means we have work to do...
-        echo -n "]R"
-    fi
-}
-
-unicode_start_stop ()
-{
-    vc=$1
-    if [ -n "$UNICODE_MODE" -a -z "`eval echo \\$CONSOLE_MAP_vc$vc`" ]; then
-        action=unicode_start
-    else
-        action=unicode_stop
-    fi
-    if [ "${CONSOLE_FONT}" ]; then
-        $action "${CONSOLE_FONT}" < ${DEVICE_PREFIX}$vc > ${DEVICE_PREFIX}$vc 2> /dev/null || true
-    else
-        $action < ${DEVICE_PREFIX}$vc > ${DEVICE_PREFIX}$vc 2> /dev/null || true
-    fi
-}
-
-setup ()
-{
-    # be sure the main program is installed
-    which setfont >/dev/null || return
-
-    VT="no"
-    # If we can't access the console, quit
-    CONSOLE_TYPE=`fgconsole 2>/dev/null` || return
-
-    if [ ! $CONSOLE_TYPE = "serial" ]; then
-        readlink /proc/self/fd/0 | grep -q -e /dev/vc -e '/dev/tty[^p]' -e /dev/console
-        if [ $? -eq 0 ]; then
-            VT="yes"
-            reset_vga_palette
-        fi
-    fi
-
-    [ $VT = "no" ] && return
-
-    # start vcstime
-    if [ "${DO_VCSTIME}" = "yes" ] && which vcstime >/dev/null; then
-        [ "$VERBOSE" != "no" ] && log_action_begin_msg "Starting clock on text console"
-        vcstime &
-        [ "$VERBOSE" != "no" ] && log_action_end_msg 0
-    fi
-
-    if [ -d /etc/init ] && which initctl >/dev/null; then
-	    # Upstart
-	    LIST_CONSOLES=`cd /etc/init; find -name 'tty*.conf' -printf '%f ' | sed -e 's/[^0-9 ]//g'`
-    else
-	    # traditional SysV init
-	    LIST_CONSOLES=`sed -e '/^ *#/d' /etc/inittab | grep -e '\<tty[0-9]*\>' | awk -F: '{printf "%s ", $1}'`
-    fi
-
-    # Global default font+map
-    if [ -z "${HAVE_SETUPCON}" -a "${CONSOLE_FONT}" ]; then
-        [ "$VERBOSE" != "no" ] && log_action_begin_msg "Setting up general console font"
-        sfm="${FONT_MAP}" && [ "$sfm" ] && sfm="-u $sfm"
-        acm="${CONSOLE_MAP}" && [ "$acm" ] && acm="-m $acm"
-    
-        # Set for the first 6 VCs (as they are allocated in /etc/inittab)
-        for vc in $LIST_CONSOLES
-        do
-            if ! ( unicode_start_stop $vc \
-                   && setfont -C ${DEVICE_PREFIX}$vc ${SETFONT_OPT} $sfm ${CONSOLE_FONT} $acm )
-            then
-                [ "$VERBOSE" != "no" ] && log_action_end_msg 1
-                break
-            fi
-        done
-        [ "$VERBOSE" != "no" ] && log_action_end_msg 0
-    fi
-
-    # Default to Unicode mode for new VTs?
-    if [ -f /sys/module/vt/parameters/default_utf8 ]; then
-        if [ -n "$UNICODE_MODE" ]; then
-            echo 1
-        else
-            echo 0
-        fi > /sys/module/vt/parameters/default_utf8
-    fi
-
-    # Per-VC font+sfm
-    PERVC_FONTS="`set | grep "^CONSOLE_FONT_vc[0-9]*="  | tr -d \' `"
-    if [ -z "${HAVE_SETUPCON}" -a "${PERVC_FONTS}" ]; then
-        [ "$VERBOSE" != "no" ] && log_action_begin_msg "Setting up per-VC fonts"
-        for font in ${PERVC_FONTS}
-        do
-            # extract VC and FONTNAME info from variable setting
-            vc=`echo $font | cut -b16- | cut -d= -f1`
-            eval font=\$CONSOLE_FONT_vc$vc
-            # eventually find an associated SFM
-            eval sfm=\${FONT_MAP_vc${vc}}
-            [ "$sfm" ] && sfm="-u $sfm"
-            if ! ( unicode_start_stop $vc \
-                   && setfont -C ${DEVICE_PREFIX}$vc ${SETFONT_OPT} $sfm $font )
-            then
-                [ "$VERBOSE" != "no" ] && log_action_end_msg 1
-                break
-            fi
-        done
-        [ "$VERBOSE" != "no" ] && log_action_end_msg 0
-    fi
-
-
-    # Per-VC ACMs
-    PERVC_ACMS="`set | grep "^CONSOLE_MAP_vc[0-9]*="  | tr -d \' `"
-    if [ -z "${HAVE_SETUPCON}" -a "${PERVC_ACMS}" ]; then
-        [ "$VERBOSE" != "no" ] && log_action_begin_msg "Setting up per-VC ACM's"
-        for acm in ${PERVC_ACMS}
-          do
-          # extract VC and ACM_FONTNAME info from variable setting
-          vc=`echo $acm | cut -b15- | cut -d= -f1`
-          eval acm=\$CONSOLE_MAP_vc$vc
-          if ! setfont -C "${DEVICE_PREFIX}$vc" ${SETFONT_OPT} -m "$acm"; then
-              [ "$VERBOSE" != "no" ] && log_action_end_msg 1
-              break
-          fi
-        done
-        [ "$VERBOSE" != "no" ] && log_action_end_msg 0
-    fi
-    
-
-    # screensaver stuff
-    setterm_args=""
-    if [ "$BLANK_TIME" ]; then
-        setterm_args="$setterm_args -blank $BLANK_TIME"
-    fi
-    if [ "$BLANK_DPMS" ]; then
-        setterm_args="$setterm_args -powersave $BLANK_DPMS"
-    fi
-    if [ "$POWERDOWN_TIME" ]; then
-        setterm_args="$setterm_args -powerdown $POWERDOWN_TIME"
-    fi
-    if [ "$setterm_args" ]; then
-        setterm $setterm_args 
-    fi
-
-    # Keyboard rate and delay
-    KBDRATE_ARGS=""
-    if [ -n "$KEYBOARD_RATE" ]; then
-        KBDRATE_ARGS="-r $KEYBOARD_RATE"
-    fi
-    if [ -n "$KEYBOARD_DELAY" ]; then
-        KBDRATE_ARGS="$KBDRATE_ARGS -d $KEYBOARD_DELAY"
-    fi
-    if [ -n "$KBDRATE_ARGS" ]; then
-        [ "$VERBOSE" != "no" ] && log_action_begin_msg "Setting keyboard rate and delay"
-        kbdrate -s $KBDRATE_ARGS
-        [ "$VERBOSE" != "no" ] && log_action_end_msg 0
-    fi
-
-    # Inform gpm if present, of potential changes.
-    if [ -f /var/run/gpm.pid ]; then
-        kill -s WINCH `cat /var/run/gpm.pid` 2> /dev/null
-    fi
-
-    # Allow user to remap keys on the console
-    if [ -z "${HAVE_SETUPCON}" -a -r /etc/$PKG/remap ]; then
-        dumpkeys < ${DEVICE_PREFIX}1 | sed -f /etc/$PKG/remap | loadkeys --quiet
-    fi
-
-    # Set LEDS here
-    if [ -n "$LEDS" ]; then
-        for i in $LIST_CONSOLES
-        do
-            setleds -D $LEDS < $DEVICE_PREFIX$i
-        done
-    fi
-}
-
-case "$1" in
-    start|reload|restart|force-reload)
-        if [ -n "$HAVE_SETUPCON" ]
-        then
-                log_action_msg "Setting console screen modes"
-        else
-                log_action_msg "Setting console screen modes and fonts"
-        fi
-        setup
-	[ -z "$HAVE_SETUPCON" ] || log_action_msg "Skipping font and keymap setup (handled by console-setup)"
-        ;;
-    stop)
-        ;;
-    *)
-        setup
-        ;;
-esac
-
-:
-

contrib/fstab.bb

@@ -0,0 +1,15 @@
+# This is a basic /etc/fstab that mounts up all of the virtual filesystems
+# that older versions of Finit used to mount internally. It can serve as a
+# starting point for systems running Busybox's mount implementation. Make
+# sure that CONFIG_FEATURE_MOUNT_HELPERS enabled; as this is required
+# create the /dev/{pts,shm} directories.
+
+devtmpfs	/dev		devtmpfs	defaults		0	0
+mkdir#-p	/dev/pts	helper		none			0	0
+devpts		/dev/pts	devpts		mode=620,ptmxmode=0666	0	0
+mkdir#-p	/dev/shm	helper		none			0	0
+tmpfs		/dev/shm	tmpfs		mode=0777		0	0
+proc		/proc		proc		defaults		0	0
+tmpfs		/tmp		tmpfs		mode=1777,nosuid,nodev	0	0
+tmpfs		/run		tmpfs		mode=0755,nosuid,nodev	0	0
+sysfs		/sys		sysfs		defaults		0	0

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

@@ -0,0 +1,75 @@
+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/procmon.sh

@@ -0,0 +1,51 @@
+#!/bin/sh
+USAGE="Usage: $0 processName"
+LOG_FILE="/tmp/memusage.csv"
+ELAPSED_TIME=0
+PERIOD=1        # seconds
+
+if [ $# -ne 1 ]; then
+        echo $USAGE
+        exit 1
+fi
+
+echo "ElapsedTime,VmSize,VmRSS" > $LOG_FILE
+
+# Monitor memory usage forever until script is killed
+while :
+do
+        SUM_VM_SIZE=0
+        SUM_RSS_SIZE=0
+        # In case the monitored process has not yet started
+        # keep searching until its PID is found
+        PROCESS_PIDS=""
+        while :
+        do
+                PROCESS_PIDS=`/bin/pidof $1`
+                if [ "$PROCESS_PIDS.X" != ".X" ]; then
+                        break
+                fi
+        done
+
+        for PID in ${PROCESS_PIDS} ; do
+                VM_SIZE=`awk '/VmSize/ {print $2}' < /proc/$PID/status`
+                if [ "$VM_SIZE.X" = ".X" ]; then
+                        continue
+                fi
+                #echo exprVM_ $SUM_VM_SIZE + $VM_SIZE
+                SUM_VM_SIZE=`expr $SUM_VM_SIZE + $VM_SIZE`
+
+                VM_RSS=`awk '/VmRSS/ {print $2}' < /proc/$PID/status`
+                if [ "$VM_RSS.X" = ".X" ]; then
+                        continue
+                fi
+                SUM_RSS_SIZE=`expr $SUM_RSS_SIZE + $VM_RSS`
+        done
+        echo "$ELAPSED_TIME sec, $SUM_VM_SIZE KB, $SUM_RSS_SIZE KB"
+        echo "$ELAPSED_TIME,$SUM_VM_SIZE,$SUM_RSS_SIZE" >> $LOG_FILE
+        sleep $PERIOD
+        VM_SIZE=""
+        VM_RSS=""
+        # Needs to get actual elapsed time instead of doing this
+        ELAPSED_TIME=`expr $ELAPSED_TIME + $PERIOD`
+done

contrib/service

@@ -0,0 +1,33 @@
+#!/bin/sh
+
+JOB=$1
+CMD=$2
+
+usage() {
+    echo "Usage: service [job# | name] <stop | start | restart | status | show>"
+    exit 1
+}
+
+if [ $# -eq 0 ]; then
+    initctl show
+    exit 0
+fi
+
+case $CMD in
+    stop)
+	;;
+    start)
+	;;
+    restart)
+	;;
+    status)
+	;;
+    show)
+	;;
+    *)
+	usage
+	;;
+esac
+
+initctl $2 $1
+

contrib/void/Makefile.am

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

contrib/void/README.md

@@ -0,0 +1,62 @@
+HowTo: Finit on Void Linux
+==========================
+
+HowTo use Finit to boot an [Void Linux][] system.  It is assumed that
+the user has already installed make, a compiler, C library header files,
+and other tools needed to build a GNU configure based project.
+
+To start with you need to first install [libuEv][] and [libite][].  They
+default to install to `/usr/local`, but unlike Debian and Ubuntu based
+distros, Void's `pkg-config` does not look for libraries and header
+files there.  So the `PKG_CONFIG_LIBDIR` environment variable must be
+used, or change the install prefix to `/usr`.
+
+The bundled [build.sh](build.sh) script can be used to configure and
+build finit:
+
+    void:~# cd finit
+    void:~/finit# ./contrib/void/build.sh
+
+Then run the [install.sh](install.sh) script to install all necessary
+files, including the sample `finit.conf` and `finit.d/*.conf` files.
+More on that below.
+
+    void:~/finit# ./contrib/void/install.sh
+
+The install script is (supposed to be) non-destructive by default, you
+have to answer *Yes* twice to set up Finit as the system default init.
+Pay close attention to the last question:
+
+    *** Install Finit as the system default Init (y/N)?
+
+If you answer `No`, simply by pressing enter, you can change the symlink
+yourself later on, to point to `finit` instead of `runit`:
+
+    void:~/finit# cd /sbin
+    void:/sbin# rm init
+    void:/sbin# ln -s finit init
+
+Another option is to change the Grub defaults, in `/etc/default/grub`:
+
+    #GRUB_CMDLINE_LINUX_DEFAULT="loglevel=4 slub_debug=P page_poison=1"
+    GRUB_CMDLINE_LINUX_DEFAULT="loglevel=4 init=/sbin/finit"
+
+Alternatively, you can simply modify the default Grub entry at boot, or
+set up an alternative Grub entry to include:
+
+    linux /boot/vmlinuz-X.YY.Z ... init=/sbin/finit
+
+If you modify a Grub configuration file, remember to run:
+
+    update-grub
+
+Before rebooting, make sure to set up a [/etc/finit.conf](finit.conf),
+and [/etc/finit.d/](finit.d/) for your services.  Samples are included
+in this directory.  Notice the symlinks in `/etc/finit.d/`, which can be
+managed by the operator at runtime using `initctl enable SERVICE`.  You
+can also use a standard [/etc/rc.local](rc.local) for one-shot tasks and
+initialization like keyboard language etc.
+
+[libuEv]: https://github.com/troglobit/libuev
+[libite]: https://github.com/troglobit/libite
+[Void Linux]: https://www.voidlinux.eu/

contrib/void/build.sh

@@ -0,0 +1,37 @@
+#!/bin/sh -e
+
+echo
+echo "*** Configuring Finit for Void Linux"
+
+if [ ! -e configure ]; then
+    echo "    The configure script is missing, maybe you're using a version from GIT?"
+    echo "    Attempting to run the autogen.sh script, you will need these tools:"
+    echo "    autoconf, automake, libtool, pkg-config ..."
+    echo
+   ./autogen.sh
+fi
+
+# The plugins are optional, but you may need D-Bus and X11 if you want
+# to run X-Window, the other configure flags are however required.
+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			\
+		 --with-keventd			--with-sulogin
+
+echo
+echo "*** Building ..."
+echo
+make
+
+if [ $? -ne 0 ]; then
+    echo
+    echo "*** The build failed for some reason"
+    echo
+    exit 1
+fi
+
+echo
+echo "*** Done"
+echo

contrib/void/finit.conf

@@ -0,0 +1,26 @@
+# /etc/finit.conf: Example for Void Linux
+# See /etc/finit.d/*.conf and `initctl list` for other services
+
+## Runlevel to start after bootstrap, runlevel 'S'
+# Default is 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 <sys/key/ctrlaltdel> [12345789] initctl reboot -- Rebooting system
+
+# Task to run if the kernel gets a power fail condition is pressed.
+# Asserted by Finit upon receiving SIGPWR (from the kernel).
+#task <sys/pwr/fail> [12345789] initctl poweroff -- Shutting down system
+
+## Bootstrap services and tasks
+# Can be listed here or in /etc/finit.d/*.conf

contrib/void/finit.d/Makefile.am

@@ -0,0 +1,21 @@
+SUBDIRS    = available
+docsdir   := @docdir@/contrib/void/finit.d
+d_LINKS    = acpid.conf dhcpcd.conf getty.conf sshd.conf uuidd.conf
+
+install-exec-hook:
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/available
+	@$(MKDIR_P) $(DESTDIR)$(docsdir)/enabled
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		rm -f $$lnk;					\
+		$(LN_S) ../$$src $$lnk;				\
+	done
+
+
+uninstall-hook:
+	@for file in $(d_LINKS); do				\
+		lnk=$(DESTDIR)$(docsdir)/enabled/$$file;	\
+		src=available/$$file;				\
+		$(RM) -f $$lnk;					\
+	done

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

@@ -0,0 +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		\
+             sshd.conf syslog.conf uuidd.conf
+EXTRA_DIST = $(docs_DATA)

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

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

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

@@ -0,0 +1 @@
+service [2345] <pid/syslogd> crond -f -S -c /etc/crontabs -- Cron daemon

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

@@ -0,0 +1 @@
+service [2345] dhcpcd -B -M -- DHCP client

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

@@ -0,0 +1 @@
+service [S12345] dmeventd -f -- Device mapper event daemon

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

@@ -0,0 +1,4 @@
+# Consoles to start Finit built-in getty on when system is up
+tty [12345] /dev/tty1 noclear nowait
+tty [2345]  /dev/tty2 noclear nowait
+tty [2345]  /dev/tty3 noclear nowait

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

@@ -0,0 +1,2 @@
+# Oneshot task to run once at bootstrap
+task [S] zcat /etc/keymap/se.bmap.gz | loadkmap -- Loading keymap

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

@@ -0,0 +1 @@
+service [2345] lxdm -- Lightweight Login Manager

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

@@ -0,0 +1,7 @@
+## Linux kernel modules to load
+#module fbcon
+#module button
+#module evdev
+#module mousedev
+#module 8139cp
+module softdog

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

@@ -0,0 +1,2 @@
+# Silly Busybox ntpd has no option to use syslog when running in foreground
+service [2345] <pid/syslogd> log ntpd -n -N -p pool.ntp.org -- NTP daemon

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

@@ -0,0 +1,2 @@
+# Start SSH daemon as soon as basic networking comes up
+service [2345] /usr/sbin/sshd -D -- OpenSSH daemon

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

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