0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-06-29 07:18:20 +02:00
construct/ircd
2021-09-15 01:44:36 -07:00
..
.gitignore
allocator.cc ircd::fs: Move madvise suite to allocator unit. 2021-05-11 20:56:09 -07:00
allocator_gnu.cc
allocator_je.cc
assert.cc ircd: Reduce code generated for argument prep in assert block; jump directly to lfence. 2021-09-15 01:44:36 -07:00
b58.cc
b64.cc
backtrace.cc
cbor.cc
cl.cc ircd:🆑 Remove build success stub assertion; add stub debuglog. 2021-09-14 23:39:55 -07:00
client.cc
conf.cc
crh.cc
ctx.cc ircd::ctx::pool: Simplify notify on work completion. 2021-05-11 20:56:09 -07:00
ctx.h
ctx_eh.cc
ctx_ole.cc ircd::ctx::ole: Split missing worker_remove() definition; enable pthread for seq. 2021-05-11 20:56:09 -07:00
ctx_posix.cc
ctx_posix.h
ctx_x86_64.S
db.cc
db.h
db_allocator.cc
db_database.cc
db_env.cc
db_env.h
db_env_state.h
db_fixes.cc
db_has.h
db_port.cc
db_port.h
default.proftext
demangle.cc
exception.cc
exec.cc
fmt.cc ircd::fmt: Add missing float alignment policies. 2021-09-15 01:44:36 -07:00
fpe.cc
fs.cc ircd::fs: Move madvise suite to allocator unit. 2021-05-11 20:56:09 -07:00
fs_aio.cc
fs_aio.h
fs_dev.cc
fs_iou.cc
fs_iou.h
fs_path.cc ircd::fs: Add missing base::include path definition. 2021-09-14 23:39:55 -07:00
globular.cc
gpt.cc ircd::gpt: Splits and renames; various reorg. 2021-09-15 01:44:36 -07:00
gpt_cpu.cc ircd::gpt: Splits and renames; various reorg. 2021-09-15 01:44:36 -07:00
gpt_gpu.cl ircd::gpt: Splits and renames; various reorg. 2021-09-15 01:44:36 -07:00
gpt_model.cc ircd::gpt::model: Add conf items for model/cache opts related. 2021-09-14 23:39:55 -07:00
gpt_pipe.cc ircd::gpt: Splits and renames; various reorg. 2021-09-15 01:44:36 -07:00
gpt_vocab.cc ircd::gpt::vocab: Simplify masks w/ sign extension. 2021-09-14 23:39:55 -07:00
http.cc
http2.cc
icu.cc
info.cc
ios.cc
ircd.cc
js.cc
json.cc ircd::utf: Rename encode() to encode_sparse(). 2021-08-08 09:47:02 -07:00
lex_cast.cc ircd: Improve bad_lex_cast error string related. 2021-04-22 12:27:57 -07:00
logger.cc
magic.cc
magick.cc
Makefile.am ircd::gpt: Splits and renames; various reorg. 2021-09-15 01:44:36 -07:00
mods.cc ircd::mapi: Fix for non-standard-layout unique_ptr impl. 2021-09-14 23:39:55 -07:00
mods.h
mods_ldso.cc
net.cc
net_addrs.cc
net_dns.cc ircd::net::dns: Split delegate service_init/fini; fix error. 2021-09-14 23:39:55 -07:00
net_dns_cache.cc
net_dns_netdb.cc ircd::net::dns: Split delegate service_init/fini; fix error. 2021-09-14 23:39:55 -07:00
net_dns_resolver.cc
net_listener.cc
net_listener_udp.cc
openssl.cc
parse.cc
pbc.cc
png.cc
prof.cc ircd::prof: Use non-elided log call covered by outer #ifdef. 2021-04-22 12:27:57 -07:00
prof_linux.cc
prof_psi.cc
rand.cc
README.md
resource.cc
rfc1035.cc
rfc1459.cc
rfc3986.cc
run.cc
server.cc ircd::server: Fix comments. [ci skip] 2021-04-22 12:27:57 -07:00
simd.cc
sodium.cc
stats.cc
stringops.cc ircd: Use buffer::move for possibly overlapping uses. 2021-04-22 12:27:56 -07:00
sys.cc
timedate.cc
tokens.cc
utf.cc ircd::utf: Split header; improve decode codegen; inline length. 2021-09-14 23:39:55 -07:00
util.cc
vg.cc

Library Definitions

This directory contains definitions for libircd

The purpose of libircd is to facilitate the execution of a server which handles requests from end-users. The library hosts a set of pluggable modules which may introduce the actual application features (or the "business logic") of the server.

Implied #include <ircd.h>

The ircd.h standard include group is pre-compiled and included first by default for every compilation unit in this directory. Developers do not have to worry about including project headers in a compilation unit, especially when creating and reorganizing either of them.

Note that because ircd.h is include above any manually included header, there is a theoretical possibility for a conflict. We make a serious effort to prevent ircd.h from introducing pollution outside of our very specific namespaces (see: Project Namespaces).

Dependency Isolation

Compilation units are primarily divided around the inclusion of a specific header or third-party dependency which is not involved in the ircd.h include group. Second to that, units tend to be divided by namespace and the subsystem they're implementing. Units can further be divided if they become unwieldy, but we bias toward large aggregate units in this library. Within these large units, there are divisions which group the definitions by the include/ircd/ header which declares them.

We do not included third-party headers in our own headers which are included by others. A developer of an ircd:: interface can choose to either forward declare third-party symbols in our headers, or wrap more complicated functionality.