Modules/2.0/hostchange

From the makers of InspIRCd.
Jump to: navigation, search
Important Need Update - This page needs to be revised. Information posted here has been viewed as incorrect, incomplete, or obsolete. Anyone is welcome to correct these flaws if this page has not been "protected". Otherwise, contact a Docs Team member and let them know.

hostchange module (2.0 version)

Current Future
2.0 Documentation 3.0 Documentation
Return to the 2.0 Module List
Description
Allows IRCds to set a displayed hostname on a user based on their hostmask and ident. The module may set hostnames in the form "nickname.network.net" or as static names, or as just the network address.
Configuration Tags
To use this module you must add the following tags to your Configuration file:
<host suffix="mynet.net" separator=".">
<hostchange mask="*@some.host" action="addnick">
<hostchange mask="*[email protected]*" action="suffix">
<hostchange mask="[email protected]" action="set" value="blah.blah.blah">

If any connecting user matches one of the masks, the action you provide will be taken upon the users displayed hostname. The action variable can be one of three values:

  • addnick - Make a copy of the nickname, take out all characters illegal in a domain name, and append "separator + suffix". In this example, if the nick "foo" connected their host would be "foo.mynet.net".
  • suffix - Just use the host suffix as their displayed hostname, in this example use "mynet.net".
  • set - Sets their hostname to the 'value' variable. In this case, their hostname would become "blah.blah.blah".


Optionally you can set a prefix which overrules the suffix for action addnick:

<host suffix="mynet.net" separator="." prefix="othernet.net">
<hostchange mask="*@some.host" action="addnick" action="addnick">
<hostchange mask="*[email protected]*" action="suffix">
<hostchange mask="[email protected]" action="set" value="blah.blah.blah">
  • actions suffix and set is the same as above, however the addnick action will now produce a host with "prefix + separator + nickname". In this example, if the nick "foo" connected their host would be "othernet.net.foo".
Modes
This module does not implement any extra user or channel modes.
Extended Bans (Extbans)
This module implements no extended bans.
Commands
This module adds no extra commands.
Special Notes
Please note that this module is largely incompatible with the m_cloaking module, so while this module is loaded you will usually have no +x user mode as you won't load that module at the same time. Once a vhost is set, it stays set until the user disconnects, or is changed by the /chghost command.