$Id: README,v 1.38.2.1 2005/07/11 15:57:06 metalrock Exp $

This directory contains modules and patches that have been contributed
by other people, or aren't suitable for including into the 
hybrid tree. The coding team do not officially support the contrib/ 
modules, or guarantee any of them will actually work.

There is also a lone ircII script (challenge.irc) that works along with
rsa_respond so you can authenticate within your client.

Once again. WITH feeling. Not all of these modules have been thoroughly
tested! That's why some of them are in contrib not in the main tree yet.
At least one module in contrib has been known to core servers when used.
You have been warned. 

To repeat, ONE OR MORE OF THESE MAY CRASH YOUR SERVER.  USE AT YOUR
OWN RISK.

Modules
-------

m_capture.c    - CAPTURE - Makes <nick> captive (unable to
			   issue commands to the server).
		 Syntax: CAPTURE <nick>
		 Example: CAPTURE kiddie

m_change.c     - CHANGE - Modify username/host/realname of a connected client.
                 Syntax: CHGIDENT <nick> <newuser>
		         CHGHOST <nick> <newhost>
			 CHGNAME <nick/server> <newname>

m_classlist.c  - CLASSLIST - Shows the number of clients in the specified
			     class.
		 Syntax: CLASSLIST <class>
		 Example: CLASSLIST users

m_clearchan.c  - CLEARCHAN - Clears all users out of a channel and joins person
                             issuing command
                 Syntax: CLEARCHAN <channel>
		 Example: CLEARCHAN #channel

m_ctrace.c     - CTRACE - Performs a trace on a certain class
		 Syntax: CTRACE <class>
		 Example: CTRACE users

m_etrace.c     - ETRACE - Gives a list of all clients connected to the local server,
			  both users and operators.
		 Syntax: ETRACE <mask>
		 Example: ETRACE *

m_flags.c      - FLAGS - csircd like support of changing usermodes
                 Syntax: FLAGS :+OWALLOPS -SWALLOPS
			 FLAGS

m_force.c      - FORCE - Forces a user to either part or join a channel with
                         an optional status (@%+)
                 Syntax: FORCEJOIN <nick> [status]<channel>
                         FORCEPART <nick> <channel>
		 Example: FORCEJOIN nick @#channel
			  FORCEPART nick #channel

m_help.c       - HELP - Provide help for IRC commands. See bottom of document.
                 Syntax: HELP :command

m_jupe.c       - JUPE - Server juping command
                 Syntax: JUPE <server> :[reason]
		 Example: JUPE irc.server.com :juped

m_killhost.c   - KILLHOST - Kills users based on [hostmask]
		 Syntax: KILLHOST <hostmask> [reason]
		 Example: KILLHOST *@clones.com clones

m_ltrace.c     - LTRACE - Limited trace.  Similar to TRACE except only reports
                          current opers and servers.
                 Syntax: LTRACE [nick|mask [server]]
		 Example: LTRACE nick
			  LTRACE irc.server.com

m_map.c        - MAP - Display the server routing graph in a visually pleasing
                       format
                 Syntax: MAP
		 
m_mkpasswd.c   - MKPASSWD - generate a DES or MD5 encryption of a password
                 Syntax: MKPASSWD <plaintext> [MD5|DES]

m_ojoin.c      - OJOIN - Join a channel through any modes or limits with 
                         an optional status (@%+)
                 Syntax: OJOIN [status]<channel>
		 Example: OJOIN @#channel

m_omotd.c      - OMOTD - Displays the operator message of the day
		 Syntax: OMOTD [server]

m_operspy.c    - OPERSPY - Allows operators with access to spy on users
                 Syntax: OPERSPY <LIST/WHO/MODE/WHOIS/NAMES> <paramter>

m_opme.c       - OPME - Allows an admin to op themselves in an opless channel
                 Syntax: OPME <channel>
		 Example: OPME #channel

m_spoof.c      - SPOOF - Automatizes auth{} configuration on local and
                         overlocal level. Check m_spoof.c for more info.
                 Syntax: SPOOF <umask@hmask> <spoof> [flags [password]]
                         DELSPOOF <umask@hmask>
                 Example: SPOOF *@some.host.org i.am.l33t lkgf
                          DELSPOOF *@other.host.edu

m_tburst.c     - TBURST - module that will make servers send channel topics
                          to each other after a netsplit/restart.

m_whois.c      - WHOIS - is a modified form of the standard
		  	 whois provided. It adds the real IP
			 to a remote whois if applicable. 
			  	  
example_module.c - An example module to be used for creating your own.
                   Syntax: TEST

Spy Modules
-----------

The following are the 'spy' parts, accessible via the +y usermode

spy_admin_notice.c   - Spy on clients doing ADMIN
spy_info_notice.c    - Spy on clients doing INFO
spy_links_notice.c   - Spy on clients doing LINKS
spy_motd_notice.c    - Spy on clients doing MOTD
spy_stats_notice.c   - Spy on clients doing all STATS
spy_stats_p_notice.c - Spy on clients doing STATS p only
spy_trace_notice.c   - Spy on clients doing TRACE/LTRACE
spy_whois_notice.c   - Spy on local clients who WHOIS you.

Note: if you have both spy_stats_notice.c and spy_stats_p_notice.c loaded
you will get two messages.

Patches
_______

halfops.diff	- This patch will add halfops support to the ircd. To
		  use this patch, type "patch -p1 < contrib/halfops.diff"
		  in the main ircd-hybrid directory.

Help files
----------

Previously part of the default install, these are the help files that 
display information about every command with /quote HELP :whatever.

They are installed if you make install in this directory.

Other files
___________

confgen.pl	- generates hybrid-7 config files from SQL database

