File: README

package info (click to toggle)
mutella 0.3.3-4
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,488 kB
  • ctags: 2,069
  • sloc: cpp: 14,194; sh: 8,714; ansic: 464; makefile: 55
file content (126 lines) | stat: -rw-r--r-- 5,360 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
MUTELLA - unix/linux Gnutella-net client
========================================
http://mutella.sourceforge.net

Well, yet another Gnutella clone. Initially I wrote it for myself suddenly
I've noticed that it's not bad at all... Still it is far from ideal though.

General information about Gnutella network can be found at
http://www.gnutella.co.uk
http://www.gnutella.wego.com
http://www.gnutelliums.com
http://www.gnutellaforums.com/

The INSTALL document describes how to build mutella. If you are running a
reasonably recent (less than a year old) release of Linux, it will amount to
the following steps:
  # unpack the tarfile, this will create a directory "mutella-X.X"
  # go into the directory that was just produced
  ./configure  # or 'sh ./configure'
  make         # or 'gmake' on some systems
  make install # if you want to put it in a public directory like
               # /usr/local/bin

Compiled? Installed? Ready ro rock! See "Usage" for the tips. Or just start
your client and get connected to the gnutella network.

USAGE
=====

I have to apologise, but currently MUTELLA lacks proper usage manual, etc,
but this improves slowly... Anyway, here I have some tips, which hopefully
will help one to get started.

Current version of mutella does not have any command line options; to start
the client simply type 'mutella'. It will perform certain initialisation
steps and come up with '>'.
Now you can type in commands. 'help' or '?' without parameters lists all
supported commands. Type 'help <command>' to see some details on the command
usage.

The most useful commands are:

find <list of keywords separated by spaces>
       this adds new query to the search list. additionally you can specify
       minimum size of the file with 'min:XXXX' or exact size with
       'size:XXXX' where XXXX is the size specification. K, M and G suffixes
       are accepted. When issued without parameters performs 'list' command.

list <keywords> [-auto] [-empty]
       displays current query list. When keyword(s) is/are specified lists
       only searches which contain all given keywords. Optional parameter
       '-auto' suppressed automatically generated searches like searches for
       the alternative locations for the files you attempt to download or
       searches for broken downloads and partial files. Use '-empty' to
       suppress output of searches with no hits.

ls <keywords> [-auto]
       synonym for 'list -empty'.

results <keywords> | <number_list>
       displays the results of the query(s). Queries can be selected by the
       numeric IDs given by previous 'list' command or by the set of
       keywords. Accepts numeric ranges like 1-5,7,21- and so on.

get <number_list>
       retrieve the file, or the set of files for the result Ids given.

info
       displays various bits of information concerning current status of the
       client and the net.

stop <numer_list>
       stops a transfer (upload or download) for given ID(s). When stopping
       the download partial file remains on the disc.

open <host> [port]
       opens Gnutella-net connection to the given host. When 'port' is
       ommited 6346 is assumed.

close <number_list>
       closes the Gnutella-net connection by numeric ID(s).

set <Variable> [new_value]
       sets or displays values of the various parameters.

scan
       rescans the shared directory

The behaviour of Mutella to great degree depends on multitude of options,
also refered here as properties, parameters or variables. You can access
these by the `set' command. NEW: `help' command now works with properties
as well, e.g. `help MaxUploads' will produce few lines of text describing
MaxUploads variable. Curently almost all variables are documented to some
degree, but still I will mention few of them here.

important variables:
--------------------
BandwidthTransfer  maximum network bandwidth given to all uploads together
DownloadPath       where to put files
ForceIP            IP to display to the network (if behind firewall)
ForcePort          port to display to the network
MaxConnections     maximum Gnutella-net connections. set according to your
                   bandwidth. In most cases values between 6 and 20 make
                   sense. 15 connections I normally use result in 15-60Kbyte
                   per second of connection-related bandwidth consumption
MinConnections     minimum number of connections to maintain. recommended
                   value is 4.
MaxUploads         maximum number of uploads.
SharePath          path to your shared files. curently only single directory
                   is supported, but you can use symbolic links inside it to
                   share files for example from different partitions.
TerminalLines      number of lines in your terminal window.
TreminalColumns    width of the terminal window in characters.
Paginate           Boolean variable controls whether to stop between terminal
                   pages

When client is started, before '>' is displayed optional start-up script can
be exicuted. Default location of the script is $HOME/.mutella/termrc (used to
be $HOME/.mutella_termrc in the earlier versions). Syntax is similar to the
interactive mode commands described above.

Well, I wish you what? --Good files!
Hope mutella works fine for you.

Max Zaitsev
mailto:maksik@gmx.co.uk