Skip to content

Latest commit

 

History

History
519 lines (399 loc) · 19.3 KB

ChangeLog.md

File metadata and controls

519 lines (399 loc) · 19.3 KB

Change Log

All relevant changes are documented in this file.

2.4 - 2015-12-04

Bug fix release.

Changes

  • Add support for status/show service by name:id
  • Enforce terse mode after boot, if verbose mode is disabled
  • Reenable verbose mode at reboot, if disabled at boot
  • Update section mentioning BusyBox getty
  • Update debugging documentation
  • Allow debug to override terse mode
  • Revert confusing change in service state introduced in v2.3. As of v2.4 services are listed as "halted" and "stopped", when they have been halted due to a runlevel changed or stopped by the user, respectively.

Fixes

  • Fix system freeze at reconfiguration. Changed services that all support SIGHUP caused a freeze due to Finit waiting for them to stop.
  • Make sure to start and/or SIGHUP services after reconfiguration when there was no services to stop.

2.3 - 2015-11-28

Bug fix release.

Changes

  • Add support for stop/start/restart/reload service by name:id
  • Refactor service status listed in initctl show, show actual status

Fixes

  • Remove bootstrap-only tasks/services when leaving runlevel 'S'
  • Fix reference counting issue with already stopped and removed services when the user performs initctl reload to change system configuration
  • Revert semantic change in behavior of initctl restart: users expect service to be stopped/started, not reloaded with SIGHUP even if the service supports it
  • Fix NULL pointer dereference causing kernel panic when user calls initctl reload after change of system configuration
  • Fix column alignment in output of initctl show for services not in current runlevel

2.2 - 2015-11-23

Lots of fixes to handle static builds, but also fixes for dynamic event handling and reconfiguration at runtime.

Changes

  • Upgrade to libuEv v1.2.4, to handle static builds
  • Upgrade to libite (LITE) v1.2.0, to handle static builds
  • Clarify how to select different plugins with the configure script
  • Improve urandom plugin for embedded systems w/o random seed
  • Add --debug flag to initctl
  • The runlevels listed for services in initctl show now hightlight the active runlevel.
  • Clarify in the README and in initctl help that the GW event to listen for in service declarations is GW:UP

Fixes

  • Build fixes for configure --disable-inetd
  • Fixed issue #14: Improved support for static Finit builds
  • Misc. fixes to silence warnings when building a static Finit
  • Default to register services as SIGHUP'able, regression in v2.0
  • Call HOOK_SVC_RECONF only when all processes have been stopped
  • On reload/reconf we must wait for all services to stop first
  • Only trigger on events that matches the service's specification, fix by Tobias Waldekranz

2.1 - 2015-10-16

Changes

  • Add hook point for fstab mount failure
  • Set hostname on dynamic reload
  • Upgrade to libite v1.1.1

Fixes

  • Fix service callback coredump checks and simplify callback exit
  • Do not use -Os use -O2 as default optimization level. Many cross compiler toolchains are known to have problems with -Os
  • Do not allow build VERSION to be overloaded by an environment variable
  • Fix too small MAX arguments and too few argments in svc_t for reading currently running services with initctl show
  • Unblock blocked signals after forking off a child

2.0 - 2015-09-20

Support for multiple instances and event based services, as well as the introduction of an initctl tool.

Note: Incompatible change to syntax for custom inetd services, c.f. Finit v1.12.

Changes

  • The most notable change is the support for multiple instances. A must have when running multiple DHCP clients, OpenVPN tunnels, or anything that means using the same command only with different arguments. Now simply add a :ID after the service keyword, where ID is a unique instance number for that service.

      service :1 [2345] /sbin/httpd -f -h /http -p 80   -- Web server
  service :2 [2345] /sbin/httpd -f -h /http -p 8080 -- Old web server

  • Another noteworthy new feature is support for starting/stopping services on Netlink events:

      service :1 [2345] <!IFUP:eth0,GW> /sbin/dropbear -R -F -p 22 -- SSH daemon

    Here the first instance :1 of the SSH daemon is declared to run in runlevels 2-5, but only if eth0 IFUP:eth0 is up and a gateway GW is set. When the configuration changes, a new gateway is set, or if somehow a new IFUP event for eth0 is received, then dropbear is not SIGHUP'ed, but instead stop-started <!>. The latter trick applies to all services, even those that do not define any events.

  • Support for reloading *.conf files in /etc/finit.d/ on SIGHUP. All task, service and run statements can be used in these .conf files. Use the telinit q command, initctl reload or simply send SIGHUP to PID 1 to reload them. Finit automatically does reload of these *.conf files when changing runlevel.

  • Support for a modern initctl tool which can stop/start/reload and list status of all system services. Also, the old client tool used to change runlevel is now also available as a symlink: telinit.

      initctl [-v] <status|stop|start|reload|restart> [JOB]

  • Add concept of "jobs". This is a unique identifier, composed of a service and instance number, SVC:ID

      initctl <stop|start|reload|restart> JOB

  • Support for deny filters in inetd services.

      inetd service/proto[@iface,!iface,...] </path/to/cmd | internal[.service]>

    Internal services on a custom port must use the internal.service syntax so Finit can properly bind the inetd service to the correct plugin. Here follows a few examples:

      inetd time/udp                    wait [2345] internal                -- UNIX rdate service
  inetd time/tcp                  nowait [2345] internal                -- UNIX rdate service
  inetd 3737/tcp                  nowait [2345] internal.time           -- UNIX rdate service
  inetd telnet/tcp@*,!eth1,!eth0, nowait [2345] /sbin/telnetd -i -F     -- Telnet service
  inetd 2323/tcp@eth1,eth2,eth0   nowait [2345] /sbin/telnetd -i -F     -- Telnet service
  inetd 222/tcp@eth0              nowait [2345] /sbin/dropbear -i -R -F -- SSH service
  inetd ssh/tcp@*,!eth0           nowait [2345] /sbin/dropbear -i -R -F -- SSH service

    Access to telnet on port 2323 is only possible from interfaces eth0, eth1 and eth2. The standard telnet port (23) is available from all other interfaces, but also eth2. The * notation used in the ssh stanza means any interface, however, here eth0 is not allowed.

    NOTE: This change breaks syntax compatibility with Finit v1.12.

  • Support for a more user-friendly configure script rather than editing the top Makefile, or setting environment variables at build time.

  • Support for building Finit statically, no external libraries. This unfortunately means that some plugins cannot be built, at all. Big thanks goes to James Mills for all help testing this out!

  • Support for disabling the built-in inetd server with configure.

  • Support for two new hook points: HOOK_SVC_RECONF and HOOK_RUNLEVEL_CHANGE. See the source for the exact location.

  • The include <FILE> option now needs an absolute path to FILE.

Fixes

  • Rename patches/ to contrib/ to simplify integration in 3rd party build systems.
  • Fix for unwanted zombies ... when receiving SIGCHLD we must reap all children. We only receive one signal, but multiple processes may have exited and need to be collected.

1.12 - 2015-03-04

The inetd release.

Changes

  • Add support for built-in inetd super server -- launch services on demand. Supports filtering per interface and custom Inet ports.
  • Upgrade to libuEv v1.1.0 to better handle error conditions.
  • Allow mixed case config directives in finit.conf
  • Add support for RFC 868 (rdate) time plugin, start as inetd service.
  • Load plugins before parsing finit.conf, this makes it possible to extend finit even with configuration commands. E.g., the time.so plugin must be loaded for the inetd time/tcp internal service to be accepted when parsing finit.conf.
  • Slight change in TTY fallback behavior, if no TTY is listed in the system finit.conf first inspect the console setting and only if that too is unset fall back to /bin/sh
  • When falling back to the console TTY or /bin/sh, finit now marks this fallback as console. Should improve usability in some use cases.

Fixes

  • Revert "Use vfork() instead of fork() before exec()" from v1.11. It turned out to not work so well after all. For instance, launching TTYs in a background process completely blocked inetd services from even starting up listening sockets ... proper fork seems to work fine though. This is the casue for yanking the 1.11 release, below.
  • Trap segfaults caused by external plugins/callbacks in a sub-process. This prevents a single programming mistake in by a 3rd party developer from taking down the entire system.
  • Fix Coverity CID 56281: dlopen() resource leak by storing the pointer. For the time being we do not support unloading plugins.
  • Set hostname early, so bootstrap processes like syslog can use it.
  • Only restart lost daemons when recovering from a SIGSTOP/norespawn.

1.11 - 2015-01-24 [YANKED]

The libuEv release.

Note: This release has been yanked from distribution due to a regression in launching background processes and TTY's. Fixed in Finit v1.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