1 | atheme-services -- a set of services for IRC networks |
1 | ermyth -- a set of services for IRC networks |
2 | ===================================================== |
2 | ===================================================== |
3 | |
3 | |
4 | This program is free but copyrighted software; see the LICENSE file for |
4 | Ermyth is free software: you can redistribute it and/or modify |
5 | details. |
5 | it under the terms of the GNU General Public License as published by |
|
|
6 | the Free Software Foundation, either version 3 of the License, or |
|
|
7 | (at your option) any later version. |
6 | |
8 | |
7 | Information about atheme-services may be found at http://www.atheme.net/. |
9 | Information about ermyth may be found at http://ermyth.xinutec.org/. |
8 | |
10 | |
9 | TABLE OF CONTENTS |
11 | TABLE OF CONTENTS |
10 | ----------------- |
12 | ----------------- |
11 | 1. Credits |
13 | 1. Credits |
12 | 2. Presentation, and what atheme-services is not |
14 | 2. Presentation, and what ermyth is not |
13 | 3. Installation |
15 | 3. Installation |
14 | 4. Command line options |
16 | 4. Command line options |
15 | 5. Getting support |
17 | 5. Getting support |
16 | 6. Reporting bugs |
18 | 6. Reporting bugs |
17 | |
19 | |
18 | 1. CREDITS |
20 | 1. CREDITS |
19 | ---------- |
21 | ---------- |
20 | |
22 | |
21 | atheme-services was originally based on Shrike, however, this has almost |
23 | ermyth was originally based on Shrike, however, this has almost |
22 | all been rewritten now. We have also borrowed some code from Sentinel |
24 | all been rewritten now. We have also borrowed some code from Sentinel |
23 | and ircd-ratbox. |
25 | and ircd-ratbox. |
24 | |
26 | |
25 | Information about Shrike can be found at http://shrike.malkier.net/. |
27 | Information about Shrike can be found at http://shrike.malkier.net/. |
26 | Information about Sentinel can be found at http://ircd.botbay.net/sentinel/. |
28 | Information about Sentinel can be found at http://ircd.botbay.net/sentinel/. |
27 | Information about ircd-ratbox can be found at http://www.ircd-ratbox.org/. |
29 | Information about ircd-ratbox can be found at http://www.ircd-ratbox.org/. |
28 | |
30 | |
29 | 2. PRESENTATION AND WHAT ATHEME-SERVICES IS NOT |
31 | 2. PRESENTATION AND WHAT ERMYTH IS NOT |
30 | ----------------------------------------------- |
32 | ----------------------------------------------- |
31 | |
33 | |
32 | atheme-services is a set of Services for IRC networks that allows users to |
34 | ermyth is a set of Services for IRC networks that allows users to |
33 | manage their channels in a secure and efficient way and allows operators to |
35 | manage their channels in a secure and efficient way and allows operators to |
34 | manage various things about their networks. Unlike it's predecessor, Shrike, |
36 | manage various things about their networks. Unlike it's predecessor, Shrike, |
35 | services has a completely reworked form of channel management that feels |
37 | services has a completely reworked form of channel management that feels |
36 | somewhat like eggdrop and is somewhat more useful. |
38 | somewhat like eggdrop and is somewhat more useful. |
37 | |
39 | |
38 | Services currently works with many irc daemons. More details are |
40 | Services currently works with many irc daemons. More details are |
39 | available in the config file. |
41 | available in the config file. |
40 | |
42 | |
41 | Internally, atheme-services shares more similarities with ircd than it |
43 | Internally, ermyth shares more similarities with ircd than it |
42 | does with IRCServices. Anope/Epona, Cygnus, OperStats, Hybserv, Theia, etc |
44 | does with IRCServices. Anope/Epona, Cygnus, OperStats, Hybserv, Theia, etc |
43 | are all based on IRCServices and as such have very old legacy code that |
45 | are all based on IRCServices and as such have very old legacy code that |
44 | none of the authors, except Church truly understand. Atheme was written |
46 | none of the authors, except Church truly understand. Ermyth was written |
45 | completely from scratch with the more complex concepts taken from |
47 | completely from scratch with the more complex concepts taken from |
46 | various modern ircd packages, including ircu, ircd-ratbox, hybrid and |
48 | various modern ircd packages, including ircu, ircd-ratbox, hybrid and |
47 | bahamut. |
49 | bahamut. |
48 | |
50 | |
49 | atheme-services is not a drop-in replacement for Anope or Andy Church's IRC |
51 | ermyth is not a drop-in replacement for Anope or Andy Church's IRC |
50 | Services. It is designed with an entirely different set of goals and as |
52 | Services. It is designed with an entirely different set of goals and as |
51 | such should not be migrated to with the expectation that it will behave |
53 | such should not be migrated to with the expectation that it will behave |
52 | exactly like what was previously implemented. Atheme is designed to act |
54 | exactly like what was previously implemented. Ermyth is designed to act |
53 | as a directory server, with alternative ways of getting to the data |
55 | as a directory server, with alternative ways of getting to the data |
54 | implemented as well as the IRC presence. |
56 | implemented as well as the IRC presence. |
55 | |
57 | |
56 | 3. INSTALLATION |
58 | 3. INSTALLATION |
57 | --------------- |
59 | --------------- |
… | |
… | |
59 | See the INSTALL file. |
61 | See the INSTALL file. |
60 | |
62 | |
61 | 4. COMMAND LINE OPTIONS |
63 | 4. COMMAND LINE OPTIONS |
62 | ----------------------- |
64 | ----------------------- |
63 | |
65 | |
64 | Normally, services can be run simply by invoking the "atheme-services" |
66 | Normally, services can be run simply by invoking the "ermyth" |
65 | executable. Services will then use the defaults specified in the |
67 | executable. Services will then use the defaults specified in the |
66 | configuraiton file and connect to the specified uplink server. |
68 | configuraiton file and connect to the specified uplink server. |
67 | Alternatively, any of the following command-line options can be |
69 | Alternatively, any of the following command-line options can be |
68 | specified to change the default behavior: |
70 | specified to change the default behavior: |
69 | |
71 | |
… | |
… | |
76 | Services also handles the following signals: |
78 | Services also handles the following signals: |
77 | HUP - force a REHASH |
79 | HUP - force a REHASH |
78 | INT - force a RESTART |
80 | INT - force a RESTART |
79 | TERM - force a SHUTDOWN |
81 | TERM - force a SHUTDOWN |
80 | |
82 | |
81 | Upon starting, atheme-services will parse its command-line arguments, |
83 | Upon starting, ermyth will parse its command-line arguments, |
82 | open its log file, parse its configuration file, load its database, |
84 | open its log file, parse its configuration file, load its database, |
83 | connect to the uplink, and (assuming -n is not specified) detach into |
85 | connect to the uplink, and (assuming -n is not specified) detach into |
84 | the background. If services encounters an error while parsing the |
86 | the background. If services encounters an error while parsing the |
85 | configuration or database files it will terminate immediately. |
87 | configuration or database files it will terminate immediately. |
86 | Otherwise, it will run until killed or otherwise stopped. |
88 | Otherwise, it will run until killed or otherwise stopped. |