An open API service indexing awesome lists of open source software.

https://github.com/troglobit/finit-plugins

Plugin Repository for Finit
https://github.com/troglobit/finit-plugins

finit init pid1 plugins

Last synced: 2 months ago
JSON representation

Plugin Repository for Finit

Awesome Lists containing this project

README

          

Finit Plugin Repository
=======================

This repository is for external plugins not part of mainline [Finit][].

> **Note:** contributions to this repo are expected to follow the coding
> style of 1) an existing plugin, or 2) coding style of Finit. It is
> also expected that contributions are tested against the latest release
> of Finit, or current mainline. Please describe your changes, or what
> a new plugin does (code is not self documenting) in the PR and also
> describe how you have verified the change or tested a new plugin.

Finit v4.4, and later, is required for these plugins. Earlier versions
of Finit did not export all required header files. Loading of external
plugins is supported as of Finit v4.4 from (in order) `/usr/lib/finit`
and `/usr/local/lib/finit`. This in addition to the main search path
for native plugins (`/lib/finit`).

Build & Install
---------------

This assumes Finit header files are installed in `/usr/include/finit`.

./autogen.sh
./configure --prefix=/usr
make
sudo make install

The build system is based on GNU autotools so it honors the `DESTDIR`
environment variable.

Notice
------

The plugins used to depend on an optional Finit plugin called `mdevd.so`,
this has been replaced in upstream Finit with two .conf lines:

service [S12345789] cgroup.system notify:s6 @root:root mdevd -O 4 -D %n -- Extended Hotplug Daemon (mdevd)
task [S] @root:root mdevd-coldplug -- Replaying hotplug events to mdevd

Any services that today are plugins and depend on `mdevd` should be
started as plain services instead. With an additional condition to
ensure they are started *after* mdevd, e.g.

service [S12345789] ...

Disclaimer
----------

All boiler-plate files, e.g., build system files, are copyright free and
in the public domain. Each plugin, however, is copyright the respective
author(s), and they are all licensed under the same [MIT license][] as
[Finit][], due to runtime linking.

[Finit]: https://github.com/troglobit/finit
[MIT license]: https://en.wikipedia.org/wiki/MIT_License