NAME

Net::BitTorrent::Types - Shared constants for Net::BitTorrent

SYNOPSIS

use Net::BitTorrent::Types qw[:all];

if ($torrent->state == STATE_RUNNING) { ... }

DESCRIPTION

This module exports constants used throughout the Net::BitTorrent suite.

CONSTANTS

Encryption Levels (:encryption)

ENCRYPTION_NONE

No protocol encryption is allowed. Only plaintext connections.

ENCRYPTION_PREFERRED

Attempt encryption but fall back to plaintext if the peer doesn't support it.

ENCRYPTION_REQUIRED

Only encrypted connections are allowed. Plaintext handshakes will be rejected.

Swarm States (:state)

STATE_STOPPED

The swarm is inactive. No network or disk I/O.

STATE_STARTING

The swarm is initializing (allocating files, announcing to trackers).

STATE_RUNNING

The swarm is actively transferring data.

STATE_PAUSED

The swarm is active but data transfer is suspended.

STATE_METADATA

The swarm is in magnet-mode, fetching the info dictionary.

Piece Picking Strategies (:pick)

PICK_SEQUENTIAL

Download pieces in order (0, 1, 2, ...). Useful for streaming.

PICK_RAREST_FIRST

Download the pieces that are least common in the swarm first. Standard strategy.

PICK_STREAMING

A hybrid strategy optimized for media playback.

AUTHOR

Sanko Robinson <sanko@cpan.org>

COPYRIGHT

Copyright (C) 2008-2026 by Sanko Robinson.

This library is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.