View source

See [http://www.erights.org/javadoc/net/captp/jcomm/LocatorUnum.html].

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==

{{instance msgdoc|getRcvr|4|<var>searchPath</var> :[[SearchPath]], <var>vatID</var> :[[VatID]], <var>swissNum</var> :[[Swiss]], <var>optFarVine</var> :[[any]]|[[any]]}}

{{XXX|In E-on-Java this is Java-defined as <code>throws IOException, IndexOutOfBoundsException</code>. 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 [[Introducer#onTheAir/0|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.

[[Category:Pluribus]]
[[Category:Stubs]]