Provided by: amule-utils_2.3.3-2_amd64
名稱
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 雖然上面這些都是合於規定的語系設定參數,但 encoding 和 modifier 目前已經沒在使用了。 你也可以使用完整的英文名稱來設定語系,例如:-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@vollstreckernet.de>