[Pkg-ocaml-maint-commits] r1707 -
trunk/packages/mldonkey/trunk/debian
Jeroen van Wolffelaar
jeroen at costa.debian.org
Mon Aug 29 23:31:03 UTC 2005
Author: jeroen
Date: 2005-08-29 23:31:02 +0000 (Mon, 29 Aug 2005)
New Revision: 1707
Modified:
trunk/packages/mldonkey/trunk/debian/NEWS.Debian
trunk/packages/mldonkey/trunk/debian/README.Debian
Log:
Re-flow text of NEWS and README.Debian to fit in 80-character wide terminal,
and some minor typographic fixes.
Modified: trunk/packages/mldonkey/trunk/debian/NEWS.Debian
===================================================================
--- trunk/packages/mldonkey/trunk/debian/NEWS.Debian 2005-08-29 23:25:24 UTC (rev 1706)
+++ trunk/packages/mldonkey/trunk/debian/NEWS.Debian 2005-08-29 23:31:02 UTC (rev 1707)
@@ -1,10 +1,12 @@
mldonkey (2.5.28.1-1) unstable; urgency=low
- Starting from mldonkey 2.5.28-1, the file /etc/default/mldonkey-server has been managed through
- ucf. But ucf was not well used. This version of the package should correct this problem by
- removing the file /etc/default/mldonkey-server and recreating it, using ucf. This should be
- automatic during the upgrade. You will find a backup of the former configuration file at
- /etc/default/mldonkey-server.dpkg-bak, if something goes wrong.
+ Starting from mldonkey 2.5.28-1, the file /etc/default/mldonkey-server has
+ been managed through ucf. But ucf was not well used. This version of the
+ package should correct this problem by removing the file
+ /etc/default/mldonkey-server and recreating it, using ucf. This should be
+ automatic during the upgrade. You will find a backup of the former
+ configuration file at /etc/default/mldonkey-server.dpkg-bak, if something
+ goes wrong.
-- Sylvain Le Gall <sylvain.le-gall at polytechnique.org> Tue, 28 Jun 2005 00:22:20 +0200
Modified: trunk/packages/mldonkey/trunk/debian/README.Debian
===================================================================
--- trunk/packages/mldonkey/trunk/debian/README.Debian 2005-08-29 23:25:24 UTC (rev 1706)
+++ trunk/packages/mldonkey/trunk/debian/README.Debian 2005-08-29 23:31:02 UTC (rev 1707)
@@ -1,9 +1,9 @@
----------------------------------
-*Packages : mldonkey-[server|gui]*
+*Packages: mldonkey-[server|gui]*
----------------------------------
I have implemented some commands to ease the installation
-and the maintenance process :
+and the maintenance process:
- mldonkey_command: to send command to mlnet,
- mldonkey_server: to keep mlnet instance alive,
@@ -26,22 +26,22 @@
Actually, there is an option to enable chroot for mldonkey.
-I decide not to use it for many reasons :
+I decide not to use it for many reasons:
- running the daemon under a different ID is safer than chrooting
- chrooting doesn't cooperate well with chuid...
-Browsing the code of mldonkey, lead me to one conclusion : the creation of
+Browsing the code of mldonkey, lead me to one conclusion: the creation of
*.ini file is erratic. If you try to make chuid && chroot, you will need to
start the daemon as root, it will create some file owned by root, then you
chroot, then you try to chuid. So it needs to have a etc/passwd in the chroot,
we need to check file permission after start...
So it is a lot of bug to correct. There is bugreport about this situation for
-mldonkey :
+mldonkey:
http://savannah.nongnu.org/bugs/?func=detailbug&group_id=1409&bug_id=3969
For now, i prefer to use mldonkey-server to start mlnet. Mldonkey server
-has a lot of very good reason to be use :
+has a lot of very good reason to be use:
- the code is very simple and short
- it handle only start/stop and chuid of another process
- it doesn't open/read/write anything before chuid
@@ -54,9 +54,9 @@
-- Sylvain LE GALL <sylvain.le-gall at polytechnique.org> Sun, 17 Aug 2003 22:40:00 +0200
-Mick Kappenburg has created a script to create chroot for mldonkey. For now this
-script need more extensive testing, but i think it could be use to run more safely
-mldonkey.
+Mick Kappenburg has created a script to create chroot for mldonkey. For now
+this script need more extensive testing, but i think it could be use to run
+more safely mldonkey.
If this scripts works well enough, he will probably be integrated in the daemon
start-stop script of mldonkey-server.
@@ -73,11 +73,11 @@
1.1 Changing Password
-MLDonkey natively support only two ways to set the password : through the GUI,
+MLDonkey natively support only two ways to set the password: through the GUI,
through the telnet interface.
-To change the password through the telnet interface :
-- you log into the telnet interface with the former user/password :
+To change the password through the telnet interface:
+- you log into the telnet interface with the former user/password
- you change the password with the auth command.
telnet>auth user old-passwd
@@ -90,42 +90,43 @@
1.2 Default parameter
-At the beginning only one user exist in the system : admin. The default
+At the beginning only one user exist in the system: admin. The default
password for this user is an empty string. In order to connect through the
-telnet interface, you nee to type :
+telnet interface, you nee to type:
telnet>auth admin ""
-To login through the GUI :
+To login through the GUI:
- Files->Settings->Password (empty)
- Files->Settings->Password admin
-To login through the HTTP :
-- User : admin
-- Password : (empty)
+To login through HTTP:
+- User: admin
+- Password: (empty)
1.3 Adding user
-There is only one way to add new user : through the telnet interface.
-You need to invoke the command add_user. See help in the telnet interface
-about this command.
+There is only one way to add new user: through the telnet interface. You
+need to invoke the command add_user. See help in the telnet interface about
+this command.
2. Debian way
As part of utilities available in the debian package, the program mldonkey_users
enable to manipulate the user management system through the command line.
-You should use it with care : the system manipulate download.ini which is regularly
-updated by the mldonkey server, if this one is running.
+You should use it with care: the system manipulate download.ini which is
+regularly updated by the mldonkey server, if this one is running.
-If you want to manipulate user/password, you need to stop your server, or to go back to
-native ways of managing user/password.
+If you want to manipulate user/password, you need to stop your server, or to
+go back to native ways of managing user/password.
Refer to mldonkey_users manpage.
-Important note : the default value of the debconf screen for password is an empty string.
-If you leave an empty string for password, no password will be registered. It is a way of
-keeping old password, which could have been changed by other way than debconf.
+Important note: the default value of the debconf screen for password is an
+empty string. If you leave an empty string for password, no password will be
+registered. It is a way of keeping old password, which could have been changed
+by other way than debconf.
-- Sylvain LE GALL <sylvain.le-gall at polytechnique.org> Sun, 02 Sep 2003 00:22:00 +0200
@@ -137,13 +138,15 @@
See FASSTRACK.
-In order to fix the problem coming with the FASTTRACK problem, i build the program called
-mldonkey_files.
+In order to fix the problem coming with the FASTTRACK problem, i build the
+program called mldonkey_files.
-This program permits you to filter the files.ini to extract Fasttrack sources. But you can
-also use with any other plugin :
-- for fasttrack mldonkey_files --split Fasttrack -f0 files.ini -f1 files.ini.fasttrack -f2 files.ini
-- for edonkey mldonkey_files --split Donkey -f0 files.ini -f1 files.ini.edonkey -f2 files.ini
+This program permits you to filter the files.ini to extract Fasttrack sources.
+But you can also use with any other plugin:
+- for fasttrack mldonkey_files --split Fasttrack -f0 files.ini -f1
+ files.ini.fasttrack -f2 files.ini
+- for edonkey mldonkey_files --split Donkey -f0 files.ini -f1
+ files.ini.edonkey -f2 files.ini
...
-- Sylvain LE GALL <sylvain.le-gall at polytechnique.org> Sun, 25 Sep 2003 00:33:00 +0200
@@ -154,29 +157,30 @@
* *
---------------------------------------
-The initial package was release for Sarge/Sid. It was not targeted to Woody. Regarding this
-it leads the packager to do certain choice, regarding the scripting possibility...
+The initial package was release for Sarge/Sid. It was not targeted to Woody.
+Regarding this it leads the packager to do certain choice, regarding the
+scripting possibility...
-I choose to use the command "stat" to get the owner of certains files. It was easy since
-stat belongs to coreutils in Sarge/Sid which is marked as essential. This means, i should
-not have any dependence on this package...
+I choose to use the command "stat" to get the owner of certains files. It was
+easy since stat belongs to coreutils in Sarge/Sid which is marked as
+essential. This means, i should not have any dependence on this package...
-In woody the situation is different : the arguments of the command are not the same, and the
-dependency to the package containing stat should be explicit. So if you are backporting or
-using mldonkey packages in Woody :
+In woody the situation is different: the arguments of the command are not the
+same, and the dependency to the package containing stat should be explicit. So
+if you are backporting or using mldonkey packages in Woody:
- install coreutils from testing
or
- install stat and edit the corresponding script ( config, /etc/init.d ... )
-If you have downloaded this package from a private repository, you should try to contact the
-maintainer from this repository to explain the situation.
+If you have downloaded this package from a private repository, you should try
+to contact the maintainer from this repository to explain the situation.
-- Sylvain LE GALL <sylvain.le-gall at polytechnique.org> Sun, 01 Feb 2004 21:56:00 +0200
-If you try to use the init script of mldonkey, you should encounter problem with the option
-used for the nicelevel of start-stop-daemon. On woody system, it seems that you could only
-have a niceness of 0 set by this way.
+If you try to use the init script of mldonkey, you should encounter problem
+with the option used for the nicelevel of start-stop-daemon. On woody system,
+it seems that you could only have a niceness of 0 set by this way.
Use a niceness of 0 when using Woody start-stop-daemon.
@@ -186,11 +190,12 @@
* Note for upgrading *
----------------------
-From time to time upgrade is quite difficult. You could encounter errors like "Exception Not_found while
-handling ...". This generally means that there is problems concerning a certain pair of file you was
-downloading before the upgrade.
+From time to time upgrade is quite difficult. You could encounter errors like
+"Exception Not_found while handling ...". This generally means that there is
+problems concerning a certain pair of file you was downloading before the
+upgrade.
-You can try to reconstruct your database following this step :
+You can try to reconstruct your database following this step:
- delete the files.ini in you mldonkey dir
- start mldonkey ( system wide or user )
- go to the console ( GUI or telnet to the core ).
@@ -198,14 +203,15 @@
This should build you a minimal file.ini.
-WARNING : this method is known not to be 100% safe. You can loose files, you can restart downloading
-et al. This command is not really reliable for everything. This command is know to work pretty well
-for ed2k and emule -- and very bad with bittorent.
+WARNING: this method is known not to be 100% safe. You can loose files, you
+can restart downloading et al. This command is not really reliable for
+everything. This command is know to work pretty well for ed2k and emule -- and
+very bad with bittorent.
-The best method is maybe to come back to an older version of mldonkey and try to get your download
-finished.
+The best method is maybe to come back to an older version of mldonkey and try
+to get your download finished.
-More informations :
+More information:
http://mldonkey.berlios.de/modules.php?name=Wiki&pagename=recover_temp
-- Sylvain Le Gall <sylvain.le-gall at polytechnique.org> Mon, 23 Aug 2004 01:07:07 +0200
@@ -214,11 +220,12 @@
* GTK2 interface *
----------------------
-In order to make the new GTK2 interface to work, we need to use UTF 8 everywhere on the GUI
-side. This means in particular, you have to be sure that every strings in the GUI configuration
-file is UTF8 encoded. In particular, you need to be sure that your login/password are UTF 8 encoded.
+In order to make the new GTK2 interface to work, we need to use UTF 8
+everywhere on the GUI side. This means in particular, you have to be sure that
+every strings in the GUI configuration file is UTF8 encoded. In particular,
+you need to be sure that your login/password are UTF 8 encoded.
-So you have two choice :
+So you have two choice:
- use "iconv" to convert the file
- erase the file and recreate it.
@@ -230,19 +237,23 @@
* Force startup *
----------------------
-Since the beginning of the package, a choice has been made to allow user to choose to start
-MLDonkey or not at startup. This decision was made because mldonkey is not an essential service
-and can be a really heavy time/network/processor consumer.
+Since the beginning of the package, a choice has been made to allow user to
+choose to start MLDonkey or not at startup. This decision was made because
+mldonkey is not an essential service and can be a really heavy
+time/network/processor consumer.
-However, it should be interesting to be able to start mldonkey, as configured during the install
-after the boot ( ie when you know that you can start it ). But the fact that you have configured
-the script not to start at startup, prevents user to do that.
+However, it should be interesting to be able to start mldonkey, as configured
+during the install after the boot ( ie when you know that you can start it ).
+But the fact that you have configured the script not to start at startup,
+prevents user to do that.
-Some users proposed to link/not to link startup script from /etc/rcX.d/SXXmldonkey-server to
-/etc/init.d/mldonkey-server. This way is a violation of the debian policy ( at least i think so ).
+Some users proposed to link/not to link startup script from
+/etc/rcX.d/SXXmldonkey-server to /etc/init.d/mldonkey-server. This way is a
+violation of the debian policy ( at least i think so ).
-I decide to let user be able to start the script using : "/etc/init.d/mldonkey-server force-start".
-This way, we are policy compliant and we let user start mldonkey-server, when needed.
+I decide to let user be able to start the script using:
+"/etc/init.d/mldonkey-server force-start". This way, we are policy compliant
+and we let user start mldonkey-server, when needed.
-- Sylvain Le Gall <sylvain.le-gall at polytechnique.org> Wed, 27 Apr 2005 23:35:36 +0200
@@ -250,25 +261,28 @@
* MLDonkey and groups *
-----------------------
-MLDonkey cannot handle more than one group when running. This limitation is due to OCaml library
-not providing enough function for changing the groups. So MLDonkey server will only be run using
-the user/primary group that is assigned to the MLDonkey user.
+MLDonkey cannot handle more than one group when running. This limitation is
+due to OCaml library not providing enough function for changing the groups. So
+MLDonkey server will only be run using the user/primary group that is assigned
+to the MLDonkey user.
-For example :
+For example:
$ cat /etc/passwd | grep mldonkey
mldonkey:x:102:1002::/var/lib/mldonkey:/bin/false
$ cat /etc/group | grep mldonkey
windows:x:1003:mldonkey
mldonkey:x:1002:
-Won't made the process mldonkey run with group mldonkey and windows, as expected !
-It will run with user mldonkey and group mldonkey ( because it is the primary group of mldonkey ).
+Won't made the process mldonkey run with group mldonkey and windows, as
+expected! It will run with user mldonkey and group mldonkey ( because it is
+the primary group of mldonkey ).
-So you have to choose the most appropriate primary group for mldonkey and change the
-primary group of mldonkey (usermod(8)) to this group.
+So you have to choose the most appropriate primary group for mldonkey and
+change the primary group of mldonkey (usermod(8)) to this group.
-For example, if you need to write to a special partition ( for example Windows partition ) and that
-only windows group user can do that, you should set the primary group of mldonkey to "windows".
+For example, if you need to write to a special partition (for example Windows
+partition) and that only windows group user can do that, you should set the
+primary group of mldonkey to "windows".
This bug has been sent to the ocaml team.
More information about the Pkg-ocaml-maint-commits
mailing list