Manpages

名 稱

amulecmd - 終 端 機 模 式 下 控 制 aMule 的 程 式

簡 介

amulecmd [-h <主 機 >] [-p <通 訊 埠 >] [-P <密 碼 >] [-f <路 徑 >] [-q] [-v] [-l <語 言 >] { [-w] | [-c <指 令 >] }

amulecmd [--create-config-from=<路 徑 >]

amulecmd [--version]

amulecmd [--help]

說 明

amulecmd 是 終 端 機 模 式 下 控 制 aMule 的 的 客 戶 端 程 式 。
[ -h
<主 機 >, --host=<主 機 > ] 正 在 執 行 aMule 核 心 的 主 機 (預 設 : 本 機 ), <主 機 > 可 以 是 IP 位 址 或 網 域 名 稱
[ -p
<通 訊 埠 >, --port=<通 訊 埠 > ]

aMule 外 部 連 線 用 的 通 訊 埠 , 在 偏 好 設 定 > 遠 端 控 制 設 定 (預 設 : 4712)

[ -P <密 碼 >, --password=<密 碼 > ] 外 部 連 線 密 碼 。
[ -f
<路 徑 >, --config-file=<路 徑 > ] 使 用 指 定 的 設 定 檔 , 預 設 是 ~/.aMule/remote.conf
[ -q
, --quiet ] 不 將 任 何 資 訊 顯 示 在 標 準 輸 出 。
[ -v
, --verbose ] 詳 細 模 式 - 也 顯 示 除 錯 訊 息 。
[ -l
<語 言 >, --locale=<語 言 > ] 設 定 程 式 的 語 系 (語 言 )。 請 看 附 註 章 節 裏 關 於 <語 言 > 參 數 的 說 明 。
[ -w
, --write-config ] 將 命 令 列 選 項 寫 入 設 定 檔 後 離 開
[ -c
<指 令 >, --command=<指 令 > ] 像 在 amulecmd 的 命 令 列 模 式 下 一 樣 , 執 行 <指 令 > 後 離 開 。
[ --create-config-from
=<路 徑 > ] 參 考 <path> 裏 的 資 料 來 建 立 設 定 檔 後 離 開 。 (<path> 裏 必 須 有 有 效 的 aMule 設 定 檔 )
[ -v
, --version ] 顯 示 目 前 的 版 本 號 碼 。
[ -h
, --help ] 顯 示 簡 短 的 使 用 說 明 。

指 令

所 有 指 令 都 不 分 大 小 寫 。

Add <eD2k 連 結 > | <magnet 連 結 > 將 eD2k 連 結 或 magnet 加 到 核 心 。 可 以 使 用 以 下 幾 種 eD2k 連 結 :

• 檔 案 連 結

(ed2k://|file|...), 會 將 檔 案 加 入 下 載 等 候 區 ;

• 伺 服 器 連 結

(ed2k://|server|...), 會 將 伺 服 器 加 入 aMule 的 伺 服 器 清

單 ;

• 伺 服 器 清 單 , 所 有 在 這 個 清 單 內 的 伺 服 器 都 會 被 加 到

aMule 的 伺 服 器 清

單 。

magnet 連 結 裏 必 須 包 含 eD2k 的 hash 值 和 檔 案 大 小 。

Cancel <hash 值 > | <編 號 > 取 消 下 載 指 定 的 檔 案 , 指 定 方 式 : <hash 值 ><編 號 >; 要 查 詢 數 值 請 用 show

connect [ kad | ed2k | <IP | 網 域 名 稱 > ] 連 線 到 網 路 。 這 樣 將 會 連 線 到 在 偏 好 設 定 中 啟 用 的 所 有 網 路 。 用 這 個 選 項 參 數 , 你 可 以 指 定 要 連 線 到 哪 個 網 路 : 用 「 IP:port」 格 式 指 定 伺 服 器 的 位 址 (IP 可 以 用 有 小 數 點 的 十 進 位 IPv4 網 址 , 或 是 可 從 DNS 轉 換 的 網 域 名 稱 ), aMule 就 會 只 連 線 到 那 個 伺 服 器 。

Disconnect [ ed2k | kad ] 中 斷 所 有 已 連 線 的 網 路 , 或 只 中 斷 指 定 的 網 路 連 線 。

download <編 號 > 開 始 下 載 檔 案 。

<編 號 > 指 上 次 搜 尋 檔 案 時 的 結 果 。 例 如 : 「 download 12」 會 下 載 上 次 搜 尋 時 編 號 12 的 檔 案 。

Exit 始 amule/amuled 斷 線 , 並 離 開 amulecmd。

get <目 標 > 取 得 並 顯 示 某 個 偏 好 設 定 的 值 。

<目 標 > 參 數 可 用 的 值 :

BwLimits 取 得 頻 寬 限 制 。

IPFilter 取 得

IP 過 濾 器 的 偏 好 設 定 。

help [ <命 令 > ] 顯 示 使 用 說 明 。 如 果 沒 有 加 參 數 , 會 顯 示 可 用 的 指 令 一 覽 ; 如 果 加 了 <指 令 > 參 數 , 會 顯 示 該 指 令 的 簡 單 說 明 。

pause <hash 值 > | <編 號 > 暫 停 下 載 指 定 的 檔 案 , 指 定 方 式 : <hash 值 ><編 號 >; 要 查 詢 數 值 請 用 show

priority <優 先 程 度 > <hash 值 > | <編 號 ><hash 值 ><編 號 > 設 定 下 載 檔 案 的 優 先 程 度 。 可 用 在 <優 先 度 > 的 參 數 :

Auto 自 動 優 先 權 。

High 高 優 先 權 。

Low 低 優 先 權 。

Normal 一 般 優 先 權 。

Progress 顯 示 正 在 進 行 中 的 搜 尋 進 度 。

Quit 功 能 和 exit 一 樣 的 指 令 。

reload <目 標 > 重 新 載 入 指 定 的 物 件 。

<目 標 > 參 數 可 用 的 值 :

Shared 重 新 載 入 分 享 檔 案 清 單 。

IPFilter 重 新 載 入

IP 過 濾 器 資 料 。

Reset 清 除 記 錄 。

Results 顯 示 上 次 搜 尋 的 結 果 。

resume <hash 值 > | <編 號 > 繼 續 下 載 指 定 的 檔 案 , 指 定 方 式 : <hash 值 ><編 號 >; 要 查 詢 數 值 請 用 show

search <種 類 > <關 鍵 字 > 用 指 定 的 <關 鍵 字 > 搜 尋 。 必 須 要 有 搜 尋 的 「 種 類 」 加 上 「 關 鍵 字 」 , 例 如 : 「 search kad amule」 會 開 始 在 KAD 網 路 搜 尋 「 amule」 。 可 用 的 搜 尋 類 型 :

Global 開 始 在 全 球 伺 服 器 搜 尋 。

Kad 開 始 在

Kad 搜 尋 。

Local 開 始 在 本 地 伺 服 器 搜 尋 。

set <目 標 > 設 定 指 定 的 偏 好 設 定 值 。

<目 標 > 參 數 可 用 的 值 :

BwLimits 設 定 頻 寬 限 制 。

IPFilter 設 定

IP過 濾 器 的 偏 好 設 定 。

show <目 標 > 顯 示 上 傳 /下 載 等 候 區 、 伺 服 器 清 單 或 分 享 檔 案 清 單 。

<目 標 > 參 數 可 用 的 值 :

DL 顯 示 下 載 等 候 區 。

Log 顯 示 記 錄 。

Servers 顯 示 伺 服 器 清 單 。

UL 顯 示 上 傳 等 候 區 。

Shutdown 關 閉 在 遠 端 執 行 的 核 心 (amule/amuled)。 這 樣 也 會 關 閉 文 字 模 式 客 戶 端 程 式 , 因 為 不 能 在 沒 有 核 心 下 執 行 。

statistics [ <號 字 > ] 顯 示 統 計 資 訊 。

<編 號 > 是 這 個 指 令 的 參 數 之 一 , 用 來 指 定 要 顯 示 多 少 個 客 戶 端 程 式 的 版 本 附 加 版 本 ; 須 為 0-255 的 數 字 , 輸 入 0 或 略 過 不 輸 入 則 表 示 「 不 限 」 。 範 例 : 「 statistics 5」 只 會 顯 示 每 個 客 戶 端 種 類 的 前 5 個 版 本 。

Status 顯 示 連 線 狀 態 、 目 前 的 上 傳 /下 載 速 度 等 等 。

附 註

路 徑 對 於 有 <路 徑 > 的 選 項 , 如 果 路 徑 裏 面 沒 有 含 目 錄 (即 只 有 單 純 檔 名 ), 則 會 被 認 為 是 在 aMule 的 設 定 檔 所 在 目 錄 ~/.aMule 下 。 語 言

-l 選 項 的 <語 系 > 參 數 有 以 下 幾 種 樣 式 : lang[_LANG][.encoding][@modifier]。 其 中 : lang 是 主 要 的 語 系 代 碼 , LANG 是 語 系 次 分 類 、 使 用 地 區 代 碼 , encoding 是 使 用 的 編 碼 , modifier 則 讓 使 用 者 用 一 個 代 號 就 指 定 一 組 語 系 設 定 。 例 如 : 「 zh_TW.UTF-8@Taiwan」 例 如 , 以 下 的 字 串 都 有 效 :

de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro 雖 然 上 面 這 些 都 是 合 於 規 定 的 語 系 設 定 參 數 , 但 encodingmodifier 目 前 已 經 沒 在 使 用 了 。 你 也 可 以 使 用 完 整 的 英 文 名 稱 來 設 定 語 系 , 例 如 : -l german 也 等 於 -l de_DE。 沒 有 在 命 令 列 或 設 定 檔 中 設 定 語 系 時 , 會 使 用 系 統 預 設 語 言 。

檔 案

~/.aMule/remote.conf

範 例

通 常 amulecmd 會 優 先 以 這 樣 執 行 :

amulecmd -h 主 機 名 稱 -p 外 部 連 線 通 訊 埠 -P 外 部 連 線 密 碼 -w

amulecmd --create-config-from=/home/username/.aMule/amule.conf 這 樣 就 會 將 設 定 儲 存 到 $HOME/.aMule/remote.conf, 然 後 你 只 需 要 再 輸 入 :

amulecmd 當 然 , 你 可 以 不 必 都 遵 照 這 個 範 例 。

回 報 問 題

請 到 我 們 的 論 壇 (http://forum.amule.org/) 或 錯 誤 追 蹤 網 站 (http://bugs.amule.org/) 回 報 發 現 的 問 題 。 請 不 要 用 e-mail 或 在 我 們 的 群 組 信 件 中 回 報 , 也 不 要 直 接 通 知 某 個 團 隊 成 員 。

版 權

aMule 與 附 加 的 工 具 程 式 都 遵 守 GNU 的 GPL 協 定 。

參 考

amule(1), amuled(1)

作 者

說 明 文 件 撰 寫 者 : Vollstrecker <amule [AT] vollstreckernet.de>