The InspIRCd Project
Home | Developers | Wiki | Forums | Bug Tracker | SVN | Download | Blog
Personal tools

Modules/hostchange

From Inspire IRCd (InspIRCd)

Jump to: navigation, search

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="*someident@*" action="suffix">
<hostchange mask="a@b.com" 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="*someident@*" action="suffix">
<hostchange mask="a@b.com" 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".

Additional Modes

None

Additional Commands

None

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.