table of contents
| MLNET(1) | [FIXME: manual] | MLNET(1) |
NAME¶
mlnet - your door to Edonkey, Directconnect, Gnutella, Bittorent, Overnet, OpenNap networks
SYNOPSIS¶
mlnet [options]
DESCRIPTION¶
This manual page documents briefly the mlnet command.
This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.
With mlnet you will be able to connect to different peer-to-peer network :
Peer to peer network is based on sharing file. Moreover, many servers on this different network have connection scripting. If you want to be welcome everywhere, it is highly recommended to share some files. When sharing take two consideration : number of file and total size of this file. The limit is typically : sharing more than 1 Gb and less than 1000 files.
MLDonkey is always in developpement. The download rate is not guaranteed. Through version it appears that queueing, uploading, downloading could be buggy. Normally, none of this bug really restrict you download / upload rate. If you see a very low rate, try to review all your settings and sharing before contacting the MLDonkey user mailing-list <mldonkey-users@nongnu.org>.
ENVIRONNEMENT¶
COLUMNS,LINES sets width and height for the terminal. This is the terminal as you see it when connecting to the telnet port of you MLDonkey client.
MLDONKEY_DIR sets name of the directory where the application will run. This directory must contains all the files describe in mldonkey_ini
MLDONKEY_MESSAGES name of the file where you can found the message for mldonkey.
YAHOO_SERVER hostname of the yahoo server to contact for Instant Messenging.
OPTIONS¶
-v
-exit
-format <filename>
-test_ip <ip>
-check_impl
-stdout
-stderr
-daemon
-find_port
-pid
-useradd "<user> <pass>"
-client_name <string>
-allowed_ips <string>
for internal command set: list separated by spaces
example for internal command: set allowed_ips "127.0.0.0/8 192.168.1.2"
or for editing the ini-file: list separated by semi-colon
example for ini-file: allowed_ips = [ "127.0.0.0/8"; "192.168.1.2";]
CIDR and range notations are supported: ie use 192.168.0.0/24
or 192.168.0.0-192.168.0.255 for 192.168.0.* (current: 127.0.0.1)
-gui_port <string>
-gift_port <string>
now 0 for disabled, because it does not check for a password. (current: 0)
-http_port <string>
-telnet_port <string>
-http_bind_addr <string>
-gui_bind_addr <string>
-telnet_bind_addr <string>
-print_all_sources <string>
-improved_telnet <string>
-verbosity <string>
printing information on the corresponding messages:
verb : verbose mode (interesting not only for coders)
mc : debug client messages
mr|raw : debug raw messages
mct : debug emule clients tags
ms : debug server messages
sm : debug source management
net : debug net
gui : debug gui
no-login : disable login messages
file : debug file handling
do : some download warnings
up : some upload warnings
unk : unknown messages
ov : overnet
loc : debug source research/master servers
share: debug sharing
md4 : md4 computation
connect : debug connections
udp : udp messages
ultra|super : debug supernode
swarming : debug swarming
hc : http_client messages
hs : http_server messages
com : commands by non-admin users
act : debug activity
bw : debug bandwidth
geo : debug GeoIP
unexp : debug unexpected messages (current: )
-max_hard_upload_rate <string>
The limit will apply on all your connections (clients and servers) and both
control and data messages. (current: 10)
-max_hard_download_rate <string>
The limit will apply on all your connections (clients and servers) and both
control and data messages. Maximum value depends on max_hard_upload_rate:
>= 10 -> unlimited download
< 10 > 3 -> download limited to upload * 4
< 4 -> download limited to upload * 3 (current: 50)
-max_hard_upload_rate_2 <string>
-max_hard_download_rate_2 <string>
-max_opened_connections <string>
-max_opened_connections_2 <string>
-max_indirect_connections <string>
-max_upload_slots <string>
-max_release_slots <string>
tagged as release, maximum 75% (current: 20)
-friends_upload_slot <string>
-small_files_slot_limit <string>
-dynamic_slots <string>
-max_connections_per_second <string>
-loop_delay <string>
increase the bandwidth usage, or increased to lower the CPU usage. (current: 5)
-nolimit_ips <string>
upload/download and upload slots. List separated by spaces, wildcard=255
ie: use 192.168.0.255 for 192.168.0.* (current: 127.0.0.1 )
-copy_read_buffer <string>
from a channel, but use more CPU as it must then copy the data in the
channel buffer. (current: true)
-enable_overnet <string>
(enable_donkey must be true) (current: true)
-enable_kademlia <string>
(enable_donkey must be true, and only experimental) (current: false)
-enable_servers <string>
(enable_donkey must be true, and only experimental) (current: true)
-enable_bittorrent <string>
-enable_donkey <string>
-enable_opennap <string>
-enable_soulseek <string>
-enable_gnutella <string>
-enable_gnutella2 <string>
-enable_fasttrack <string>
-enable_directconnect <string>
-enable_openft <string>
-enable_fileTP <string>
-client_ip <string>
-force_client_ip <string>
ourself. Don't set this option to true if you have dynamic IP. (current: false)
-discover_ip <string>
-user_agent <string>
-rss_preprocessor <string>
-ip_blocking_descriptions <string>
-ip_blocking <string>
Zip files must contain either a file named guarding.p2p or guarding_full.p2p. (current: )
-ip_blocking_countries <string>
Names are in ISO 3166 format, see http://www.maxmind.com/app/iso3166
You can also at your own risk use "Unknown" for IPs Geoip won't recognize. (current: )
-ip_blocking_countries_block <string>
true: use ip_blocking_countries as allow list, all other countries are blocked (current: false)
-geoip_dat <string>
-tcpip_packet_size <string>
14 bytes sometimes, so modify to take that into account) (current: 40)
-mtu_packet_size <string>
-minimal_packet_size <string>
available on the connection (current: 600)
-socket_keepalive <string>
This implies some bandwidth-cost (with 200 connections ~10-20%) (current: false)
-http_proxy_server <string>
-http_proxy_port <string>
-http_proxy_tcp <string>
-html_mods <string>
-html_mods_style <string>
-html_mods_human_readable <string>
-html_mods_use_relative_availability <string>
-html_mods_vd_network <string>
-html_mods_vd_comments <string>
-html_mods_vd_user <string>
-html_mods_vd_group <string>
-html_mods_vd_active_sources <string>
-html_mods_vd_age <string>
-html_flags <string>
-html_mods_vd_gfx <string>
-html_mods_vd_gfx_remove <string>
-html_mods_vd_gfx_fill <string>
-html_mods_vd_gfx_split <string>
-html_mods_vd_gfx_stack <string>
-html_mods_vd_gfx_flip <string>
-html_mods_vd_gfx_mean <string>
-html_mods_vd_gfx_transparent <string>
-html_mods_vd_gfx_png <string>
-html_mods_vd_gfx_h <string>
-html_mods_vd_gfx_x_size <string>
-html_mods_vd_gfx_y_size <string>
-html_mods_vd_gfx_h_intervall <string>
Changes to this option require a core restart. (current: 60)
-html_mods_vd_gfx_h_dymamic <string>
-html_mods_vd_gfx_h_grid_time <string>
-html_mods_vd_gfx_subgrid <string>
-html_mods_vd_gfx_tag <string>
-html_mods_vd_gfx_tag_use_source <string>
-html_mods_vd_gfx_tag_source <string>
-html_mods_vd_gfx_tag_png <string>
-html_mods_vd_gfx_tag_enable_title <string>
-html_mods_vd_gfx_tag_title <string>
-html_mods_vd_gfx_tag_title_x_pos <string>
-html_mods_vd_gfx_tag_title_y_pos <string>
-html_mods_vd_gfx_tag_dl_x_pos <string>
-html_mods_vd_gfx_tag_dl_y_pos <string>
-html_mods_vd_gfx_tag_ul_x_pos <string>
-html_mods_vd_gfx_tag_ul_y_pos <string>
-html_mods_vd_gfx_tag_x_size <string>
-html_mods_vd_gfx_tag_y_size <string>
-html_mods_vd_last <string>
-html_mods_vd_prio <string>
-html_vd_barheight <string>
-html_vd_chunk_graph <string>
-html_vd_chunk_graph_style <string>
-html_vd_chunk_graph_max_width <string>
-html_mods_show_pending <string>
-html_mods_load_message_file <string>
-html_mods_max_messages <string>
-html_mods_bw_refresh_delay <string>
-html_mods_theme <string>
leave blank to use internal theme (current: )
-html_checkbox_vd_file_list <string>
-html_checkbox_search_file_list <string>
-html_use_gzip <string>
-html_mods_use_js_tooltips <string>
-html_mods_js_tooltips_wait <string>
-html_mods_js_tooltips_timeout <string>
-html_mods_use_js_helptext <string>
-allow_local_network <string>
(only for debugging) (current: false)
-log_size <string>
-log_file_size <string>
log_file will be deleted if its bigger than log_file_size. (current: 2)
-log_file <string>
set this option, mldonkey will log this info in the file until you use the
'close_log' command. The log file may become very large. You can
also enable logging in a file after startup using the 'log_file' command. (current: mlnet.log)
-log_to_syslog <string>
and its associated commands, therefore close_log does not stop log to syslog.
Its therefore possible to log to syslog and log_file at the same time. (current: false)
-gui_log_size <string>
-auto_commit <string>
in incoming directory (current: true)
-pause_new_downloads <string>
will be set to false on core start. (current: false)
-release_new_downloads <string>
-max_concurrent_downloads <string>
-sources_per_chunk <string>
-max_recover_zeroes_gap <string>
should be interpreted as downloaded during a recovery (current: 16)
-file_completed_cmd <string>
Arguments are (kept for compatibility):
$1 - temp file name, without path
$2 - file size
$3 - filename of the committed file
Also these environment variables can be used (preferred way):
$TEMPNAME - temp file name, including path
$FILEID - same as $1
$FILESIZE - same as $2
$FILENAME - same as $3
$FILEHASH - internal hash
$DURATION - download duration
$INCOMING - directory used for commit
$NETWORK - network used for downloading
$ED2K_HASH - ed2k hash if MD4 is known
$FILE_OWNER - user who started the download
$FILE_GROUP - group the file belongs to
$USER_MAIL - mail address of file_owner
(current: )
-file_started_cmd <string>
are '-file <num>'
Also these environment variables can be used (preferred way):
$TEMPNAME - temp file name, including path
$FILEID - same as $1
$FILESIZE - same as $2
$FILENAME - same as $3
$FILEHASH - internal hash
$NETWORK - network used for downloading
$ED2K_HASH - ed2k hash if MD4 is known
$FILE_OWNER - user who started the download
$FILE_GROUP - group the file belongs to
$USER_MAIL - mail address of file_owner
(current: )
-run_as_user <string>
have been bound (can be used not to run with root privileges when
a port < 1024 is needed) (current: )
-run_as_useruid <string>
have been bound (can be used not to run with root privileges when
a port < 1024 is needed) (current: 0)
-run_as_group <string>
-run_as_groupgid <string>
-ask_for_gui <string>
-start_gui <string>
-recover_temp_on_startup <string>
-config_files_security_space <string>
-smtp_server <string>
-smtp_port <string>
-mail <string>
-add_mail_brackets <string>
-filename_in_subject <string>
-url_in_mail <string>
-temp_directory <string>
-share_scan_interval <string>
Minimum 5, 0 to disable. Use command reshare to manually scan shares.
When core starts, shared directories are scanned once, independent of this option. (current: 30)
-create_file_mode <string>
-create_dir_mode <string>
-create_file_sparse <string>
-hdd_temp_minfree <string>
-hdd_temp_stop_core <string>
otherwise all downloads are paused and a warning email is sent. (current: false)
-hdd_coredir_minfree <string>
-hdd_coredir_stop_core <string>
otherwise all downloads are paused and a warning email is sent. (current: true)
-hdd_send_warning_interval <string>
-previewer <string>
is name of file as searched on eDonkey (current: /usr/bin/see)
-mldonkey_bin <string>
-mldonkey_gui <string>
-allow_any_command <string>
ones in allowed_commands (current: false)
-allow_browse_share <string>
-messages_filter <string>
-comments_filter <string>
-save_results <string>
-buffer_writes <string>
-buffer_writes_delay <string>
-buffer_writes_threshold <string>
-emule_mods_count <string>
-emule_mods_showall <string>
-backup_options_delay <string>
A value of zero means that a backup is written only when the core shuts down. (current: 0)
-backup_options_generations <string>
-backup_options_format <string>
-shutdown_timeout <string>
-interface_buffer <string>
to increase when the connection between them has a small bandwith (current: 1000000)
-max_name_len <string>
-max_filenames <string>
-max_client_name_len <string>
-term_ansi <string>
-update_gui_delay <string>
-http_realm <string>
-html_frame_border <string>
-commands_frame_height <string>
-motd_html <string>
-compaction_delay <string>
-vd_reload_delay <string>
-client_bind_addr <string>
-create_mlsubmit <string>
-minor_heap_size <string>
-relevant_queues <string>
-min_reask_delay <string>
-display_downloaded_results <string>
-filter_table_threshold <string>
-client_buffer_size <string>
For high-volume links raise this value to 1.000.000 or higher. (current: 500000)
-save_options_delay <string>
Changes to this option require a core restart. (current: 900.)
-server_connection_timeout <string>
-download_sample_rate <string>
-download_sample_size <string>
-compaction_overhead <string>
-space_overhead <string>
that will be "wasted" because the GC does not immediatly collect
unreachable blocks. It is expressed as a percentage of the memory used
for live data. The GC will work more (use more CPU time and collect
blocks more eagerly) if space_overhead is smaller. (current: 80)
-max_displayed_results <string>
-options_version <string>
-max_comments_per_file <string>
-max_comment_length <string>
--ED2K-max_xs_packets <string>
--ED2K-port <string>
--ED2K-check_client_connections_delay <string>
--ED2K-client_timeout <string>
--ED2K-max_connected_servers <string>
--ED2K-reliable_sources <string>
--ED2K-ban_identity_thieves <string>
--ED2K-server_black_list <string>
Servers on this list can't be added, and will eventually be removed (current: )
--ED2K-force_high_id <string>
--ED2K-force_client_high_id <string>
--ED2K-update_server_list_server <string>
receive new servers from servers (current: false)
--ED2K-update_server_list_server_met <string>
receive new servers from server.met (current: true)
--ED2K-update_server_list_client <string>
receive new servers from clients (current: false)
--ED2K-keep_best_server <string>
to change the master servers it is connected to (current: true)
--ED2K-connect_only_preferred_server <string>
please note that any server must be set to preferred to use this feature (current: false)
--ED2K-max_walker_servers <string>
between servers (current: 1)
--ED2K-walker_server_lifetime <string>
--ED2K-log_clients_on_console <string>
--ED2K-propagate_sources <string>
This function is superseded by eMule-style source exchange,
this option is outdated (current: false)
--ED2K-max_sources_per_file <string>
--ED2K-keep_sources <string>
--ED2K-client_md4 <string>
--ED2K-client_private_key <string>
--ED2K-enable_sui <string>
--ED2K-black_list <string>
--ED2K-queued_timeout <string>
--ED2K-upload_timeout <string>
--ED2K-upload_lifetime <string>
--ED2K-upload_full_chunks <string>
--ED2K-upload_complete_chunks <string>
partial. this setting overrides upload_full_chunks and dynamic_upload_lifetime,
but is, as a failsafe, limited by upload_lifetime (should be set reasonable high) (current: false)
--ED2K-dynamic_upload_lifetime <string>
--ED2K-dynamic_upload_threshold <string>
--ED2K-connected_server_timeout <string>
--ED2K-upload_power <string>
peer-to-peer networks. Setting it to 5 for example means that a donkey
connection will be allowed to send 5 times more information per second than
an Open Napster connection. This is done to favorise donkey connections
over other networks, where upload is less efficient, without preventing
upload from these networks. (current: 5)
--ED2K-max_server_age <string>
--ED2K-remove_old_servers_delay <string>
(in seconds, 0 to disable) (current: 900.)
--ED2K-min_left_servers <string>
--ED2K-servers_walking_period <string>
--ED2K-keep_cancelled_in_old_files <string>
--ED2K-keep_downloaded_in_old_files <string>
--ED2K-send_warning_messages <string>
upload bandwidth sending messages to clients which are banned :) (current: false)
--ED2K-ban_queue_jumpers <string>
clients that try queue jumping (3 reconnections faster than 9 minutes) (current: true)
--ED2K-use_server_ip <string>
--ED2K-ban_period <string>
--ED2K-good_client_rank <string>
--ED2K-min_users_on_server <string>
--ED2K-max_published_files <string>
--ED2K-login <string>
--ED2K-options_version <string>
--BT-client_port <string>
--BT-client_uid <string>
--BT-ask_tracker_threshold <string>
--BT-max_tracker_redirect <string>
--BT-send_key <string>
--BT-max_uploaders_per_torrent <string>
--BT-max_bt_uploaders <string>
--BT-numwant <string>
--BT-import_new_torrents_interval <string>
--BT-tracker_retries <string>
--BT-min_tracker_reask_interval <string>
--BT-client_timeout <string>
--BT-user_agent <string>
--BT-options_version <string>
--BT-tracker_port <string>
--BT-max_tracked_files <string>
--BT-max_tracker_reply <string>
--BT-tracker_force_local_torrents <string>
--BT-tracker_use_key <string>
--BT-default_tracker <string>
--BT-default_comment <string>
--FTP-get_range <string>
--FTP-range_arg <string>
--FTP-options_version <string>
--FTP-chunk_size <string>
--DC-client_port <string>
--DC-dc_open_slots <string>
--DC-login <string>
--DC-servers_list_url <string>
--DC-search_timeout <string>
--DC-file_search_time <string>
--DC-client_timeout <string>
--DC-client_read_timeout <string>
--DC-client_write_timeout <string>
--DC-wait_for_next_upload <string>
--DC-firewalled <string>
--DC-autosearch_by_tth <string>
from searches automatically (current: true)
--DC-max_sources_file <string>
--DC-client_speed <string>
eg. Modem, Cable, DSL, Satellite, LAN(T1), LAN(T3) (current: DSL)
--DC-options_version <string>
-dump <filename>
-known <filename>
-part <filename>
-server <filename>
-pref <filename>
-peers <filename>
-help
--help
LICENSE¶
This manual page was originally written by Sylvain Le Gall <gildor@debian.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.
SEE ALSO¶
mlguistarter (1)
mlgui (1)
AUTHORS¶
Sylvain Le Gall <gildor@debian.org>
Mehdi Dogguy <dogguy@pps.jussieu.fr>
COPYRIGHT¶
Copyright © 2003, 2004, 2005, 2006 Sylvain Le Gall
Copyright © 2009 Mehdi Dogguy
| March 14, 2009 | [FIXME: source] |