LocatorUnum

From Erights

(Difference between revisions)
Jump to: navigation, search
(stubish)
(add protocol doc)
 
(2 intermediate revisions not shown)
Line 2: Line 2:
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.
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:Pluribus]]
[[Category:Stubs]]
[[Category:Stubs]]

Latest revision as of 22:37, 6 September 2009

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