0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-26 16:52:44 +01:00
construct/ircd
2020-06-08 21:28:07 -07:00
..
.gitignore
allocator.cc
allocator_gnu.cc
allocator_je.cc ircd::allocator::je: Add thp to our default options. 2020-05-30 19:28:39 -07:00
assert.cc
backtrace.cc
base.cc
cbor.cc
client.cc ircd::net: Convey ALPN selection to socket instance. 2020-05-30 23:19:03 -07:00
conf.cc ircd::conf: Fix interface argument inconsistency. 2020-06-08 17:16:07 -07:00
crh.cc
ctx.cc
ctx.h
ctx_eh.cc
ctx_ole.cc
ctx_posix.cc
ctx_x86_64.S
db.cc ircd::db: Add parallel read suite to internal interface. 2020-06-08 21:28:07 -07:00
db.h ircd::db: Add parallel read suite to internal interface. 2020-06-08 21:28:07 -07:00
db_allocator.cc ircd::db: Split allocator related into unit. 2020-06-04 15:38:38 -07:00
db_env.cc
db_env.h ircd::db: Recombine db.h; split defines into header. 2020-06-04 15:41:11 -07:00
db_env_state.h
db_fixes.cc
db_has.h ircd::db: Sort feature defines. 2020-06-07 05:48:07 -07:00
db_port.cc
db_port.h
demangle.cc
exception.cc
fmt.cc ircd::spirit: Add template option for truncation behavior to generate. 2020-06-05 12:15:11 -07:00
fs.cc ircd::fs: Add syscall warning timers on some operations. 2020-06-08 21:28:07 -07:00
fs_aio.cc ircd::fs::dev: Eliminate the static map; refactor interface; add console cmd. 2020-06-08 16:13:00 -07:00
fs_aio.h ircd::fs::aio: Fix request object semantics and immobility guarantees. 2020-05-30 16:50:38 -07:00
fs_dev.cc ircd::fs::dev: Eliminate the static map; refactor interface; add console cmd. 2020-06-08 16:13:00 -07:00
fs_iou.cc
fs_iou.h
fs_path.cc
globular.cc
http.cc
http2.cc
info.cc ircd::fs::info: Attempt to get sysconf for AIO_MAX w/o exception. 2020-06-05 16:32:57 -07:00
ios.cc
ircd.cc
js.cc
json.cc
lex_cast.cc
locale.cc
logger.cc ircd::logger: Remove unnecessary cruft. 2020-06-04 15:41:11 -07:00
magic.cc
Makefile.am ircd::fs: Split fs::dev definitions into unit. 2020-06-07 01:51:19 -07:00
mods.cc
mods.h
mods_ldso.cc
net.cc
net_addrs.cc
net_dns.cc
net_dns_cache.cc
net_dns_netdb.cc
net_dns_resolver.cc
net_listener.cc ircd::net: Convey ALPN selection to socket instance. 2020-05-30 23:19:03 -07:00
net_listener_udp.cc
openssl.cc ircd::openssl: Add interface wrapping get/set app_data. 2020-05-30 22:17:11 -07:00
parse.cc
pbc.cc
prof.cc
prof_linux.cc
rand.cc
README.md
resource.cc ircd::resource: Split mime and content length nego branches into functions. 2020-06-08 16:13:00 -07:00
rfc1035.cc
rfc1459.cc
rfc3986.cc
run.cc
server.cc ircd::server: Add tag completed counters on link and peer w/ report. 2020-06-07 07:53:37 -07:00
sodium.cc
stats.cc
stringops.cc
timedate.cc
tokens.cc
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.