This repository has been archived by the owner on Jan 11, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
259 lines (194 loc) · 9.47 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
README
======
INFO:
Hybserv2 is a new and improved version of the now unsupported Hybserv,
sporting new features, bugfixes, and more. It is specifically designed
for Hybrid IRC servers, but may work with others as well. It includes
OperServ, NickServ, ChanServ, MemoServ, StatServ, HelpServ, and Global.
Each of the services can be enabled and disabled as necessary.
Hybserv was specifically designed to run with Hybrid6/7 IRCd, although it
*should* work with Ratbox IRCd and any other Hybrid-based IRCd. You may
find the Hybrid IRC daemon at http://ircd-hybrid.com/. These services
(more or less same code) are currently used by several other networks such
as idolNET, BalcanNET, BGNet, BGFree, UniBG, BCNet, GunNet, ShakeIT,
FreeWorld, IRCBG, FreeNode/OPN.
The former Hybserv development team has decided to spin off and focus its
energy towards the Hybserv2 project. Like the name implies, this new
version is even better. If there is something you would like to see added
to Hybserv2, please let us know as we are always looking for fresh ideas.
NOTE: Per Sidewnder's (Cosine's) request - original Hybserv will no longer
be supported. So if you have questions or some problems, please
*upgrade* first to a recent stable or even to a development version.
Hybserv was first coded by Patrick Alken (wnder|AT|underworld|net) and is
now maintained by the Hybserv2 Coding Team, unless otherwise mentioned in
the code or the Credits.
#########################################################
STAFF:
Lead developer of Hybserv2
kreator Dinko Korunic dinko.korunic@gmail.com
The following people have contributed to Hybserv2 in blood and sweat
(nick alphabetical order):
adx Piotr Nizynski adx|AT|crashnet|pl
alex Ales Tokic ales|tokic|AT|gmail|com
args Antoniu-George Savu antoniu-george|savu|AT|fr|tiscali|com
asuffield Andrew Suffield asuffield|AT|users|sourceforge|net
bane Dragan Dosen ddosen|AT|ddosen|net
bbrazil Brian Brazil bbrazil|AT|netsoc|tcd|ie
BEER_MAN Ilian Jovchev ilian|AT|irc|zonebg|com
Bruns Brian Bruns bruns|AT|magenet|net
CoolCold Roman Ovchinnikov coolcold|AT|coolcold|org
cosine Patrick Alken wnder|AT|uwns|underworld|net
ddb Ivan Petrov ddb|AT|xplovdiv|com
decho Nedelcho Stanev decho|AT|iname|com
fl_ Lee Hardy lee|AT|leeh|co|uk
harly Tomislav Novak harly|AT|bofhlet|net
ike Ivan Krstic ike|AT|gnjilux|srk|fer|hr
Janos John Binder jbinder|AT|kgazd|bme|hu
John-Work F| John Rowan john|AT|tdkt|org
knight Alan Levee alan|levee|AT|prometheus-designs|net
KrisDuv Christophe Duverger krisduv2000|AT|yahoo|fr
mend0za Vladimir Shahov mend0za|AT|nsys|by
MOLI Olivier Molinete olivier|AT|molinete|org
rhodie Julian Petrov rhodie|AT|irchelp|unibg|org
Sarisa Wendy Campbell wcampbel|AT|botbay|net
sofit Stanislav Zahariev sofit|AT|proshe|bg
t0sh Todor Dimitrov todor_p_dimitrov|AT|yahoo|com
toot Toby Verrall to7|AT|antipope|fsnet|co|uk
Craig Kamen Sabeff ksabeff|AT|gmail|com
We are grateful to all these people, as well as all users that have been
reporting bugs last several years. Thank you, without you this project
would be meaningless.
#########################################################
DISTRIBUTION:
You can get Hybserv2 from:
1) GitHub home:
http://github.com/dkorunic/hybserv2
http://github.com/dkorunic/hybserv2/releases
NOTE: GitHub copy is always more current than the release, since it is
working/development version. It is possible to checkout any needed
release via appropriate tags (for example REL_1_9_5).
NOTE: I plan to move off SourceForge completely and stay on GitHub in
future.
#########################################################
INSTALLATION:
Please read the INSTALL file. NOW.
#########################################################
RUNNING HYBSERV:
Make sure that each hub server you have specified in your config file has
C/N lines for Hybserv matching the password in the first field of the S:
line and the server name specified in the N: line. Also, if you wish to
enable jupes (#define ALLOW_JUPES), you *MUST* give services an H: line in
ircd.conf.
Configuration examples:
NOTE: Suppose the host name of services is "services.name" with
an ip of 1.2.3.4, and that server accepting the services
has name "server.shomewhere" with ircd class "server" (or
class 1).
Required statements in ircd.conf for Hybrid5/6:
C:1.2.3.4:password:services.name::1
N:1.2.3.4:password:services.name::1
H:*:*:services.name
NOTE: You can leave out H line if you don't want to use server
jupes and G-Lines.
NOTE: We recommend using services on same server that is your
hub, and then you can use 127.0.0.1 as address in C/N lines
(which will give you some performance, since traffic will
go through loop back device).
However in Hybrid7 to accomplish the same you have to put in ircd.conf
following code:
connect {
name = "services.name";
host = "1.2.3.4";
send_password = "password";
accept_password = "password";
compressed = no;
hub_mask = "*";
class = "server";
};
In hybserv.conf configuration should be as follows:
S:password:hub.server.somewhere:6667
N:services.name:Hybrid services
When you have compiled Hybserv and edited the necessary files, simply type
./hybserv which should start daemon properly. If it is not in process
list, check hybserv.log which should state reasons of failure.
Then, go on IRC and type:
/msg OperServ identify <password>
Assuming OperServ is the OperServNick defined in settings.conf and you
have given yourself a O: line in hybserv.conf. You should be allowed to
give OperServ commands through /msg or DCC CHAT.
For a list of commands do:
/msg OperServ help
Most commands may also be done through DCC CHAT, and in fact more commands
are available through DCC CHAT. Simply /dcc chat OperServ to connect, and
.help
I have tried to make Hybserv fully compatible with TCM (linking wise). If
you wish Hybserv to be part of your TCM botnet, read TCM-LINKING for
instructions. If you have no idea what a TCM bot is, don't worry about it
:-)
If you enabled NickServ, ChanServ, MemoServ etc. in config.h, you can get
lists of their commands through /msg *Serv help. NickServ and ChanServ
have several commands that can only be executed by administrators. This
means you must match an O: line (with an "a" flag) in hybserv.conf and be
registered with OperServ to use them. This can be done by typing /msg
OperServ password, these commands CANNOT be accessed by DCC Chat.
NOTE: If you use Hybrid or Hybrid-compatible IRC daemon, you should enable
Q-lines (quarantined nickname) for services-reserved nicknames
because of obvious security reasons:
Q:NickServ:This nickname is reserved.
Q:ChanServ:This nickname is reserved.
Q:OperServ:This nickname is reserved.
However Q lines changed in Hybrid7. Feel free to copy and paste these
lines:
resv {
# The reason must go first
reason = "This nickname is reserved";
nick = "NickServ";
nick = "ChanServ";
nick = "OperServ";
};
################################################################
BUGS:
Use the appropriate bug reporting and ticketing system:
http://sourceforge.net/projects/hybserv2
(click on Tracker button, choose Bugs/Feature requests/Patches/Support
Requests)
Alternative, subscribe to the mailing list (details follow) and post them
there. We can't fix bugs if no one reports them!
################################################################
MAILING LISTS:
If you are interested in helping out with the development of Hybserv, or
just tracking the changes in Hybserv, feel free to join the Hybserv
Development List.
Here we can discuss anything we need and make sure problems get fixed.
Please feel free to give out this address, and you may subscribe by
sending email to:
hybserv2-devel-subscribe|AT|lists|sourceforge|net
Or by visiting the list web interface available at:
https://lists.sourceforge.net/lists/listinfo/hybserv2-devel
NOTE: E-mail should corrected that "|AT|" is translated into "@" and rest
of "|" characters are translated to ".", forming a correct
destination.
Once subscribed, you can send a public post to:
hybserv2-devel|AT|lists|sourceforge|net
################################################################
LEGAL STUFF:
This package has absolutely no warranty. Use at your own risk. The author
will accept no responsibility for any damage, whatsoever, caused by this
program.
This software is released under the terms of the GNU General Public
License (see COPYING). Should you choose to use and/or modify any of code,
please do so under the terms of the GNU General Public License, published
by the Free Software Foundation.
################################################################
CREDITS:
Functions used from other GPL'd sources:
match() -- from ircd-hybrid source
HashNick() -- from ircd-hybrid source
HashChannel() -- from ircd-hybrid source
tools/mkpasswd.c is copyright (C) 1991 Nelson Minar
<minar|AT|reed|edu>, W. Campbell, and Hybrid7 team.
Some help files were used from EsperNet's service package:
ftp.dragonfire.net/software/unix/irc
The ideas for a settings.conf and the shownicks/showchans programs were
inspired from this package as well.
See also the beginning of this file.