mldonkey_users - a configuration editor for mlnet init file.

This manual page documents briefly the mldonkey_users command.

This manual page was written for the Debian GNU/Linux distribution because the original program is Debian GNU/Linux specific.

This script was written by the debian developper to enable easy user management configuration of mlnet server.

-f [file]

This option is needed. This is the name of the file which contains the actual list of users (downloads.ini).

-p [password]

Set the password for this user. If not set through the command line and required by action to be taken, user will be prompted to enter one.

-q

Quiet mode.

--add [name]

Add the user whose name is given. If no password is set, user will be prompted to enter one. If the user already exists, he will be replaced by the new one.

--del [name]

Delete the user whose name is given.

--check [name]

Check that the user has the password set with -p. If no password is provided, it assumes that the application is performing a sanity check and return an error if the password of the corresponding user is empty.

--list

List all user managed by the file used.

--test-users-section

Check for the presence of a users section. If a users section is found in the given file, exit with an error code of 0 else exit with an error code of 1.

--dump-users-section

Print on the standard output the users section.

--strip-users-section

Print on the standard output all the given file, without the users section.

The action --add, --del, --check, --list, --test-users-section, --dump-users-section and --strip-users-section are exclusive. You can only perform one at the same time.

If the program cannot found the user, an error code of 1 is returned.

During --check, if the password does not match the given password, an error code of 1 is returned. If no password is given and that the password match with the empty string, an error code of 1 is returned. Otherwise, it returns an error code of 0 ( no error )

During --test-users-section, if a section if found an error code of 0 is returned. Otherwise an error code of 1 is returned.

This manual page was written by Sylvain Le Gall <sylvain.le-gall@polytechnique.org> for the Debian GNU/Linux system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Lesser General Public License, Version 2.1 or any later version published by the Free Software Foundation; considering as source code all the file that enable the production of this manpage.

mlnet (1)

Sylvain Le Gall.