.\"switches a player (interactive) connection from one object to another
.DT
exec
$MUDNAME$ driver help
exec

.SH Name
.SI 5
exec() - switches a player (interactive) connection from one object to another
.EI

.SH Synopsis
.SI 5
int exec( object to, object from );
.EI

.SH Description
.SP 5 5
This efunction allows the interactive link to a given object to be
moved to another object.  That is, after a successful exec(to, from)
call, interactive(to) will return 1 and interactive(from) will return 0.
The player that was controlling 'from' will begin controlling 'to' following
the exec() call.  Note that this is a powerful function and its use must
be restricted if you wish to attempt to have a secure mud.  The proper
way to restrict the use of exec() is to make a simul_efun of the same name
and then use valid_override() to restrict the use of a simul_efun override
(i.e. efun::exec()).  The exec() function returns 1 if the switch is
successful (and 0 otherwise).
.EP

.SH See also
.SI 5
interactive(), valid_override()
.EI
