Difference between revisions of "LSL Protocol/Restrained Love Open Relay Group/x-xtensions"

From Second Life Wiki
Jump to: navigation, search
m
Line 2: Line 2:
  
 
== !x-tensions ==
 
== !x-tensions ==
 +
STATUS: Up for discussion, but near final
  
; Description : Queries the relay to discover the list of supported x-tensions
+
''Implemented in OpenCollar and in Satomi's Multirelay HUD''
 +
 
 +
; Description : Queries the relay to discover the list of supported x-tensions; this way devices can query the relay for supported x-tensions and make use of them or not as they choose.
  
 
; Implementation : Returns the list of ORG extensions implemented in the relay
 
; Implementation : Returns the list of ORG extensions implemented in the relay
  
 
; Syntax : '''!x-tensions'''
 
; Syntax : '''!x-tensions'''
 +
; Response : '''!x-tensions,<reply>'''
 +
:: where '''<reply>''' is a list of x-tensions, separated by / where each extension is listed with a version number
  
; Scenario:
+
; Example:
 
  -> blah,k(R),!x-tensions
 
  -> blah,k(R),!x-tensions
  <- blah,k(C),!x-tensions,vision|0002/listen|1021/email|0122
+
  <- blah,k(C),!x-tensions,tensions|000/vision|0002/listen|1021/email|0122
  
 
; Discussion
 
; Discussion
 
The relay should answer, in the acknowledgement field by the list of supported x-tensions, separated by slashes "/", followed by the version of the specification of the extension which is implemented (after a vertical bar "|"). Note that only the x-tension names are given, not the full list of meta-commands (email extension has 3 meta-commands, for instance). Note that extension names do not contain the "!x-".
 
The relay should answer, in the acknowledgement field by the list of supported x-tensions, separated by slashes "/", followed by the version of the specification of the extension which is implemented (after a vertical bar "|"). Note that only the x-tension names are given, not the full list of meta-commands (email extension has 3 meta-commands, for instance). Note that extension names do not contain the "!x-".
 +
 +
Also note that one of the responses should be ''tensions'' and its version number. While it seems unlikely that the protocol would change, not responding with ''tensions'' and a version number will make it impossible to make any substantive changes should they prove necessary.

Revision as of 16:09, 28 June 2009

!x-tensions

STATUS: Up for discussion, but near final

Implemented in OpenCollar and in Satomi's Multirelay HUD

Description 
Queries the relay to discover the list of supported x-tensions; this way devices can query the relay for supported x-tensions and make use of them or not as they choose.
Implementation 
Returns the list of ORG extensions implemented in the relay
Syntax 
!x-tensions
Response 
!x-tensions,<reply>
where <reply> is a list of x-tensions, separated by / where each extension is listed with a version number
Example
-> blah,k(R),!x-tensions
<- blah,k(C),!x-tensions,tensions|000/vision|0002/listen|1021/email|0122
Discussion

The relay should answer, in the acknowledgement field by the list of supported x-tensions, separated by slashes "/", followed by the version of the specification of the extension which is implemented (after a vertical bar "|"). Note that only the x-tension names are given, not the full list of meta-commands (email extension has 3 meta-commands, for instance). Note that extension names do not contain the "!x-".

Also note that one of the responses should be tensions and its version number. While it seems unlikely that the protocol would change, not responding with tensions and a version number will make it impossible to make any substantive changes should they prove necessary.