btpd
1.0.0
Démon du protocole BitTorrent
btpd est un utilitaire de partage de fichiers via le protocole réseau BitTorrent. Il fonctionne en mode démon, ne nécessitant donc aucun terminal de contrôle ni interface graphique. Au lieu de cela, le démon est contrôlé par btcli, son utilitaire de ligne de commande ou d'autres programmes capables d'envoyer des commandes et des requêtes sur le socket de contrôle.
btpd se compose des programmes suivants :
btpd - Le client bittorrent.btcli - Interface de ligne de commande vers btpd.btinfo - Affiche les informations d'un fichier torrent. Tous les programmes acceptent l'option --help .
L'utilitaire btcli dispose de plusieurs modes de fonctionnement différents. L'une des commandes suivantes doit être spécifiée lors de l'exécution btcli :
add - Ajouter des torrents à btpd.del - Supprime les torrents de btpd.kill - Arrêtez btpd.list - Liste les torrents.rate - Définissez les taux globaux d'installation et de téléchargement en Ko/s.start - Activer les torrents.stat - Afficher les statistiques des torrents actifs.stop - Désactivez les torrents. Pour commencer à partager un torrent avec btpd, le torrent doit être ajouté à btpd. Cela se fait avec btcli add . Lorsque vous ajoutez un torrent, btpd commence automatiquement (si vous n'avez pas spécifié le contraire) à partager le torrent et à télécharger toutes les données manquantes. Le répertoire de contenu que vous spécifiez lors de l'ajout d'un torrent n'a pas besoin d'exister ; il sera créé par btpd.
Vous pouvez voir quels torrents ont été ajoutés à btpd avec btcli list . La commande list affiche également un numéro pour chaque torrent ajouté. Ce numéro peut être utilisé pour spécifier le torrent cible pour les commandes btcli, vous n'avez donc pas besoin de conserver le fichier torrent une fois que vous l'avez ajouté.
La progression du téléchargement et du téléchargement peut être suivie à l'aide de la commande btcli stat . Les commandes list et stat utilisent les indicateurs suivants pour afficher l'état d'un torrent :
+ - le torrent démarre. Cela peut prendre du temps si btpd doit tester le contenu de ce torrent ou d'un torrent lancé avant lui.- - le torrent est en train d'être arrêté.I - le torrent est inactif.S - btpd amorce le torrent.L - btpd draine le torrent. Vous pouvez arrêter un torrent actif avec btcli stop et, bien sûr, démarrer un torrent inactif en utilisant btcli start .
La commande btcli del ne doit être utilisée que lorsque vous avez totalement terminé le partage d'un torrent. La commande supprimera le torrent et ses données associées de btpd. C'est une très mauvaise idée de supprimer un torrent pas entièrement téléchargé, puis de l'ajouter à nouveau, car btpd a perdu des informations sur les éléments non entièrement téléchargés et devra à nouveau télécharger les données.
Pour arrêter btpd, utilisez btcli kill . N'oubliez pas de lire l'aide de chacune des commandes de btcli.
REMARQUE : vous ne devriez avoir besoin que d'une seule instance de btpd, quel que soit le nombre de torrents que vous souhaitez partager.
Pour démarrer btpd avec les paramètres par défaut, il vous suffit de l'exécuter. Cependant, il existe de nombreuses options utiles que vous souhaiterez peut-être utiliser. Pour voir une liste complète, exécutez btpd --help . Si vous n'avez pas spécifié le contraire, btpd démarre avec le même ensemble de torrents actifs que lors de son dernier arrêt.
btdp stockera les informations et écrira son journal dans $HOME/.btpd . Il doit donc pouvoir y écrire lors de son exécution. Vous pouvez spécifier un autre répertoire via l'option -d ou la variable $BTPD_HOME .
Je recommande de spécifier le nombre maximum de téléchargements. Bittorrent utilise un algorithme du tac au tac, donc le téléchargement à de bons tarifs permet le téléchargement. Essayez de trouver un équilibre entre les téléchargements/bande passante sortante et le nombre de torrents actifs.
Démarrez btpd avec toutes les options définies sur leurs valeurs par défaut.
# btpd
Démarrez btpd et faites-le écouter sur le port 12345, limitez la bande passante sortante à 200 Ko/s, limitez le nombre de pairs à 40 et ne démarrez aucun torrent qui était actif la dernière fois que btpd a été arrêté.
# btpd -p 12345 --bw-out 200 --max-peers 40 --empty-start
Afficher une liste des torrents de btpd et leur nombre, taille, statut, etc.
# btcli list
Comme ci-dessus, mais uniquement pour torrent 12 et my.little.torrent.
# btcli list 12 my.little.torrent
Comme ci-dessus mais uniquement pour les torrents actifs.
# btcli list -a
Comme ci-dessus, mais imprimez en utilisant un format personnalisé
# btcli list -a -f "btcli list -f "%nt%#t%p%st%rn"
Ajoutez foo.torrent, avec le répertoire de contenu foo.torrent.d, et démarrez-le.
# btcli add -d foo.torrent.d foo.torrent
Comme ci-dessus sans le démarrer.
# btcli add --no-start -d foo.torrent.d foo.torrent
Démarrez bar.torrent et torrent numéro 7.
# btcli start bar.torrent 7
Arrêtez le torrent numéro 7.
# btcli stop 7
Arrêtez tous les torrents actifs.
# btcli stop -a
Supprimez bar.torrent et ses informations associées de btpd.
# btcli del bar.torrent
Affichez un résumé des statistiques de mise en ligne/téléchargement pour les torrents actifs.
# btcli stat
Affichez le résumé une fois toutes les cinq secondes.
# btcli stat -w 5
Comme ci-dessus, mais affiche également des statistiques individuelles pour chaque torrent actif.
# btcli stat -w 5 -i
Définissez le taux de téléchargement global sur 20 Ko/s et le taux de téléchargement sur 1 Mo/s.
# btcli rate 20K 1M
Arrêtez btpd.
# btcli kill
Si btpd s'est arrêté pour une raison inconnue, vérifiez le fichier journal pour trouver des indices possibles.
Vous devez disposer d'un système BSD, Linux ou suffisamment similaire.
Assurez-vous de disposer de versions récentes des logiciels suivants :
Vous avez également besoin d'un compilateur C99. Un GCC non antique devrait faire l'affaire.
Pour pouvoir ouvrir le manuel situé dans doc vous devez avoir installé man-pages .
# ./configure
# make
# make install
Voir ./configure --help pour les options de construction disponibles si ce qui précède échoue.
La disposition du répertoire torrents dans le répertoire btpd a changé depuis btpd 0.11. Veuillez supprimer le répertoire torrents avant d'exécuter des versions ultérieures.
Si btpd doit envoyer des messages d'arrêt aux trackers avant de s'arrêter, il entrera en mode pré-sortie. Un processus btpd dans ce mode peut être ignoré en toute sécurité et n'interférera pas avec tout nouveau btpd démarré dans le même répertoire.
Malheureusement, activer à la fois IPv6 et IPv4 dans btpd est moins utile qu'il ne devrait l'être. Le problème est que certains sites disposent de trackers pour les deux versions et il est probable que celui d'IPv6, qui a probablement moins de pairs, soit utilisé au profit de celui d'IPv4.
Afin de résoudre ce problème, les options de version IP doivent être modifiées pour être par torrent, dans une future version de btpd.
Si vous souhaitez nous contacter pour obtenir de l'aide, contribuer ou simplement dire bonjour, n'hésitez pas à venir sur notre canal IRC #btpd sur freenode.
