mldonkey系列之四──Mldonkey命令解释2007-10-27 周六, 21:16

MLDonkey拥有一个简单的内部命令解释器。多数如telnet、Web或GUI这样Mldonkey的界面，都提供了输入命令的方法。通常它们都很方便，有时这是使用Mldonkey高级功能的唯一方法。

在Mldonkey中有许多命令可用，有些并不为人所知。本页试图详细地解释这些命令。

内容

1、用户命令
2、组命令
3、服务器命令
4、搜索命令
5、好友命令
6、下载命令
7、上传命令
8、全局Donkey命令
9、配置命令
10、Overnet命令
11、Kademlia命令
12、恢复命令
13、状态命令
14、调试测试命令
15、未分类的命令
16、旧命令

用户命令
auth <user> <password>: 登录（允许用户登录到mldonkey，如果不登录多数命令无法使用）

useradd <user> <passwd> [<mail>] : 添加新的mldonkey用户/修改用户密码
admin用户可以使用本命令建立一个新用户或修改前面用户的密码，普通用户可以修改自己的密码。
例如：
代码: > whoami
admin

> useradd Jimbo "Jimbos secret password"
User Jimbo added

> auth Jimbo "Jimbos secret password"
Full access enabled

> whoami
Jimbo

> useradd Jimbo newpassword
Password of user Jimbo changed
userdel <user> : （限admin使用）删除一个用户

users : （限admin使用）列出用户。

whoami : 列出登录的用户名

组命令

groupadd <group> <admin: true|false>

服务器命令

vm : 以如下格式列出连接的服务器：
[<网络> <服务器序号>] <IP地址>:<端口> <服务器名> <服务器上连接的节点数> <服务器上索引的文件数> <连接状态>

vma : 按以下格式列出所有已知的服务器：
[<网络> <服务器序号>] <IP地址>:<端口> <服务器名> <服务器上连接的节点数> <服务器上索引的文件数> <连接状态>

n <ip> [<port>] : 添加一个服务器到服务器列表，如果端口省略，默认使用4661端口。

server_banner <num> : 显示已连接服务器<num>的标题。

servers <filename> : 读取一个标准的server.met文件，将其中的服务器添加到你的服务器列表中。

c [<num>] : 若现有服务器连接数小于max_connected_servers的设定值，则连接到另一服务器。
若为<num>设定了值，则连接到vma列出的服务器号为<num>的服务器。

x <num> : 断开到服务器<num>的连接，<num>为vm显示的已连接服务器号之一。

id : 显示你的客户端在已连接的donkey服务器上分配的id，HighID以IP地址方式显示，LowID以单整数显示。

preferred <true/false> <ip> : 设置或重置指定IP的服务器的<preferred>标志。
Preferred服务器永远不会被清除，会更快地升级成主服务器，最后一个降级。它们会被放在服务器列表的最上端，因此也会成为Mldonkey首批试连接的服务器。

例如：
代码: preferred true 195.245.244.243

bs <ip1> [<ip2> ...] : 将指定IP地址添加到服务器黑名单中。MLdonkey不会尝试连接黑名单中的服务器。但是，黑名单中的服务器只会在定期自动清除中从服务器列表中删除。 清除也可由发出remove_old_servers命令强制执行。

bp <port1> [<port2> ...] :
将指定端口添加到端口黑名单列表中，MLdonkey不会尝试连接这些端口上的服务器或节点，但是，使用了黑名单列表中端口的服务器只会在定期自动清除中从服务器列表中删除。清除也可由发出remove_old_servers命令强制执行。
端口4662默认列入服务器的黑名单中。

例如：
代码: bp 9999

rem <serv1> [<serv2> ...] :
删除多日未连接的服务器。
从服务器列表中删除服务器（使用参数“all”删除全部服务器）。
remove_old_servers : 强制MLdonkey执行服务器列表清除操作。那些超过max_server_age天数的服务器、黑名单列表中的IP地址的服务器、使用端口黑名单中端口的服务器会被从服务器列表中删除。

服务器列表清除会按一定周期自动执行，所以本命令只是在使用了bp或bs命令后用一用。

搜索命令

s <query> :
在所有网络上搜索文件（指定搜索参数）。
本命令用一个指定查询发起一次网络搜索。但是，它不会显示搜索结果；使用vr命令获取结果列表。同时要知道，搜索是异步执行，可能要花很长时间。
在eDonkey网络中，只有当前连接的服务器会被查询。要查询服务器列表中的所有服务器，请使用server list命令。
另外要注意，经常用ExternalSearchUtilities（外部搜索工具）替代MLdonkey内部整合的搜索功能似乎要更可信。更有效，节约你的内存和网络资源。

例如：
代码: > s "Bill Gates - Win 98 crash on live TV"
Query 1 Sent to 5

> vr
Result of search 1
Reinitialising download selectors
2 results (1 waiting)
` Num ` Size Avail Names Tags MD4
` 1` 57624032 2 Bill Gates - Win 98 crash on live TV - EXTR...mpeg 1:00:01 128 1 urn:ed2k:4D70B5FD1ED1F73CA8A71167BD7C1C36
` 2` 5231324 3 Bill Gates - Win 98 crash on live TV - EXTR....mpg 0:29 y41p 1 urn:ed2k:D6426A3138D3952CCA0C49BAB9B64C62

xs : 扩展搜索
本命令将由s命令发起的搜索扩展到服务器列表中的eDonkey服务器上。

要执行扩展搜索，客户将UDP请求发送给不只是主要连接的服务器。这些请求被服务器以比连接客户发来的TCP请求低的优先级进行处理。

本命令花费时间长，质量不高，但结果多。

一次只可运行一个扩展搜索。

例如：
代码: > s \"Bill Gates - Win 98 crash on live TV\"
Query 1 Sent to 5

> vr
Result of search 1
Reinitialising download selectors
2 results (1 waiting)
` Num ` Size Avail Names Tags MD4
` 1` 57624032 2 Bill Gates - Win 98 crash on live TV - EXTR...mpeg 1:00:01 128 1 urn:ed2k:4D70B5FD1ED1F73CA8A71167BD7C1C36
` 2` 5231324 3 Bill Gates - Win 98 crash on live TV - EXTR....mpg 0:29 y41p 1 urn:ed2k:D6426A3138D3952CCA0C49BAB9B64C62

> xs
extended search started

> vr
Result of search 1
Reinitialising download selectors
5 results (done)
` Num ` Size Avail Names Tags MD4
` 1` 57624032 2 Bill Gates - Win 98 crash on live TV - EXTR...mpeg 1:00:01 128 1 urn:ed2k:4D70B5FD1ED1F73CA8A71167BD7C1C36
` 2` 5231324 3 Bill Gates - Win 98 crash on live TV - EXTR....mpg 0:29 y41p 1 urn:ed2k:D6426A3138D3952CCA0C49BAB9B64C62
` 3` 5231324 1 Bill Gates - Win 98 crash on live TV.mpg 0:29 y41p 1 urn:ed2k:EAFD996A305387A9308A21F283C7FC23
` 4` 2558989 1 comedy - bill gates - win 98 crash on live ...mpeg 0:29 y41p 1 urn:ed2k:99374B3732EC81538ADB7B48D8528054
` 5` 2557956 19 Funny- Bill Gates - Win 98 crash on live TV...mpeg 0:29 y41p 112 29 250 mpeg Video urn:ed2k:5634E0FAE4140DA96039ABD902DD5C47

vs : 查看所有查询

vr <num> : 查看某一搜索的结果
显示指定搜索或上次搜索（无参数时）的结果。
使用vs查看搜索序号。

view_custom_queries : 查看定制查询
查看定制搜索表/查询的号
如果你是通过telnet连接，你只能看到定制搜索查询的号和名字，如果你通过webgui连接，你就还可以选择你想使用的某一查询。

forget <num1> [<num2> ...] : 放弃搜索<num1> <num2> ...
丢弃参数和指定搜索序号的结果。搜索序号由vs命令查看。

好友命令

friends : 显示全部好友
显示全部好友及他们各自ID号的列表。它对窄带终端（narrow terminal）有用。但通常，你会更希望使用vfr命令，打的更少，信息更多。

files <client num> : 显示<client num>好友共享的文件。
查看好友ID，请使用friends或vfr命令。

vfr : 显示好友
显示一张所有好友和他们的ID、IP地址及等级的列表。这只是friends的另一个版本，打得更少，信息更多。

gfr <friend_num> : 从好友那儿取回共享的文件列表，你就可以用vfr查看那个列表。查看好友ID，请使用friends或vfr命令。

friend_add <client_num> : 添加指定ID号为<client num>的节点到好友列表。

friend_remove <client_num> : 删除好友（使用"all"参数删除全部好友）
将指定ID号的好友从好友列表中删除。

message [<client num> <msg>] : 发送信息给指定ID号为<client num>的节点。

下载命令

d <num> : 本命令用来下载一个或多个由s命令找到的文件。例如：
代码: > s bill gates
Query 1 Sent to 5

> vr
Result of search 1
Reinitialising download selectors
143 results (-288 waiting)
` Num ` Size Avail Names Tags MD4
` 1` 734935040 1 Billl Gates.avi urn:ed2k:94D83FACEC47A4297C03335566583E62
` 2` 673210368 3 Los.Piratas.De.Silicon.Valley.La.....AVI 1:33:13 div3 846 5 urn:ed2k:CB6608E4FA57454F08F38C5A161E3EBE
` 3` 457358204 4 Bill Gates - Biografia.mpeg 43:11 y41p 224 2 urn:ed2k:24CBF480D82D47345789BE7890C87553
293 sources, total available 20.64G

> d 1 3
download started
download started

dllink <link> : 下载ed2k、sig2dat、torrent或其它链接。
部分浏览器会在链接末尾添加一个斜线，MLdonkey并不受影响。

dllinks <file> : 下载包含在文件中的所有链接。
每个链接独立一行，允许空行。

dd <size> <md4> : 本命令用来发起一个文件的下载，如果你知道它的字节大小和md4-hash。

http <url> <referer> : 从HTTP、FTP或SSH URL下载文件。当前用FileTP实现还处于实验阶段。只提供了基本功能，特别是对SSH传输。（译注：这个信息比较早，是2004年的wiki，版本是2.5.9）

mirror <num> <url> <referer> : 添加URL作为HTTP或FTP下载文件<num>的镜像。
例如：
代码: > http http://www.bar.com/test.zip
download started

> vd
Downloaded 0/1 files
` Num ` File % Done Size Left Old Active Rate Prio
`F 75` test.zip 0.1 7.2kb 10.4mb 10.4mb 0:- 1/1 3.6 0

Downloaded 0 files

> mirror 75 http://www.foo.net/test.zip
mirror added

merge <file num1> <file num2> : 尝试合并下载文件<num2> (次要的)到文件<num1> (主要的)
允许从不同网络同时下载相同文件。

force_download : 强制下载一个已经下载过的文件。
如果你已经下载了一个文件，但想要再下载一次（可能你意外删除了它），mldonkey告诉你“文件已经下载”，在此之后，输入'force_download'。
例如：
代码: ~> dllink ed2k://....

file already downloaded

~> force_download

(下载还是开始了)

mldonkey使用old_files列表检测已经下载的文件。所以，要想不使用force_download，你可以在核心没有运行时从那个列表中删除hashes。
如果你使用web界面，如果你在搜索结果中点击链接你无法使用force_download（即使错误信息显示了）。而是，你必须指明ed2k-URL（从搜索窗口你怎么做？），在输入框中输入：
代码: dllink <the URL>
然后在输入框中使用force_download，

vd [<num>] : 查看文件信息
不带参数时，显示下载队列中所有文件的列表。字段如下：
[<网络> <序号>] <名字> <下载百分比> <已下载字节> <文件大小> <列表中的天数>:<days since last complete seen> <下载速度>

如果给定参数，就会显示指定序号的下载文件的详细信息，例如：文件名、md4-hash、全部/已下载字节、已下载块、替代名字、来源数。
例如：
代码: > vd

Down: 1.7 KB/s ( 106 + 1440 ) || Up: 6.2 KB/s ( 950 + 5373 ) || Shared: 22/543.5M
Num File % Done Size Avail Old Active Rate Prio
[D 17] SampleDownloadFile1.dat 99.9 699.5mb 699.8mb 100% 20:0 56/515 - 0
[D 18] SampleDownloadFile2.dat 96.4 672.9mb 698.2mb 100% 20:0 40/509 1.7 10
Downloaded 0 files

> vd 17

[Donkey 17] E8A6A3D5E6579CD244876DEF201337A9 733479324 9728000
priority 0 dst-share <default>
Chunks: [300000000000000000000000000000000000]
(E8A6A3D5E6579CD244876DEF201337A9)
(SampleDownloadFile1.dat)
(SampleDownloadFile1AlternativeNameFromTheClients1.dat)
(SampleDownloadFile1AlternativeNameFromTheClients2.dat)
3 sources:
[8530]    (last_ok <never>)
[6648]    JohnDoe (last_ok <03:50 Wed 26 Jan>)
[7378]    JaneDoe (last_ok <16:15 Wed 26 Jan>)

pause <num> : 暂停一个下载（使用参数'all'暂停全部文件）
暂停一个下载，暂停的下载不会产生网络流量。文件序号<num>可以用vd找到。如果用'all'替换<num>，所有下载会被暂停。

resume <num> : 续传暂停的下载（使用参数'all'续传所有文件）
续传一个被pause或因磁盘已满暂停的下载。文件号<num>可用vd找到。如果用'all'替换<num>，所有下载会被续传。

tracker <num> <url> [<url>...] :添加URLs作为文件<num>的trackers。

cancel <num> : 取消下载（使用参数'all'取消全部下载）
cancel停止下载并删除临时文件，在此前会要求你确认。
下载号可用vd命令列出。
例如：
代码: > cancel 77
Files to be cancelled:
[Donkey 77]
Bill Gates vs pie.avi
urn:ed2k:D8A3B060E6F7C90517A5F145492F194A
Total 2601928
Partial 20015
priority 0
Chunks: [0]
Probable name: Bill Gates vs pie.avi
(Bill Gates vs pie.avi)
0 sources:
Type 'confirm yes/no' to cancel them

> confirm yes
Files cancelled

priority <priority> <file num 1> [<file num 2> ...] : 改变文件优先级
新的MLdonkey使用不同的优先级参数，它决定着哪个文件活跃下载，哪个文件发送到等待队列中去。参数max_concurrent_downloads决定可同时下载的文件数量。
优先级可以设置为-100到100。除非你使用~=<abslevel>语法，<level>是个相对值；所以如果你的文件（优先级）已经是30,你输入40,就变成了70（30+40）。如果你输入-20,就变成了10（30-20），等等。

要在Gtk GUI界面中显示优先级，右击某列标题/在列后添加……>优先级，但是，好像优先级没有更新，在此修复前，你不得不mldonkey内核以更新它 们。另外它可以只设置它们成高/中/低，分别代表优先级10、0、-10。用命令行界面，你可以自由地设置优先级，它显示在vd输出的最后一列。

优先级对我有效，但不要幻想一个高优先级的稀有文件比低优先级的流行文件下载得更快。它影响发往服务器的命令请求。

rename <num> "<new name>" : 重命名正在下载的文件。
改变一个正在下载的文件的名字。<num>是文件的序号，<new name>是你想重命名的名字。
你可以使用vd查看正在下载的文件的序号。
它对fasttrack的文件无效，但对eDonkey的文件有效。
例如：
代码: ~> rename 3 newname.avi

commit : 移动已下载的文件到incoming目录。
当文件传输完成后，应该执行一下commit操作，以便把文件从Temp_directory（临时目录）移动到 Shared_directories（共享目录）。虽然commit默认自动执行，手动commit在特定配置中会有用的。比如，如果 Shared_directories和Temp_directory在不同的磁盘或文件系统。这种情况下，移动文件会占用相当的时间和CPU资源，最好 你能手动控制何时发生。

要关闭自动交付，使用commit命令，你需要关掉auto_commit选项。
例如：
代码: > vd
[ Num ] File Size MD4
[Donkey 99 ] SAMPLE_file.rar 188256 ABCD567890ABCDEFF6161713761822E0
Use 'commit' to move downloaded files to the incoming directory

> commit
Commited

startbt <URL|file> : 启动BT下载

上传命令

compute_torrent <filename> <comment> : 生成<filename>.torrent文件做种。

nu <m> : 在<m>分钟内关闭上传（5的倍数）

reshare : check shared files for removal

reshare_torrents : recheck torrents/* directories for changes

seeded_torrents : 显示本服务器上所有做种的.torrent文件

shares : 显示共享目录

unshare <dirname> : 删除一个共享目录

全局Donkey命令

version : 显示mldonkey版本

q : 关闭telnet

save <"options"|"sources"|"backup"> : 保存选项/源/备份(empty for options and sources)

kill : 保存并杀掉服务器

! command : 远程运行Shell命令

close_fds : 关闭所有文件 (use to free space on disk after remove)

close_all_sockets : 关闭所有打开的sockets

activity <minutes> : 显示最后<minutes>分钟的活动

配置命令

alias : 添加命令别名。例如： "alias ca cancel all" 做了一个执行"cancel all"的别名"ca"

ansi <bool> : 切换telnet界面ANSI序列开关

disable <num> : 关闭特定的网络

enable <num> : 打开特定网络

html_mods : 切换html_mods

html_mods_style : 选择html_mods_style <#>

html_theme <theme> : 选择html_theme

import <dirname> : 从<dirname>导入配置

port <port> : 改变ED2K端口

set <option_name> <option_value> : 改变选项值

share <priority> <dir> [<strategy>] : 以优先级<priority>共享目录<dir>（共享策略<strategy>）

unalias : 删除一个命令别名，例如: "unalias ca"

urladd <kind> <url> : 从网上载入这个文件，类型也可以是server.met（如果下载文件是一个server.met）

urlremove <url> : 从web_infos中删除<url>

vo : 显示基本选项

voo [<regexp | num>]: 显示所有选项，匹配表达式（比如"ED2K*"）或 视图号（限web界面）。

options : 按节（section)显示选项

reset_md4 : 随机重置client_md4/client_private_key

Overnet命令

ov_boot <ip> <port> : 添加一个Overnet节点

ov_boots : print boot peers显示启动节点

ov_dump_bucket <bucket_nr> : dumps a bucket

ov_dump_known_peers : 转存已知节点dumps known_peers

ov_link <fhalink> : 下载fha:// 链接

ov_load <filename> : 从contact.dat文件中载入节点

ov_md4 : 获取Overnet/Kademlia网络上客户的MD4地址。get client MD4 address on the Overnet/Kademlia network

ov_send_udp : 发送UDP信息(<ip> <port> <msg in hex>)

ov_store : dump the Overnet File Store

ov_view_stats_cmds : Overnet状态命令

ov_web <urls> : 下载.ocl URLS (默认不载入参数no arg load default)

Kademlia命令

kad_boot <ip> <port> : 添加一个Kademlia节点

kad_dump_bucket <bucket_nr> : dumps a bucket

kad_dump_known_peers : 转存已知节点dumps known_peers

kad_link <fhalink> :下载fha://链接

kad_load <filename> : 从一个contact.dat文件载入节点

kad_md4 : 获取Overnet/Kademlia网络上的客户MD4地址get client MD4 address on the Overnet/Kademlia network

kad_send_udp : 发送UDP信息 (<ip> <port> <msg in hex>)

kad_store : dump the Kademlia File Store

kad_view_stats_cmds : Kademlia状态命令

kad_web <urls> : 下载.ocl URLs (默认不载入参数no arg load default)

恢复命令

import_temp <temp_dir> : 导入eDonkey/eMule/lMule临时目录

scan_temp : 显示临时目录内容

recover_bytes <file1> [< file2> ...] : 尝试以字符级恢复这些文件try to recover these files at byte level

recover_temp : 从临时目录中恢复丢失的文件recover lost files from temp directory

verify_chunks <num> : 校验文件<num> 的文件块

状态命令

block_list : 显示符合拦截IP范围的列表display the list of blocked IP ranges that were hit

downloaders : 显示下载者列表display downloaders list

buildinfo : 显示mldonkey核心编译信息print mldonkey core build information

bw_stats : 显示带宽数据show bandwidth statistics

cs : 按ED2K客户种类显示下载上传表show table of download/upload by ED2K clients brand

csbt : 按BT客户种类显示下载上传表show table of download/upload by BT clients brand

csm 按eMule MODs显示下载上传表show table of download/upload by eMule MODs

client_stats : 按客户种类显示下载上传表show breakdown of download/upload by clients brand

client_stats_bt : 按客户种类显示下载上传分析show breakdown of download/upload by clients brand

diskinfo : 显示mldonkey磁盘信息print mldonkey disk information

gdstats : 显示图形传输数据display graphical transfer statistics

kad_boots : 显示启动节点print boot peers

kad_buckets : 显示存储桶表状态print buckets table status

kad_stats : Kademlia状态

links : 列出共享文件的链接 list links of shared files

ov_buckets : 显示存储桶表状态print buckets table status

ov_stats : Overnet状态

runinfo : 显示mldonkey运行时信息print mldonkey runtime information

sources : 显示现在已知源show sources currently known

sysinfo : 显示mldonkey核心编译、运行时和磁盘信息print mldonkey core build, runtime and disk information

upstats : 上传的数据statistics on upload

reset_stats : 重置会话数据reset session statistics

stats : 显示传输数据display transfer statistics

torrents : 显示这个服务器上所有.torrent文件print all .torrent files on this server

uploaders : 显示当前正在上传的用户show users currently uploading

uptime : 核心的uptime core uptime

vu : 查看上传信用view upload credits

portinfo : 显示mldonkey端口使用信息print mldonkey port usage information

调试实验命令

这些命令可能未经通知就消失或改变。请保持关注。

block_test <ip> : 检查一个IP是否被拦截。check whether an IP is blocked

clear_debug : 清除正在调试的用户表clear the table of clients being debugged

clear_log : 清除日志文件clear log_file

close_log : 停止发送核心信息到文件stop sending core messages to a file

debug_client <client num1> [<client num2> ...] : 记录特定客户的活动log specific clients activity

debug_disk <disk> : 调试命令debug command (example: disk .)

debug_file <client nums> : 调试文件状态debug file state

debug_fileinfo : 调试命令debug command (example: file .)

debug_rlimit : 调试命令debug command

debug_socks : 限调试for debugging only

dump_heap : 转存堆栈用于调试dump heap for debug

dump_reliability : 转存源的评估依赖dump the evaluated reliability of sources

log : 转存当前日志状态到控制台dump current log state to console

log_file <file> : 输出核心信息到文件output core messages to a file

mem_stats : 显示内在状态print memory stats

networks : 显示所有网络print all networks

open_log : 打开日志记录到文件enable logging to file

tsources : 显示源存储桶list source buckets

test_recover <num> : 显示文件中下载的段print the segments downloaded in file

use_poll <bool> : use poll instead of select

update_sources : 重新计算连接到源的顺序recompute order of connections to sources(experimental)

stdout <true|false> : 重新激活日志到标准输出reactivate log to stdout

未分类命令

vc <num> : 显示客户view client

add_url <kind> <url> : 从网上载入这个文件。类型也可以是server.met(如果下载的文件是一个server.met)load this file from the web. kind is either server.met (if the downloaded file is a server.met)

calendar_add <hour> "<command>" : 添加到每日被执行的命令add a command to be executed every day

vwi : 显示web_infos选项print web_infos options

confirm <yes|no|what> : 确认取消confirm cancellation

gdremove : 删除图形传输数据文件remove graphical transfer statistics files

message_log : 信息日志[刷新延迟以秒计]message_log [refresh delay in seconds]

preview <file number> : 开始预览文件<file number>start previewer for file <file number>

reload_messages : 重新载入信息文件reload messages file

rm_old_torrents : 删除所有老的.torrent文件remove all old .torrent files

rss : 显示RSS种子print RSS feeds

vcal : 显示日历print calendar

view_custom_queries : 显示定制查询view custom queries

老式命令

add_user, remove_user, add_url, commit_to, set_brothers
请使用以下网址来引用本篇文章:http://forum.ubuntu.org.cn/trackback.php?e=6600
http://forum.ubuntu.org.cn/weblog_entry.php?e=6600&sid=3936f8facca29e02a5eeb180f880d5da