Tip of the day: Connthrottle will limit the damage from big drone attacks. Check if the flood thresholds and exceptions are OK for your network.

Dev:Command Overrides

From UnrealIRCd documentation wiki
Jump to navigation Jump to search

Command overrides allow you to "override" a core command (or a command from other modules). Your code will then execute either before or after the actual command is executed. Or, you can choose not to execute the real command at all.

Generally people prefer the Dev:Hook API as it's more fine-grained and requires less work on your hand. People generally revert to Command Override's if Hooks do not provide (all) the functionality they are looking for.

About the variables available via CMD_OVERRIDE_FUNC

For command overrides we will use the CMD_OVERRIDE_FUNC() macro. These are the variables that you will receive in your override handler in your module:

Variable Type Description
ovr CommandOverride * The override information, usually not touched, except for passing to CallCommandOverride()
client Client * Client pointer of user executing the command.
recv_mtags MessageTag * Message tags associated with the command. If you don't know what this is then just ignore it for now.
parc int Command + parameter count
parv char *[] Parameters

Registering your command override

Registering your override is easy. Example:

CMD_OVERRIDE_FUNC(mymod_nickoverride); /* Forward declaration */

MOD_LOAD(mymod)
{
    CmdoverrideAdd(modinfo->handle, "NICK", mymod_nickoverride);
}

The command override function

Generally you want your code to execute before the real (core?) function is called:

CMD_OVERRIDE_FUNC(mymod_nickoverride)
{
    sendnotice(client, "We are about to call the real function. We could do something useful here.");

    return CallCommandOverride(ovr, client, recv_mtags, parc, parv); // call the real function and return it's return value
}

If you want to execute your function after this is also possible, it just takes some extra care:

CMD_OVERRIDE_FUNC(mymod_nickoverride)
{
    CallCommandOverride(ovr, client, recv_mtags, parc, parv); // call the real function

    if (IsDead(client))
        return; /* killed or client exited, we MUST return */

    sendnotice(client, "The command was executed. We could do something useful here afterwards.");
}

More information

For more information on parc and parv[], see Dev:Command_API#Parameter_checking

You can also look at the source of other modules or UnrealIRCd itself. Overrides are used in the hideserver module, restrict-commands and in the antimixedutf8 module.