
exec(3)               LPC Library Functions               exec(3)

NNAAMMEE
       exec()  -  switches a player (interactive) connection from
       one object to another

SSYYNNOOPPSSIISS
       int exec( object to, object from );

DDEESSCCRRIIPPTTIIOONN
       This efunction allows the  interactive  link  to  a  given
       object to be migrated 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(4) to restrict the use of a
       simul_efun override (i.e. efun::exec()).  The exec() func       tion  returns  1 if the switch is successful (and 0 other       wise).

SSEEEE AALLSSOO
       interactive(3), valid_override(4)

Majik                      26 Jul 1997                          1

