LocatorUnum - Revision history

Kevin Reid: add protocol doc

Kevin Reid — Sun, 06 Sep 2009 22:37:46 GMT

add protocol doc

New page

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

Kevin Reid: stubish

Kevin Reid — Wed, 02 Jul 2008 02:34:23 GMT

stubish

←Older revision		Revision as of 02:34, 2 July 2008
Line 4:		Line 4:

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

Kevin Reid: +pluribus cat

Kevin Reid — Wed, 02 Jul 2008 02:33:58 GMT

+pluribus cat

←Older revision		Revision as of 02:33, 2 July 2008
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.
		+
		+	[[Category:Pluribus]]

Kevin Reid: link to erights.org, briefly explain

Kevin Reid — Wed, 08 Aug 2007 18:50:53 GMT

link to erights.org, briefly explain

←Older revision		Revision as of 18:50, 8 August 2007
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]]~~