SYNOPSIS

#include <sys/driver_hooks.h>

set_driver_hook	(	H_MODIFY_COMMAND_FNAME,	value	)

DESCRIPTION

Arguments:

• value (int|string) – <name>(string cmd)

Mandatory hook specifying the name of the ‘modify_command’ lfun to call for newly entered commands as result of a set_modify_command(E).

Hook setting must be a string.

If set_modify_command(E) is used for an interactive user, all newly entered commands are first passed to the function named by this hook.

The function is called with the command as argument.

If the result is a string, it is the new command to execute instead of the given one. Note that it is not possible to make several commands from one this way!

If the result is a non-zero number, the given command is to be ignored. In case of the closure/lfun setting this may mean that the closure/lfun already executed it.

If the result is 0, the originally given command is to be used.

It is possible for the hook to change the command giver (this_player(E)) for the execution of the command. This means that even though the commands are execute for the original commandgiver, this_player(E) will return the changed commandgiver.

SEE ALSO

hook, command(H), modify_command(H), notify_fail(H), send_notify_fail(H)