LocatorUnum
From Erights
(Difference between revisions)
Kevin Reid (Talk | contribs) (link to erights.org, briefly explain) |
(add protocol doc) |
||
| 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: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.
