[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Mldonkey-commits] mldonkey/distrib Authors.txt Bugs.txt ChangeLog...
From: |
mldonkey-commits |
Subject: |
[Mldonkey-commits] mldonkey/distrib Authors.txt Bugs.txt ChangeLog... |
Date: |
Mon, 23 Oct 2006 12:58:36 +0000 |
CVSROOT: /sources/mldonkey
Module name: mldonkey
Changes by: spiralvoice <spiralvoice> 06/10/23 12:58:36
Modified files:
distrib : Authors.txt Bugs.txt ChangeLog Developers.txt
Install.txt Todo.txt
distrib/ed2k_mozilla: README
Removed files:
distrib : FAQ.html Readme.txt
distrib/ed2k_mozilla: mldonkey_protocol_handler-1.7.xpi
distrib/ed2k_mozilla/src: contents.rdf install.js install.rdf
distrib/ed2k_mozilla/src/components: ed2kprotocol.js
Log message:
patch #5480
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Authors.txt?cvsroot=mldonkey&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Bugs.txt?cvsroot=mldonkey&r1=1.2&r2=1.3
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ChangeLog?cvsroot=mldonkey&r1=1.1060&r2=1.1061
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Developers.txt?cvsroot=mldonkey&r1=1.7&r2=1.8
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Install.txt?cvsroot=mldonkey&r1=1.10&r2=1.11
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Todo.txt?cvsroot=mldonkey&r1=1.10&r2=1.11
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/FAQ.html?cvsroot=mldonkey&r1=1.6&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/Readme.txt?cvsroot=mldonkey&r1=1.16&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/README?cvsroot=mldonkey&r1=1.7&r2=1.8
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/mldonkey_protocol_handler-1.7.xpi?cvsroot=mldonkey&r1=1.1&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/src/contents.rdf?cvsroot=mldonkey&r1=1.2&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/src/install.js?cvsroot=mldonkey&r1=1.7&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/src/install.rdf?cvsroot=mldonkey&r1=1.3&r2=0
http://cvs.savannah.gnu.org/viewcvs/mldonkey/distrib/ed2k_mozilla/src/components/ed2kprotocol.js?cvsroot=mldonkey&r1=1.3&r2=0
Patches:
Index: Authors.txt
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/Authors.txt,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- Authors.txt 4 Feb 2006 22:26:36 -0000 1.5
+++ Authors.txt 23 Oct 2006 12:58:35 -0000 1.6
@@ -36,12 +36,9 @@
Schlumpf
su_blanc
bogeyman
-
-rlimit code taken from Ocaml-annexlib:
-Shawn Wagner <address@hidden>
-http://raevnos.pennmush.org/code/extlib/
-
-Fasttrack plugin from giFT-fasttrack:
-Markus Kern
+jave
This product includes GeoLite data created by MaxMind, available from
http://maxmind.com/
+
+A complete overview about 3rd party libraries used can be found here:
+http://mldonkey.sourceforge.net/3rdParty
Index: Bugs.txt
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/Bugs.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- Bugs.txt 4 Feb 2004 12:13:36 -0000 1.2
+++ Bugs.txt 23 Oct 2006 12:58:35 -0000 1.3
@@ -1,7 +1,9 @@
-Before feeling a bug report form on
- http://savannah.gnu.org/bugs/?group=mldonkey
+Before sending a bug report form on
+ http://savannah.nongnu.org/bugs/?group=mldonkey
please, check that the bug is not already registered (then, add a comment).
+To send a feature request please use the Task tracker
+ http://savannah.nongnu.org/task/?group=mldonkey
--------------------------------------------------------------------------
If you think your bug is a very important one, and nobody has fixed it in a
long time, it might be that we don't have enough information to reproduce it
Index: ChangeLog
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/ChangeLog,v
retrieving revision 1.1060
retrieving revision 1.1061
diff -u -b -r1.1060 -r1.1061
--- ChangeLog 23 Oct 2006 12:19:17 -0000 1.1060
+++ ChangeLog 23 Oct 2006 12:58:35 -0000 1.1061
@@ -15,6 +15,7 @@
=========
2006/10/23
+5480: Update Mozilla protocol handler, cleanup docs in distrib/
5479: Configure: Force presence of camlp4
5478: Support gdlib-config --static-libs function (new on Debian Etch)
5476: Urladd: Change default period to 0 (load file only when core starts)
Index: Developers.txt
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/Developers.txt,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- Developers.txt 2 May 2005 17:50:33 -0000 1.7
+++ Developers.txt 23 Oct 2006 12:58:35 -0000 1.8
@@ -1,5 +1,5 @@
- Yes, we are looking for developpers. If you have some programming skills,
+ Yes, we are looking for developers. If you have some programming skills,
you are welcome to help the development of mldonkey. There are different ways
to help us. You can see a bug, or a missing feature, and fix it, and then
send us a patch. If you want to spend more time, you can fix a lot of bugs, or
Index: Install.txt
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/Install.txt,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- Install.txt 3 Feb 2006 00:45:15 -0000 1.10
+++ Install.txt 23 Oct 2006 12:58:35 -0000 1.11
@@ -63,17 +63,17 @@
is compiled.
------------------------------------------------------------------------
-1) Installing required tools: Objective-Caml 3.08.3 and LablGTK
+1) Installing required tools: Objective-Caml 3.09.3 and LablGTK
- 1.1) Objective-Caml 3.08.4 (from http://pauillac.inria.fr/caml)
+ 1.1) Objective-Caml 3.09.3 (from http://pauillac.inria.fr/caml)
- ~/tmp> wget http://caml.inria.fr/distrib/ocaml-3.08/ocaml-3.08.4.tar.gz
- ~/tmp> tar zxf ocaml-3.08.4.tar.gz
- ~/tmp> cd ocaml-3.08.4
+ ~/tmp> wget http://caml.inria.fr/distrib/ocaml-3.09/ocaml-3.09.3.tar.gz
+ ~/tmp> tar zxf ocaml-3.09.3.tar.gz
+ ~/tmp> cd ocaml-3.09.3
- ~/tmp/ocaml-3.08.4> ./configure
- ~/tmp/ocaml-3.08.4> make world.opt
- ~/tmp/ocaml-3.08.4> make install
+ ~/tmp/ocaml-3.09.3> ./configure
+ ~/tmp/ocaml-3.09.3> make world.opt
+ ~/tmp/ocaml-3.09.3> make install
1.2.1) LablGTK 1.2.7 for GTK1
(from http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgtk.html)
@@ -86,22 +86,22 @@
~/tmp/lablgtk-1.2.7> make opt
~/tmp/lablgtk-1.2.7> make install
- 1.2.2) LablGTK-2.4.0 for GTK2
+ 1.2.2) LablGTK-2.6.0 for GTK2
(from http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgtk.html)
- ~/tmp> wget
http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/dist/lablgtk-2.4.0.tar.gz
- ~/tmp> tar zxf lablgtk-2.4.0.tar.gz
- ~/tmp> cd lablgtk-2.4.0
- ~/tmp/lablgtk-2.4.0> ./configure
- ~/tmp/lablgtk-2.4.0> make world
- ~/tmp/lablgtk-2.4.0> make install
+ ~/tmp> wget
http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/dist/lablgtk-2.6.0.tar.gz
+ ~/tmp> tar zxf lablgtk-2.6.0.tar.gz
+ ~/tmp> cd lablgtk-2.6.0
+ ~/tmp/lablgtk-2.6.0> ./configure
+ ~/tmp/lablgtk-2.6.0> make world
+ ~/tmp/lablgtk-2.6.0> make install
2) Compiling mldonkey with GUI:
To build GTK1 newgui: ./configure --enable-gui=newgui1
To build GTK1 oldgui: ./configure --enable-gui=oldgui
To build GTK2 GUI: ./configure --enable-gui[=newgui2]
- lablgtk-1.2.7 and lablgtk-2.4.0 can both be installed at the same time.
+ lablgtk-1.2.7 and lablgtk-2.6.0 can both be installed at the same time.
~/tmp/mldonkey> make
Index: Todo.txt
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/Todo.txt,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- Todo.txt 1 Nov 2004 11:22:59 -0000 1.10
+++ Todo.txt 23 Oct 2006 12:58:35 -0000 1.11
@@ -9,15 +9,6 @@
(1) Why is the QRT sent so often ?
(2) Implement PUSH in Gnutella and Fasttrack
-(9) When a file is commited, it should not be shared anymore in temp/.
- Moreover, in temp, it should not be shared under is URN name.
-(10) CANCEL A FILE, AND RESTART THE DOWNLOAD: <<<<<<<<<
-
-
-
-
-
-Before 2.6:
* Re-implement contributors in CommonSwarming
* Re-implement already downloaded files.
@@ -27,7 +18,6 @@
downloaded chunks for itself or the primary network.
* Does the PartialChunk strategy work ?
* Why are chunks verified before completeness ?
- * After a while, shared files are not shared anymore ! why ???
* When a connection succeeds and downloads, we should retry the connection
ASAP.
* How to remove servers from disabled networks ?
@@ -61,30 +51,14 @@
BUGS:
-* "FT not respecting max sources per file settings"
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=3761
-FT plugin AFAIK has no limits regarding the size of the serverlist
-
-* FT plugin is not able to get a list of working peers
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=7776
-
-* "Search results appear in the wrong search"
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=6956
-
Flush buffers after do_at_exit (wait 5 secondes after exit ?).
-Share only on some networks.
-Add information in the GIU protocol on who uploads what.
Send relative times in the GUI protocol
-IP blocking in net/ : http://www.peerguardian.net/pgipdb/guarding.p2p
************************************************************************
Edonkey:
- * Extension to download small files immediatly (files smaller than 10k for
- example)
* Verify that make_xs is always synchronized with sources searches.
* Add command 'export_temp' so that they can be used from emule/edonkey
* EmuleMobile ?
- * BUG: commited files are not shared
* BUG: MLdonkey client generates "Exceeding Block Boundaries" errors which
loses bandwidth
* Implement more Emule packets
@@ -93,8 +67,6 @@
OP_REASKACK (0x91) (size=2)
OP_FILENOTFOUND (0x92)
* Extended search doesnot work after connect because no ping was sent.
- * BUG: Cancel and Redownload doesnot work
- * BUG: Files randomly pause
BitTorrent:
* Implement file availability as in edonkey.
@@ -113,7 +85,6 @@
downloading clients
Gnutella2:
- * Why doesn't TigerTree work on Mac ?
* Allow browsing other clients.
* ADD urn:sha1:<HASH> and urn:tree:tiger/:<HASH> to QRT
* Search using all URI (ed2k, etc...)
@@ -124,6 +95,7 @@
* Send more information in HTTP/1.1 headers (alt-locs, thex)
Soulseek:
+ * Network does currently not work due to missing bindings with common module
* In case of Message from server LOGIN FAILURE INVALIDPASS
prevent any new reconnection without changing the password. Done ?
+ Implement more of the protocol
@@ -138,10 +110,12 @@
+ Display the number of new message per room
Opennap:
+ * Network does currently not work due to missing bindings with common module
* Register files on server
* Implement Upload completely
Direct-Connect:
+ * Network does currently not work due to missing bindings with common module
* Implement Upload completely
* How do you know your IP in Direct-Connect if you are behind a firewall
* Send replies to active searches
@@ -154,110 +128,12 @@
Core:
* LittleEndian: is buf_int correct with negative values
* Change ClientKind so that it does not depend on edonkey anymore.
- * Configurable map to translate characters appearing in the file names.
* BUG: What happens when the writes are buffered, mtime does not correspond
to
the real value ? We should probably call Unix2.flush_all before saving
the config.
- * Download one file from multiple networks:
- 1) A download must be started on a verified network (donkey, bittorrent
- or gnutella)
- 2) Complementary downloads can be started from other networks:
- 2a) Start a download as attached to a main download
- 2b) The attached download does not create a main file, but a set of
- chunks that are potentially downloaded
- 2c) If the download of the attached file is finished, and the file
- can be verified, then the attchaed download can be permuted
- with the main download (the attached download becomes the main
- download, and reciprocally).
- * Associate kinds with networks, and only download useful urls
- * Make difference between Subscribe and Submit searches clear: Submit
- searches all networks and stops when all servers have replied.
- Subscribe is a long term search, it should query the servers
- periodically, and display new results (and probably save them).
- Not implemented yet anyway.
* CD get and Collections
- * Change temporary files names to allow recover on all networks.
- * Socks 5 support
* The core sends more File_info messages than File_downloaded, which is
not normal !
* Send messages to GUI with a classifier (to be able to display messages
in different consoles, server console, download console, clients console)
-***********************************************************************
-GUI:
- * Suppress all classes in newgui: object-oriented programming makes
- modifying the GUI even harder, and is not useful at all. We should
- replace classes by simple records when possible.
- * Give more information on why a connection failed: we should now at
- which stage a connection has failed, when it was, and when was the
- last correct connection.
- * Interactive downloads (popups for one file with progress bar): for
- example, it could be used when starting a download under bittorrent
- (use a network flag to say when it should be used ?) from a
- WEB navigator so that the user see a popup from the GUI immediatly
- and see the progress of the download (as does the python bittorrent).
- * Change the color of tabs when things change
- * Add information about:
- * When a download was started and when a file was last seen _complete_:
- 3d/8d : we have been downloading this file for 8 days, and
- saw it complete three days ago
- --/8d : idem, but we have never seen it complete
-
-
-***********************************************************************
-
- And bug reports
-
-***********************************************************************
-Fasttrack
-=========
-FT not respecting max sources per file settings
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=3761
-
-
-GUI bugs
-========
-"max hits" doesn't work
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=3675
-
-Source-state error in GUI
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=2443
-
-Commited file is not removed from GUI
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=3705
-
-Right click to file option save doesn't show all file names
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=3179
-
-"old" gtk gui column sizes
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=6917
-
-
-HTML_mods bugs
-==============
-Cancel and Pause-"Feature" at same time
-http://savannah.nongnu.org/bugs/?func=detailitem&item_id=3227
-
-
-Requests for GUI enhancements
-=============================
-Change the serach-for field into a combo box
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=3445
-
-Remember current tab on exit
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=3476
-
-Better GUI for identifying what files are in good states
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=4316
-
-ed2k-links of all files available (might be best for html_mods)
-https://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=4378
-
-
-Others
-======
-Wrong filename used when downloading ed2k links? (Patch attached)
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=4080
-
-Handling of foreign characters
-http://savannah.nongnu.org/bugs/index.php?func=detailitem&item_id=4154
Index: ed2k_mozilla/README
===================================================================
RCS file: /sources/mldonkey/mldonkey/distrib/ed2k_mozilla/README,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- ed2k_mozilla/README 14 Dec 2005 20:15:39 -0000 1.7
+++ ed2k_mozilla/README 23 Oct 2006 12:58:35 -0000 1.8
@@ -1,10 +1,10 @@
-Mozilla MLdonkey/eMule Protocol Handler 1.7
-Copyright (C) 2003 - 2005 Simon Peter <address@hidden>
+Firefox MLdonkey/eMule Protocol Handler 1.8
+Copyright (C) 2003 - 2006 Simon Peter <address@hidden>
Description:
------------
-This is a protocol handler for Mozilla and Firefox (see
-www.mozilla.org) that forwards some link types to a running MLdonkey
+This is a protocol handler for Firefox 1.5 and later (see
+www.mozilla.com) that forwards some link types to a running MLdonkey
(see www.mldonkey.net) or eMule (see www.emule-project.net) client.
Supported protocols are ed2k:, magnet: and sig2dat:. For eMule, only
@@ -15,13 +15,13 @@
specific questions to Dan Fritz.
The protocol handler is implemented in JavaScript and should run on
-any platform supported by Mozilla and Firefox.
+any platform supported by Firefox.
Prerequisites:
--------------
The Web interface of your Donkey client must be enabled and access for
-the host this extension should be running on must be enabled in order
-for this extension to work.
+the host, this extension should be running on, must be enabled in
+order for this extension to work.
For eMule, it is advised that you set your web interface template to
default (eMule.tmpl). It may work with other templates but this has
@@ -29,8 +29,8 @@
Installation:
-------------
-Just open the .xpi installer file in Mozilla/Firefox and follow the
-on-screen instructions.
+Just open the .xpi installer file in Firefox and follow the on-screen
+instructions.
If you are on a UNIX derivative system (e.g. Linux, BSD, MacOS X and
the like) and like to install this extension for all users on your
@@ -51,48 +51,34 @@
Configuration:
--------------
-The protocol handler is configurable through Mozilla's preferences
-scheme. The preferences can be set in multiple ways, depending on your
-browser version.
-
-For Mozilla 1.3, newer versions and Firefox, the preferences are
-accessible by visiting the URL "about:config" inside the browser. This
-opens a page containing a table of all available preference
-options. Right clicking on the table opens a menu to create, modify
-and reset the options. Note that the preference defaults of this
-protocol handler are internal and NOT visible initially in the list!
-To set your own preferences, you have to create them.
-
-For Mozilla versions below 1.3, you can set the preferences by
-creating a file 'user.js' in your profile directory (this is
-$HOME/.mozilla/default/<profile>/ on UNIX systems, where <profile> has
-to be replaced by some cryptic string -- just look in that directory)
-and set the options there by adding lines of the form:
-user_pref("option", "value"); to it.
+The protocol handler is GUI configurable through Firefox' extensions
+menu, for Firefox versions 1.5 and later. Go to the extensions menu,
+by clicking on Tools->Extensions from the main bar of pull-down
+menus. There, select the MLdonkey Protocol Handler and click on
+Options. A GUI configuration dialog should pop up, which allows you to
+set all options. The following preference options are available:
-The following preference options are available:
-
-Option: network.mldonkey.server
+Option: Server
Default: localhost
Description: Hostname on which MLdonkey/eMule is running
-Option: network.mldonkey.port
+Option: Port
Default: 4080
-Description: Port of the MLdonkey/eMule WEB service
+Description: Port of the MLdonkey/eMule web service
-Option: network.mldonkey.pass
+Option: Password
Default: (empty)
Description: Password for eMule clients (MLdonkey is handled
-automatically by Mozilla's password manager)
+automatically by Firefox' password manager)
-Option: network.mldonkey.mode
+Option: Mode
Default: mldonkey
Description: Donkey client to send the data to. This can be set to
-'mldonkey' or 'emule' (without the quotes) to talk to an MLdonkey or
-an eMule client, respectively.
+'mldonkey', 'emule' (without the quotes) to talk to an MLdonkey or
+eMule client, respectively.
-All these options are string options. Remember to restart your browser
-before any of them can take effect!
+Remember to restart your browser before any of these options can take
+effect!
Deinstallation:
---------------
@@ -100,16 +86,25 @@
the extensions dialog by clicking on Extensions in the Tools
menu. Select the plugin there and click on Uninstall.
-On Mozilla, you have to manually deinstall the plugin by removing the
-file 'ed2kprotocol.js' from Mozilla's components directory. On a UNIX
-system, this normally is /usr/lib/mozilla/components.
-
News:
-----
+Changes for version 1.8:
+- Support for GUI configuration through Firefox' extensions menu
+ (thanks to David Ciecierski <address@hidden>).
+
+ ATTENTION upgraders: If you manually set configuration options
+ through the about:config dialog for a previous version of this
+ extension, you first have to go to this dialog and reset all user
+ set options back to their defaults in order to be able to use the
+ new GUI configuration dialog!
+
+- Since this version, only Firefox version 1.5 and higher is
+ supported.
+
Changes for version 1.7:
- eMule communication is now faster (thanks to ZZ
- http://forum.emule-project.net/index.php?showuser=9079)
-- Added support for eMule 0.46a
+ http://forum.emule-project.net/index.php?showuser=9079).
+- Added support for eMule 0.46a.
- eMule response is now displayed in the same way as MLdonkey
responses.
@@ -161,13 +156,14 @@
The Initial Developer of the Original Code is
Simon Peter <address@hidden>.
-Portions created by the Initial Developer are Copyright (C) 2003 - 2005
+Portions created by the Initial Developer are Copyright (C) 2003 - 2006
the Initial Developer. All Rights Reserved.
Contributor(s):
Sven Koch
Len Walter <address@hidden>
Dan Fritz <address@hidden>
+David Ciecierski <address@hidden>
Alternatively, the contents of this file may be used under the terms of
either the GNU General Public License Version 2 or later (the "GPL"), or
Index: FAQ.html
===================================================================
RCS file: FAQ.html
diff -N FAQ.html
--- FAQ.html 2 May 2005 17:50:33 -0000 1.6
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,1129 +0,0 @@
-<html>
-<head>
-<META name="robots" content="noindex, nofollow">
-<title>mldonkey FAQ</title>
-</head>
-<body bgcolor="#ffffff">
-
-
-<center>
-
- <H1> <a href=index.html> mldonkey </a>: Frequently Asked Questions </H1>
-
-
- <a href=faq.html> English </a>,
- <a href=faq.html.de> Deutsch </a>,
- <a href=faq.html.fr> Francais </a>
-o <a href=faq.html.es>EspaƱol</a>
-
-</center>
-
-<ol>
-
- <a name=index_back>
- <li> <h3> Background </h3> </a>
- <ol>
- <li> <strong> <a href=#back1> What is mldonkey ? </a> </strong>
- <li> <strong> <a href=#back2> Why use Objective-Caml to program mldonkey
? </a> </strong>
- <li> <strong> <a href=#back3> Where can I find support on mldonkey ?
</a> </strong>
- <li> <strong> <a href=#back4> Where can I download mldonkey ? </a>
</strong>
- <li> <strong> <a href=#back5> Where can I find mldonkey for Windows ?
</a> </strong>
- <li> <strong> <a href=#back6> What's new with MLdonkey 2.00 ? </a>
</strong>
- </ol>
-
- <a name=index_run>
- <li> <h3> Running mldonkey </h3> </a>
-
- <ol>
- <li> <strong> <a href=#run1> How should I start mldonkey ? </a> </strong>
- <li> <strong> <a href=#run2> How can I control mldonkey ? </a> </strong>
- <li> <strong> <a href=#run3> Where/what are mldonkey configuration files
? </a> </strong>
- <li> <strong> <a href=#run4> How can I control the bandwidth used by
mldonkey ? </a> </strong>
- <li> <strong> <a href=#run5> When I modify an option in the config file,
mldonkey overwrites it with its old value ? </a> </strong>
- <li> <strong> <a href=#run6> Where are the files I have downloaded with
mldonkey ? </a> </strong>
- <li> <strong> <a href=#run7> Why does MLdonkey automatically pause some
of my downloads ? </a> </strong>
- <li> <strong> <a href=#run8> How can I reach mldonkey WEB interface
-if my firewall only allows port 80 ? </a> </strong>
- </ol>
-
- <a name=index_gui>
- <li> <h3> Running the GTK GUI </h3> </a>
-
- <ol>
- <li> <strong> <a href=#gui1> When I start the GUI, I get a lot of error
messages, and the GUI terminates with a "Segmentation Fault" ? </a> </strong>
- <li> <strong> <a href=#gui2> I can't connect to mldonkey from a remote
host, neither by telnet, WWW or the GUI ? </a> </strong>
- <li> <strong> <a href=#gui3> The GUI is immediatly disconnected from the
core, or keeps connecting and disconnecting very fast ? </a> </strong>
- </ol>
-
- <a name=index_build>
- <li> <h3> Building mldonkey </h3> </a>
-
- <ol>
- <li> <strong> <a href=#build1> How can I download the latest sources of
mldonkey ? </a> </strong>
- <li> <strong> <a href=#build2> What do I need to compile mldonkey on my
system ? </a> </strong>
- <li> <strong> <a href=#build3> How do I compile mldonkey on my system ?
</a> </strong>
- <li> <strong> <a href=#build4> I just updated from CVS, and I get an
error while compiling ? </a> </strong>
- </ol>
-
- <a name=index_edonkey>
- <li> <h3> The eDonkey plugin </h3> </a>
-
- <ol>
- <li> <strong> <a href=#edonkey0> What is the eDonkey network ? </a>
</strong>
- <li> <strong> <a href=#edonkey1> Why can't mldonkey connect to any
server ? </a> </strong>
- <li> <strong> <a href=#edonkey2> How can I import my old edonkey files
under mldonkey ? </a> </strong>
- <li> <strong> <a href=#edonkey3> Where can I find files on eDonkey
without searching on servers ? </a> </strong>
- <li> <strong> <a href=#edonkey4> Why does mldonkey only connect 5
-servers, whereas <tt> max_connected_servers </tt> is greater ? </a> </strong>
- <li> <strong> <a href=#edonkey5> What's about Overnet ? </a> </strong>
- <li> <strong> <a href=#edonkey6> I'm behind a firewall, what should I do
? </a> </strong>
- <li> <strong> <a href=#edonkey7> How can I share multiple directories ?
</a> </strong>
- </ol>
-
- <a name=index_soulseek>
- <li> <h3> The Soulseek plugin </h3> </a>
-
- <ol>
- <li> <strong> <a href=#slsk0> What is the Soulseek network ? </a>
</strong>
- <li> <strong> <a href=#slsk1> I can't connect to the server ? </a>
</strong>
- </ol>
-
- <a name=index_limewire>
- <li> <h3> The LimeWire plugin </h3>
-
- <ol>
- <li> <strong> <a href=#limewire0> What is the LimeWire network ? </a>
</strong>
- <li> <strong> <a href=#limewire1> When I search for files, I receive
unrelated results ? </a> </strong>
- </ol>
-
- <li> <h3> The other plugins </h3>
- <ol>
- <li> <strong> <a href=#other1> What is the current Development Status of
-mldonkey plugins ? </a> </strong>
- </ol>
-</ol>
-
-
-
-
-
-
-<ol>
-
-<hr>
-<li> <h2> Background </H2>
-
-<ol>
- <li> <h3> <a name=back1> What is mldonkey ? </a> </h3>
-
-Formerly, mldonkey was a Linux client for the eDonkey network, built from
-a reverse-engineered version of the protocol. Now, it is also able to connect
-to multiple networks (gnutella, Direct-Connect, Soulseek, etc).
-
-<p>
-MLdonkey runs on most Unix clones: Linux (x86, alpha, sparc), Mac OS X,
-Solaris x86, Free/OpenBSD, etc.
-
-<p>
-
-It runs as a daemon, in the background, that can run, downloading and sharing
-files, 24 hours a day. You can interact with your mldonkey daemon, either
-locally or remotely, by a telnet interface, a WEB interface or a GTK
-GUI. Other GUIs have also been created for mldonkey.
-
- <li> <h3> <a name=back2> Why use Objective-Caml to program mldonkey ? </a>
</h3>
-
-Most programmers associate functional languages with languages theory,
-lambda-calculus, recursivity, and non-mutable variables, ie the most
-boring lectures at university.
-
-<p>
- Fortunately, Objective-Caml is not only a functional language: it also
-provides many other programming paradigms, such as imperative constructs
-(<tt>while</tt> and <tt>for</tt> loops, mutable variables, records),
-object-oriented constructs, and a powerful C-interface. Moreover, its
-native-code compiler carefully checks your program for typing errors (no
-more segfaults !), and produces a very efficient code (even faster than C
-on many examples).
-
-<p>
-If you don't believe me, check the following links:
-<ul>
-<li>
-<a href="http://www.bagley.org/~doug/shootout/"> A comparison between many
languages </a>
-<li> Two Objective Caml programs win first and second prizes at the
-<a href="http://www.cs.cornell.edu/icfp/"> ICFP'2000 programming contest </a>,
- to write a ray-tracer program.
-<li> An Objective Caml program ranks first at the
-<a href="http://www.cs.virginia.edu/~jks6b/icfp/"> ICFP'1999 programming
contest </a>.
-</ul>
-
-<li> <h3> <a name=back3> Where can I find support on mldonkey ? </a> </h3>
-
-The first place is the
-<a href="http://savannah.nongnu.org/projects/mldonkey/"> MLdonkey Project
Site</a>
- where you will find:
-
-<ul>
- <li> The <a href="mailto:address@hidden">
address@hidden </a> Mailing-list, where you can
-either contact the developpers or ask other users for advises.
- <li> The
-<a href="http://savannah.nongnu.org/bugs/?group=mldonkey"> Bug Report
-system </a>
- to report bugs appearing when running mldonkey.
- <li> The
-<a href="http://savannah.nongnu.org/support/?group=mldonkey">
-Support system </a> where you can ask for support in running mldonkey.
-</ul>
-
-<p> You can also try to read/post in the
-<a href="http://www.mldonkeyworld.com/">
- MLDonkey Forums </a> or on the IRC Channel #mldonkey on irc.freenode.net .
-
- <li> <h3> <a name=back4> Where can I download mldonkey ? </a> </h3>
-
-The latest stable binaries can be downloaded from the
-<a href="http://savannah.nongnu.org/download/mldonkey/">
- Project Download page </a>.
-
-If you want a more recent version of mldonkey, you need to check out the
-sources from the CVS, and compile it yourself.
-See <a href=#index_build> Building Mldonkey </a> for help.
-
-<li> <h3> <a name=back5> Where can I find mldonkey for Windows ? </a> </h3>
-
-MLdonkey does not run very well under Cygwin on Windows. Moreover, there
-is no native port of MLdonkey to Windows, so you will not be able to run
-it on these systems.
-
- <p>
-
- If you have some knowledge of MinGW, you might try to compile
- Objective-Caml and mldonkey. It would probably run better than under
- Cygwin. Note that mldonkey does not use threads, and the select call
- is only used to descriminate between sockets (read/write/connect/accept).
-
-<li> <h3> <a name=back6> What's new with MLdonkey 2.00 ? </a> </h3>
-
- If you were using MLdonkey 1.16, you might be interested in knowing what
is new
- with MLdonkey 2.00. Here are the main improvements:
-
- <ul>
-
- <li> Overnet support.
- <li> Completely New GUI: upload panel, icons, configuration of many
options.
- <li> Post-filtering of results (see Overnet or LimeWire plugins).
- <li> Multi-networks support (sources and CVS only).
- <li> Many bug fixes: memory leak, "too many open file descrs", sharing,
- upload/download rates, ...
- </ul>
-
-</ol>
-
-<hr>
-<li> <h2> Running mldonkey </H2>
-
-<ol>
-
-<li> <H3> <a name=run1> How should I start mldonkey ? </a> </H3>
-
-mldonkey will install its configuration files in the directory where you
-start it. So, first, choose the right directory, where you want it to run.
-Then, copy the "servers.ini" file that is in the distribution in this
-directory. I suppose here that mldonkey is started in its directory.
-
-Start mldonkey with:
-
-<pre>
-./mldonkey
-</pre>
-
-It should display some debug info. DON'T CLOSE THE TERMINAL WHERE IT
-WAS STARTED, otherwise it might get blocked on terminal output.
-
- Once you are sure it works correctly, you can dump the debug info in a file
-(but it can become very big) or better in /dev/null, the next time you
-start it:
-
-<pre>
-./mldonkey &> /dev/null
-</pre>
-
-<li> <h3> <a name=run2> How can I control mldonkey ? </a> </h3>
-
- You have three different ways to control the mldonkey daemon (note that, by
-default, mldonkey is configured to accept only control connections from the
-host running mldonkey (<a href=#gui2> more info </a>)):
-
-<ul>
-
-<li> The telnet interface: the telnet interface allows you to control
-mldonkey locally or remotely from a terminal with simple commands:
-<pre>
-telnet localhost 4000
-</pre>
-where <tt> localhost </tt> is the host running mldonkey and 4000 is the
-default port for the telnet interface.
-
-<p>
-There are many commands available. Use the <tt> help </tt> command to
-display all of them.
-
-<li> The WEB interface: the WEB interface allows you to control mldonkey
-through your favorite navigator. The default url is:
-
-<pre>
-http://localhost:4080/
-</pre>
-
-where <tt> localhost </tt> is the host running mldonkey and 4080 is the
-default port for the WEB interface.
-
-<li> The GTK GUI: you can use a powerful GTK interface to control mldonkey.
-It is called <tt> mldonkey_gui </tt>. Use the File::Setting menu to
-configure how to connect to your mldonkey daemon.
-
-
-</ul>
-
-<li> <h3> <a name=run3> Where/what are mldonkey configuration files ? </a>
</h3>
-
-MLdonkey creates its configuration files in the directory where it is
-started. All of them terminate with a .ini extension. You should not
-modify them while mldonkey is running since it periodically overwrites
-them. Instead you should either stop it, or modify the options using one of
-the interfaces.
-
-<ul>
-
-<li> <tt> downloads.ini </tt> : the basic options (and historically, the
-edonkey plugin options)
-<li> <tt> files.ini </tt> : the list of files being currently downloaded,
-and informations needed to recover the download after a stop.
-<li> <tt> servers.ini </tt> : the list of all known servers for all networks.
-<li> <tt> friends.ini </tt> : the list of your friends (peers you like to
-browse files) on all networks.
-
-<li> Other configuration files are used by mldonkey plugins, normally one
-per network.
-
-<li> <tt> ~/.mldonkey_gui.ini </tt> : the GUI configuration file is the
-only one which is not stored in the mldonkey directory.
-
-</ul>
-
-<li> <h3> <a name=run4> How can I control the bandwidth used by mldonkey ?
</a> </H3>
-
-There are two options in the downloads.ini file: max_hard_upload_rate and
-max_hard_download_rate. Setting these options to 0 means that there are no
-limits. They are expressed in kilobytes/second (not kilobits/second !).
-The upload limit both applies to the files which are downloaded from you,
-and for the messages you send to ask for files: be careful not to limit
-your upload too much !
-
-<p>
-<table border="1" cellpadding="5" align=center>
-
-<tr>
-<td align=center> </td>
-<td align=center colspan=2> Low Bandwidth Usage </td>
-<td align=center colspan=2> High Bandwidth Usage </td>
-</tr>
-
-<tr>
-<td align=center> Your Connection Type </td>
-<td align=center> max_hard_upload_rate </td>
-<td align=center> max_hard_download_rate </td>
-<td align=center> max_hard_upload_rate </td>
-<td align=center> max_hard_download_rate </td>
-</tr>
-
-</tr>
-<td> T1 and more </td>
-<td align=center> 50 </td>
-<td align=center> 0 </td>
-<td align=center> 0 </td>
-<td align=center> 0 </td>
-</tr>
-
-</tr>
-<td> Cable/ADSL 512/128 kbs </td>
-<td align=center> 2 </td>
-<td align=center> 6 </td>
-<td align=center> 6 </td>
-<td align=center> 12 </td>
-</tr>
-
-</tr>
-
-If you have troubles with these values, find the best one corresponding to
-your link and send us the information to fix this table !
-
-</table>
-
-<li> <h3> <a name=run5> When I modify an option in the config file, mldonkey
overwrites it
-with its old value ? </a> </h3>
-
-There are two cases:
-<ul>
- <li> When you edit a config file, mldonkey must not run. Indeed, mldonkey
-saves its configuration periodically, overwritting any changes made in the
-files.
- <li> Be careful with the syntax. If mldonkey can't parse the config file, it
-will generate a new file with the old values for all options that couldn't
-be read correctly. You must remember that you must put filenames and directory
-names between "" (they are not always required if there are no special
-characters inside the name (such as spaces, slashes, etc...), so mldonkey can
-remove them in some cases).
-
-</ul>
-
-<li> <h3> <a name=run6> Where are the files I have downloaded with
-mldonkey ? </a> </h3>
-
-Files being currently downloaded are temporarily stored in the <tt>
-temp/ </tt> directory at the level of mldonkey config files. Files in this
-directory are identified by their MD4 (for edonkey files) or by a random
-identifier.
-
-<p> When the download of a file is finished, the file is added to a list
-of files that have to be "committed". These files are not renamed, so they
-are still kept in the temp directory.
-
- <p> To move finished downloads into the <tt> incoming/ </tt> directory with
-their final name, you need to use the command <tt> commit </tt> in the
-telnet, or the "Save" buttons in the GUI.
-
-<li> <h3> <a name=run7> Why does MLdonkey automatically pause some of my
downloads ? </a> </h3>
-
- When mldonkey receives data for a file from the network, it tries to write
-this data in the file in the temp/ directory. If, for some reason, it cannot
-write the data, it immediatly pauses the file.
-
-<p> This can happen for different reasons:
-
-<ul>
- <li> You have no space left on the disk. You can verify it with the "df"
- command, and free some space for the downloads to continue.
- <li> The user running mldonkey has not write permissions to write in
- your temp/ directory, or on the file temporary file.
-</ul>
-
-<li> <h3> <a name=run8> How can I reach mldonkey WEB interface
-if my firewall only allows port 80 ? </a> </h3>
-
-If you want to access the WEB interface (port 4080) through a firewall,
-and the firewall only allows port 80, and you don't want to run mldonkey
-as root, you can set up the apache WEB server to redirect requests to mldonkey:
-
-<ul>
- <li> Edit your "httpd.conf" : Insert the following lines somewhere in the
-"Section 2: main server configuration":
-
-<pre>
-RewriteEngine on
-ProxyRequests on
-RewriteRule /mldonkey http://localhost:4080/$1 [P,L]
-RewriteRule /(submit.*) http://localhost:4080/$1 [P,L]
-RewriteRule /(files.*) http://localhost:4080/$1 [P,L]
-ProxyPassReverse /(.*) http://localhost:4080/$1
-</pre>
-
-where, of course, <tt> localhost </tt> is your mldonkey host, and <tt>
-4080 </tt> is the <tt> http_port </tt> of mldonkey.
-
-<li> With these rules, <tt> http://aaa.bbb.ccc.ddd/mldonkey </tt>,
-where <tt>aaa.bbb.ccc.ddd</tt> is the IP address of the host running the
-apache server, should connect to your mldonkey.
-
-</ul>
-
-</ol>
-
-<hr>
-<li> <h2> Running the GTK GUI </h2>
-
-<ol>
-
-<li> <H3> <a name=gui1> When I start the GUI, I get a lot of error messages,
-and the GUI terminates with a "Segmentation Fault" ? </a> </H3>
-
-You probably use the "static" binary of mldonkey GUI. Download the
-"shared" binaries from this site, and use that GUI. This bug is caused by
-an incompatibility between the statically linked GTK library and the
-themes installed on your distribution.
-
-<li> <H3> <a name=gui2> I can't connect to mldonkey from a remote host,
-neither by telnet, WWW or the GUI ? </a> </H3>
-
-You need to modify the "allowed_ips" option in the downloads.ini file to
-define which hosts are allowed to control your mldonkey core.
-
-You can either stop mldonkey, and edit the downloads.ini file:
-
-<pre>
-allowed_ips = ["127.0.0.1"; "192.168.255.255"; "65.64.43.63"]
-</pre>
-
-for example allows your localhost (127.0.0.1) to control mldonkey, all the
-hosts from the network 192.168.*.*, and the host 65.64.43.63.
-
-If you don't want to stop mldonkey, just connect locally with the telnet,
-and type:
-
-<pre>
-set allowed_ips "127.0.0.1 192.168.255.255 65.64.43.63"
-</pre>
-
-<li> <h3> <a name=gui3> The GUI is immediatly disconnected from the core, or
keeps connecting and disconnecting very fast ? </a> </h3>
-
-There are two cases to consider:
-
-<ul>
-
-<li> You have set a password in the core to access it through the GUI: you
-must enter the password in the GUI too (use the <tt> Files :: Settings
-</tt> menu for that.
-
- <li> You have two GUIs connected to the same core: the core (1.99 and
-later) only allows one GUI to be connected simultaneously. When you connect,
-it immediatly disconnects the previous GUI. This can only work if the
-previous GUI does not try to reconnect automatically: <tt> mldonkey_gui </tt>
-will not reconnect, but maybe you are using another contributed GUI, which
-tries to automatically reconnect, and make the core disconnect your GUI ?
-Then, tell its author to remove this feature or to put an option to disable
-it.
-
-</ul>
-
-</ol>
-
-<hr>
-<li> <h2> Building mldonkey </h2>
-
-<ol>
- <li> <h3> <a name=build1> How can I download the latest sources
-of mldonkey ? </a> </h3>
-
- Checkout the sources of mldonkey from the
-<a href="http://savannah.nongnu.org/cvs/?group_id=1409"> CVS repository </a>.
-Here is the standard procedure:
-
-<!--
-or download the
-<a href="http://freesoftware.fsf.org/cvs.backups/mldonkey.tar.gz">
-CVS tarball
-</a> (be careful, .
--->
-
-<pre>
-cvs -d:pserver:address@hidden:/cvsroot/mldonkey login
-(password: just hit enter)
-cvs -z3 -d:pserver:address@hidden:/cvsroot/mldonkey co mldonkey
-</pre>
-
-
- <li> <h3> <a name=build2> What do I need to compile mldonkey on my system ?
</a> </h3>
-
- You need ocaml-3.06 (<a href="http://caml.inria.fr/ocaml/distrib.html">
-Ocaml site </a>) installed
- for the code
- and <a
href="http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgtk.html">
-lablgtk </a> compiled in native code with ocaml 3.06 for the GTK gui.
-
-The easiest way is to download binaries for your system. Otherwise, use
-the following lines to install them:
-
-<ul>
- <li> Installing Objective-Caml 3.06 in <tt>/usr/local/bin</tt>
-
-<pre>
- ~/tmp> tar zxf ocaml-3.06.tar.gz
- ~/tmp> cd ocaml-3.06
- ~/tmp/ocaml-3.06> ./configure
- ~/tmp/ocaml-3.06> make world opt opt.opt
- ~/tmp/ocaml-3.06> make install
-</pre>
-
-<li> LablGTK 1.2.3 for example
-
-<pre>
- ~/tmp> tar zxf lablgtk-1.2.3.tar.gz
- ~/tmp> cd lablgtk-1.2.3
- ~/tmp/lablgtk-1.2.3> make configure
- ~/tmp/lablgtk-1.2.3> make
- ~/tmp/lablgtk-1.2.3> make opt
- ~/tmp/lablgtk-1.2.3> make install
-</pre>
-
-Do not forget the "make opt" which is required to get a native-code version
-of the libraries.
-
-</ul>
-
- <li> <h3> <a name=build3> How do I compile mldonkey on my system ? </a> </h3>
-
-
- To compile the core, you just need to use the following commands:
- <pre>
- cd mldonkey
- ./configure [...options...]
- make depend
- make
- </pre>
-
- You should now have a "mldonkey" executable ... No "make install" is
- provided.
-
-<p> If you get strange errors from make, you probably need to use "gmake"
-on your system.
-
- <p>
- You can use the following options for the configure:
-<ul>
-<li> --enable-batch : install Objective-Caml and Lablgtk locally just
-to be able to compile mldonkey.
-<li> --disable-multinet: allows you to only compile support for edonkey
-<li> --disable-opennap: allows you to remove support for Open Napster
-<li> --disable-limewire: allows you to remove support for LimeWire
-<li> --disable-directconnect: allows you to remove support for Direct
Connect
-<li> --disable-soulseek: allows you to remove support for SoulSeek
-<li> --disable-openft: allows you to remove support for OpenFT
-<li> --disable-donkey: allows you to remove support for eDonkey
-</ul>
-
-<li> <h3> <a name=build4> I just updated from CVS, and I get an error while
compiling ? </a> </h3>
-
- After an update from the CVS, you MUST restart the configure script, and
-rebuild the dependencies:
-
- <pre>
- cd mldonkey
- cvs login
- cvs -z3 up -d
- ./configure [...options...]
- make depend
- make
- </pre>
-
- If the error messages are related to camlzip, a workaround is to edit
-manually the file <tt> config/Makefile.config </tt>, and to change the line
-<tt> ZLIB=no </tt> and <tt> SOULSEEK=no </tt> (only soulseek requires
-camlzip).
-
-</ol>
-
-<hr>
-<li> <h2> The eDonkey plugin </h2>
-
-<ol>
-
-<li> <H3> <a name=edonkey0> What is the eDonkey network ? </a> </H3>
-
- The <a href="http://www.edonkey2000.com"> eDonkey network </a> is a network
-specialized in sharing really big files (between 0 to 1.4 GB).
-
-<p>
-This network offers a set of characteristics that cannot be found on other
networks:
-<ul>
- <li> Files can be downloaded from different sources at the same time.
- <li> Files are identified by uniq identifiers (MD4) that can be used to find
- new sources for a file.
- <li> Files are checked using checksums, and chunks (9MB) that are corrupted
- are downloaded again.
- <li> Files chunks can be downloaded in any order.
- <li> Files are shared as soon as a checked chunk has been downloaded, to
- speed up the spreading of files.
-</ul>
-
-<li> <H3> <a name=edonkey1> Why can't mldonkey connect to any server ? </a>
</H3>
-
-<ul>
- <li> First, check that you have some servers known by mldonkey: connect
-to mldonkey by telnet (telnet localhost 4000) and use the "vma" command to
-display all known servers.
- <li> If you have no servers known, you need to add a list of servers for
-mldonkey to connect to them: you can either:
- <ul>
- <li> Manually add them in the telnet :)
- <li> Import a Windows server.met file (downloaded on the WEB):
- use the "servers" command in the telnet, for example:
-
-<pre>
-servers "/mnt/windows/bureau/edonkey server list/server.met"
-</pre>
-
- <li> You can restart mldonkey after copying the "servers.ini" file that
-was in the distribution.
- </ul>
- <li> If you already have a list of known servers, maybe the list is not
-up-to-date, and maybe the servers are full. Try to add some new servers
-like above.
-</ul>
-
-<li> <h3> <a name=edonkey2> How can I import my old edonkey files under
mldonkey ? </a> </h3>
-
-<ul>
- <li> Use the <tt>import</tt> command with the donkey directory containing
your old
-config as parameter. If your old edonkey was running on
-<tt> /home/bidule/edonkey </tt> (mldonkey should find a "pref.met" file in
-this directory), you can send the following command on mldonkey console:
-
-<pre>
-import "/home/bidule/edonkey"
-</pre>
-
- <li> This might not work for a Windows configuration, since the absolute
-path under windows is not the same as under linux (different mount points).
-In this case, retry this command, but before, make sure that:
-
-<ul>
- <li> The files you want to import are in a "temp" directory, inside the
-directory you give to the "import" command.
- <li> Remove the "pref.met" file, so that mldonkey does not try to use the
-temp directory specified in this file.
-</ul>
-
-</ul>
-
- <li> <h3> <a name=edonkey3> Where can I find files on eDonkey without
searching on servers ? </a> </h3>
-
- There are two kinds of WEB sites where you can find <a href=#edonkey4>
-ed2k:// links </a> for files on eDonkey:
-
-<ul>
- <li> Recommandation Engines: on these Web sites, you will find commented
- files, that you are sure to find complete on the eDonkey network.
-
-<ul>
- <li> The most famous is <a href="http://www.sharereactor.com"> Share
-Reactor </a>
-</ul>
-
- <li> Search Engines: these Web sites allow you to search for files
-that are currently available on some servers. However, you have no
-guaranty they are complete:
-
-<ul>
- <li> <a href="http://www.filedonkey.com"> File Donkey </a>
- <li> <a href="http://www.jigle.com"> Jigle </a>
-</ul>
-</ul>
-
- <li> <h3> <a name=edonkey4> Why does mldonkey only connect 5
-servers, whereas <tt> max_connected_servers </tt> is greater ? </a> </h3>
-
-Being connected to several servers can be useful to spread the files you
-are uploading, and to initially find more sources to begin a download.
-
-<p> However, each server on which you are connected is not available for
-another user. For this reason, you should not stay connected to too many
-servers. mldonkey enforces this policy by limiting to 5 the number of
-servers on which you remain connected for a long time, whatever the value
-of <tt> max_connected_servers </tt> is.
-
-<p> Thus, you should simply see <tt> max_connected_servers </tt> as the
-number of servers mldonkey tries to connect concurrently to at the
-startup, not as the number of servers he will remain connected to.
-
-<li> <h3> <a name=edonkey5> What's about Overnet ? </a> </h3>
-
- <a href="http://www.overnet.com"> Overnet </a> is a network using the
same
- download protocol as edonkey, but a different
- <a href="http://citeseer.nj.nec.com/529075.html"> search/localisation
protocol </a>,
- that doesn't need servers.
-
- <p>
-
- MLdonkey 2.00 is able to search for files and sources on Overnet. For
that, you must
- make sure that:
-
- <ol>
-
- <li> The "overnet_search_sources" and "overnet_search_keywords" options
are set to
- true.
-
- <li> You have a (recent) list of Overnet peers that you can connect to.
For that, you
- can:
-
- <ul>
- <li> Use the "servers.ini" file from the most recent distribution
of mldonkey. It
- contains a long list of Overnet peers.
-
- <li> Use the "boot IP PORT" command, to add a new peer.
-
- <li> Use the "ovweb URL" command, to download a .ocl file from
url URL
- containing a list of recent peers.
-
- </ul>
-
- You can use the "ovstats" command, to display how many peers you
have been able
- to connect to (well, they have replied to a connect UDP packet).
-
- <li> If you have enabled "overnet_search_keywords", replies to search
can arrive from
- Overnet peers. These results are not very accurate (they only need
to match only
- one of the keywords, instead of all for example).
-
- <p>
-
- As for all networks, you can activate post-filtering of results
(very useful on
- Gnutella too): set the "filter_search" option to true, and maybe
the "filter_search_delay"
- option (period between results updates in seconds). Then, only
results matching exactly
- your query will be displayed.
-
- </ol>
-
- <li> <h3> <a name=edonkey6> I'm behind a firewall, what should I do ? </a>
</h3>
-
-MLdonkey uses two ports for incoming connections, one on TCP (default is
-4662) and the other one for UDP (4666). Thus, you should open these ports
-in your firewall, and forward them to the computer running mldonkey. More
-generally, you can do that for all ports between 4660 and 4670.
-
-<p> Allowing incoming connections is important as it is the only way for
-you to connect other sources which are behind a firewall.
-
-<p> If you have no control on the firewall, and your administrator blocks
-port 4660 to 4670, you should change the port used by mldonkey in the
configuration
-file <tt> downloads.ini </tt> : <tt> port </tt> is the TCP port, while the
-UDP port is always computed as <tt> port + 4 </tt>.
-
-<li> <h3> <a name=edonkey7> How can I share multiple directories ? </a> </h3>
-
-Just edit the <tt> shared_directories </tt> option in <tt> downloads.ini </tt>:
-
-<pre>
-shared_directories = [ "/usr/share/documents"; "/usr/share/videos"]
-</pre>
-
-</ol>
-
-
-<hr>
-<li> <h2> The Soulseek plugin </h2>
-
-<ol>
-
-<li> <H3> <a name=slsk0> What is the Soulseek network ? </a> </H3>
-
-The <a href="http://www.soulseek.org"> Soulseek Network </a> is a network
-similar to Napster.
-
- <p> You connect on a single server, and there, you can search for (mainly
-audio) files, you can join rooms to chat with other users, and you can browse
-other users files.
-
-<li> <H3> <a name=slsk1> Why can't mldonkey connect to any server ? </a> </H3>
-
-There is only one server on Soulseek, and the one you have in soulseek.ini
-is probably not up-to-date. Normally, mldonkey will download another one, so
-that you will have to servers in your list of servers.
-
-<p>
-By default, mldonkey_gui does not display the servers you are not
-connected to. So you have to use the "Display All Servers" button, and ask
-mldonkey to try to connect to the second soulseek server.
-
-<p>
-Currently, the server is <tt> mail.slsk.org </tt>, port 2242.
-
-<p>
-Mldonkey behavior will be improved to automatically connect to the current
- server from the soulseek site Web page.
-
-</ol>
-
-<hr>
-<li> <h2> The LimeWire plugin </h2>
-
-<ol>
-
- <li> <h3> <a name=limewire0> What is the LimeWire network ? </a> </h3>
-
- The <a href="http://www.limewire.org"> LimeWire network </a> is a
-network built upon the <a href="http://www.gnutella.org"> Gnutella network
</a>.
-
-<p>
-The main difference is that all nodes in this network do not broadcast each
-received message to its neighbours. Instead, special nodes, called
-ultra-peers, with higher connectivity are dedicated for this task, whereas
-other smaller nodes (such as mldonkey) only connect and ask ultra-peers.
-
-<p>
-Currently, the LimeWire support in MLdonkey also allows mldonkey client to
-use <a href="http://www.gnucleus.org"> Gnucleus </a>,
-<a href="http://www.morpheus.com"> Morpheus </a>, and MyNapster
-ultra-peers as servers.
-
-<p>
-On this network, you can mainly search for small files, you have no way to
-chat nor browse other peers.
-
- <li> <h3> <a name=limewire1> When I search for files, I receive unrelated
results ? </a> </h3>
-
-On Gnutella, there is no specified protocol for asking complex queries to
-other peers. Instead, each peer is free to interpret your query as it
-wants and reply what it wants.
-
-<p>
-In particular, multiple-words queries are often understood as logical-or
-queries between words, ie each document that contains at least one word is
returned.
-
-<p>
- As for Overnet, you can activate post-filtering of sources. Then,
results
- which are received are checked by mldonkey against the query and only
displayed if
- they are accurate. Post-Filtering is activated by setting the
"filter_search" option
- to true, and modifying the "filter_search_delay" depending on the
period you
- want between updates (for example, 30 means that results will be added
only every
- 30 seconds).
-
-</ol>
-
-<hr>
-<li> <h2> The other plugins </h2>
-
-<ol>
-<li> <h3> <a name=other1> What is the current Development Status of
-mldonkey plugins ? </a> </h3>
-
- The current Development Status of mldonkey (in the CVS) at 2002/09/09 is
-shown on the following table (also have a look at the
-<a
href="http://savannah.nongnu.org/cgi-bin/viewcvs/*checkout*/mldonkey/mldonkey/distrib/ChangeLog?rev=HEAD&content-type=text/plain">
-ChangeLog
-</a>)
-
-
-<table border="1" cellpadding="5">
-<tr bgcolor="#80FF80">
-<td align=center width="12%"> Features </td>
-<td align=center width="9%"> <a href=http://www.edonkey2000.com/> eDonkey </a>
</td>
-<td align=center width="9%"> <a href=http://www.neo-modus.com/> Direct
-Connect </a> </td>
-<td align=center width="9%"> <a href=http://opennap.sourceforge.net/> Open
-Napster </a> </td>
-<td align=center width="9%"> <a href=http://www.limewire.org> Gnutella
-LimeWire </a> </td>
-<td align=center width="9%"> <a href=http://www.slsk.org> Soulseek </a> </td>
-<td align=center width="9%"> <a href=http://gift.sourceforge.net> OpenFT </a>
</td>
-</tr>
-
-
-<tr>
-<td> Download Server List </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-</tr>
-
-
-<tr>
-<td> Server Connect </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-</tr>
-
-
-<tr>
-<td> View Server Users </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-<tr bgcolor=yellow>
-<td> Search Files </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> (web) </td>
-<td align=center> CVS </td>
-</tr>
-
-<tr>
-<td> Browse Peer </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-<tr bgcolor=yellow>
-<td> Download Files </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-</tr>
-
-<tr>
-<td> Recover Files </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-</tr>
-
-<tr>
-<td> Recover Sources </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-</tr>
-
-<tr>
-<td> Pause Downloads </td>
-<td align=center> 1.16 </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-</tr>
-
-<tr>
-<td> Cancel Downloads </td>
-<td align=center> 1.16 (not CVS) </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-</tr>
-
-
-<tr bgcolor=yellow>
-<td> Upload Files </td>
-<td align=center> 1.16 </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-
-<tr>
-<td> Upload File List </td>
-<td align=center> 1.16 </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-
-<tr>
-<td> Friends </td>
-<td align=center> 1.16 </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-<tr>
-<td> Public Messages </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> CVS </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-
-<tr>
-<td> Private Messages </td>
-<td align=center> 1.16 </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-<tr>
-<td> Import Windows Config </td>
-<td align=center> 1.16 </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-<td align=center> </td>
-</tr>
-
-<tr>
-<td> Config File </td>
-<td align=center> downloads.ini </td>
-<td align=center> directconnect.ini </td>
-<td align=center> opennap.ini </td>
-<td align=center> limewire.ini </td>
-<td align=center> soulseek.ini </td>
-<td align=center> openft.ini </td>
-</tr>
-
-<tr>
-<td> Disable Network </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-<td align=center> CVS </td>
-</tr>
-
-</table>
-
-
-</ol>
-
-</ol>
-
-<p>
-
-If you have any comments, if you want to add some questions, or improve
-this FAQ, send a mail to <a href="mailto:address@hidden">
address@hidden </a>
-
-</body>
-</html>
Index: Readme.txt
===================================================================
RCS file: Readme.txt
diff -N Readme.txt
--- Readme.txt 1 May 2005 17:43:11 -0000 1.16
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,433 +0,0 @@
- *** THIS FILE IS OUTDATED. PLEASE HAVE A LOOK AT THE ***
- *** WIKI PAGE FOR BASIC INFORMATION ABOUT INSTALLING ***
-
-
- MLDonkey
- ========
-
-Release: 1.16
-Authors: [b8]_bavard (Communication engine) and [b8]_Zoggy (GUI)
-
- MLDonkey is a door to the 'donkey' network, a decentralized network used to
-exchange big files on the Internet. It is written in a wonderful language,
-called Objective-Caml, and present most features of the basic Windows donkey
-client, plus some more:
- - It should work on most UNIX-compatible platforms.
- - You can remotely command your client, either by telnet, on a WEB browser,
- or with the GTK interface.
- - You can connect to several servers, and each search will query all the
- connected servers.
- - You can select mp3s by bitrates in queries (useful ?).
- - You can select the name of a downloaded file before moving it to your
- incoming directory.
- - You can have several queries in the graphical user interface at the same
- time.
- - You can remember your old queries results in the command-line interface.
- - You can search in the history of all files you have seen on the network.
-
-
-USAGE:
-======
-
- This package contains three files: 'mldonkey', 'mldonkey_gui' and
-servers.ini'.
-
-'mldonkey' is the main program, a daemon which is used to download files.
-It takes no argument, and outputs some debugging messages on his terminal,
-so you should not close it. So, to start your program in the background,
-you can use:
-
-prompt> ./mldonkey > mldonkey.log &
-
- 'mldonkey' expects to find several .ini files in the directory
-where it is started. You can use the file provided in this package, or your
-old one if you already used 'mldonkey' before. It contains a list of servers
-that were available when the release was done. You can edit 'downloads.ini'
-to modify its parameters before starting 'mldonkey', but you can also
-modify the parameters in the graphical user interface 'mldonkey_gui'.
-
- 'mldonkey_gui', the graphical user interface, can be started by:
-
-prompt> ./mldonkey_gui &
-
- 'mldonkey_gui' doesn't need to be started in the same directory as
-'mldonkey'. Without parameters, it expects to find 'mldonkey' running on the
-same computer on the default port. If you started 'mldonkey' on another
-computer, you should specify the hostname (myhost.mydomain.mydot for example)
-on the command line:
-
-prompt> ./mldonkey_gui myhost.mydomain.mydot
-
- If you also modified the GUI port, you can also specify it (here 9999 for
-example) on the command line:
-
-prompt> ./mldonkey_gui myhost.mydomain.mydot 9999
-
- You can also start the GUI, and modify these settings in the Options panel,
-and then try to reconnect. This is anyway necessary if you have put a
-password.
-
- Instead of using the GUI, you can also telnet to the daemon:
-
-prompt> telnet localhost 4000
-
-(on your local computer) or
-
-prompt> telnet myhost.mydomain.mydot
-
-(if the client was started on that host).
-
-Using the config the standard core :
-===================================
- Connect to mldonkey by telnet:
-
-prompt> telnet localhost 4000
-
- Use the 'import' command with the donkey directory containing your old
-config as parameter.
-
-import '/.../donkey2000'
-
- All the files which were currently downloading will be moved to mldonkey
-temp directory, and the server list will be imported too.
-
- If you only want to import the server.met file, use the 'servers' command:
-
-servers '/.../donkey2000/server.met'
-
- Filenames containing special characters (such as spaces) should be put
-inside ''.
-
-
-Frequently Asked Questions
-==========================
-
-*) How can I contact the authors ?
-----------------------------------
-
-You can reach us for a short time on
-
- address@hidden
- address@hidden
-
-Please don't bother us too much with questions on how to use mldonkey. We
-prefer bug reports, containing USEFUL information to find the bug. You can
-also submit bugs on the savannah WEB site:
-
- http://www.freesoftware.fsf.org/mldonkey/
-
-For advices on how to use mldonkey, you can check several forums:
-
- http://www.mldonkeyworld.com/
- http://www.mldonkey.org/ (German forum)
-
-*) What about the sources ? What about the protocol ?
------------------------------------------------------
-
-All sources are available on the savannah WEB site:
-
- http://www.freesoftware.fsf.org/mldonkey/
-
-*) The GUI/telnet/WEB can't connect to the core.
------------------------------------------------
-
-Since version 1.12, there is an option to control which computers can
-connect to mldonkey: allowed_ips
-
-By default, this option only allows your local computer to connect to the
-core. You can change this either by editing the downloads.ini file, or, in
-the console, using the
-
-set allowed_ips '127.0.0.1 A.B.C.D ...'
-
-command, where A.B.C.D ... are IP addresses separated by spaces.
-
-*) I added a password, and now the connection between the client and
- the GUI is immediatly aborded at startup. What should I do ?
---------------------------------------------------------------
-
- Start the GUI. In the Options panel, type your password, and ENTER.
- Then reconnect to the client (menu or CTRL-R).
-
-*) How can I see the upload information ?
------------------------------------------
-
-In mldonkey, you cannot directly know the current upload state of your
-core. There is a 'upstats' command which can be used to get sorted
-information on the files which have been requested.
-
-Two options are used to control upload:
-- 'max_upload_rate' controls the maximal bandwidth you accept to provide
-on upload. The minimun is 1 (kB/s).
-- 'shared_directories' is the list of directories that you want to share.
-By default, the list is empty, since the temp/ and incoming/ dirs are always
-shared.
-
-You can also disable upload for short periods of time with the 'nu' command.
-Before you must have ran mldonkey at least 5*m minutes if you want to
-disable upload for m minutes. You cannot disable upload for more than
-5 hours per day. Your credit can be displayed with the 'vu' command.
-
-*) How can I modify parameters that don't appear in the GUI nor in the
-command-line client ?
-----------------------
-
-mldonkey uses a file called 'downloads.ini'. You must stop your donkey client
-(use the Kill menu in the GUI or the 'kill' command in the telnet client).
-Then, edit this file and change the values of the options you want.
-
-Some options can also be modified by the 'set' command (in the command-line
-client or in the console of the GUI). These options appear when you use
-the 'vo' command.
-
-*) How can I communicate with the client ?
-------------------------------------------
-
-There are three ways to communicate with the client. In all the cases, you
-can run the client on one computer and control it from another computer.
-In these examples, we suppose they both run on the local computer 'localhost':
-
- 1) Use the GUI, called 'mldonkey_gui':
-
-prompt> ./mldonkey_gui localhost
-
- 2) Use the command-line client:
-
-prompt> telnet localhost 4000
-
- 3) Use a WEB browser:
-
-prompt> lynx http://localhost:4080/
-
-*) How can use the GUI on MacOS X ?
------------------------------------
-
-First, you need to have an X server installed. See for more information:
-
- http://fink.sourceforge.net/doc/x11/index.php
-
-You will find a script in the tar file to start the GUI, that set the
-correct library path for most systems. If it doesn't work, you need to
-modify it according to your non-standard configuration.
-
-*) Previewing doesn't work ?
-----------------------------
-
-mldonkey tries to start a script, specified by the 'previewer' option.
-By default, this option calls 'mldonkey_previewer', which must be in your
-path. Its first arg is the name of the file on the local disk, while its
-second arg is the name of the file on the donkey network.
-
-*) I started mldonkey, and it didn't connect to any server !
------------------------------------------------------------
-
-Depending on your list of servers, the process of finding a server available
-can take a while. You can try to modify some options, such as the server
-connection timeout or the delay between connections attempts. If you know
-a good server, use 'c 34' if 34 is for example the number of the server
-in the list 'vma'. You can also select some servers in the GUI, and use the
-connect button/menu.
-
-*) Which ports should I open on my firewall ?
---------------------------------------------
-
-By default, mldonkey uses ports 4662 for tcp connections, and port 4666 for
-udp connections. If you change the tcp port, udp port will be tcp_port + 4.
-Therefore, you should allow your firewall to send incoming connections and
-messages on these ports to your local network.
-
-
-Help on the command-line interface
-==================================
-
-In a different shell, telnet to your application by:
-
-prompt> telnet localhost 4000
-
-4000 is the default port for connecting with the command-line client.
-Command-line client is disabled if you have set a password.
-
-Then, use ? to find some help on available commands. Some commands are only
-available in the graphical interface (setting options for example), others
-only in the command-line interface (import of old donkey config for example).
-
-Here is the output of the help command for version 1.12:
-n <ip> [<port>]: add a server
-vu : view upload credits
-nu <m> : disable upload during <m> minutes (multiple of 5)
-import <dirname> : import the config from dirname
-x <num> : disconnect from server
-servers <filename> : add the servers from a server.met file
-commit : move downloaded files to incoming directory
-vd <num>: view file info
-reshare : check shared files for removal
-vm : list connected servers
-vma : list all known servers
-q : close telnet
-kill : save and kill the server
-save : save
-d <size> <md4> : download this file
-upstats : statistics on upload
-port <port> : change connection port
-vo : print options
-set <option_name> <option_value> : change option value
-vr [<num>]: view results of a search
-forget <num> : forget search <num>
-ls <query> : local search
-s <query> : search for files
-
- With special args:
- -minsize <size>
- -maxsize <size>
- -media <Video|Audio|...>
- -Video
- -Audio
- -format <format>
- -field <field> <fieldvalue>
- -not <word>
- -and <word>
- -or <word> :
-
-vs : view all queries
-cancel <num> : cancel download
-xs : extended search
-clh : clear local history
-c [<num>]: connect to more servers (or to server <num>)
-
-
-Help on the graphical user interface
-====================================
-1. Servers page:
-
-The server page presents the list of known servers. For each server, the list
-provides information on its IP address, port, connexion status, name,
-description, number of users and number of files.
-
-The list is automatically updated when new servers are discovered. MLDonkey
-tries to automatically connect to servers until enough (see the
-'Max connected servers' option) of them have replied.
-
-To add a server: enter its IP and Port, and press the 'Add server' button.
-To remove a server: select the server, and click the 'Remove' button.
-To connect a server: select the server, and click the 'Connect' button.
-To view server users: select the server, and click the 'View Users' button.
- If the list of users is already available, it is automatically displayed in
- the list on the right when the server is selected.
-To add some user to your friend list: select the users, and click the
- 'Add to friends' button. Direct users (those with a valid IP address)
- are immediatly added, while others are only added when they are
- connected.
-The 'Connect more servers' button: if not enough servers are connected,
- you can click this button to speed connections to servers.
-The 'Remove old servers' button: this button allows to clean the list of
- servers which have not been connected for a while (see the
- 'Max server age' option).
-
-2. Downloads page:
-
-When you select a file, its full name is displayed under the list of
-files. A bar indicates which chunks of the file are available:
-red means the chunks is not available and blue is for chunks which are
-available on only one client. Black is for chunks that are available on
-several clients, whereas green means you already have the chunk.
-Chunks are 9mb of consecutive bytes in the file.
-
-You can put ed2k:// URLs (those found on www.sharereactor.com) in the
-upper entry (after the ed2k: label). Press ENTER then.
-
-If you started a download and lost the config files for some reason, you can
-recover it in the upper right entry (Recover MD4) if it is still present under
-this MD4 in your temp/ directory.
-
-When selecting a file in the 'Downloading' list, the GUI will display the list
-of its locations on the right side. You can select some of these locations,
-and click the 'Add to friends' button to add them to your friends.
-
-When a download is finished, files are displayed in the 'Downloaded' list.
-You can use the 'Save all files' button to move these files to your
-incoming/ directory. This is not done automatically. You can also click on the
-right button of the mouse to have a contextual menu where you can select the
-name of the file. You can edit the tags of mp3 too in this menu.
-
-3. Friends page:
-
-Friends are displayed on the left, with the list of their files on the
-right. You can remove a friend by selecting it and clicking the 'Remove'
-button. You can also search all connected servers for a friend by
-putting its name in the 'Find Friend' entry and pressing ENTER.
-
-You can select files in the list on the right, then click
-'Download Selected Files' to add them to your download list.
-
-4. Queries page:
-
-'Max Hits' is not working yet.
-
-Use the 'Stop' button to stop receiving results for a query.
-
-5. Options page:
-
-This page can be used to update the simple options of the configuration
-file 'downloads.ini', which can be found in the directory where
-'donkey_downloads' was started.
-
-Interesting options are:
-
-'Name': your name on the donkey network.
-
-'Max Connected Servers': the maximum number of servers you can remain
-connected to. This is an old option, that was useful before UDP packets.
-1 is now enough, since all servers will eventually be searched by UDP.
-
-'Upload limit': default is 30 kB/s (good for ADSL/Cable). You can't set it
- under 1kB/s. If you have a large bandwith, set it to 500 kB/s or +
-
-'Client hostname': the name of the host were your client is running if not
- the same host as the graphical interface.
-
-'Password': the password used to control your client.
-
-The different ports that can be modified in the Option panel can be used to
-allow several clients to run on the same computer. Moreover, several user
-interfaces can connect to the same client at the same time (command-line
-interfaces and graphical interfaces).
-
-6. Console
-
-In the console, you have access to the command-line commands.
-
-Using auxiliary programs for local indexation (in development)
-=============================================
-
-mldonkey now uses auxiliary programs to help find results to search.
-Currently, two types of programs are supported:
-
-- Finder (set by the 'local_index_find_cmd' option)
- The finder receives a query on its standard input, and replies by
- the results on its standard output.
-
-Query format: the query finishes with 'end_query' on one line. On each line
-of the query, there is one keyword, a colon :, and a value. Keywords are:
- words, minsize, maxsize, minrate, media, format, title, album, artist
-
-Result format: the result finishes with 'end result' on one line. On each line
-of the result, there is one keyword, a colon :, and a value.
-Keywords are:
- Required: md4, size
- Optional: name, format, type, string_tag, int_tag
-
-There can be several name, string_tag, int_tag lines. The value on the
-string_tag line should be the name of the tag, a colon : and the value of
-the tag. Idem for int_tag, but the value should be an integer.
-
-- Indexer (set by the 'local_index_add_cmd' option)
-The indexer is called each time a new result is received by mldonkey,
-and the result is given on its standard input in the same format as specified
-above. It can be used to add the result to the index that is used by the
-Finder.
-
-Known bugs:
-===========
- * When clicking on the columns it sorts on that column, when
- clicking again it should do a reverse sort on it, but it doesn't.
-
Index: ed2k_mozilla/mldonkey_protocol_handler-1.7.xpi
===================================================================
RCS file: ed2k_mozilla/mldonkey_protocol_handler-1.7.xpi
diff -N ed2k_mozilla/mldonkey_protocol_handler-1.7.xpi
Binary files /tmp/cvsocGsFB and /dev/null differ
Index: ed2k_mozilla/src/contents.rdf
===================================================================
RCS file: ed2k_mozilla/src/contents.rdf
diff -N ed2k_mozilla/src/contents.rdf
--- ed2k_mozilla/src/contents.rdf 8 Jun 2003 12:48:08 -0000 1.2
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,13 +0,0 @@
-<?xml version="1.0"?>
-<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
- xmlns:chrome="http://www.mozilla.org/rdf/chrome#">
-
-<!-- list all the packages being supplied -->
- <RDF:Seq about="urn:mozilla:package:root">
- <RDF:li resource="urn:mozilla:package:hdl"/>
- </RDF:Seq> <!-- package information -->
- <RDF:Description about="urn:mozilla:package:ed2k"
- chrome:displayName="Mozilla MLdonkey Protocol Handler"
- chrome:author="Simon Peter <address@hidden>"
- chrome:name="ed2k">
- </RDF:Description> </RDF:RDF>
Index: ed2k_mozilla/src/install.js
===================================================================
RCS file: ed2k_mozilla/src/install.js
diff -N ed2k_mozilla/src/install.js
--- ed2k_mozilla/src/install.js 14 Dec 2005 20:15:39 -0000 1.7
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,56 +0,0 @@
-/* -*- Mode: Java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*/
-/* ***** BEGIN LICENSE BLOCK *****
- * Version: MPL 1.1/GPL 2.0/LGPL 2.1
- *
- * The contents of this file are subject to the Mozilla Public License Version
- * 1.1 (the "License"); you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- * http://www.mozilla.org/MPL/
- *
- * Software distributed under the License is distributed on an "AS IS" basis,
- * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
- * for the specific language governing rights and limitations under the
- * License.
- *
- * The Original Code is the MLdonkey protocol handler installer.
- *
- * The Initial Developer of the Original Code is
- * Simon Peter <address@hidden>.
- * Portions created by the Initial Developer are Copyright (C) 2003 - 2005
- * the Initial Developer. All Rights Reserved.
- *
- * Contributor(s):
- * Len Walter <address@hidden>
- *
- * Alternatively, the contents of this file may be used under the terms of
- * either the GNU General Public License Version 2 or later (the "GPL"), or
- * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
- * in which case the provisions of the GPL or the LGPL are applicable instead
- * of those above. If you wish to allow use of your version of this file only
- * under the terms of either the GPL or the LGPL, and not to allow others to
- * use your version of this file under the terms of the MPL, indicate your
- * decision by deleting the provisions above and replace them with the notice
- * and other provisions required by the GPL or the LGPL. If you do not delete
- * the provisions above, a recipient may use your version of this file under
- * the terms of any one of the MPL, the GPL or the LGPL.
- *
- * ***** END LICENSE BLOCK ***** */
-
-const G_MSG = "Mozilla MLdonkey Protocol Handler 1.6";
-const G_NAME = "ed2k";
-const G_VER = "1.7";
-
-var err = initInstall(G_MSG, G_NAME, G_VER);
-logComment("initInstall: " + err);
-
-addFile("protocol handler", "components/ed2kprotocol.js",
getFolder("Components"), "");
-
-// needed for older versions to see the new component
-var f = getFolder("Program", "component.reg");
-if (File.exists(f)) File.remove(f);
-
-err = getLastError();
-if (err==SUCCESS)
- performInstall();
-else
- cancelInstall(err);
Index: ed2k_mozilla/src/install.rdf
===================================================================
RCS file: ed2k_mozilla/src/install.rdf
diff -N ed2k_mozilla/src/install.rdf
--- ed2k_mozilla/src/install.rdf 14 Dec 2005 20:15:40 -0000 1.3
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,29 +0,0 @@
-<?xml version="1.0"?>
-
-<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
- xmlns:em="http://www.mozilla.org/2004/em-rdf#">
-
- <Description about="urn:mozilla:install-manifest">
- <em:id>{bc72206d-b3ce-4b49-88b9-d59b388a0cde}</em:id>
- <em:version>1.7</em:version>
-
- <!-- Target Application this extension can install into,
- with minimum and maximum supported versions. -->
- <em:targetApplication>
- <Description>
- <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
- <em:minVersion>0.7</em:minVersion>
- <em:maxVersion>1.9</em:maxVersion>
- </Description>
- </em:targetApplication>
-
- <!-- Front End MetaData -->
- <em:name>Mozilla MLdonkey Protocol Handler</em:name>
- <em:description>Mozilla/Firefox MLdonkey Protocol Handler</em:description>
- <em:creator>Simon Peter</em:creator>
- <em:contributor>Len Walter</em:contributor>
- <em:contributor>Sven Koch</em:contributor>
- <em:contributor>Dan Fritz</em:contributor>
-
<em:homepageURL>http://www.informatik.uni-oldenburg.de/~dyna/mldonkey/</em:homepageURL>
- </Description>
-</RDF>
Index: ed2k_mozilla/src/components/ed2kprotocol.js
===================================================================
RCS file: ed2k_mozilla/src/components/ed2kprotocol.js
diff -N ed2k_mozilla/src/components/ed2kprotocol.js
--- ed2k_mozilla/src/components/ed2kprotocol.js 14 Dec 2005 20:15:40 -0000
1.3
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,251 +0,0 @@
-/* -*- Mode: Java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*/
-/* ***** BEGIN LICENSE BLOCK *****
- * Version: MPL 1.1/GPL 2.0/LGPL 2.1
- *
- * The contents of this file are subject to the Mozilla Public License Version
- * 1.1 (the "License"); you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- * http://www.mozilla.org/MPL/
- *
- * Software distributed under the License is distributed on an "AS IS" basis,
- * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
- * for the specific language governing rights and limitations under the
- * License.
- *
- * The Original Code is the MLdonkey protocol handler 1.7.
- *
- * The Initial Developer of the Original Code is
- * Simon Peter <address@hidden>.
- * Portions created by the Initial Developer are Copyright (C) 2003 - 2005
- * the Initial Developer. All Rights Reserved.
- *
- * Contributor(s):
- * Sven Koch
- * Len Walter <address@hidden>
- * Dan Fritz (eMule bindings)
- *
- * Alternatively, the contents of this file may be used under the terms of
- * either the GNU General Public License Version 2 or later (the "GPL"), or
- * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
- * in which case the provisions of the GPL or the LGPL are applicable instead
- * of those above. If you wish to allow use of your version of this file only
- * under the terms of either the GPL or the LGPL, and not to allow others to
- * use your version of this file under the terms of the MPL, indicate your
- * decision by deleting the provisions above and replace them with the notice
- * and other provisions required by the GPL or the LGPL. If you do not delete
- * the provisions above, a recipient may use your version of this file under
- * the terms of any one of the MPL, the GPL or the LGPL.
- *
- * ***** END LICENSE BLOCK ***** */
-
-/***** Defines *****/
-
-// components defined in this file
-const ED2KPROT_HANDLER_CONTRACTID =
- "@mozilla.org/network/protocol;1?name=ed2k";
-const ED2KPROT_HANDLER_CID =
- Components.ID("{af8d664a-d002-438f-84a3-01f3a8ff325b}");
-
-const MAGNETPROT_HANDLER_CONTRACTID =
- "@mozilla.org/network/protocol;1?name=magnet";
-const MAGNETPROT_HANDLER_CID =
- Components.ID("{3e022170-58b0-4548-ba4c-1f47d54c7767}");
-
-const SIG2DATPROT_HANDLER_CONTRACTID =
- "@mozilla.org/network/protocol;1?name=sig2dat";
-const SIG2DATPROT_HANDLER_CID =
- Components.ID("{2a2e71ea-e857-4c71-9c93-04ff681df88a}");
-
-// components used in this file
-const NS_IOSERVICE_CID = "{9ac9e770-18bc-11d3-9337-00104ba0fd40}";
-const NS_PREFSERVICE_CONTRACTID = "@mozilla.org/preferences-service;1";
-const URI_CONTRACTID = "@mozilla.org/network/simple-uri;1";
-const NS_WINDOWWATCHER_CONTRACTID = "@mozilla.org/embedcomp/window-watcher;1";
-const INPUTSTREAMCHANNEL_CONTRACTID =
"@mozilla.org/network/input-stream-channel;1";
-
-// interfaces used in this file
-const nsIProtocolHandler = Components.interfaces.nsIProtocolHandler;
-const nsIURI = Components.interfaces.nsIURI;
-const nsISupports = Components.interfaces.nsISupports;
-const nsIIOService = Components.interfaces.nsIIOService;
-const nsIPrefService = Components.interfaces.nsIPrefService;
-const nsIWindowWatcher = Components.interfaces.nsIWindowWatcher;
-const nsIChannel = Components.interfaces.nsIChannel;
-
-// some misc. constants
-const PREF_BRANCH = "network.mldonkey.";
-const WND_WIDTH = 320;
-const WND_HEIGHT = 200;
-
-const WND_EMULE_WIDTH = 450;
-const WND_EMULE_HEIGHT = 75;
-
-// configuration (and defaults)
-cfgServer = "localhost";
-cfgPort = "4080";
-myWnd = null;
-cfgMode = "mldonkey"
-cfgPass = ""
-
-/***** MLdonkeyProtocolHandler *****/
-
-function MLdonkeyProtocolHandler(scheme)
-{
- this.scheme = scheme;
- this.readPreferences(PREF_BRANCH);
-}
-
-// attribute defaults
-MLdonkeyProtocolHandler.prototype.defaultPort = -1;
-MLdonkeyProtocolHandler.prototype.protocolFlags =
nsIProtocolHandler.URI_NORELATIVE;
-
-MLdonkeyProtocolHandler.prototype.allowPort = function(aPort, aScheme)
-{
- return false;
-}
-
-MLdonkeyProtocolHandler.prototype.newURI = function(aSpec, aCharset, aBaseURI)
-{
- var uri = Components.classes[URI_CONTRACTID].createInstance(nsIURI);
- uri.spec = aSpec;
- return uri;
-}
-
-MLdonkeyProtocolHandler.prototype.newChannel = function(aURI)
-{
- var myUri = "";
- var myTitle = "";
- var myWidth = WND_WIDTH;
- var myHeight = WND_HEIGHT
-
- if (cfgMode == "mldonkey") {
- myTitle = "MLDonkey";
-
- // rewrite the URI into a http URL to the mldonkey client
- myURI = "http://";
- // if(cfgUser != "") myURI += cfgUser + ":" + cfgPass + "@";
- myURI += cfgServer + ":" + cfgPort + "/submit?q=dllink+" +
- encodeURIComponent(decodeURI(aURI.spec));
- } else {
- // eMule mode
- myTitle = "eMule";
- myWidth = WND_EMULE_WIDTH;
- myHeight = WND_EMULE_HEIGHT
-
- // rewrite the URI into a http URL to the eMule client
- myURI = "http://";
- myURI += cfgServer + ":" + cfgPort + "/?w=password&p=" + cfgPass;
- myURI += "&cat=0&c=" + encodeURIComponent(decodeURI(aURI.spec));
- }
-
- // open up a window with our newly generated http URL
- var wwatch =
Components.classes[NS_WINDOWWATCHER_CONTRACTID].getService(nsIWindowWatcher);
- if(myWnd == null || myWnd.closed == true)
- myWnd = wwatch.openWindow(wwatch.activeWindow, myURI, myTitle,
- "width=" + myWidth + ", height=" + myHeight, null);
- else
- myWnd.location.href = myURI;
-
- // return a fake empty channel so current window doesn't change
- var chan =
Components.classes[INPUTSTREAMCHANNEL_CONTRACTID].createInstance(nsIChannel);
- return chan;
-}
-
-MLdonkeyProtocolHandler.prototype.readPreferences = function(pref_branch)
-{
- // get preferences branch
- var PrefService =
Components.classes[NS_PREFSERVICE_CONTRACTID].getService(nsIPrefService);
- var myPrefs = PrefService.getBranch(null); // Mozilla bug #107617
-
- // read preferences (if available)
- if(myPrefs.getPrefType(pref_branch + "server") == myPrefs.PREF_STRING)
- cfgServer = myPrefs.getCharPref(pref_branch + "server");
- if(myPrefs.getPrefType(pref_branch + "port") == myPrefs.PREF_STRING)
- cfgPort = myPrefs.getCharPref(pref_branch + "port");
- if(myPrefs.getPrefType(pref_branch + "mode") == myPrefs.PREF_STRING)
- cfgMode = myPrefs.getCharPref(pref_branch + "mode");
- if(myPrefs.getPrefType(pref_branch + "pass") == myPrefs.PREF_STRING)
- cfgPass = myPrefs.getCharPref(pref_branch + "pass");
-}
-
-/***** MLdonkeyProtocolHandlerFactory *****/
-
-function MLdonkeyProtocolHandlerFactory(scheme)
-{
- this.scheme = scheme;
-}
-
-MLdonkeyProtocolHandlerFactory.prototype.createInstance = function(outer, iid)
-{
- if(outer != null) throw Components.results.NS_ERROR_NO_AGGREGATION;
-
- if(!iid.equals(nsIProtocolHandler) && !iid.equals(nsISupports))
- throw Components.results.NS_ERROR_INVALID_ARG;
-
- return new MLdonkeyProtocolHandler(this.scheme);
-}
-
-var factory_ed2k = new MLdonkeyProtocolHandlerFactory("ed2k");
-var factory_magnet = new MLdonkeyProtocolHandlerFactory("magnet");
-var factory_sig2dat = new MLdonkeyProtocolHandlerFactory("sig2dat");
-
-/***** Ed2kzillaModule *****/
-
-var Ed2kzillaModule = new Object();
-
-Ed2kzillaModule.registerSelf = function(compMgr, fileSpec, location, type)
-{
- compMgr =
compMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
-
- // register ed2k protocol handler
- compMgr.registerFactoryLocation(ED2KPROT_HANDLER_CID,
- "ED2K protocol handler",
- ED2KPROT_HANDLER_CONTRACTID,
- fileSpec, location, type);
-
- // register magnet protocol handler
- compMgr.registerFactoryLocation(MAGNETPROT_HANDLER_CID,
- "Magnet protocol handler",
- MAGNETPROT_HANDLER_CONTRACTID,
- fileSpec, location, type);
-
- // register sig2dat protocol handler
- compMgr.registerFactoryLocation(SIG2DATPROT_HANDLER_CID,
- "Sig2dat protocol handler",
- SIG2DATPROT_HANDLER_CONTRACTID,
- fileSpec, location, type);
-}
-
-Ed2kzillaModule.unregisterSelf = function(compMgr, fileSpec, location)
-{
- compMgr =
compMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
-
- // unregister our components
- compMgr.unregisterFactoryLocation(ED2KPROT_HANDLER_CID, fileSpec);
- compMgr.unregisterFactoryLocation(MAGNETPROT_HANDLER_CID, fileSpec);
- compMgr.unregisterFactoryLocation(SIG2DATPROT_HANDLER_CID, fileSpec);
-}
-
-Ed2kzillaModule.getClassObject = function(compMgr, cid, iid)
-{
- if(!iid.equals(Components.interfaces.nsIFactory))
- throw Components.results.NS_ERROR_NOT_IMPLEMENTED;
-
- if(cid.equals(ED2KPROT_HANDLER_CID)) return factory_ed2k;
- if(cid.equals(MAGNETPROT_HANDLER_CID)) return factory_magnet;
- if(cid.equals(SIG2DATPROT_HANDLER_CID)) return factory_sig2dat;
-
- throw Components.results.NS_ERROR_NO_INTERFACE;
-}
-
-Ed2kzillaModule.canUnload = function(compMgr)
-{
- return true; // our objects can be unloaded
-}
-
-/***** Entrypoint *****/
-
-function NSGetModule(compMgr, fileSpec)
-{
- return Ed2kzillaModule;
-}
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Mldonkey-commits] mldonkey/distrib Authors.txt Bugs.txt ChangeLog...,
mldonkey-commits <=