Compilare rTorrent da SVN su Ubuntu Gutsy

Importante: eseguire i comandi come utente normale; usare sudo solo per i comandi che richiedono privilegi di sistema.

Introduzione

I torrent sono un ottimo modo per trasferire file di grandi dimensioni rapidamente. Molti client torrent hanno interfacce grafiche e consumano molte risorse di sistema (ad esempio Azureus). rTorrent è un client leggero che gira in terminale. Può essere eseguito in una sessione screen (anche all’avvio), il che lo rende ideale per il controllo remoto.

Come usare, supportare e ottenere aiuto

Pagina ufficiale di rTorrent: qui puoi trovare informazioni e link utili.
Guida base all’uso di rTorrent: qui trovi una guida introduttiva.
Canali IRC: irc.freenode.org #rtorrent e irc.worldforgenet.org #libtorrent.

Assunzioni

Questa guida usa la cartella home predefinita dell’utente e scarica i file SVN in ~/rtorrent. Non devi essere loggato come root; lavora come utente normale e usa sudo quando necessario.

Requisiti iniziali

Esegui questo comando per installare i pacchetti necessari:

sudo apt-get install subversion build-essential libtool automake1.9 openssl libcurl3 libcurl3-dev libsigc++-2.0-0c2a libsigc++-2.0-dev libncurses5 libncurses5-dev

Nota: Automake deve essere una versione più recente di 1.4. Altre versioni funzionano; nell’esempio si usa automake1.9 perché era richiesta per altri scopi.

Workflow sintetico

Creare la cartella di lavoro
Scaricare il trunk SVN
Compilare e installare libtorrent
Compilare e installare rTorrent
Aggiornare ld.so e avviare rTorrent

1. Creare la cartella di download per rtorrent

mkdir ~/rtorrent

2. Spostarsi nella cartella di download

cd ~/rtorrent

Posizione corrente: /home/USER/rtorrent

3. Ottenere l’ultima versione trunk

svn co svn://rakshasa.no/libtorrent/trunk

4. Entrare nella cartella trunk

cd trunk

Posizione corrente: /home/USER/rtorrent/trunk

5. Aggiornare rTorrent all’ultima versione SVN

svn up

6. Andare nella cartella libtorrent

cd libtorrent

Posizione corrente: /home/USER/rtorrent/trunk/libtorrent

7. Eseguire lo script autogen

./autogen.sh

8. Configurare la build di libtorrent

./configure

9. Compilare libtorrent

make

10. Installare libtorrent nel sistema

sudo make install

11. Aggiungere /usr/local/lib a ld.so.conf

echo "include /usr/local/lib" | sudo tee -a /etc/ld.so.conf

12. Ricostruire la cache di ld.so

sudo ldconfig

13. Andare nella cartella rTorrent

cd ../rtorrent

Posizione corrente: /home/USER/rtorrent/trunk/rtorrent

14. Eseguire autogen per rTorrent

./autogen.sh

15. Configurare rTorrent

./configure

16. Compilare rTorrent

make

17. Installare rTorrent

sudo make install

18. Avviare rTorrent

rtorrent

Questo è tutto — buon lavoro e buona condivisione!

Aggiornare alla versione più recente

Per aggiornare rTorrent in futuro, ripeti il punto 5 (svn up) e poi ricompila seguendo i passi per libtorrent e rTorrent.

Alternative e approcci diversi

Installazione tramite pacchetti: su Ubuntu più recenti è spesso più semplice usare apt-get install rtorrent, che gestisce automaticamente dipendenze e aggiornamenti.
Versioni precompilate: molte distribuzioni e repository PPA offrono build pronte per l’uso, utile se non vuoi compilare.
Contenitori: usare Docker o LXC per isolare l’installazione e non toccare librerie di sistema.

Quando questa procedura può fallire

Distribuzione obsoleta: Gutsy Gibbon è molto vecchia; alcune dipendenze potrebbero non essere disponibili o aggiornate.
Permessi: eseguire make install come utente non privilegiato senza sudo fallirà.
Versioni incompatibili di librerie (libcurl, libsigc++): in caso di errori, leggere i log di configure e make.

Checklist prima di iniziare (ruoli)

Utente normale:
- Verificare spazio su disco e connessione internet
- Assicurarsi di avere sudo
Amministratore di sistema:
- Consentire l’uso di sudo per l’utente
- Verificare policy di sicurezza e repository interni

Mini-metodologia per la compilazione

Preparare l’ambiente: installare build-essential e dipendenze.
Scaricare sorgenti via SVN.
Eseguire autogen e configure per generare i Makefile.
Compilare (make) e installare (sudo make install).
Aggiornare linker dinamico (ldconfig).
Testare l’eseguibile e risolvere eventuali errori dei log.

Note di compatibilità e migrazione

Se stai migrando da una versione più recente di Ubuntu: preferisci i pacchetti della distro o un PPA aggiornato.
Attenzione alle differenze di percorso di librerie (/usr/local/lib vs /usr/lib).
In ambienti moderni potresti dover usare automake o autoconf più nuovi rispetto a quelli presenti su Gutsy.

Glossario in una riga

SVN: sistema di controllo versione Subversion.
trunk: ramo principale del repository SVN.
libtorrent: libreria C++ usata da rTorrent per il protocollo BitTorrent.
rTorrent: client BitTorrent a linea di comando.

Risoluzione rapida dei problemi (sintesi)

Errore di configure: installare le dipendenze mancanti indicate nell’output.
Funziona in locale ma non dopo make install: verificare ld.so.conf e ldconfig.
Comportamento strano all’avvio: controllare le impostazioni nel file di configurazione di rTorrent e i permessi delle cartelle di download.

Riepilogo

Scarica il codice dal trunk SVN, compila prima libtorrent, poi rTorrent.
Assicurati che /usr/local/lib sia incluso in ld.so.conf e ricostruisci la cache con ldconfig.
Valuta alternative come pacchetti precompilati o container se la compilazione fallisce o la tua distribuzione è obsoleta.

Takeaway finali

Compilare da sorgente dà controllo e accesso a versioni recenti, ma richiede gestione delle dipendenze.
Per ambienti di produzione o utenti non esperti è spesso preferibile usare pacchetti della distribuzione o container.