mulle-atinit

🤱🏼 Compatibility library for deterministic initializers

This is a workaround for dynamic libraries initializers not being properly sequenced (e.g. an ELF shared library).

Release Version	Release Notes
	RELEASENOTES

You must statically link the mulle-atinit library with your executable. Ensure that global symbols are exported and that the whole library is linked to the executable and not optimized away by the linker.

Platform	Linker Flags
Linux	`-Wl,--export-dynamic -Wl,--whole-archive`
macos	`-force_load <library>`

Any participating shared library constructor uses

mulle_atinit( f, userinfo, priority);

to defer f to a later date.

The function f will be called properly sequenced before main. userinfo will be passed as the only parameter. You use priority 0 normally. Use higher priorities to move initializers ahead.

Missing `dlsym`

If you are linking your executable statically and dlsym is not available (musl) then you must define __MULLE_STATICALLY_LINKED__, when building all dependencies that use mulle_atinit. Dynamic linking with a missing dlsym won't work.

Add

Use mulle-sde to add mulle-atinit to your project:

mulle-sde add github:mulle-core/mulle-atinit

To only add the sources of mulle-atinit with dependency sources use clib:

clib install --out src/mulle-core mulle-core/mulle-atinit

Add -isystem src/mulle-core to your CFLAGS and compile all the sources that were downloaded with your project.

Install

Install with mulle-sde

Use mulle-sde to build and install mulle-atinit and all dependencies:

mulle-sde install --prefix /usr/local \
   https://github.com/mulle-core/mulle-atinit/archive/latest.tar.gz

Manual Installation

Install the requirements:

Requirements	Description
mulle-thread	🔠 Cross-platform thread/mutex/tss/atomic operations in C
mulle-dlfcn	♿️ Shared library helper

Download the latest tar or zip archive and unpack it.

Install mulle-atinit into /usr/local with cmake:

cmake -B build \
      -DCMAKE_INSTALL_PREFIX=/usr/local \
      -DCMAKE_PREFIX_PATH=/usr/local \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK

mulle-core/mulle-atinit