KHLA

From Gnutella2
Revision as of 09:49, 29 January 2009 by CyberBob (talk | contribs) (Fixed typo)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Root Packets
CRAWLA - CRAWLR
HAW - LNI
KHL - KHLA - KHLR
PI - PO - PUSH
QKA - QKR
Q2 - QA - QH2 - QHT
UPROC - UPROD

/KHLA

The known hub list acknowledgement packet is part of UKHL implementation, used to answer back to request of packet list of known Gnutella2 hubs with /KHLR packet.

Sending

This packet should be sent through UDP when received /KHLR packet.

Receiving

Upon receiving a known hub list, the detailed hubs should be stored in appropriate data structures.

Payload

This packet has no payload at the current time.

Children

This packet has several child packet types defined at the current time:

  • /KHLA/UKHLID - Unique ID
  • /KHLA/YOURIP - IP address of requester.
  • /KHLA/URL - URL to UKHL services for bootstrap propagation.
  • /KHLA/TS - Timestamp
  • /KHLA/NH - Neighbouring Hub
  • /KHLA/CH - Cached Hub

/KHLA/UKHLID - Unique ID

Unique ID which must be same as sent on corresponding /KHLR packet. Client requesting Known Hub List should compare if ID is same as corresponding /KHLR packet for security reason.

Sending

This child is optional but recommended.

Payload

16Byte unique ID such as GUID.

/KHLA/TS - Timestamp

The /KHLA/TS child provides a timestamp representing the current universal time at the sending node. This can be used as a reference when considering other timestamps in the packet, allowing them to be adjusted to eliminate differences between the time setting on the local and remote node.

Sending

This child is optional but recommended.

Payload

A 32-bit integer representing the current UNIX time, or time (NULL).

Children

This packet has no known children at the current time.

/KHLA/NH - Neighbouring Hub

This child packet represents a neighbouring hub.

Sending

One should be included for each Gnutella2 neighbour hub, with the possible exception of the one to which this packet is being sent.

Payload

The node address of the hub. See datatypes for more information.

Children

This packet has several child packet types defined at the current time:

  • /KHLA/NH/GU - GUID
  • /KHLA/NH/V - Vendor Code
  • /KHLA/NH/LS - Library Statistics
  • /KHLA/NH/HS - Hub Status

/KHLA/NH/GU - GUID

The /KHLA/NH/GU child packet specifies the globally unique identifier of the hub.

Sending

This child is optional.

Payload

The 16 byte globally unique node identifier of the hub.

Children

This packet has no known children at the current time.

/KHLA/NH/V - Vendor Code

The /KHLA/NH/V child packet specifies the vendor code of the software operating the hub.

Sending

This child is optional.

Payload

A four byte vendor code.

Children

This packet has no known children at the current time.

/KHLA/NH/LS - Library Statistics

The /KHLA/NH/LS packet provides information about the content library of the hub and its connected leaves.

Sending

This child is optional.

Payload

Two 32-bit integers representing the number of files, and the total KB of available content in the hub's own library and the libraries of its connected leaves. The payload may grow beyond 8 bytes in the future.

Children

This packet has no known children at the current time.

/KHLA/NH/HS - Hub Status

The /KHLA/NH/HS packet contains the status of the hub.

Sending

This child is optional.

Payload

Two 16-bit integers representing the current leaf count and the maximum leaf count respectively. This packet may grow beyond 4 bytes in the future.

Children

This packet has no known children at the current time.

/KHLA/CH - Cached Hub

This child packet represents a hub from the hub cache.

Sending

An arbitrary number of these children should be included, constrained by space and the number of available cached hubs. A selection of freshly time stamped but previously unknown hubs should be included, and the list should not include hubs in the local cluster.

Payload

The node address of the hub, followed by the time this hub was last seen as a 32-bit timestamp. The last seen time can be adjusted based on the difference between the /KHLA/TS timestamp and the local time. Note that the node address is of variable length, so it is important to consider the last 4 bytes as the timestamp rather than assuming a fixed length node address.

Children

This packet has several child packet types defined at the current time:

  • /KHLA/CH/GU - GUID
  • /KHLA/CH/V - Vendor Code
  • /KHLA/CH/LS - Library Statistics
  • /KHLA/CH/HS - Hub Status

This extra information is considered less relevant for a cached hub because it is unlikely to be up to date enough to be useful.

/KHLA/CH/GU - GUID

The /KHLA/CH/GU child packet specifies the globally unique identifier of the hub.

Sending

This child is optional.

Payload

The 16 byte globally unique node identifier of the hub.

Children

This packet has no known children at the current time.

/KHLA/CH/V - Vendor Code

The /KHLA/CH/V child packet specifies the vendor code of the software operating the hub.

Sending

This child is optional.

Payload

A four byte vendor code.

Children

This packet has no known children at the current time.

/KHLA/CH/LS - Library Statistics

The /KHLA/NH/LS packet provides information about the content library of the hub and its connected leaves.

Sending

This child is optional.

Payload

Two 32-bit integers representing the number of files, and the total KB of available content in the hub's own library and the libraries of its connected leaves. The payload may grow beyond 8 bytes in the future.

Children

This packet has no known children at the current time.

/KHLA/CH/HS - Hub Status

The /KHLA/CH/HS packet contains the status of the hub.

Sending

This child is optional.

Payload

Two 16-bit integers representing the current leaf count and the maximum leaf count respectively. This packet may grow beyond 4 bytes in the future.

Children

This packet has no known children at the current time.