User Commands                                     transmission(1)



NAME
     transmission - a GTK]-based BitTorrent client

SYNOPSIS
     transmission [--help]

     transmission [--paused] [--minimized]  [--config-dir  direc-
     tory] [torrent-file...]

DESCRIPTION
     transmission is a fast  and  easy  BitTorrent  client.  Bit-
     Torrent  is a peer-to-peer file transfer protocol which uses
     a metainfo file (usually with the .torrent  file  extension)
     and  a  central  tracker  to  distribute file data amongst a
     group of peers. For more information on the BitTorrent  pro-
     tocol see http:/www.bittorrent.org/

EXTENDED DESCRIPTION
  Seeder
     A seeder is a peer that has a complete copy of  the  torrent
     and  still offers it for upload. The more seeders there are,
     the better the chances are for completion of the file.

  Leecher
     A leecher is usually a peer who has a negative effect on the
     swarm  by  having  a very poor share ratio - in other words,
     downloading much more than they upload.  Most  leechers  are
     users  on  asymmetric  internet connections and do not leave
     their BitTorrent client open to seed the  file  after  their
     download has completed. However, some leechers intentionally
     avoid uploading by using  modified  clients  or  excessively
     limiting  their upload speed. The term leecher, however, can
     be used simply to describe a peer - or any client that  does
     not have 100% of the data.

  Swarm
     Together, all peers (including seeders)  sharing  a  torrent
     are  called a swarm. For example, six ordinary peers and two
     seeders make a swarm of eight.

  Torrent
     A torrent can mean either a .torrent metadata  file  or  all
     files  described  by  it,  depending on context. The torrent
     file contains metadata about all the files  it  makes  down-
     loadable,  including  their names and sizes and checksums of
     all pieces in the torrent. It also contains the address of a
     tracker  that coordinates communication between the peers in
     the swarm.

  Tracker
     A tracker is a server that keeps track of  which  seeds  and
     peers  are  in  the swarm. Clients report information to the



SunOS 5.11          Last change: 17 Jul 2008                    1






User Commands                                     transmission(1)



     tracker periodically and  in  exchange  receive  information
     about  other  clients to which they can connect. The tracker
     is not directly involved in the data transfer and  does  not
     have a copy of the file.

OPTIONS
     The following options are supported:

     -?, --help

         Show help options.



     -p, --paused

         Start with all torrents paused.



     -m, --minimized

         Start minimized in system tray.



     -g, --config-dir directory

         Where to look for configuration files.



     Multiple .torrent files may be added at startup by appending
     them  on  the  command line. If transmission is already run-
     ning, the torrents will be added to the running instance.

OPERANDS
     The following operands are supported:

     torrent-file    The name of the torrent file.



ENVIRONMENT VARIABLES
     transmission uses the following environment variables:

     TRANSMISIONHOME       Sets the default conf-dir.



FILES




SunOS 5.11          Last change: 17 Jul 2008                    2






User Commands                                     transmission(1)



     The following files are used by this application:

     /usr/bin/transmission

         The executable for transmission



     $HOME/.config/transmission

         The conf-dir used when neither TRANSMISIONHOME nor  -g
         is specified.



EXIT STATUS
     The following exit values are returned:

     0        Application exited successfully.



     >0       Application exited with failure.



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWtransmission            
    
     Interface stability          Volatile                    
    


SEE ALSO
     transmissioncli(1),  transmission-daemon(1),   transmission-
     remote(1), attributes(5)

     Transmission community site - http:/www.transmissionbt.org/

NOTES
     transmission   program   was   written   by   Charles   Kerr