MirrorHub/construct
0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-27 01:02:46 +01:00
Code Issues Releases Wiki Activity
No description
2930 commits 1 branch 23 tags 43 MiB
C++ 87.4%
JavaScript 4%
M4 2.4%
C 2%
Nix 1.2%
Other 3%
Find a file
William Pitcock 1160f6c9bf wsockd: implement websocket handshake part
2016-04-02 17:07:00 -05:00
authd authd: fix up comment [ci skip] 2016-04-02 03:49:31 -05:00
bandb bandb: update sqlite3 to 3.12.0 2016-03-29 13:29:18 -05:00
doc Move m_locops module to extensions. 2016-04-02 05:20:30 -05:00
extensions Move m_locops module to extensions. 2016-04-02 05:20:30 -05:00
help Really fix the help index. 2016-03-12 06:26:50 -06:00
include Rename authd.[ch] on ircd side to authproc.[ch] to prevent shadowing. 2016-04-02 16:44:04 -05:00
ircd Rename authd.[ch] on ircd side to authproc.[ch] to prevent shadowing. 2016-04-02 16:44:04 -05:00
librb Add new sockaddr_storage port retrieval/setting macros 2016-03-31 03:00:29 -05:00
m4 Remove more $Id tags. 2016-03-06 02:58:32 -06:00
modules Move m_locops module to extensions. 2016-04-02 05:20:30 -05:00
scripts Make release scripts less out of date. 2016-03-21 08:32:21 -05:00
ssld ssld: Remove left over function 2016-03-27 06:13:11 -04:00
testsuite testsuite: Update startall.sh 2016-03-28 00:09:01 -04:00
tools Cleanup warnings 2016-03-21 22:28:41 -04:00
wsockd wsockd: implement websocket handshake part 2016-04-02 17:07:00 -05:00
.appveyor-build.sh appveyor: make the build less hacky 2016-03-25 18:25:00 -05:00
.appveyor.yml appveyor: dont try to start ircd for the moment 2016-03-20 23:00:30 -05:00
.gitignore gitignore: Ignore pid files from startall.sh 2016-03-28 00:09:51 -04:00
.mailmap mailmap: Sam is Christine now apparently. 2016-03-17 14:48:46 -05:00
.travis.yml travis: this branch is deprecated, authd-framework-2 is the new hotness 2016-03-21 08:32:47 -05:00
autogen.sh Invoke the standard system shell in autogen.sh 2016-03-23 19:49:50 -05:00
configure.ac wsockd: add skeleton for future websockets helper (ref #78) 2016-03-25 21:04:22 -05:00
CREDITS Add BlindSight to the credits 2016-03-23 22:17:47 -05:00
GIT-Access Update Git repo references to new organization 2015-12-28 16:01:07 -08:00
install-sh install-sh: make +x 2016-03-18 16:25:38 -05:00
LICENSE Remove more $Id tags. 2016-03-06 02:58:32 -06:00
Makefile.am wsockd: add skeleton for future websockets helper (ref #78) 2016-03-25 21:04:22 -05:00
NEWS.md Move m_locops module to extensions. 2016-04-02 05:20:30 -05:00
README.md Remove tier 4 (tier 3 is basically "everything but") 2016-03-23 15:51:25 -05:00

README.md

charybdis POSIX Build Status Windows Build Status

Charybdis is an IRCv3 server designed to be highly scalable. It implements IRCv3.1 and some parts of IRCv3.2.

It is meant to be used with an IRCv3-capable services implementation such as Atheme or Anope.

necessary requirements

  • A supported platform
  • A working dynamic library system
  • A working lex and yacc - flex and bison should work

platforms

Charybdis is designed with portability in mind, but does not target older systems nor those of solely academic interest.

Do note that operating systems are only supported if they are supported by their vendor.

Tier 1

These platforms are the best supported, and should always work. They are actively tested. If you encounter problems, please file a bug.

  • FreeBSD 10.x and above (i386 and amd64)
  • Linux 2.6.x and above with glibc or musl (i386, x86_64, and ARM)
  • Mac OS X 10.7 and above
  • Windows Vista/Server 2008 and above (x86 or x64)

Tier 2

These platforms are supported and occasionally tested, and most features should work, but this is not guaranteed. If you find any problems, file a bug, but as these are not regularly tested platforms, a timely resolution may not be possible.

  • DragonflyBSD 4.4 and above (i386)
  • Linux with uClibc (i386 or x86_64)
  • NetBSD 6.1.x and above (i386, amd64)
  • OpenBSD 5.6 and above (i386, amd64)
  • Solaris 10 and above (i386)

Tier 3

Anything else that hasn't been tested. Charybdis may or may not work on it; patches welcome if they don't.

platform specific errata

These are known issues and workarounds for supported platforms.

  • FreeBSD: if you are compiling with ipv6 you may experience problems with ipv4 due to the way the socket code is written. To fix this you must: "sysctl net.inet6.ip6.v6only=0"

  • Solaris: you may have to set your PATH to include /usr/gnu/bin and /usr/gnu/sbin before /usr/bin and /usr/sbin. Solaris's default tools don't seem to play nicely with the configure script.

building from git

We no longer supply a prebuilt configure script in git, due to use of automake and libtool causing problems. You will need to run autogen.sh to build the autotools files prior to building charybdis.

feature specific requirements

  • For SSL/TLS client and server connections, one of:

    • OpenSSL 1.0 or newer
    • LibreSSL
    • mbedTLS
    • GnuTLS

  • For certificate-based oper CHALLENGE, OpenSSL 1.0 or newer. (Using CHALLENGE is not recommended for new deployments, so if you want to use a different TLS library, feel free.)

  • For ECDHE, OpenSSL 1.0.0 or newer is required. Solaris; and RHEL/Fedora and its derivatives such as CentOS have removed support for ECC/ECDHE. You will need to compile your own OpenSSL on these systems.

tips

  • To report bugs in charybdis, visit us at irc.freenode.net #charybdis

  • Please read doc/index.txt to get an overview of the current documentation.

  • Read the NEWS file for what's new in this release.

  • The files, /etc/services, /etc/protocols, and /etc/resolv.conf, SHOULD be readable by the user running the server in order for ircd to start with the correct settings. If these files are wrong, charybdis will try to use 127.0.0.1 for a resolver as a last-ditch effort.