$darkmode
Elektra 0.10.0
0.9.<<VERSION>> Release

This release did not happen yet.

Please always update this file within every PR:

  1. write what changed
  2. use links pointing to your change (See Documentation Guidelines)
  3. add your name at the end of the line Syntax: _(your name)_

For example, Max would write:

- Added a new [doc plugin](https://www.libelektra.org/plugins/doc) _(Max)_

Pick a random line to write your changes to minimize the chances of conflicts in this file.

For non-trivial changes, you can choose to be part of the highlighted changes. Please write a highlight section in this case.

After the horizontal line the release notes for the next version starts.


<<scripts/generate-news-entry>>

We are proud to release Elektra 0.9.<<VERSION>>.

What is Elektra?

Elektra serves as a universal and secure framework to access configuration settings in a global, hierarchical key database. For more information, visit https://libelektra.org.

You can also read the news on our website.

You can try out the latest Elektra release using our docker image elektra/elektra. This is the quickest way to get started with Elektra without compiling and other obstacles, simply run:

docker pull elektra/elektra
docker run -it elektra/elektra

Highlights

  • New Changetracking API
  • New spec plugin
  • <<HIGHLIGHT>>

New Changetracking API

We've created a new KeySet diffing and changetracking API for both internal and external use. Several plugins already had their own implementations to detect changes made to the key database. Every implementation did something different and results varied. With this new release every plugin now uses the same shared implementation, with identical results!

To try the amazing new API yourself, take a look at the tutorial.

Elektra's internal code now also uses this new API to detect which backends to execute. This can lead to better performance in I/O bound cases, where previously certain keys would have been detected as changed when they weren't.

We ran some memory benchmarks and found a slightly increased memory usage on a stock instance of Elektra. If you're using many plugins that do changetracking, the overhead will decrease.

Number of Keys Old Implementation (bytes) New Implementation (bytes) Memory Increase (%)
50 225792 bytes 229580 bytes 1,68 %
500 383180 bytes 411238 bytes 7,32 %
5000 1992294 bytes 2306867 bytes 15,79 %
50000 18245222 bytes 21181235 bytes 16,09 %
500000 178782208 bytes 207827763 bytes 16,25 %

Apart from memory benchmark, we also ran some performance benchmarks. As the benchmark is heavily I/O bound, the biggest bottleneck is the I/O performance of the system. We could not reliably detect a real, reliably reproducible performance impact measured in seconds. Alternatively, we have measured executed instructions. There seems to be about 10 % overhead, but we don't expect it to be noticeable in real-world workloads.

Number of Keys Old Implementation (Instructions) New Implementation (Instructions) Performance Overhead (%)
50 18910449 19583227 3,56 %
500 63001911 68948096 9,44 %
5000 526801917 586344210 11,30 %
50000 5730261920 6340292587 10,65 %
500000 104614374974 110702166761 5,82 %

New spec plugin

The spec plugin was rewritten to use the standardized error handling in Elektra. It is now strictly defined that the spec plugin throws a warning on kdbGet and on any other call an error.

Default values are now created in the default namespace. The instantiated array specifications are now also created in the default namespace.

Keys with a require metakey and no default metakey do throw an error now.

Known limitations:

  • # and _ keys do not work on MINGW
  • No defaults for _ globbing character

For more information see Spec Plugin.

Go into repo

The go binding is now inside of libelektra repository. It is now also included into our build pipeline. For more information on how to use it see go readme.

NOTE: On information how to publish new versions of go-elektra to go packages see go-publishing.

Plugins

The following text lists news about the plugins we updated in this release.

General

  • Updated target name of shared object files according to #3486

spec

  • Rewrite spec plugin, fix bugs and use correct error handling _(Tomislav Makar @tmakar)_
  • Remove info metakey from spec plugin _(Tomislav Makar @tmakar)_

counter

  • Move static variables into functions to avoid global variables _(@kodebach)_

logchange

  • Utilize new changetracking API _(Maximilian Irlinger @atmaxinger)_
  • Add Maximilian Irlinger as maintainer _(Maximilian Irlinger @atmaxinger)_

yajl

  • The itKs global variable workaround, which was used to replace the now removed internal KeySet cursor, was replaced with a custom context struct. _(@kodebach)_

toml

  • The flex lexer and bison parser are now fully reentrant and therefore thread-safe. _(@kodebach)_

multifile

  • Remove multifile plugin as it is unmaintained and conflicts with the new backend architecture _(Maximilian Irlinger @atmaxinger)_

c

  • Add Florian Lindner as maintainer _(Florian Lindner @flo91)_
  • Use separate symbols for set and commit functions to satisfy kdb plugin-check _(@kodebach)_
  • Use new elektraPluginGetPhase() instead of counting executions _(@kodebach)_

mmapstorage

Note: The plugin is currently disabled, because it is not yet compatible with the COW data structures.

TODO: remove above note, when COW support is added.

  • The magic data structures are now fully compile-time constants. The magic number to detect endianness is generated in CMake instead of at runtime. _(@kodebach)_

syslog

  • Convert to hook plugin _(Maximilian Irlinger @atmaxinger)_
  • Utilize new changetracking API _(Maximilian Irlinger @atmaxinger)_

lineendings

  • Add Florian Lindner as maintainer _(Florian Lindner @flo91)_

length

  • Add Florian Lindner as maintainer _(Florian Lindner @flo91)_

missing

  • Add Florian Lindner as maintainer _(Florian Lindner @flo91)_

unit

  • Add Florian Lindner as maintainer _(Florian Lindner @flo91)_

dbus

  • Utilize new changetracking API _(Maximilian Irlinger @atmaxinger)_
  • Add Maximilian Irlinger as maintainer _(Maximilian Irlinger @atmaxinger)_

internalnotifications

  • Utilize new changetracking API _(Maximilian Irlinger @atmaxinger)_
  • Add Maximilian Irlinger as maintainer _(Maximilian Irlinger @atmaxinger)_

Libraries

The text below summarizes updates to the C (and C++)-based libraries of Elektra.

Compatibility

Core

  • The syslog logging code now calls openlog before every syslog to avoid the use of a global variable. _(@kodebach)_
  • Fix memleak in kdb.c, #4925 _(@hannes99)_

loader

  • Adapt target rename with -plugin- in dl.c _(Tomislav Makar @tmakar)_

go

  • Golang is now included to build go binding _(Tomislav Makar @tmakar)_
  • From now on we use tags which are prefixed with v so go package versioning works _(Tomislav Makar @tmakar)_

kdb

  • Add new changetracking API _(Maximilian Irlinger @atmaxinger)_
  • Fix unwanted removal of subkeys when using mv _(Hannes Laimer @hannes99)_
  • Fix inconsistent return values in code, tests and man pages _(Hannes Laimer @hannes99)_
  • Remove smount alias _(Hannes Laimer @hannes99)_

Bindings

Bindings allow you to utilize Elektra using various programming languages. This section keeps you up-to-date with the multi-language support provided by Elektra.

jna

  • Updated Java binding related dependencies. _(Michael Tucek @tucek)_
  • Updated KDBException to only access error key at construction time. _(Michael Tucek @tucek)_
  • Removed public naive resource release API. To migrate just remove calls to the affected methods Key#release(), KeySet#release() and KDBException#releaseErrorKey() _(Michael Tucek @tucek)_
  • Enabled strict javadoc checking for Gradle build _(Michael Tucek @tucek)_
  • add merging based on elektraMerge _(Maximilian Irlinger @atmaxinger)_
  • Added support for ksIncRef for KeySet _(Michael Tucek @tucek)_
  • Enabled ReferenceCleaner _(Michael Tucek @tucek)_

go-elektra

  • Move go-elektra binding from repository into bindings folder of libelektra _(Tomislav Makar @tmakar)_
  • Change module for go-elektra _(Tomislav Makar @tmakar)_
  • Rename go-elektra module _(Tomislav Makar @tmakar)_
  • Adapt README for go-elektra and change module name to match github.com _(Tomislav Makar @tmakar)_

<<Binding>>

  • <<TODO>>
  • <<TODO>>
  • <<TODO>>

<<Binding>>

  • <<TODO>>
  • <<TODO>>
  • <<TODO>>

<<Binding>>

  • <<TODO>>
  • <<TODO>>
  • <<TODO>>

<<Binding>>

  • <<TODO>>
  • <<TODO>>
  • <<TODO>>

Tools

elektrad

  • Implemented new request to add multiple metakeys for one key _(Tomislav Makar @tmakar)_
  • Adding bulk creation request for configuration keys _(Tomislav Makar @tmakar)_

webd

  • Implemented new request to add multiple metakeys for one key _(Tomislav Makar @tmakar)_
  • Adding bulk creation request for configuration keys _(Tomislav Makar @tmakar)_

Scripts

Jenkins

  • Use only v prefix for tags not in real version _(Tomislav Makar @tmakar)_

Release

  • Exclude v prefix from populate-release-notes.sh script _(Tomislav Makar @tmakar)_
  • Handle tag prefix v correctly in release.sh _(Tomislav Makar @tmakar)_
  • Check for v prefix in make-source-package script and Jenkinsfile.release _(Tomislav Makar @tmakar)_
  • Use correct tags for git-release-stats script _(Tomislav Makar @tmakar)_

Documentation

  • Adapt and remove outdated docs https://issues.libelektra.org/4882 _(Tomislav Makar @tmakar)_
  • Added missing dependencies in COMPILE.md for APT-based systems _(Michael Tucek @tucek)_
  • Add default namespace to namespaces documentation _(Tomislav Makar @tmakar)_
  • Added Tomislav Makar to AUTHORS.md _(Tomislav Makar @tmakar)_
  • Added Florian Lindner to AUTHORS.md _(Florian Lindner @flo91)_
  • .github rework _(Markus Raab)_
  • Added hook to placements contract in CONTRACT.ini _(Tomislav Makar @tmakar)_
  • Added hook information to hooks.md
  • Added Hannes Laimer to AUTHORS.md _(Hannes Laimer @hannes99)_
  • Add README to tools/kdb _(Hannes Laimer @hannes99)_
  • Fixed shell-recorder test in `install-webui.md` _(Tomislav Makar @tmakar)_
  • Add new shell-recorder test in `install-webui.md` for newly implemented request for adding multiple metakeys for one key _(Tomislav Makar @tmakar)_
  • <<TODO>>
  • <<TODO>>
  • <<TODO>>
  • Small fixes in decisions. _(Markus Raab)_
  • <<TODO>>
  • <<TODO>>
  • <<TODO>>
  • Remove wikipedia from release todos in RELEASE.md _(Tomislav Makar @tmakar)_
  • <<TODO>>
  • Update AUTHORS.md info _(@kodebach)_
  • Add Stefan Hanreich to AUTHORS.md _(Stefan Hanreich @lawli3t)_

Use Cases

  • Add specification use case for array-specification _(Tomislav Makar @tmakar)_
  • Add specification use case for underline-specification _(Tomislav Makar @tmakar)_
  • Add specification use case for simple-specification _(Tomislav Makar @tmakar)_
  • Add specification use case for enum-specification _(Tomislav Makar @tmakar)_
  • Add complete specification for dockerd configuration file (daemon.json) _(Tomislav Makar @tmakar)_

Decisions

  • Decide and implement decision process _(Markus Raab)_
  • Decided future library split _(@kodebach)_
  • Decided decision process _(Markus Raab)_
  • Draft for man pages _(Markus Raab)_
  • Add decision for change tracking _(Maximilian Irlinger @atmaxinger)_
  • Create decision for allowed and prohibited operation seqences _(Maximilian Irlinger @atmaxinger)_
  • Add decisions about location of headers and use of `#include` in the repo _(@kodebach)_
  • Add decision about metadata semantics _(@kodebach)_
  • Many small fixes to adapt to documentation guidelines and new decision process. _(Markus Raab)_
  • Add decision for read-only keynames _(Maximilian Irlinger @atmaxinger)_
  • Revive keyname decision _(@kodebach)_
  • Add decision for copy-on-write and provide implementation suggestions. _(Maximilian Irlinger @atmaxinger)_
  • Added explanation on why we wanted to migrate from Maven to Gradle for Java-related build facilities. _(Michael Tucek @tucek)_

Tutorials

  • Add basic tutorial about changetracking _(Maximilian Irlinger @atmaxinger)_

Man Pages

Tests

Build

Docker

  • CentOS 8 Stream: manually install config-manager DNF plugin. _(Maximilian Irlinger @atmaxinger)_

Infrastructure

Cirrus

  • Rename deprecated d-bus to dbus in macOS.yml and .cirrus.yml Issue-#4900 _(Tomislav Makar @tmakar)_
  • Push FreeBSD 12.3 to 12.4 since 12.3 is end of life. _(Richard Stöckl @eiskasten)_

GitHub Actions

Website

The website is generated from the repository, so all information about plugins, bindings and tools are always up-to-date. Furthermore, we changed:

Miscellaneous

  • Many global variables that where used as constants have been made fully const _(@kodebach)_

Outlook

We are currently working on following topics:

  • Rewriting tools in C _(@hannes99)_
  • Elektrify KDE and GNOME _(Mihael Pranjić @mpranj)_
  • Elektrify XFCE _(Richard Stöckl @Eiskasten)_
  • Mounting SQL databases _(Florian Lindner @flo91)_
  • Recording Configuration _(Maximilian Irlinger)_
  • Ansible-Elektra _(Maximilian Irlinger)_
  • Configure Olimex Base Images _(Maximilian Irlinger)_
  • Improving Build Server Infrastructure _(Lukas Hartl)_
  • Improve Java Development Experience _(Michael Tucek)_

Statistics

We closed <> issues for this release.

<<scripts/git-release-stats 0.9.VER-1 0.9.<<VERSION>>>>

Thanks to all authors for making this release possible!

Join the Initiative!

We welcome new contributors! Read here about how to get started.

As first step, you could give us feedback about these release notes. Contact us via our issue tracker.

Get the Release!

You can download the release from

The hashsums are:

<<scripts/generate-hashsums elektra-0.9.<<VERSION>>.tar.gz>>

The release tarball is also available signed using GnuPG from

The following GPG Key was used to sign this release: 12CC44541E1B8AD9B66AFAD55262E7353324914A

Already built API documentation can be found

Stay tuned!

Subscribe to the RSS feed to always get the release notifications.

If you also want to participate, or for any questions and comments, please contact us via our issue tracker on GitHub.

Permalink to this NEWS entry

For more information, see https://libelektra.org.

Best regards, Elektra Initiative