freenet.node.probe

Interface Listener

public interface Listener

Listener for the different types of probe results.

Method Summary

Modifier and Type	Method and Description
void	onBuild(int build) Build result.
void	onError(Error error, java.lang.Byte code, boolean local) An error occurred.
void	onIdentifier(long identifier, byte uptimePercentage) Identifier result.
void	onLinkLengths(float[] linkLengths) Link length result.
void	onLocation(float location) Location result.
void	onOutputBandwidth(float outputBandwidth) Output bandwidth limit result.
void	onOverallBulkOutputCapacity(byte bandwidthClassForCapacityUsage, float capacityUsage) Capacity usage and approximate bandwidth class
void	onRefused() Endpoint opted not to respond with the requested information.
void	onRejectStats(byte[] stats) Reject stats.
void	onStoreSize(float storeSize) Store size result.
void	onUptime(float uptimePercentage) Uptime result.

Method Detail

onError

void onError(Error error,
             java.lang.Byte code,
             boolean local)

An error occurred.

Parameters:

error - type: What error occurred. Can be one of Probe.ProbeError.

code - Code byte value. If the error is an UNKNOWN or UNRECOGNIZED_TYPE which occurred locally this contains the unrecognized code from the message. Otherwise it is null.

local - True if the error occurred locally and was not prompted by an error relayed from a remote node. False if the error was relayed from a remote node.

onRefused

void onRefused()

Endpoint opted not to respond with the requested information.

onOutputBandwidth

void onOutputBandwidth(float outputBandwidth)

Output bandwidth limit result.

Parameters:

outputBandwidth - endpoint's reported output bandwidth limit in KiB per second.

onBuild

void onBuild(int build)

Build result.

Parameters:

build - endpoint's reported build / main version.

onIdentifier

void onIdentifier(long identifier,
                  byte uptimePercentage)

Identifier result.

Parameters:

identifier - identifier given by endpoint.

uptimePercentage - quantized noisy 7-day uptime percentage

onLinkLengths

void onLinkLengths(float[] linkLengths)

Link length result.

Parameters:

linkLengths - endpoint's reported link lengths.

onLocation

void onLocation(float location)

Location result.

Parameters:

location - location given by endpoint.

onStoreSize

void onStoreSize(float storeSize)

Store size result.

Parameters:

storeSize - endpoint's reported store size in GiB multiplied by Gaussian noise.

onUptime

void onUptime(float uptimePercentage)

Uptime result.

Parameters:

uptimePercentage - endpoint's reported percentage uptime in the last requested period; either 48 hour or 7 days.

onRejectStats

void onRejectStats(byte[] stats)

Reject stats.

Parameters:

stats - Array of 4 bytes, with the percentage rejections for (bulk only): CHK request, SSK request, CHK insert, SSK insert. Negative value = insufficient data. Positive value = percentage rejected.

onOverallBulkOutputCapacity

void onOverallBulkOutputCapacity(byte bandwidthClassForCapacityUsage,
                                 float capacityUsage)

Capacity usage and approximate bandwidth class