debian: fix build-deps for focal
[amule.git] / docs / man / amulecmd.zh_TW.1
blob61131d86075e9dd1abe319529093a6fa1c32516f
1 .\"*******************************************************************
2 .\"
3 .\" This file was generated with po4a. Translate the source file.
4 .\"
5 .\"*******************************************************************
6 .TH AMULECMD 1 "2016 九月" "aMuleCmd v2.3.2" "aMule 的工具程式"
7 .als B_untranslated B
8 .als RB_untranslated RB
9 .als SS_untranslated SS
10 .SH 名稱
11 amulecmd \- 終端機模式下控制 aMule 的程式
12 .SH 簡介
13 .B_untranslated amulecmd
14 [\fB\-h\fP \fI<主機>\fP] [\fB\-p\fP \fI<通訊埠>\fP] [\fB\-P\fP \fI<密碼>\fP]
15 [\fB\-f\fP \fI<路徑>\fP]
16 .RB_untranslated [ \-q ]
17 .RB_untranslated [ \-v ]
18 [\fB\-l\fP \fI<語言>\fP] {\fB \fP[\fB\-w\fP]\fB \fP|\fB \fP[\fB\-c\fP \fI<指令>\fP]\fB \fP}
20 .B_untranslated amulecmd
21 [\fB\-\-create\-config\-from\fP=\fI<路徑>\fP]
23 .B_untranslated amulecmd
24 .RB_untranslated [ \-\-version ]
26 .B_untranslated amulecmd
27 .RB_untranslated [ \-\-help ]
28 .SH 說明
29 \fBamulecmd\fP 是終端機模式下控制 aMule 的的客戶端程式。
30 .TP 
31 \fB[ \-h\fP \fI<主機>\fP, \fB\-\-host\fP=\fI<主機>\fP \fB]\fP
32 正在執行 aMule 核心的主機 (預設:\fI本機\fP), \fI<主機>\fP 可以是 IP 位址或網域名稱
33 .TP 
34 \fB[ \-p\fP \fI<通訊埠>\fP, \fB\-\-port\fP=\fI<通訊埠>\fP \fB]\fP
35 aMule 外部連線用的通訊埠,在 偏好設定 >  遠端控制 設定 (預設:\fI4712\fP)
36 .TP 
37 \fB[ \-P\fP \fI<密碼>\fP, \fB\-\-password\fP=\fI<密碼>\fP \fB]\fP
38 外部連線密碼。
39 .TP 
40 \fB[ \-f\fP \fI<路徑>\fP, \fB\-\-config\-file\fP=\fI<路徑>\fP \fB]\fP
41 使用指定的設定檔,預設是 \fI~/.aMule/remote.conf\fP
42 .TP 
43 .B_untranslated [ \-q\fR, \fB\-\-quiet ]\fR
44 不將任何資訊顯示在標準輸出。
45 .TP 
46 .B_untranslated [ \-v\fR, \fB\-\-verbose ]\fR
47 詳細模式 \- 也顯示除錯訊息。
48 .TP 
49 \fB[ \-l\fP \fI<語言>\fP, \fB\-\-locale\fP=\fI<語言>\fP \fB]\fP
50 設定程式的語系 (語言)。請看 \fB附註\fP 章節裏關於 \fI<語言>\fP 參數的說明。
51 .TP 
52 .B_untranslated [ \-w\fR, \fB\-\-write\-config ]\fR
53 將命令列選項寫入設定檔後離開
54 .TP 
55 \fB[ \-c\fP \fI<指令>\fP, \fB\-\-command\fP=\fI<指令>\fP \fB]\fP
56 像在 amulecmd 的命令列模式下一樣,執行 \fI<指令>\fP 後離開。
57 .TP 
58 \fB[ \-\-create\-config\-from\fP=\fI<路徑>\fP \fB]\fP
59 參考 \fI<path>\fP 裏的資料來建立設定檔後離開。(\fI<path>\fP 裏必須有有效的 aMule 設定檔)
60 .TP 
61 .B_untranslated [ \-v\fR, \fB\-\-version ]\fR
62 顯示目前的版本號碼。
63 .TP 
64 .B_untranslated [ \-h\fR, \fB\-\-help ]\fR
65 顯示簡短的使用說明。
66 .SH 指令
67 所有指令都不分大小寫。
68 .SS "Add \fI<eD2k 連結>\fP | \fI<magnet 連結>\fP"
69 將 eD2k 連結或 magnet 加到核心。
71 可以使用以下幾種 eD2k 連結:
72 .RS 3
73 .IP \(bu 2
74 檔案連結 (ed2k://|file|...),會將檔案加入下載等候區;
75 .IP \(bu 2
76 伺服器連結 (ed2k://|server|...),會將伺服器加入 aMule 的伺服器清單;
77 .IP \(bu 2
78 伺服器清單,所有在這個清單內的伺服器都會被加到 aMule 的伺服器清單。
79 .RE
81 magnet 連結裏必須包含 eD2k 的 hash 值和檔案大小。
82 .SS "Cancel \fI<hash 值>\fP | \fI<編號>\fP"
83 取消下載指定的檔案,指定方式:\fI<hash 值>\fP 或 \fI<編號>\fP;要查詢數值請用 \fBshow\fP。
84 .SS "connect [ \fIkad\fP | \fIed2k\fP | \fI<IP | 網域名稱>\fP ]"
85 連線到網路。
87 這樣將會連線到在偏好設定中啟用的所有網路。
89 用這個選項參數,你可以指定要連線到哪個網路:用「IP:port」格式指定伺服器的位址 (IP 可以用有小數點的十進位 IPv4 網址,或是可從 DNS
90 轉換的網域名稱),aMule 就會只連線到那個伺服器。
91 .SS_untranslated Disconnect [ \fIed2k\fP | \fIkad\fP ]
92 中斷所有已連線的網路,或只中斷指定的網路連線。
93 .SS "download \fI<編號>\fP"
94 開始下載檔案。
96 \fI<編號>\fP 指上次搜尋檔案時的結果。例如:「download 12」會下載上次搜尋時編號 12 的檔案。
97 .SS_untranslated Exit
98 始 amule/amuled 斷線,並離開 amulecmd。
99 .SS "get \fI<目標>\fP"
100 取得並顯示某個偏好設定的值。
102 \fI<目標>\fP 參數可用的值:
104 .IP BwLimits 10
105 取得頻寬限制。
106 .IP IPFilter 10
107 取得 IP 過濾器的偏好設定。
109 .SS "help [ \fI<命令>\fP ]"
110 顯示使用說明。如果沒有加參數,會顯示可用的指令一覽;如果加了 \fI<指令>\fP 參數,會顯示該指令的簡單說明。
111 .SS "pause \fI<hash 值>\fP | \fI<編號>\fP"
112 暫停下載指定的檔案,指定方式:\fI<hash 值>\fP 或 \fI<編號>\fP;要查詢數值請用 \fBshow\fP。
113 .SS "priority \fI<優先程度>\fP \fI<hash 值>\fP | \fI<編號>\fP"
114 用 \fI<hash 值>\fP 或 \fI<編號>\fP 設定下載檔案的優先程度。
116 可用在 \fI<優先度>\fP 的參數:
118 .IP Auto 10
119 自動優先權。
120 .IP High 10
121 高優先權。
122 .IP Low 10
123 低優先權。
124 .IP Normal 10
125 一般優先權。
127 .SS_untranslated Progress
128 顯示正在進行中的搜尋進度。
129 .SS_untranslated Quit
130 功能和 \fBexit\fP 一樣的指令。
131 .SS "reload \fI<目標>\fP"
132 重新載入指定的物件。
134 \fI<目標>\fP 參數可用的值:
136 .IP Shared 10
137 重新載入分享檔案清單。
138 .IP IPFilter 10
139 重新載入 IP 過濾器資料。
141 .SS_untranslated Reset
142 清除記錄。
143 .SS_untranslated Results
144 顯示上次搜尋的結果。
145 .SS "resume \fI<hash 值>\fP | \fI<編號>\fP"
146 繼續下載指定的檔案,指定方式:\fI<hash 值>\fP 或 \fI<編號>\fP;要查詢數值請用 \fBshow\fP。
147 .SS "search \fI<種類>\fP \fI<關鍵字>\fP"
148 用指定的 \fI<關鍵字>\fP 搜尋。必須要有搜尋的「種類」加上「關鍵字」,例如:「search kad amule」會開始在 KAD
149 網路搜尋「amule」。
151 可用的搜尋類型:
153 .IP Global 10
154 開始在全球伺服器搜尋。
155 .IP Kad 10
156 開始在 Kad 搜尋。
157 .IP Local 10
158 開始在本地伺服器搜尋。
160 .SS "set \fI<目標>\fP"
161 設定指定的偏好設定值。
163 \fI<目標>\fP 參數可用的值:
165 .IP BwLimits 10
166 設定頻寬限制。
167 .IP IPFilter 10
168 設定 IP過濾器的偏好設定。
170 .SS "show \fI<目標>\fP"
171 顯示 上傳/下載 等候區、伺服器清單 或 分享檔案清單。
173 \fI<目標>\fP 參數可用的值:
175 .IP DL 10
176 顯示下載等候區。
177 .IP Log 10
178 顯示記錄。
179 .IP Servers 10
180 顯示伺服器清單。
181 .IP UL 10
182 顯示上傳等候區。
184 .SS_untranslated Shutdown
185 關閉在遠端執行的核心 (amule/amuled)。這樣也會關閉文字模式客戶端程式,因為不能在沒有核心下執行。
186 .SS "statistics [ \fI<號字>\fP ]"
187 顯示統計資訊。
189 \fI<編號>\fP 是這個指令的參數之一,用來指定要顯示多少個客戶端程式的版本附加版本;須為 0\-255 的數字,輸入 0
190 或略過不輸入則表示「不限」。
192 範例:「statistics 5」只會顯示每個客戶端種類的前 5 個版本。
193 .SS_untranslated Status
194 顯示 連線狀態、目前的上傳/下載速度 等等。
195 .SH 附註
196 .SS 路徑
197 對於有 \fI<路徑>\fP 的選項,如果 \fI路徑\fP 裏面沒有含目錄 (即只有單純檔名),則會被認為是在 aMule 的設定檔所在目錄
198 \fI~/.aMule\fP 下。
199 .SS 語言
200 \fB\-l\fP 選項的 \fI<語系>\fP
201 參數有以下幾種樣式:\fIlang\fP[\fB_\fP\fILANG\fP][\fB.\fP\fIencoding\fP][\fB@\fP\fImodifier\fP]。其中:\fIlang\fP
202 是主要的語系代碼,\fILANG\fP 是語系次分類、使用地區代碼,\fIencoding\fP 是使用的編碼,\fImodifier\fP
203 則讓使用者用一個代號就指定一組語系設定。例如:「zh_TW.UTF\-8@Taiwan」
205 例如,以下的字串都有效:
207 .RB_untranslated de
209 .RB_untranslated de_DE
211 .RB_untranslated de_DE.iso88591
213 .RB_untranslated de_DE@euro
215 .RB_untranslated de_DE.iso88591@euro
218 雖然上面這些都是合於規定的語系設定參數,但 \fIencoding\fP 和 \fImodifier\fP 目前已經沒在使用了。
220 你也可以使用完整的英文名稱來設定語系,例如:\fB\-l german\fP 也等於 \fB\-l de_DE\fP。
222 沒有在命令列或設定檔中設定語系時,會使用系統預設語言。
223 .SH 檔案
224 ~/.aMule/remote.conf
225 .SH 範例
226 通常 amulecmd 會優先以這樣執行:
228 \fBamulecmd\fP \fB\-h\fP \fI主機名稱\fP \fB\-p\fP \fI外部連線通訊埠\fP \fB\-P\fP \fI外部連線密碼\fP \fB\-w\fP
232 \fBamulecmd\fP \fB\-\-create\-config\-from\fP=\fI/home/username/.aMule/amule.conf\fP
234 這樣就會將設定儲存到 \fI$HOME/.aMule/remote.conf\fP,然後你只需要再輸入:
236 .B_untranslated amulecmd
238 當然,你可以不必都遵照這個範例。
239 .SH 回報問題
240 請到我們的論壇 (\fIhttp://forum.amule.org/\fP) 或錯誤追蹤網站 (\fIhttp://bugs.amule.org/\fP)
241 回報發現的問題。請不要用 e\-mail 或在我們的群組信件中回報,也不要直接通知某個團隊成員。
242 .SH 版權
243 aMule 與附加的工具程式都遵守 GNU 的 GPL 協定。
244 .SH 參考
245 .B_untranslated amule\fR(1), \fBamuled\fR(1)
246 .SH 作者
247 說明文件撰寫者: Vollstrecker <amule@vollstreckernet.de>