kitetorrent/io.github.yuroyami.kitetorrent.alert/TrackerErrorAlert

TrackerErrorAlert

data class TrackerErrorAlert(val torrentName: String?, val trackerUrl: String, val localEndpoint: String, val timesInRow: Int, val errorMessage: String, val failureReason: String = "", val version: ProtocolVersion = ProtocolVersion.V1) : TrackerAlert

Generated on tracker timeouts, premature disconnects, invalid responses or a non-200 OK HTTP response. Ported from libtorrent::tracker_error_alert (alert_type 11).

libtorrent renders <tracker-prefix> <v1|v2> <error-message> "<failure-reason>" (<timesInRow>).

Constructors

TrackerErrorAlert

constructor(torrentName: String?, trackerUrl: String, localEndpoint: String, timesInRow: Int, errorMessage: String, failureReason: String = "", version: ProtocolVersion = ProtocolVersion.V1)

Types

Companion

object Companion

Properties

category

open override val category: Int

The bitmask of AlertCategory flags this alert belongs to. Mirrors alert::category(), which returns the concrete alert's static_category.

errorMessage

val errorMessage: String

the description of why the announce failed.

failureReason

val failureReason: String

the tracker's "failure reason" string, if any (may be empty).

localEndpoint

open override val localEndpoint: String

the local listen interface endpoint, already formatted.

timesInRow

val timesInRow: Int

how many times in a row this tracker has failed.

torrentName

open override val torrentName: String?

the torrent's name, or null when the handle would be invalid (rendered as " - ", matching libtorrent).

trackerUrl

open override val trackerUrl: String

the tracker URL being announced to.

type

open override val type: Int

An integer unique to this alert type, matching the C++ alert_type static constant. It can be compared against a concrete alert's ALERT_TYPE to determine the runtime type. Mirrors alert::type().

version

val version: ProtocolVersion

the BitTorrent protocol version announced.

what

open override val what: String

A short string literal naming the alert type (e.g. "torrent_finished"). It carries no bundled information. Mirrors alert::what(), which in libtorrent returns alert_name(alert_type).

Functions

message

open override fun message(): String

A string describing the alert and the information bundled with it. Intended for debugging/development, not localization. Mirrors alert::message().