QKA - Revision history

Ram: /* Payload */ Pinpoint a G2 protocol design mistake

2014-01-27T22:12:42Z

Payload: Pinpoint a G2 protocol design mistake

← Older revision		Revision as of 22:12, 27 January 2014
Line 28:		Line 28:

	This packet has no payload at the current time.		This packet has no payload at the current time.

			'''Note''' from ''Raphael Manfredi'': there is a protocol design ''mistake'' here: when the /QKA message is sent back by a hub because the /Q2 did not contain a valid query key, the MUID of the faulty /Q2 should be inserted here as payload, in order to let the querying party know which /Q2 was rejected.

			It is OK however to have an empty payload when replying to a /QKR.

	== Children ==		== Children ==

Dcat: /* /QKA/CACHED - The query key is from cache */

2009-01-11T19:30:19Z

/QKA/CACHED - The query key is from cache

← Older revision		Revision as of 19:30, 11 January 2009
Line 98:		Line 98:
	This packet has no known children at the current time.		This packet has no known children at the current time.

	== /QKA/CACHED - ~~The query key is from cache~~ ==		== /QKA/CACHED - Query Key Cached ==

	Indicates that the query key returned was retrieved from cache.		Indicates that the query key returned was retrieved from cache.

Dcat: /* /QKA/QNA - Queried Node Address */

2009-01-11T19:28:41Z

/QKA/QNA - Queried Node Address

← Older revision		Revision as of 19:28, 11 January 2009
Line 78:		Line 78:
	If this query key answer packet has been forwarded to a firewalled leaf from a		If this query key answer packet has been forwarded to a firewalled leaf from a
	connected hub, a /QKA/QNA child will have been added to indicate the address of		connected hub, a /QKA/QNA child will have been added to indicate the address of
	the remote hub.		the remote hub from which the query key has been issued.

	=== Sending ===		=== Sending ===

Dcat: /* /QKA/CACHED */

2009-01-11T18:34:19Z

/QKA/CACHED

← Older revision		Revision as of 18:34, 11 January 2009
Line 98:		Line 98:
	This packet has no known children at the current time.		This packet has no known children at the current time.

	== /QKA/CACHED ==		== /QKA/CACHED - The query key is from cache ==

	Indicates that the query key returned was retrieved from cache.		Indicates that the query key returned was retrieved from cache.
Line 104:		Line 104:
	=== Sending ===		=== Sending ===

	This packet should be added in response to a /QKR/QNA over TCP.		This packet should be added by a hub in response to a /QKR/QNA over TCP from a leaf.

	=== Receiving ===		=== Receiving ===

	Indicates that the query key in the response was retrieved from cache.		Indicates to the leaf that the query key in the response was retrieved from cache.

	=== Payload ===		=== Payload ===

Dcat at 18:32, 11 January 2009

2009-01-11T18:32:41Z

← Older revision		Revision as of 18:32, 11 January 2009
Line 31:		Line 31:
	== Children ==		== Children ==

	The QKA packet has ~~three~~ child packets defined at the current time:		The QKA packet has these child packets defined at the current time:

	* /QKA/QK		* /QKA/QK
	* /QKA/SNA		* /QKA/SNA
	* /QKA/QNA		* /QKA/QNA
			* /QKA/CACHED

	== /QKA/QK - Query Key ==		== /QKA/QK - Query Key ==
Line 92:		Line 93:

	The node address (with port number optional) of the remote hub.		The node address (with port number optional) of the remote hub.

			=== Children ===

			This packet has no known children at the current time.

			== /QKA/CACHED ==

			Indicates that the query key returned was retrieved from cache.

			=== Sending ===

			This packet should be added in response to a /QKR/QNA over TCP.

			=== Receiving ===

			Indicates that the query key in the response was retrieved from cache.

			=== Payload ===

			This packet has no payload at the current time.

	=== Children ===		=== Children ===

	This packet has no known children at the current time.		This packet has no known children at the current time.

Dcat at 04:10, 1 January 2009

2009-01-01T04:10:58Z

← Older revision		Revision as of 04:10, 1 January 2009
Line 1:		Line 1:
	~~[[PUSH\|<< PUSH]] \| [[QKR\|QKR >>]] \| [[Root_packets_index\|Packet Index]]~~		{{Packets}}


	= /QKA - Query Key Answer =		= /QKA - Query Key Answer =

Spooky: navi

2005-09-05T23:39:24Z

navi

← Older revision		Revision as of 23:39, 5 September 2005
Line 1:		Line 1:
			[[PUSH\|<< PUSH]] \| [[QKR\|QKR >>]] \| [[Root_packets_index\|Packet Index]]


	= /QKA - Query Key Answer =		= /QKA - Query Key Answer =

Dcat at 05:27, 20 March 2005

2005-03-20T05:27:06Z

New page

= /QKA - Query Key Answer =

The query key answer packet is sent in response to a [[QKR|query key request]] or in the
event that a query with an incorrect or omitted query key is received. It advises the
receiver of the correct query key to be used when contacting the sending hub to
execute a remote cluster query.

== Sending ==

The query key answer packet should be sent by a hub when a query key has been
requested. It should contain a key unique to the local hub and the requesting node
address supplied in the request, and should be sent to that address only.
The query key answer packet may also be sent upon receiving a query with a
missing or invalid query key. In this case no query should be performed.

== Receiving ==

Upon receiving a query key answer packet, the supplied query key should be stored
for later use. If the answer packet contains a sending node address (/QKA/SNA) child
which does not match the local node address, it may be forwarded to a connected
leaf node via TCP with a matching address. In the forwarding case, a query node
address (/QKA/QNA) child is added prior to forwarding to retain the remote (queried)
hub's address.

== Payload ==

This packet has no payload at the current time.

== Children ==

The QKA packet has three child packets defined at the current time:

* /QKA/QK
* /QKA/SNA
* /QKA/QNA

== /QKA/QK - Query Key ==

The /QKA/QK child contains the query key that was requested.

=== Sending ===

This child is required if a key is being issued. Sending a /QKA without a /QKA/QK
indicates that the hub does not wish to authorise the requesting node to query it or
its cluster.

=== Payload ===

A 32-bit query key which is unique to the hub and the sending node address.

=== Children ===

This packet has no known children at the current time.

== /QKA/SNA - Sending Node Address ==

This child specifies the node address for which the key has been issued. This is not
necessarily the node that physically transmitted the key request or the query.

=== Sending ===

This child is required.

=== Payload ===

The node address (with port number optional) of the node which requested the
query key.

=== Children ===

This packet has no known children at the current time.

== /QKA/QNA - Queried Node Address ==

If this query key answer packet has been forwarded to a firewalled leaf from a
connected hub, a /QKA/QNA child will have been added to indicate the address of
the remote hub.

=== Sending ===

This child should be added by a hub when relaying a received query key answer on
to a leaf via TCP.

=== Receiving ===

If this child is present, the query key answer should be treated as if it originated
from the stored address rather than the TCP neighbour.

=== Payload ===

The node address (with port number optional) of the remote hub.

=== Children ===

This packet has no known children at the current time.