.. | ||
admin | ||
client | ||
federation | ||
identity | ||
js | ||
key | ||
media | ||
widget | ||
console.cc | ||
llvm.cc | ||
m_breadcrumbs.cc | ||
m_bridge.cc | ||
m_bridge_register.cc | ||
m_command.cc | ||
m_control.cc | ||
m_device.cc | ||
m_device_list_update.cc | ||
m_direct.cc | ||
m_direct_to_device.cc | ||
m_ignored_user_list.cc | ||
m_listen.cc | ||
m_noop.cc | ||
m_presence.cc | ||
m_profile.cc | ||
m_push.cc | ||
m_pusher.cc | ||
m_receipt.cc | ||
m_relation.cc | ||
m_room_aliases.cc | ||
m_room_canonical_alias.cc | ||
m_room_create.cc | ||
m_room_history_visibility.cc | ||
m_room_join_rules.cc | ||
m_room_member.cc | ||
m_room_message.cc | ||
m_room_name.cc | ||
m_room_power_levels.cc | ||
m_room_redaction.cc | ||
m_room_server_acl.cc | ||
m_room_third_party_invite.cc | ||
m_room_tombstone.cc | ||
m_signing_key_update.cc | ||
Makefile.am | ||
net_dns_cache.cc | ||
README.md | ||
stats.cc | ||
web_hook.cc | ||
web_root.cc | ||
well_known.cc |
Module Tree
This directory contains dynamically loadable functionality to libircd.
Approach
Unlike most of the module systems found in traditional C free software projects, our approach is oriented around global symbol availability to the address space rather than explicit imports from self-contained modules. This direction is made viable by C++ and advances in the compiler and linker toolchains. The result is significantly simpler and more convenient for developers to work with.
GLOBAL SYMBOLS
Modules are loaded with RTLD_GLOBAL
on both posix and windows platforms.
Use of C++ namespaces, visibility attributes, STB_GNU_UNIQUE
, etc are
adequate to make this modernization.
WEAK UNDEFINED SYMBOLS
All project code is built to silently weaken undefined symbols. This means a complicated interface declared in a header, like a class interface with public and private and static members (typical in C++) can be included by itself into any part of the project without knowing where the definitions of that interface are until they are first used at runtime.
If definitions are not available because they are in an unloaded module: a C++ exception is thrown directly from the callsite. We have built this action is built into the lookup mechanism of the runtime dynamic linker; none of this requires knowledge or effort from developers to use.
Layout
(TODO)
Getting started
The header mods/mapi.h
is specific to modules and included for modules in
addition to the core ircd.h
. Both of these are included automatically
via the compiler's command-line and the developer does not have to #include
either in the module.
- Every loadable module requires a static
ircd::mapi::header
with the explicit name ofIRCD_MODULE
. This is an object which will be sought by the module loader in libircd.
// Example of a trivial module
ircd::mapi::header
IRCD_MODULE
{
"My Module", []
{
puts("hi\n");
}
};
-
Add an
_la_SOURCES
entry for your module in the appropriate place in Makefile.am. -
Add the module
.la
name to the appropriate LTLIBRARIES list in Makefile.am.