| 1 |
$Id$ |
| 2 |
----------------------------------------------- |
| 3 |
|
| 4 |
ircd-hybrid contributive add-ons :: |
| 5 |
|
| 6 |
This directory contains contributive modules, patches and other add-ons |
| 7 |
that have been created by other people, or are not suitable to be included |
| 8 |
into the main ircd-hybrid tree for various reasons. The coding team does |
| 9 |
not officially support modules, patches and add-ons nor do they guarantee |
| 10 |
that any of them will work to their intended capacity. |
| 11 |
|
| 12 |
It is to be noted WITH feeling, that not all of these modules, patches |
| 13 |
or add-ons have been thoroughly tested, only that they've been tested |
| 14 |
enough to see if they compile or work. This is one of the main driving |
| 15 |
reasons why many of these are not in the main ircd-hybrid tree. At least |
| 16 |
one or two of the modules in contrib have been known to core servers when |
| 17 |
used. Heed this warning! |
| 18 |
|
| 19 |
To reiterate, ONE OR MORE OF THESE MAY AND PROBABLY WILL CORE YOUR SERVER. |
| 20 |
USE AT YOUR OWN RISK. Reading this dicticates that you agree to the stated |
| 21 |
fact. |
| 22 |
|
| 23 |
Modules :: |
| 24 |
----------------------------------------------- |
| 25 |
ip_cloaking.c -- This module enables IP/hostname cloaking support for |
| 26 |
ircd-hybrid. It adds a CRC32 encrypted based cloaking |
| 27 |
known to be used by other daemons such as Unreal IRCd |
| 28 |
but with some modifications and different hashing |
| 29 |
methods. Please read README.cloaking before you compile |
| 30 |
and load this module, it contains VERY important |
| 31 |
information. |
| 32 |
|
| 33 |
|
| 34 |
m_capture.c -- This module will essentially capture a client (making it |
| 35 |
impossible for a user to send commands to the server). |
| 36 |
|
| 37 |
Syntax: CAPTURE <nickname/mask> |
| 38 |
UNCAPTURE <nickname/mask> |
| 39 |
|
| 40 |
Example: (UN)CAPTURE scriptkiddie |
| 41 |
(UN)CAPTURE *!*@abuser.host |
| 42 |
|
| 43 |
|
| 44 |
m_change.c -- This module will allow IRC operators to alter the ident, |
| 45 |
hostname or gecos (realname) fields of a given user. |
| 46 |
|
| 47 |
Syntax: CHGIDENT <nickname> <newident> |
| 48 |
CHGHOST <nickname> <newhostname> |
| 49 |
CHGNAME <nickname> <newname> |
| 50 |
|
| 51 |
Example: CHGIDENT lart llama |
| 52 |
CHGHOST lart i.hate.packets |
| 53 |
CHGNAME lart oorgle |
| 54 |
|
| 55 |
|
| 56 |
m_classlist.c -- This module will show the number of clients connected in |
| 57 |
a specific class. Valid classes would be servers, users, |
| 58 |
operators, or any custom one you defined in class {} |
| 59 |
blocks. |
| 60 |
|
| 61 |
Syntax: CLASSLIST <class> |
| 62 |
|
| 63 |
Example: CLASSLIST users |
| 64 |
|
| 65 |
|
| 66 |
m_clearchan.c -- Similar to the OperServ command CLEARCHAN, this module |
| 67 |
will clear all users out of a channel, joins the person |
| 68 |
who issued it, and locks the channel. It should be noted |
| 69 |
that this command can be abused heavily. |
| 70 |
|
| 71 |
Syntax: CLEARCHAN <channel> |
| 72 |
|
| 73 |
Example: CLEARCHAN #warez |
| 74 |
|
| 75 |
|
| 76 |
m_ctrace.c -- This module will perform a trace on a certain class. Valid |
| 77 |
classes would be servers, users, operators or any custom |
| 78 |
one you defined in class {} blocks. |
| 79 |
|
| 80 |
Syntax: CTRACE <class> |
| 81 |
|
| 82 |
Example: CTRACE users |
| 83 |
|
| 84 |
|
| 85 |
m_flags.c -- This module adds csircd like support for changing |
| 86 |
usermodes. If passed without any arguments, it will |
| 87 |
show what flags are enabled and which are available. |
| 88 |
|
| 89 |
Syntax: FLAGS [+|-FLAG] |
| 90 |
|
| 91 |
Example: FLAGS +CALLERID |
| 92 |
|
| 93 |
|
| 94 |
m_force.c -- This module will force a user to either part or join a |
| 95 |
channel with an optional status (@%+) |
| 96 |
|
| 97 |
Syntax: FORCEJOIN <nickname> [status]<channel> |
| 98 |
FORCEPART <nickname> <channel> |
| 99 |
|
| 100 |
Example: FORCEJOIN nick @#chitchat |
| 101 |
FORCEPART lamer #chitchat |
| 102 |
|
| 103 |
|
| 104 |
m_jupe.c -- Similar to the OperServ command JUPE, this module adds the |
| 105 |
ability to jupiter (ban) a server from your network. It can |
| 106 |
be extremely dangerous if not used correctly or without |
| 107 |
proper information. So use it with EXTREME care. |
| 108 |
|
| 109 |
Syntax: JUPE <server> :[reason] |
| 110 |
|
| 111 |
Example: JUPE node.server.net :get lost |
| 112 |
|
| 113 |
|
| 114 |
m_killhost.c -- Similar to the OperServ command KILLHOST, allows you to |
| 115 |
issue (mass) KILLs to a specific hostname or hostmask that is |
| 116 |
connected to the server. |
| 117 |
|
| 118 |
Syntax: KILLHOST <hostmask> [reason] |
| 119 |
|
| 120 |
Example: KILLHOST *@cloners.com clones |
| 121 |
|
| 122 |
|
| 123 |
m_ltrace.c -- This module will give a limited trace. This is similar to |
| 124 |
TRACE except that it only reports current operators and servers. |
| 125 |
|
| 126 |
Syntax: LTRACE [nick|mask [server]] |
| 127 |
|
| 128 |
Example: LTRACE god |
| 129 |
LTRACE node.server.com |
| 130 |
|
| 131 |
|
| 132 |
m_mkpasswd.c -- This module will generate a DES or MD5 encrypted password |
| 133 |
similar to the console version bundled with hybrid. |
| 134 |
|
| 135 |
Syntax: MKPASSWD <plaintext> [MD5|DES] |
| 136 |
|
| 137 |
|
| 138 |
m_ojoin.c -- This module will add the ability to join any channel no |
| 139 |
matter what modes or limits are set with an optional |
| 140 |
status (@%+) It should be noted that this command can be |
| 141 |
abused heavily. |
| 142 |
|
| 143 |
Syntax: OJOIN [status]<channel> |
| 144 |
|
| 145 |
Example: OJOIN @#private |
| 146 |
|
| 147 |
|
| 148 |
m_operspy.c -- This module will allow operators with access to spy on |
| 149 |
users. It should be noted the notion of this module |
| 150 |
practically invalidates any form of privacy. |
| 151 |
|
| 152 |
Syntax: OPERSPY <LIST/WHO/MODE/WHOIS/NAMES> <parameter> |
| 153 |
|
| 154 |
|
| 155 |
m_opme.c -- This module will allow an IRC operator to op themselves in |
| 156 |
an opless channel should the need arise. |
| 157 |
|
| 158 |
Syntax: OPME <channel> |
| 159 |
Example: OPME #orphanchan |
| 160 |
|
| 161 |
|
| 162 |
m_services.c -- This module will add services hook support to hybrid. It |
| 163 |
will add secure messaging aliases to services like such |
| 164 |
as NickServ, OperServ and so on. It also adds SVSNICK |
| 165 |
support to allow NickServ to change nicknames should |
| 166 |
a user fail to identify or if an operator chooses |
| 167 |
to want to change a user's nickname if it is offensive. |
| 168 |
To use the aliases simply do ServiceName without MSG, |
| 169 |
e.g. /NickServ IDENTIFY instead of /MSG NickServ IDENTIFY. |
| 170 |
|
| 171 |
Syntax: SVSNICK <nickname> <newnick> |
| 172 |
|
| 173 |
Example: SVSNICK fsck lamer |
| 174 |
|
| 175 |
|
| 176 |
m_spoof.c -- This module adds automated auth {} block configurations |
| 177 |
on local and over-local levels. Check m_spoof.c for |
| 178 |
more information and the help pages for SPOOF and |
| 179 |
DELSPOOF. |
| 180 |
|
| 181 |
Syntax: SPOOF <umask@hmask> <spoof> [flags [password]] |
| 182 |
DELSPOOF <umask@hmask> |
| 183 |
|
| 184 |
Example: SPOOF *@some.host.org i.hate.packets lkgf |
| 185 |
DELSPOOF *@other.host.edu |
| 186 |
|
| 187 |
|
| 188 |
example_module.c -- This is an example module template to help users create |
| 189 |
their own modules. |
| 190 |
|
| 191 |
|
| 192 |
Spy Modules :: |
| 193 |
----------------------------------------------- |
| 194 |
|
| 195 |
The following modules are the 'spy' parts and are accessible via the +y |
| 196 |
user mode. |
| 197 |
|
| 198 |
spy_admin_notice.c -- Spy on clients doing ADMIN |
| 199 |
spy_info_notice.c -- Spy on clients doing INFO |
| 200 |
spy_links_notice.c -- Spy on clients doing LINKS |
| 201 |
spy_motd_notice.c -- Spy on clients doing MOTD |
| 202 |
spy_stats_notice.c -- Spy on clients doing all STATS |
| 203 |
spy_stats_p_notice.c -- Spy on clients doing STATS p only |
| 204 |
spy_trace_notice.c -- Spy on clients doing TRACE/LTRACE |
| 205 |
spy_whois_notice.c -- Spy on local clients who WHOIS you. |
| 206 |
|
| 207 |
Note: If you have both spy_stats_notice.c and spy_stats_p_notice.c |
| 208 |
loaded at the same time you will get two messages. So only load one |
| 209 |
or the other to avoid duplicate NOTICE events. |
| 210 |
|
| 211 |
Help Files :: |
| 212 |
----------------------------------------------- |
| 213 |
|
| 214 |
Each contrib module listed here has an accompanying help page or set of |
| 215 |
help pages. They will be installed when you issue 'make install' inside |
| 216 |
the contrib directory. To view them do /QUOTE HELP COMMAND. |
| 217 |
|
| 218 |
|
| 219 |
Other Files :: |
| 220 |
----------------------------------------------- |
| 221 |
|
| 222 |
Other files that have been put into the contrib directory but do not have |
| 223 |
a specific category are listed here with a brief description of what they |
| 224 |
are and what they do. |
| 225 |
|
| 226 |
challange.irc -- ircII script that works in conjunction with rsa_respond |
| 227 |
so you can authenticate within your client. |
| 228 |
|
| 229 |
ircd-hybrid.spec -- RPM specifications file that can be used to build an RPM of |
| 230 |
ircd-hybrid. |
| 231 |
|
| 232 |
ircd.init.in -- rc-init style file used with the spec file to allow system |
| 233 |
loading of ircd-hybrid. |
| 234 |
|
| 235 |
setup-win32.h -- This header file is a win32 compatible include/setup.h |
| 236 |
suitable for building ircd-hybrid on Windows with MSVC/BCC. |
| 237 |
|
| 238 |
win32build.bat -- Automated BATCH script designed to aid in the building of |
| 239 |
ircd-hybrid on Windows with MSVC/BCC |