kitetorrent/io.github.yuroyami.kitetorrent.alert/PeerErrorAlert

PeerErrorAlert

data class PeerErrorAlert(val torrentName: String?, val endpoint: String, val client: String = "Unknown", val operation: String = "bittorrent", val errorCategory: String = "system", val errorMessage: String) : PeerAlert

Generated when a peer sends invalid data over the peer protocol and is disconnected. Ported from libtorrent::peer_error_alert (alert_type 22).

libtorrent renders <peer-prefix> peer error [<operation>] [<errorCategory>]: <errorMessage>.

Constructors

PeerErrorAlert

constructor(torrentName: String?, endpoint: String, client: String = "Unknown", operation: String = "bittorrent", errorCategory: String = "system", errorMessage: String)

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.

client

open override val client: String

the identified client string for the peer id, if known.

endpoint

open override val endpoint: String

the peer's address and port, already formatted (e.g. "1.2.3.4:6881").

errorCategory

val errorCategory: String

the error category name (error.category().name()).

errorMessage

val errorMessage: String

the error description.

operation

val operation: String

the low-level operation that failed (operation_name).

torrentName

open override val torrentName: String?

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

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().

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().