mldonkey_users(1)

NAME

mldonkey_users - a configuration editor for mlnet init

file.

SYNOPSIS

mldonkey_users {[--add {name}] | [--del {name}] | [--check
{name}] | [--list] | [--test-users-section] |  [--dump-users-section] | [--strip-users-section]} [-p {password}] [-f {file}] [-q]

DESCRIPTION

This manual page documents briefly the mldonkey_users com

mand.

This manual page was written for the Debian GNU/Linux dis

tribution because the original program is Debian GNU/Linux spe

cific.

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 ex

ists, 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 perform

ing 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, with

out 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.

RETURN VALUE

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 er

ror code of 0 is returned. Otherwise an error code of 1 is re

turned.

LICENSE

This manual page was written by Sylvain Le Gall <syl

vain.le-gall@polytechnique.org> for the Debian GNU/Linux system

(but may be used by others). Permission is granted to copy, dis

tribute 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.

SEE ALSO

mlnet (1)

AUTHOR

Sylvain Le Gall <sylain.le-gall@polytechnique.org>

Author.

COPYRIGHT

Copyright © 2003 Sylvain Le Gall

May 20, 2003 ML

DONKEY_USERS(1)