LocatorUnum

From Erights

Jump to: navigation, search

See [1].

The LocatorUnum provides the authority to convert bits (a VatID and SwissNumber) into a capability (a CapTP live ref). Each Introducer has one presence of the LocatorUnum.

Protocol

getRcvr/4

Signature: getRcvr(searchPath :SearchPath, vatID :VatID, swissNum :Swiss, optFarVine :any) :any

XXX In E-on-Java this is Java-defined as throws IOException, IndexOutOfBoundsException. Should this be documented as throwing? If it throws rather than returning broken, is this a being-consistently-eventual failure?

The basic operation underlying 'SturdyRef.getRcvr()'.

This is where a reference to a remote object actually gets the various underlying comm systems connected so that we can send messages.

getRcvr only works when we're onTheAir.

Parameters:

searchPath 
A list of places to try to find the vat
vatID 
The vat from which the object reference should be obtained
swissNum 
The SwissNumber of the desired object
optFarVine 
Optional object for holding onto a Remote reference via whoever we got it from long enough to fetch our own Remote reference via this lookup.
Personal tools
more tools