Remote Verb Calls

Remote Verb calling is one of two modes of operation on SunNET and is the only mode requiring no wizardly assistance. I consider it the higher level of operation, yet it is unsuitable for transmissions which are intended to broadcast to several sites.

There are four verbs for remotely executing verbs. All of these are run with $no_one permissions.

• $sunnet_utils:verb_call(STR destination, [OBJ object number | STR object name (to be matched remotely)], STR verb [, @argslist])
  This is probably the most frequently used verb on SunNET for programmers. It returns a two element list where the first element is the success or failure and the second element is the return value on success or the reason for failure.

• $sunnet_utils:send(STR destination, [OBJ object number | STR object name (to be matched remotely)], STR verb [, @argslist])
  This is very similar to :verb_call but asks that the remote site not send back a return value. This verb always returns a two element list with the first element as 1 (or success) and the second element undefined.

• $sunnet_utils:eval(STR destination, STR eval code)
  This verb called eval with $no_one's permissions to execute the eval code. Like all the other verbs, it returns a two element list with the first element as success or failure and the second element as the call result or reason for falure.

• $sunnet_utils:eval_d(STR destination, STR eval code)
  Same as :eval except the eval code is treated as if the `d' bit were turned off (or as if the entire eval were enclosed in a catch statement in 1.8.0).