| 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. |
