.TH AMULECMD 1 "August 2026" "aMuleCmd vGIT" "aMule utilities" .als B_untranslated B .als RB_untranslated RB .als SS_untranslated SS .SH "نام (NAME)" amulecmd \- کلاینت خط فرمانی برای کنترل aMule .SH "خلاصه دستور (SYNOPSIS)" .B_untranslated amulecmd .RB [ \-h " " \fI ] .RB [ \-p " " \fI ] .RB [ \-P " " \fI ] .RB [ \-f " " \fI ] .RB_untranslated [ \-q ] .RB_untranslated [ \-v ] .RB [ \-l " " \fI ] .RB { " " [ \-w ] " " | " " [ \-c " " \fI ] " " } .B_untranslated amulecmd .RB [ \-\-create\-config\-from = \fI ] .B_untranslated amulecmd .RB_untranslated [ \-\-version ] .B_untranslated amulecmd .RB_untranslated [ \-\-help ] .SH "توضیحات (DESCRIPTION)" .B amulecmd یک کلاینت مبتنی بر کنسول برای کنترل aMule است. .TP \fB[ \-h\fR \fI\fR, \fB\-\-host\fR=\fI\fR \fB]\fR میزبانی که aMule روی آن در حال اجرا است (پیش‌فرض: \fI127.0.0.1\fR). \fI\fR ممکن است یک نشانی IP یا یک نام DNS باشد. .TP \fB[ \-p\fR \fI\fR, \fB\-\-port\fR=\fI\fR \fB]\fR درگاه aMule برای اتصالات خارجی (External Connections)، همان‌طور که در Preferences->Remote Controls تنظیم شده است (پیش‌فرض: \fI4712\fR). .TP \fB[ \-P\fR \fI\fR, \fB\-\-password\fR=\fI\fR \fB]\fR گذرواژه اتصالات خارجی (External Connections). .TP \fB[ \-f\fR \fI\fR, \fB\-\-config\-file\fR=\fI\fR \fB]\fR استفاده از فایل پیکربندی داده‌شده. فایل پیکربندی پیش‌فرض \fI~/.aMule/remote.conf\fR است. .TP .B_untranslated [ \-q\fR, \fB\-\-quiet ]\fR عدم چاپ هرگونه خروجی در stdout. .TP .B_untranslated [ \-v\fR, \fB\-\-verbose ]\fR حالت پرگویی \- پیام‌های اشکال‌زدایی نیز نمایش داده شوند. .TP \fB[ \-l\fR \fI\fR, \fB\-\-locale\fR=\fI\fR \fB]\fR تنظیم زبان و محلی‌سازی برنامه (locale). برای توضیحات پارامتر \fI\fR بخش \fBNOTES\fR را ببینید. .TP .B_untranslated [ \-w\fR, \fB\-\-write\-config ]\fR نوشتن گزینه‌های خط فرمان در فایل پیکربندی و خروج. .TP \fB[ \-c\fR \fI\fR, \fB\-\-command\fR=\fI\fR \fB]\fR اجرای \fI\fR به گونه‌ای که گویی در اعلان amulecmd وارد شده است و سپس خروج. .TP \fB[ \-\-create\-config\-from\fR=\fI\fR \fB]\fR ایجاد فایل پیکربندی بر پایه \fI\fR (که باید به یک فایل پیکربندی معتبر aMule اشاره کند) و سپس خروج. .TP .B_untranslated [ \-\-force\-zlib ]\fR اجبار به فشرده‌سازی ZLIB روی پیوند اتصال خارجی بدون در نظر گرفتن محلی بودن IP مقصد. زمانی مفید است که سمت سرور از طریق یک تونل VPN در دسترس باشد که به یک IP شبکه محلی (LAN) نگاشت می‌شود و در غیر این صورت الگوریتم اکتشافی از فشرده‌سازی صرف‌نظر می‌کرد. .TP .B_untranslated [ \-\-version ]\fR نمایش شماره نسخه فعلی. .TP .B_untranslated [ \-\-help ]\fR چاپ یک توضیح کوتاه درباره نحوه استفاده. .SH "دستورات (COMMANDS)" تمام دستورات نسبت به بزرگی و کوچکی حروف حساس نیستند (case insensitive). .SS_untranslated Add \fI\fP | \fI\fP افزودن یک پیوند eD2k یا یک پیوند magnet به هسته. پیوند eD2k ارائه‌شده برای افزودن می‌تواند یکی از موارد زیر باشد: .RS 3 .IP \(bu 2 یک پیوند فایل (ed2k://|file|...)، که به صف بارگیری افزوده خواهد شد؛ .IP \(bu 2 یک پیوند سرور (ed2k://|server|...)، که به فهرست سرورها افزوده خواهد شد؛ .IP \(bu 2 یک پیوند فهرست سرور، که در این صورت تمام سرورهای موجود در آن به فهرست سرورها افزوده خواهند شد. .RE پیوند magnet باید شامل هش eD2k و طول فایل باشد. .SS_untranslated Cancel \fI\fP | \fI\fP لغو بارگیری مشخص‌شده توسط \fI\fR یا \fI\fR. برای دریافت مقدار از دستور \fBshow\fR استفاده کنید. .SS_untranslated Connect [ \fIkad\fP | \fIed2k\fP | \fI\fP ] اتصال به شبکه. این دستور به تمامی شبکه‌هایی که در Preferences فعال شده‌اند متصل می‌شود. با استفاده از پارامتر اختیاری می‌توانید شبکه مورد نظر برای اتصال را مشخص کنید. با ارائه نشانی سرور در قالب IP:Port (که در آن IP یک نشانی IPv4 دهدهی نقطه‌دار یا یک نام DNS قابل حل است)، aMule فقط به همان سرور متصل خواهد شد. .SS_untranslated Disconnect [ \fIed2k\fP | \fIkad\fP ] قطع اتصال از تمام شبکه‌هایی که به آن‌ها متصل هستید، یا فقط قطع اتصال از شبکه مشخص‌شده. .SS_untranslated Download \fI\fP شروع بارگیری یک فایل. باید \fI\fR یک فایل از آخرین جستجو داده شود. مثال: `download 12` بارگیری فایل شماره ۱۲ از جستجوی پیشین را آغاز می‌کند. .SS_untranslated Exit قطع اتصال از amule/amuled و خروج از amulecmd. .SS_untranslated Get \fI\fP دریافت و نمایش مقدار یک تنظیم (preference). مقادیر موجود برای \fI\fR: .RS .IP BwLimits 10 دریافت محدودیت‌های پهنای باند. .IP IPFilter 10 دریافت تنظیمات IPFilter. .RE .SS_untranslated Help [ \fI\fP ] چاپ یک توضیح کوتاه درباره نحوه استفاده. اگر بدون پارامتر فراخوانی شود، فهرستی از دستورات موجود را نمایش می‌دهد. اگر با \fI\fR فراخوانی شود، توضیح کوتاهی درباره دستور ارائه‌شده نمایش می‌دهد. .SS_untranslated Pause \fI\fP | \fI\fP متوقف کردن موقت (Pause) بارگیری مشخص‌شده توسط \fI\fR یا \fI\fR. برای دریافت مقدار از دستور \fBshow\fR استفاده کنید. .SS_untranslated Priority \fI\fP \fI\fP | \fI\fP تنظیم اولویت بارگیری مشخص‌شده توسط \fI\fR یا \fI\fR. مقادیر موجود برای \fI\fR: .RS .IP Auto 10 اولویت خودکار. .IP High 10 اولویت بالا. .IP Low 10 اولویت پایین. .IP Normal 10 اولویت عادی. .RE .SS_untranslated Progress نمایش میزان پیشرفت جستجوی در حال انجام. .SS_untranslated Quit مترادفی برای دستور \fBexit\fR. .SS_untranslated Reload \fI\fP بارگذاری مجدد یک شیء مشخص. مقادیر موجود برای \fI\fR: .RS .IP Shared 10 بارگذاری مجدد فهرست فایل‌های هم‌رسانی‌شده. .IP IPFilter 10 بارگذاری مجدد جدول‌های فیلتر IP. .RE .SS_untranslated Reset بازنشانی گزارش (log). .SS_untranslated Results نمایش نتایج آخرین جستجو. .SS_untranslated Resume \fI\fP | \fI\fP از سرگیری بارگیری مشخص‌شده توسط \fI\fR یا \fI\fR. برای دریافت مقدار از دستور \fBshow\fR استفاده کنید. .SS_untranslated Search \fI\fP [\fI\fP] \fI\fR انجام جستجو برای \fI\fR داده‌شده. مشخص کردن نوع جستجو و کلیدواژه برای این کار الزامی است. مثال: `search kad amule` یک جستجوی kad برای `amule` انجام می‌دهد. انواع جستجوی موجود: .RS .IP Global 10 انجام جستجوی سراسری (Global). .IP Kad 10 انجام جستجو روی شبکه کادملیا (Kademlia). .IP Local 10 انجام جستجوی محلی (Local). .RE .PP فیلترهای اختیاری را می‌توان قبل، بعد یا در میان کلیدواژه(های) جستجو قرار داد: .RS .IP "\fB\-\-type\fR \fI\fR" 4 محدود کردن نتایج به نوع فایل داده‌شده. .IP "\fB\-\-extension\fR \fI\fR (نام مستعار: \fB\-\-ext\fR)" 4 محدود کردن نتایج به یک پسوند فایل مشخص (مانند \fIiso\fR، \fImp3\fR). .IP "\fB\-\-avail\fR \fI\fR (نام مستعار: \fB\-\-availability\fR)" 4 حداقل تعداد منابعی (sources) که یک نتیجه باید گزارش کند. .IP "\fB\-\-min\-size\fR \fI\fR" 4 کوچک‌ترین اندازه فایل برای بازگرداندن. پسوندها از ضرایب دودویی استفاده می‌کنند (K = 1024، M = K\(mu1024، G = M\(mu1024)؛ نبود پسوند به معنای بایت است. .IP "\fB\-\-max\-size\fR \fI\fR" 4 بزرگ‌ترین اندازه فایل برای بازگرداندن. همان پسوندهای \fB\-\-min\-size\fR. .RE .PP مثال: `search global linux iso \-\-type Iso \-\-min-size 100M` نتایجی را برای \(lqlinux iso\(rq با نوع فایل Iso و با اندازه حداقل 100 مبی‌بایت (MiB) برمی‌گرداند. .SS_untranslated Set \fI\fR تنظیم مقدار یک گزینه در تنظیمات. مقادیر موجود برای \fI\fR: .RS .IP BwLimits 10 تنظیم محدودیت‌های پهنای باند. .IP IPFilter 10 تنظیم اولویت‌ها و پیکربندی IPFilter. .RE .SS_untranslated Show \fI\fR نمایش صف بارگذاری/بارگیری، فهرست سرورها یا فهرست فایل‌های هم‌رسانی‌شده. مقادیر موجود برای \fI\fR: .RS .IP DL 10 نمایش صف بارگیری (دانلود). .IP Log 10 نمایش گزارش (log). .IP Servers 10 نمایش فهرست سرورها. .IP Shared 10 نمایش فهرست فایل‌های هم‌رسانی‌شده. .IP UL 10 نمایش صف بارگذاری (آپلود). .RE .SS_untranslated Shutdown خاموش کردن هسته در حال اجرای راه دور (amule/amuled). این کار کلاینت متنی را نیز خواهد بست، زیرا بدون هسته در حال اجرا بلااستفاده است. .SS_untranslated Statistics [ \fI\fP ] نمایش درخت آمار. مقدار اختیاری \fI\fR در بازه 0-255 می‌تواند به عنوان آرگومان به این دستور داده شود، که مشخص می‌کند چه تعداد از مدخل‌های زیردرخت نسخه کلاینت باید نمایش داده شوند. ارسال 0 یا حذف آن به معنای «نامحدود» است. مثال: `statistics 5` فقط ۵ نسخه برتر برای هر نوع کلاینت را نمایش می‌دهد. .SS_untranslated Status نمایش وضعیت اتصال، سرعت‌های فعلی بارگذاری/بارگیری و غیره. .SH "نکات (NOTES)" .SS "مسیرها (Paths)" برای تمامی گزینه‌هایی که مقدار \fI\fR دریافت می‌کنند، اگر \fIpath\fR شامل هیچ بخش پوشه‌ای نباشد (یعنی فقط یک نام فایل ساده باشد)، در این صورت فرض می‌شود که در پوشه پیکربندی aMule یعنی \fI~/.aMule\fR قرار دارد. .SS "زبان‌ها (Languages)" پارامتر \fI\fR برای گزینه \fB\-l\fR ساختاری به شکل زیر دارد: \fIlang\fR[\fB_\fILANG\fR][\fB.\fIencoding\fR][\fB@\fImodifier\fR] که در آن \fIlang\fR زبان اصلی، \fILANG\fR زیرزبان/منطقه جغرافیایی، \fIencoding\fR مجموعه نویسه (character set) مورد استفاده و \fImodifier\fR به کاربر امکان می‌دهد نمونه خاصی از داده‌های محلی‌سازی را در یک دسته‌بندی منفرد انتخاب کند. برای مثال، رشته‌های زیر معتبر هستند: .RS .RB_untranslated de .br .RB_untranslated de_DE .br .RB_untranslated de_DE.iso88591 .br .RB_untranslated de_DE@euro .br .RB_untranslated de_DE.iso88591@euro .RE اگرچه تمامی رشته‌های بالا به عنوان تعاریف معتبر زبان پذیرفته می‌شوند، \fIencoding\fR و \fImodifier\fR هنوز استفاده نمی‌شوند. علاوه بر ساختار بالا، می‌توانید نام‌های کامل زبان‌ها را به زبان انگلیسی نیز مشخص کنید \- بنابراین \fB\-l german\fR نیز معتبر بوده و برابر با \fB\-l de_DE\fR است. هنگامی که هیچ محلی‌سازی‌ای (locale) تعریف نشده باشد، چه در خط فرمان و چه در فایل پیکربندی، زبان پیش‌فرض سیستم استفاده خواهد شد. .SH "فایل‌ها (FILES)" ~/.aMule/remote.conf .SH "مثال‌ها (EXAMPLES)" به‌طور معمول amulecmd برای بار اول به این صورت اجرا می‌شود: .PP \fBamulecmd\fR \fB\-h\fR \fIhostname\fR \fB\-p\fR \fIECport\fR \fB\-P\fR \fIECpassword\fR \fB\-w\fR .PP یا .PP \fBamulecmd\fR \fB\-\-create-config-from\fR=\fI/home/username/.aMule/amule.conf\fR .PP این دستورات تنظیمات را در \fI$HOME/.aMule/remote.conf\fR ذخیره می‌کنند، و بعداً تنها نیاز است وارد کنید: .B_untranslated amulecmd البته، شما مجبور نیستید این مثال را دنبال کنید. .SH "گزارش باگ‌ها (REPORTING BUGS)" لطفاً باگ‌ها را در انجمن گفتگوی ما (\fIhttps://github.com/amule-org/amule/discussions\fR) یا در سامانه ردیابی باگ ما (\fIhttps://github.com/amule-org/amule/issues\fR) گزارش دهید. لطفاً باگ‌ها را از طریق ایمیل، نه به فهرست پستی ما و نه مستقیماً به هیچ‌یک از اعضای تیم ارسال نکنید. .SH "کپی‌رایت (COPYRIGHT)" برنامه aMule و تمامی ابزارهای وابسته به آن تحت مجوز عمومی همگانی گنو (GNU General Public License) توزیع می‌شوند. .SH "همچنین ببینید (SEE ALSO)" .B_untranslated amule\fR(1), \fBamuled\fR(1) .SH "نویسندگان (AUTHORS)" این صفحه راهنما توسط Vollstrecker نوشته شده است.