.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "ARIA2C" "1" "Nov 15, 2023" "1.37.0" "aria2" .SH NAME aria2c \- ابزار فوقالعاده سریع دانلود فایل .SH "خلاصه دستور (SYNOPSIS)" .sp \fBaria2c\fP [<\fIگزینه‌ها\fP>] [<\fIنشانی\fP>|<\fIمگنت\fP>|<\fIفایل_تورنت\fP>|<\fIفایل_متالینک\fP>] ... .SH "توضیحات (DESCRIPTION)" .sp برنامه aria2 ابزاری برای دانلود فایل‌ها است. پروتکل‌های پشتیبانی‌شده عبارتند از HTTP(S)، FTP، SFTP، BitTorrent و Metalink. ابزار aria2 می‌تواند یک فایل را از چندین منبع/پروتکل مختلف دانلود کرده و تلاش می‌کند از حداکثر پهنای باند دانلود شما بهره ببرد. این ابزار از دانلود هم‌زمان یک فایل از طریق HTTP(S)/FTP/SFTP و BitTorrent پشتیبانی می‌کند، در حالی که داده‌های دانلودشده از طریق HTTP(S)/FTP/SFTP در ازدحام (swarm) بیت‌تورنت آپلود می‌شوند. با استفاده از جمع‌های کنترلی (checksum) قطعات متالینک، aria2 به‌طور خودکار صحت قطعات داده را در حین دانلود فایل اعتبارسنجی می‌کند. .SH "گزینه‌ها (OPTIONS)" .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 بیشتر گزینه‌های مرتبط با FTP برای SFTP نیز قابل استفاده هستند. برخی از گزینه‌ها روی SFTP تأثیری ندارند (مانند \fI\%\-\-ftp\-pasv\fP) .UNINDENT .UNINDENT .SS "گزینه‌های پایه (Basic Options)" .INDENT 0.0 .TP .B \-d, \-\-dir= پوشه ذخیره‌سازی فایل دانلودشده. .UNINDENT .INDENT 0.0 .TP .B \-i, \-\-input\-file= دانلود نشانی‌های (URI) فهرست‌شده در \fBFILE\fP\&. شما می‌توانید با قرار دادن چندین نشانی در یک خط و جدا کردن آن‌ها با نویسه \fBTAB\fP، چندین منبع را برای یک مورد واحد مشخص کنید. علاوه بر این، می‌توان گزینه‌ها را بعد از هر خط نشانی مشخص کرد. خطوط گزینه‌ها باید با یک یا چند نویسه فاصله خالی (\fBSPACE\fP یا \fBTAB\fP) آغاز شوند و در هر خط فقط باید یک گزینه قرار گیرد. فایل‌های ورودی می‌توانند از فشرده‌سازی gzip استفاده کنند. هنگامی که \fBFILE\fP به صورت \fB\-\fP مشخص شود، aria2 ورودی را از \fBstdin\fP می‌خواند. برای جزئیات بیشتر زیربخش \fI\%Input File\fP را ببینید. همچنین گزینه \fI\%\-\-deferred\-input\fP را ببینید. همچنین گزینه \fI\%\-\-save\-session\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-log= نام فایل لاگ (گزارش). اگر \fB\-\fP مشخص شود، لاگ در \fBstdout\fP نوشته می‌شود. اگر رشته خالی (\(dq\(dq) مشخص شود، یا این گزینه حذف گردد، هیچ گزارشی در دیسک نوشته نخواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-j, \-\-max\-concurrent\-downloads= تنظیم حداکثر تعداد دانلودهای هم‌روند برای هر مورد در صف. همچنین گزینه \fI\%\-\-split\fP را ببینید. پیش‌فرض: \fB5\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 گزینه \fI\%\-\-max\-concurrent\-downloads\fP تعداد مواردی را که به‌طور هم‌روند دانلود می‌شوند محدود می‌کند. گزینه‌های \fI\%\-\-split\fP و \fI\%\-\-min\-split\-size\fP بر تعداد اتصال‌ها درون هر مورد اثر می‌گذارند. تصور کنید فایل ورودی دارید (گزینه \fI\%\-\-input\-file\fP را ببینید) مانند این: .INDENT 0.0 .INDENT 3.5 .sp .EX http://example.com/foo http://example.com/bar .EE .UNINDENT .UNINDENT .sp در اینجا ۲ مورد دانلود وجود دارد. اگر مقداری بزرگتر یا مساوی ۲ به \fI\%\-\-max\-concurrent\-downloads\fP داده شود، aria2 می‌تواند این موارد را به‌صورت هم‌زمان دانلود کند. در هر مورد دانلود، می‌توانید تعداد اتصال‌ها را با استفاده از \fI\%\-\-split\fP و/یا \fI\%\-\-min\-split\-size\fP و غیره پیکربندی کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-V, \-\-check\-integrity [true|false] بررسی صحت و یکپارچگی فایل با اعتبارسنجی هش قطعات یا هش کل فایل. این گزینه فقط در دانلودهای بیت‌تورنت، متالینک حاوی جمع‌های کنترلی (checksum)، یا دانلودهای HTTP(S)/FTP همراه با گزینه \fI\%\-\-checksum\fP اثرگذار است. اگر هش‌های قطعات ارائه شده باشند، این گزینه می‌تواند بخش‌های آسیب‌دیده فایل را شناسایی کرده و آن‌ها را دوباره دانلود کند. اگر هش کل فایل ارائه شده باشد، بررسی هش تنها زمانی انجام می‌شود که فایل قبلاً دانلود شده باشد؛ این موضوع از طریق طول فایل تعیین می‌شود. اگر بررسی هش ناموفق باشد، فایل از ابتدا دوباره دانلود می‌شود. اگر هم هش قطعات و هم هش کل فایل ارائه شده باشند، تنها هش قطعات استفاده می‌شود. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-continue [true|false] ادامه دادن دانلود فایلی که بخشی از آن دانلود شده است. از این گزینه برای ازسرگیری دانلودی استفاده کنید که توسط یک مرورگر وب یا برنامه دیگری که فایل‌ها را به‌صورت ترتیبی از ابتدا دانلود می‌کند، آغاز شده است. در حال حاضر این گزینه فقط برای دانلودهای HTTP(S)/FTP کاربرد دارد. .UNINDENT .INDENT 0.0 .TP .B \-h, \-\-help[=|] پیام‌های راهنما با برچسب‌ها طبقه‌بندی شده‌اند. یک برچسب با \fB#\fP شروع می‌شود. به عنوان مثال، برای دریافت راهنمای گزینه‌های دارای برچسب \fB#http\fP عبارت \fB\-\-help=#http\fP را وارد کنید. اگر کلمه‌ای بدون برچسب داده شود، راهنمای گزینه‌هایی که نامشان شامل آن کلمه است چاپ می‌شود. مقادیر موجود: \fB#basic\fP، \fB#advanced\fP، \fB#http\fP، \fB#https\fP، \fB#ftp\fP، \fB#metalink\fP، \fB#bittorrent\fP، \fB#cookie\fP، \fB#hook\fP، \fB#file\fP، \fB#rpc\fP، \fB#checksum\fP، \fB#experimental\fP، \fB#deprecated\fP، \fB#help\fP، \fB#all\fP پیش‌فرض: \fB#basic\fP .UNINDENT .SS "گزینه‌های HTTP/FTP/SFTP (HTTP/FTP/SFTP Options)" .INDENT 0.0 .TP .B \-\-all\-proxy= استفاده از سرور پروکسی برای همه پروتکل‌ها. برای بازنویسی پروکسی از پیش تعریف‌شده، از \(dq\(dq استفاده کنید. همچنین می‌توانید با استفاده از گزینه‌های \fI\%\-\-http\-proxy\fP، \fI\%\-\-https\-proxy\fP و \fI\%\-\-ftp\-proxy\fP این تنظیم را بازنویسی کرده و برای یک پروتکل خاص پروکسی مشخص کنید. این تنظیم بر همه دانلودها تأثیر می‌گذارد. قالب PROXY به‌صورت \fB[http://][USER:PASSWORD@]HOST[:PORT]\fP است. همچنین بخش \fI\%ENVIRONMENT\fP را ببینید. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اگر نام کاربری و گذرواژه در نشانی پروکسی درج شده باشند و همچنین توسط گزینه‌های \fI\-\-{http,https,ftp,all}\-proxy\-{user,passwd}\fP نیز مشخص شده باشند، مقادیری که دیرتر مشخص شوند بر گزینه‌های قبلی اولویت خواهند داشت. برای مثال، اگر در aria2.conf مقدار \fBhttp\-proxy\-user=myname\fP و \fBhttp\-proxy\-passwd=mypass\fP را تعیین کرده باشید و در خط فرمان \fB\-\-http\-proxy=\(dqhttp://proxy\(dq\fP را مشخص کنید، آنگاه پروکسی HTTP با نشانی \fBhttp://proxy\fP و با نام کاربری \fBmyname\fP و گذرواژه \fBmypass\fP اعمال خواهد شد. .sp مثالی دیگر: اگر در خط فرمان \fB\-\-http\-proxy=\(dqhttp://user:pass@proxy\(dq \-\-http\-proxy\-user=\(dqmyname\(dq \-\-http\-proxy\-passwd=\(dqmypass\(dq\fP را مشخص کرده باشید، آنگاه پروکسی HTTP با نشانی \fBhttp://proxy\fP و با نام کاربری \fBmyname\fP و گذرواژه \fBmypass\fP اعمال خواهد شد. .sp یک مثال دیگر: اگر در خط فرمان \fB\-\-http\-proxy\-user=\(dqmyname\(dq \-\-http\-proxy\-passwd=\(dqmypass\(dq \-\-http\-proxy=\(dqhttp://user:pass@proxy\(dq\fP را مشخص کرده باشید، آنگاه پروکسی HTTP با نشانی \fBhttp://proxy\fP و با نام کاربری \fBuser\fP و گذرواژه \fBpass\fP اعمال خواهد شد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-all\-proxy\-passwd= تنظیم گذرواژه برای گزینه \fI\%\-\-all\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-all\-proxy\-user= تنظیم نام کاربری برای گزینه \fI\%\-\-all\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-checksum== تنظیم جمع کنترلی (checksum). مقدار TYPE نوع هش است. انواع هش پشتیبانی‌شده در بخش \fBHash Algorithms\fP خروجی \fBaria2c \-v\fP فهرست شده‌اند. مقدار DIGEST خلاصه هگزادسیمال (hex digest) است. برای مثال، تنظیم خلاصه sha\-1 به این صورت است: \fBsha\-1=0192ba11326fe2298c8cb4de616f4d4140213838\fP این گزینه فقط برای دانلودهای HTTP(S)/FTP اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-connect\-timeout= تنظیم مهلت زمان اتصال (connect timeout) به ثانیه برای برقراری ارتباط با سرور HTTP/FTP/پروکسی. پس از برقراری اتصال، این گزینه بی‌اثر شده و به‌جای آن گزینه \fI\%\-\-timeout\fP استفاده می‌شود. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-\-dry\-run [true|false] اگر مقدار \fBtrue\fP داده شود، aria2 صرفاً در دسترس بودن فایل دوردست را بررسی می‌کند و داده‌ای را دانلود نمی‌کند. این گزینه بر دانلودهای HTTP/FTP اثر دارد. در صورت تعیین \fBtrue\fP، دانلودهای بیت‌تورنت لغو می‌شوند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-lowest\-speed\-limit= بستن اتصال در صورتی که سرعت دانلود کمتر یا مساوی با این مقدار (بایت بر ثانیه) باشد. مقدار \fB0\fP به این معنی است که aria2 محدودیت حداقل سرعت ندارد. می‌توانید پسوند \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). این گزینه بر دانلودهای بیت‌تورنت تأثیری ندارد. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-x, \-\-max\-connection\-per\-server= حداکثر تعداد اتصال‌ها به یک سرور برای هر دانلود. پیش‌فرض: \fB1\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-file\-not\-found= اگر aria2 بدون دریافت حتی یک بایت، وضعیت \(dqfile not found\(dq را به تعداد NUM بار از سرورهای دوردست HTTP/FTP دریافت کند، دانلود را به اجبار ناموفق اعلام می‌کند. برای غیرفعال کردن این گزینه مقدار \fB0\fP را تعیین کنید. این گزینه تنها هنگام استفاده از سرورهای HTTP/FTP مؤثر است. تعداد تلاش‌های مجدد در شمارش \fI\%\-\-max\-tries\fP لحاظ می‌شود، بنابراین آن گزینه نیز باید پیکربندی شود. .sp پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-m, \-\-max\-tries= تنظیم تعداد دفعات تلاش. مقدار \fB0\fP به معنای نامحدود است. همچنین گزینه \fI\%\-\-retry\-wait\fP را ببینید. پیش‌فرض: \fB5\fP .UNINDENT .INDENT 0.0 .TP .B \-k, \-\-min\-split\-size= ابزار aria2 محدوده کمتر از 2*SIZE بایت را تکه نمی‌کند. به عنوان مثال، دانلود یک فایل 20MiB را در نظر بگیرید. اگر مقدار SIZE برابر 10M باشد، aria2 می‌تواند فایل را به ۲ محدوده [0\-10MiB) و [10MiB\-20MiB) تقسیم کرده و با استفاده از ۲ منبع دانلود کند (البته در صورتی که \fI\%\-\-split\fP >= 2 باشد). اگر مقدار SIZE برابر 15M باشد، چون 2*15M > 20MiB است، aria2 فایل را تقسیم نکرده و آن را با ۱ منبع دانلود می‌کند. می‌توانید پسوند \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). مقادیر ممکن: \fB1M\fP \-\fB1024M\fP پیش‌فرض: \fB20M\fP .UNINDENT .INDENT 0.0 .TP .B \-\-netrc\-path= مشخص کردن مسیر فایل netrc. پیش‌فرض: \fB$(HOME)/.netrc\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 سطح دسترسی فایل netrc. باید 600 باشد. در غیر این صورت، این فایل نادیده گرفته خواهد شد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-n, \-\-no\-netrc [true|false] غیرفعال کردن پشتیبانی از netrc. پشتیبانی از netrc به‌طور پیش‌فرض فعال است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فایل netrc تنها در زمان راه‌اندازی خوانده می‌شود اگر \fI\%\-\-no\-netrc\fP برابر \fBfalse\fP باشد. بنابراین اگر \fI\%\-\-no\-netrc\fP در زمان راه‌اندازی \fBtrue\fP باشد، در طول کل نشست هیچ netrc در دسترسی نخواهد بود. شما نمی‌توانید netrc را فعال کنید حتی اگر با استفاده از \fI\%aria2.changeGlobalOption()\fP مقدار \fI\%\-\-no\-netrc=false\fP را ارسال نمایید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-no\-proxy= مشخص کردن فهرستی از نام‌های میزبان، دامنه‌ها و آدرس‌های شبکه با یا بدون ماسک زیرشبکه (subnet mask) جداشده با کاما، که نباید برای آن‌ها از پروکسی استفاده شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 برای آدرس‌های شبکه دارای ماسک زیرشبکه، هر دو نوع آدرس IPv4 و IPv6 پشتیبانی می‌شوند. پیاده‌سازی فعلی نام میزبان موجود در نشانی (URI) را برای مقایسه با آدرس‌های شبکه تعیین‌شده در \fI\%\-\-no\-proxy\fP تحلیل (resolve) نمی‌کند؛ بنابراین این ویژگی تنها در صورتی مؤثر است که نشانی شامل آدرس‌های IP عددی باشد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-out= نام فایل دانلودشده. این نام همیشه نسبت به پوشه داده‌شده در گزینه \fI\%\-\-dir\fP در نظر گرفته می‌شود. هنگامی که از گزینه \fI\%\-\-force\-sequential\fP استفاده شود، این گزینه نادیده گرفته می‌شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 شما نمی‌توانید برای دانلودهای متالینک یا بیت‌تورنت نام فایل مشخص کنید. نام فایل مشخص‌شده در اینجا تنها زمانی استفاده می‌شود که نشانی‌های ارائه‌شده به aria2 مستقیماً در خط فرمان داده شده باشند، نه زمانی که از گزینه \fI\%\-\-input\-file\fP یا \fI\%\-\-force\-sequential\fP استفاده شود. .sp مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-o myfile.zip \(dqhttp://mirror1/file.zip\(dq \(dqhttp://mirror2/file.zip\(dq .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-proxy\-method= تنظیم متد مورداستفاده در درخواست پروکسی. مقدار METHOD می‌تواند \fBget\fP یا \fBtunnel\fP باشد. دانلودهای HTTPS صرف‌نظر از این گزینه همیشه از \fBtunnel\fP استفاده می‌کنند. پیش‌فرض: \fBget\fP .UNINDENT .INDENT 0.0 .TP .B \-R, \-\-remote\-time [true|false] دریافت برچسب زمان (timestamp) فایل دوردست از سرور HTTP/FTP دوردست و اعمال آن روی فایل محلی در صورت در دسترس بودن. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-reuse\-uri [true|false] استفاده مجدد از نشانی‌های استفاده‌شده قبلی در صورتی که هیچ نشانی استفاده‌نشده‌ای باقی نمانده باشد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-retry\-wait= تنظیم ثانیه‌های انتظار میان تلاش‌های مجدد. هنگامی که \fBSEC > 0\fP باشد، در صورتی که سرور HTTP پاسخ 503 برگرداند، aria2 دانلود را مجدداً تلاش خواهد کرد. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-server\-stat\-of= مشخص کردن نام فایلی که نمایه کارایی (performance profile) سرورها در آن ذخیره می‌شود. می‌توانید داده‌های ذخیره‌شده را با استفاده از گزینه \fI\%\-\-server\-stat\-if\fP بارگذاری کنید. برای قالب فایل، زیربخش \fI\%Server Performance Profile\fP در زیر را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-server\-stat\-if= مشخص کردن نام فایل برای بارگذاری نمایه کارایی سرورها. داده‌های بارگذاری‌شده در برخی انتخاب‌کننده‌های نشانی مانند \fBfeedback\fP استفاده خواهند شد. همچنین گزینه \fI\%\-\-uri\-selector\fP را ببینید. برای قالب فایل، زیربخش \fI\%Server Performance Profile\fP در زیر را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-server\-stat\-timeout= مشخص کردن مهلت زمانی به ثانیه برای باطل کردن نمایه کارایی سرورها از زمان آخرین تماس با آن‌ها. پیش‌فرض: \fB86400\fP (۲۴ ساعت) .UNINDENT .INDENT 0.0 .TP .B \-s, \-\-split= دانلود یک فایل با استفاده از N اتصال. اگر بیش از N نشانی داده شود، ابتدا N نشانی اول استفاده شده و نشانی‌های باقی‌مانده برای پشتیبان به کار می‌روند. اگر کمتر از N نشانی داده شود، آن نشانی‌ها بیش از یک بار استفاده می‌شوند تا در مجموع N اتصال به‌طور هم‌زمان برقرار شود. تعداد اتصال‌ها به یک میزبان واحد توسط گزینه \fI\%\-\-max\-connection\-per\-server\fP محدود می‌شود. همچنین گزینه \fI\%\-\-min\-split\-size\fP را ببینید. پیش‌فرض: \fB5\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 برخی فایل‌های متالینک تعداد سرورهای مجاز برای اتصال را تعیین می‌کنند. aria2 دقیقاً به آن‌ها احترام می‌گذارد. این بدان معناست که اگر متالینک ویژگی \fBmaxconnections\fP را کمتر از N تعریف کرده باشد، آنگاه aria2 به‌جای N از این مقدار کمتر استفاده خواهد کرد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-stream\-piece\-selector= مشخص کردن الگوریتم انتخاب قطعه در دانلودهای HTTP/FTP. یک قطعه (piece) بخشی با طول ثابت است که در دانلود چندتکه‌ای به‌صورت موازی دانلود می‌شود. پیش‌فرض: \fBdefault\fP\&. .INDENT 7.0 .TP .B default انتخاب قطعه به گونه‌ای که تعداد اتصال‌های برقرارشده کاهش یابد. این یک رفتار پیش‌فرض منطقی است چرا که برقراری اتصال یک عملیات هزینه‌بر محسوب می‌شود. .TP .B inorder انتخاب قطعه‌ای که به ابتدای فایل نزدیک‌تر است. این برای تماشای فیلم هم‌زمان با دانلود مفید است. گزینه \fI\%\-\-enable\-http\-pipelining\fP ممکن است برای کاهش بار اضافی اتصال‌های مجدد سودمند باشد. توجه داشته باشید که aria2 گزینه \fI\%\-\-min\-split\-size\fP را رعایت می‌کند، بنابراین لازم است مقدار معقولی برای گزینه \fI\%\-\-min\-split\-size\fP تعیین شود. .TP .B random انتخاب تصادفی یک قطعه. همانند \fBinorder\fP، گزینه \fI\%\-\-min\-split\-size\fP نیز رعایت می‌شود. .TP .B geom هنگام شروع دانلود فایل، مانند \fBinorder\fP قطعه‌ای را انتخاب می‌کند که به ابتدای فایل نزدیک‌تر است، اما سپس فاصله بین قطعات را به‌صورت تصاعدی افزایش می‌دهد. این کار تعداد اتصالات برقرارشده را کاهش می‌دهد، در حالی که هم‌زمان بخش ابتدایی فایل را زودتر دانلود می‌کند. این حالت برای تماشای فیلم هنگام دانلود بسیار مفید است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-t, \-\-timeout= تنظیم مهلت زمانی (timeout) به ثانیه. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-\-uri\-selector= مشخص کردن الگوریتم انتخاب نشانی (URI). مقادیر ممکن عبارتند از \fBinorder\fP، \fBfeedback\fP و \fBadaptive\fP\&. اگر \fBinorder\fP داده شود، نشانی‌ها به همان ترتیبی که در فهرست ظاهر شده‌اند آزمایش می‌شوند. اگر \fBfeedback\fP داده شود، aria2 از سرعت دانلود مشاهده‌شده در دانلودهای پیشین استفاده کرده و سریع‌ترین سرور را در فهرست نشانی‌ها انتخاب می‌کند. این کار همچنین آینه‌های (mirrors) از کار افتاده را رد می‌کند. سرعت دانلود مشاهده‌شده بخشی از نمایه کارایی سرورها است که در گزینه‌های \fI\%\-\-server\-stat\-of\fP و \fI\%\-\-server\-stat\-if\fP به آن اشاره شد. اگر \fBadaptive\fP داده شود، یکی از بهترین آینه‌ها را برای اتصال‌های اول و ذخیره انتخاب می‌کند. برای اتصال‌های تکمیلی، آینه‌هایی را برمی‌گرداند که هنوز آزمایش نشده‌اند، و اگر همه آن‌ها قبلاً آزمایش شده باشند، آینه‌هایی را برمی‌گرداند که باید مجدداً آزمایش شوند. در غیر این صورت، دیگر آینه‌ای انتخاب نمی‌کند. این حالت مانند \fBfeedback\fP، از نمایه کارایی سرورها بهره می‌برد. پیش‌فرض: \fBfeedback\fP .UNINDENT .SS "گزینه‌های اختصاصی HTTP (HTTP Specific Options)" .INDENT 0.0 .TP .B \-\-ca\-certificate= استفاده از مراجع صدور گواهی (CA) موجود در FILE برای اعتبارسنجی همتایان (peers). فایل گواهی باید در قالب PEM باشد و می‌تواند شامل چندین گواهی CA باشد. برای فعال‌سازی اعتبارسنجی از گزینه \fI\%\-\-check\-certificate\fP استفاده کنید. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اگر برنامه را با OpenSSL یا نسخه‌های جدید GnuTLS که دارای تابع \fBgnutls_certificate_set_x509_system_trust()\fP هستند بسازید و کتابخانه به درستی برای یافتن مخزن گواهی‌های CA در سطح سیستم پیکربندی شده باشد، aria2 به‌طور خودکار آن گواهی‌ها را هنگام راه‌اندازی بارگذاری می‌کند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 گزینه‌های \fIWinTLS\fP و \fIAppleTLS\fP از این گزینه پشتیبانی نمی‌کنند. در عوض باید گواهی را در مخزن مورد اعتماد سیستم‌عامل وارد (import) کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-certificate= استفاده از گواهی کلاینت موجود در FILE. گواهی باید در قالب PKCS12 (.p12, .pfx) یا PEM باشد. .sp فایل‌های PKCS12 باید حاوی گواهی، کلید و اختیاری زنجیره‌ای از گواهی‌های اضافی باشند. فقط فایل‌های PKCS12 با گذرواژه واردسازی (import) خالی قابل باز شدن هستند! .sp هنگام استفاده از PEM، باید کلید خصوصی را نیز از طریق \fI\%\-\-private\-key\fP مشخص کنید. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 در حال حاضر \fIWinTLS\fP از فایل‌های PEM پشتیبانی نمی‌کند. کاربران باید از فایل‌های PKCS12 استفاده کنند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 کاربران \fIAppleTLS\fP باید از ابزار Keychain Access برای وارد کردن گواهی کلاینت استفاده کنند و اثر انگشت SHA\-1 را از کادر گفتگوی اطلاعات مربوط به آن گواهی به دست آورند. برای شروع aria2c از \fI\-\-certificate=\fP استفاده کنید. به عنوان روش دیگر، فایل‌های PKCS12 نیز پشتیبانی می‌شوند؛ با این حال، فایل‌های PEM پشتیبانی نمی‌شوند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-check\-certificate [true|false] اعتبارسنجی همتا با استفاده از گواهی‌های مشخص‌شده در گزینه \fI\%\-\-ca\-certificate\fP\&. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-http\-accept\-gzip [true|false] ارسال سربرگ درخواست \fBAccept\-Encoding: deflate, gzip\fP و از حالت فشرده خارج کردن پاسخ در صورتی که سرور دوردست با \fBContent\-Encoding: gzip\fP یا \fBContent\-Encoding: deflate\fP پاسخ دهد. پیش‌فرض: \fBfalse\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 برخی سرورها برای فایل‌هایی که خودشان فایل فشرده gzipped هستند نیز با \fBContent\-Encoding: gzip\fP پاسخ می‌دهند. ابزار aria2 به دلیل سربرگ پاسخ دریافتی، در هر صورت آن‌ها را از حالت فشرده خارج می‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-http\-auth\-challenge [true|false] ارسال سربرگ احراز هویت HTTP تنها زمانی که توسط سرور درخواست شده باشد. اگر روی \fBfalse\fP تنظیم شود، سربرگ احراز هویت همیشه به سرور ارسال می‌گردد. یک استثنا وجود دارد: اگر نام کاربری و گذرواژه در نشانی (URI) قرار داده شده باشند، صرف‌نظر از این گزینه سربرگ احراز هویت همیشه به سرور ارسال می‌شود. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-http\-no\-cache [true|false] ارسال سربرگ‌های \fBCache\-Control: no\-cache\fP و \fBPragma: no\-cache\fP برای جلوگیری از محتوای کش‌شده. اگر مقدار \fBfalse\fP داده شود، این سربرگ‌ها ارسال نمی‌شوند و شما می‌توانید با استفاده از گزینه \fI\%\-\-header\fP سربرگ Cache\-Control را با دستورالعمل دلخواه خود اضافه کنید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-http\-user= تنظیم نام کاربری HTTP. این بر تمامی نشانی‌ها اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-http\-passwd= تنظیم گذرواژه HTTP. این بر تمامی نشانی‌ها اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-http\-proxy= استفاده از یک سرور پروکسی برای HTTP. برای بازنویسی پروکسی تعریف‌شده قبلی، از \(dq\(dq استفاده کنید. همچنین گزینه \fI\%\-\-all\-proxy\fP را ببینید. این بر تمامی دانلودهای HTTP اثر می‌گذارد. قالب PROXY به‌صورت \fB[http://][USER:PASSWORD@]HOST[:PORT]\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-http\-proxy\-passwd= تنظیم گذرواژه برای \fI\%\-\-http\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-http\-proxy\-user= تنظیم نام کاربری برای \fI\%\-\-http\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-https\-proxy= استفاده از سرور پروکسی برای HTTPS. برای بازنویسی پروکسی تعریف‌شده قبلی، از \(dq\(dq استفاده کنید. همچنین گزینه \fI\%\-\-all\-proxy\fP را ببینید. این بر تمامی دانلودهای HTTPS اثر می‌گذارد. قالب PROXY به‌صورت \fB[http://][USER:PASSWORD@]HOST[:PORT]\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-https\-proxy\-passwd= تنظیم گذرواژه برای \fI\%\-\-https\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-https\-proxy\-user= تنظیم نام کاربری برای \fI\%\-\-https\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-private\-key= استفاده از کلید خصوصی موجود در FILE. کلید خصوصی باید رمزگشایی‌شده و در قالب PEM باشد. کلید رمزنگاری‌شده ممکن است رفتارهای تعریف‌نشده ایجاد کند. همچنین گزینه \fI\%\-\-certificate\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-referer= تنظیم ارجاع‌دهنده HTTP (سربرگ Referer). این بر تمامی دانلودهای HTTP/HTTPS اعمال می‌شود. اگر \fB*\fP داده شود، خود نشانی دانلود نیز به عنوان ارجاع‌دهنده استفاده می‌شود. این ممکن است هنگام استفاده همراه با گزینه \fI\%\-\-parameterized\-uri\fP سودمند باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-http\-keep\-alive [true|false] فعال‌سازی اتصال پایدار (persistent connection) در HTTP/1.1. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-http\-pipelining [true|false] فعال‌سازی خط‌لوله‌سازی (pipelining) در HTTP/1.1. پیش‌فرض: \fBfalse\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 معمولاً فعال‌سازی این گزینه بهبودی در عملکرد و کارایی ایجاد نمی‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-header=
افزودن HEADER به سربرگ درخواست HTTP. می‌توانید از این گزینه به‌طور مکرر برای تعیین بیش از یک سربرگ استفاده کنید: .INDENT 7.0 .INDENT 3.5 .sp .EX $ aria2c \-\-header=\(dqX\-A: b78\(dq \-\-header=\(dqX\-B: 9J1\(dq \(dqhttp://host/file\(dq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-load\-cookies= بارگذاری کوکی‌ها از FILE با استفاده از قالب فایرفاکس ۳ (SQLite3)، کرومیوم/گوگل کروم (SQLite3) و قالب موزیلا/فایرفاکس(1.x/2.x)/نت‌اسکیپ. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اگر aria2 بدون libsqlite3 ساخته شده باشد، از قالب کوکی‌های فایرفاکس ۳ و کرومیوم/گوگل کروم پشتیبانی نمی‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-save\-cookies= ذخیره کوکی‌ها در FILE با قالب موزیلا/فایرفاکس(1.x/2.x)/نت‌اسکیپ. اگر FILE از قبل وجود داشته باشد، بازنویسی می‌شود. کوکی‌های نشست (Session Cookies) نیز ذخیره می‌شوند و زمان انقضای آن‌ها 0 در نظر گرفته می‌شود. مقادیر ممکن: \fB/path/to/file\fP .UNINDENT .INDENT 0.0 .TP .B \-\-use\-head [true|false] استفاده از متد HEAD برای اولین درخواست به سرور HTTP. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-no\-want\-digest\-header [true|false] تعیین غیرفعال کردن سربرگ Want\-Digest هنگام ارسال درخواست‌ها. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-U, \-\-user\-agent= تنظیم عامل کاربر (User Agent) برای دانلودهای HTTP(S). پیش‌فرض: \fBaria2/$VERSION\fP، مقدار $VERSION با نسخه بسته جایگزین می‌شود. .UNINDENT .SS "گزینه‌های اختصاصی FTP/SFTP (FTP/SFTP Specific Options)" .INDENT 0.0 .TP .B \-\-ftp\-user= تنظیم نام کاربری FTP. این بر تمامی نشانی‌ها اعمال می‌شود. پیش‌فرض: \fBanonymous\fP .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-passwd= تنظیم گذرواژه FTP. این بر تمامی نشانی‌ها اعمال می‌شود. اگر نام کاربری در نشانی درج شده باشد اما گذرواژه نباشد، aria2 تلاش می‌کند گذرواژه را از طریق netrc. بیابد. اگر گذرواژه در netrc. یافت شود، از آن استفاده می‌کند. در غیر این صورت، از گذرواژه مشخص‌شده در این گزینه استفاده خواهد شد. پیش‌فرض: \fBARIA2USER@\fP .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-ftp\-pasv [true|false] استفاده از حالت غیرفعال (Passive) در FTP. اگر \fBfalse\fP داده شود، از حالت فعال (Active) استفاده خواهد شد. پیش‌فرض: \fBtrue\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه برای انتقال‌های SFTP نادیده گرفته می‌شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-proxy= استفاده از سرور پروکسی برای FTP. برای بازنویسی پروکسی تعریف‌شده قبلی، از \(dq\(dq استفاده کنید. همچنین گزینه \fI\%\-\-all\-proxy\fP را ببینید. این بر تمامی دانلودهای FTP اثر می‌گذارد. قالب PROXY به‌صورت \fB[http://][USER:PASSWORD@]HOST[:PORT]\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-proxy\-passwd= تنظیم گذرواژه برای گزینه \fI\%\-\-ftp\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-proxy\-user= تنظیم نام کاربری برای گزینه \fI\%\-\-ftp\-proxy\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-type= تنظیم نوع انتقال FTP. مقدار TYPE می‌تواند \fBbinary\fP یا \fBascii\fP باشد. پیش‌فرض: \fBbinary\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه برای انتقال‌های SFTP نادیده گرفته می‌شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-ftp\-reuse\-connection [true|false] استفاده مجدد از اتصال در FTP. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-ssh\-host\-key\-md== تنظیم جمع کنترلی (checksum) برای کلید عمومی میزبان SSH. مقدار TYPE نوع هش است. انواع هش پشتیبانی‌شده \fBsha\-1\fP یا \fBmd5\fP هستند. مقدار DIGEST خلاصه هگزادسیمال است. برای مثال: \fBsha\-1=b030503d4de4539dc7885e6f0f5e256704edf4c3\fP\&. از این گزینه می‌توان برای اعتبارسنجی کلید عمومی سرور هنگام استفاده از SFTP استفاده کرد. اگر این گزینه تنظیم نشود (که حالت پیش‌فرض است)، هیچ اعتبارسنجی انجام نمی‌گیرد. .UNINDENT .SS "گزینه‌های BitTorrent/Metalink (BitTorrent/Metalink Options)" .INDENT 0.0 .TP .B \-\-select\-file=... مشخص کردن فایل برای دانلود با استفاده از شناسه (اندیس) آن. می‌توانید شناسه فایل را با استفاده از گزینه \fI\%\-\-show\-files\fP بیابید. می‌توانید چندین شناسه را با استفاده از \fB,\fP مشخص کنید، مثلاً: \fB3,6\fP\&. همچنین می‌توانید از \fB\-\fP برای مشخص کردن یک بازه استفاده کنید: \fB1\-5\fP\&. می‌توان \fB,\fP و \fB\-\fP را با یکدیگر به کار برد: \fB1\-5,8,9\fP\&. هنگامی که همراه با گزینه \-M استفاده شود، شناسه ممکن است بسته به پرس‌وجو متغیر باشد (گزینه‌های \fI\-\-metalink\-*\fP را ببینید). .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 در تورنت‌های چندفایلی، ممکن است فایل‌های مجاور مشخص‌شده با این گزینه نیز دانلود شوند. این یک ویژگی طراحی است و باگ محسوب نمی‌شود. یک قطعه منفرد ممکن است شامل چندین فایل یا بخشی از فایل‌ها باشد و aria2 قطعه دانلودشده را در فایل‌های مربوطه می‌نویسد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-S, \-\-show\-files [true|false] چاپ فهرست فایل‌های موجود در فایل‌های \(dq.torrent\(dq، \(dq.meta4\(dq و \(dq.metalink\(dq و سپس خروج. در مورد فایل‌های \(dq.torrent\(dq، اطلاعات بیشتر (infohash، طول قطعه و غیره) نیز چاپ خواهد شد. .UNINDENT .SS "گزینه‌های اختصاصی بیت‌تورنت (BitTorrent Specific Options)" .INDENT 0.0 .TP .B \-\-bt\-detach\-seed\-only [true|false] استثنا کردن دانلودهایی که صرفاً سید (seed) هستند هنگام شمارش دانلودهای فعال هم‌زمان (گزینه \fI\%\-j\fP را ببینید). این بدان معناست که اگر \fB\-j3\fP داده شود و این گزینه فعال باشد و ۳ دانلود فعال باشند و یکی از آن‌ها وارد حالت سید شود، از شمارش دانلودهای فعال مستثنا می‌گردد (در نتیجه به ۲ تبدیل می‌شود) و دانلود بعدی که در صف منتظر است آغاز می‌شود. اما توجه داشته باشید که آیتم در حال سید همچنان در متد RPC به عنوان دانلود فعال شناخته می‌شود. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-enable\-hook\-after\-hash\-check [true|false] اجازه فراخوانی دستور هوک (hook) پس از بررسی هش (گزینه \fI\%\-V\fP را ببینید) در دانلود بیت‌تورنت. به‌طور پیش‌فرض، زمانی که بررسی هش با موفقیت انجام شود، دستور ارائه‌شده توسط \fI\%\-\-on\-bt\-download\-complete\fP اجرا می‌شود. برای غیرفعال کردن این رفتار، مقدار \fBfalse\fP را به این گزینه بدهید. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-enable\-lpd [true|false] فعال کردن کشف همتای محلی (Local Peer Discovery). اگر فلگ خصوصی (private) در یک تورنت تنظیم شده باشد، aria2 حتی در صورت مشخص شدن \fBtrue\fP از این ویژگی برای آن دانلود استفاده نمی‌کند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-exclude\-tracker=[,...] فهرست جداشده با کاما از نشانی‌های (URI) اعلام ترکر بیت‌تورنت جهت حذف. می‌توانید از مقدار ویژه \fB*\fP استفاده کنید که با تمام نشانی‌ها مطابقت دارد و در نتیجه تمام نشانی‌های اعلام را حذف می‌کند. هنگام مشخص کردن \fB*\fP در خط فرمان شل، اسکیپ کردن یا قرار دادن آن در نقل‌قول را فراموش نکنید. همچنین گزینه \fI\%\-\-bt\-tracker\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-external\-ip= مشخص کردن آدرس IP خارجی برای استفاده در دانلود بیت‌تورنت و DHT. این آدرس ممکن است به ترکر بیت‌تورنت ارسال شود. برای DHT، این گزینه باید تنظیم شود تا گزارش دهد گره محلی در حال دانلود یک تورنت مشخص است. این امر برای استفاده از DHT در یک شبکه خصوصی حیاتی است. اگرچه این تابع \fBexternal\fP نامیده شده است، اما می‌تواند هر نوع آدرس IP را بپذیرد. .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-force\-encryption [true|false] رمزگذاری بار داده پیام‌های بیت‌تورنت با arc4 را الزامی می‌کند. این یک شکل خلاصه از \fI\%\-\-bt\-require\-crypto\fP \fI\%\-\-bt\-min\-crypto\-level\fP=arc4 است. این گزینه مقدار تنظیم‌شده برای آن گزینه‌ها را تغییر نمی‌دهد. اگر \fBtrue\fP داده شود، دست‌تکانی سنتی بیت‌تورنت رد شده و تنها از دست‌تکانی مبهم‌سازی (Obfuscation) استفاده می‌شود و بار داده پیام‌ها همیشه رمزگذاری می‌گردد. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-hash\-check\-seed [true|false] اگر \fBtrue\fP داده شود، پس از بررسی هش با استفاده از گزینه \fI\%\-\-check\-integrity\fP و کامل بودن فایل، به سید کردن فایل ادامه می‌دهد. اگر می‌خواهید فایل را بررسی کنید و تنها در صورت آسیب‌دیدگی یا ناقص بودن آن را دانلود نمایید، این گزینه را روی \fBfalse\fP تنظیم کنید. این گزینه تنها بر دانلود بیت‌تورنت تأثیر دارد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-load\-saved\-metadata [true|false] قبل از دریافت متادیتای تورنت از DHT هنگام دانلود با لینک مگنت، ابتدا تلاش می‌کند فایل ذخیره‌شده توسط گزینه \fI\%\-\-bt\-save\-metadata\fP را بخواند. اگر موفقیت‌آمیز باشد، از دانلود متادیتا از DHT صرف‌نظر می‌شود. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-lpd\-interface= استفاده از رابط مشخص‌شده برای کشف همتای محلی (LPD). اگر این گزینه مشخص نشود، رابط پیش‌فرض انتخاب می‌شود. می‌توانید نام رابط و آدرس IP را مشخص کنید. مقادیر ممکن: interface, IP address .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-max\-open\-files= حداکثر تعداد فایل‌ها برای باز شدن در دانلود چندفایلی بیت‌تورنت/متالینک را به صورت سراسری مشخص می‌کند. پیش‌فرض: \fB100\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-max\-peers= حداکثر تعداد همتاها (peers) به ازای هر تورنت را تعیین می‌کند. مقدار \fB0\fP به معنای نامحدود است. همچنین گزینه \fI\%\-\-bt\-request\-peer\-speed\-limit\fP را ببینید. پیش‌فرض: \fB55\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-metadata\-only [true|false] تنها متادیتا را دانلود می‌کند. فایل(های) توصیف‌شده در متادیتا دانلود نخواهند شد. این گزینه تنها زمانی تأثیر دارد که از نشانی مگنت بیت‌تورنت استفاده شود. همچنین گزینه \fI\%\-\-bt\-save\-metadata\fP را ببینید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-min\-crypto\-level=plain|arc4 تنظیم حداقل سطح روش رمزگذاری. اگر چند روش رمزگذاری توسط یک همتا ارائه شود، aria2 پایین‌ترین موردی را انتخاب می‌کند که سطح داده‌شده را برآورده سازد. پیش‌فرض: \fBplain\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-prioritize\-piece=head[=],tail[=] تلاش برای دانلود قطعات ابتدایی و انتهایی هر فایل در اولویت نخست. این امر برای پیش‌نمایش فایل‌ها کاربرد دارد. این آرگومان می‌تواند شامل ۲ کلمه کلیدی باشد: \fBhead\fP و \fBtail\fP\&. برای استفاده هم‌زمان از هر دو، باید با کاما از هم جدا شوند. این کلمات کلیدی می‌توانند یک پارامتر SIZE دریافت کنند. برای مثال، اگر \fBhead=\fP مشخص شود، قطعات موجود در بازه SIZE بایت نخست از هر فایل اولویت بالاتری دریافت می‌کنند. \fBtail=\fP به معنای بازه SIZE بایت پایانی هر فایل است. مقدار SIZE می‌تواند شامل \fBK\fP یا \fBM\fP باشد (1K = 1024, 1M = 1024K). اگر SIZE مشخص نشود، از مقدار پیش‌فرض SIZE=1M استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-remove\-unselected\-file [true|false] هنگامی که دانلود در بیت‌تورنت تکمیل شد، فایل‌های انتخاب‌نشده را حذف می‌کند. جهت انتخاب فایل‌ها، از گزینه \fI\%\-\-select\-file\fP استفاده کنید. در صورت عدم استفاده از آن، فرض می‌شود که همه فایل‌ها انتخاب شده‌اند. لطفاً با احتیاط از این گزینه استفاده کنید زیرا این کار واقعاً فایل‌ها را از دیسک شما پاک می‌کند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-require\-crypto [true|false] اگر \fBtrue\fP داده شود، aria2 اتصال با دست‌تکانی سنتی بیت‌تورنت (\e19BitTorrent protocol) را نمی‌پذیرد و برقرار نمی‌کند. بنابراین aria2 همواره از دست‌تکانی مبهم‌سازی (Obfuscation) استفاده می‌کند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-request\-peer\-speed\-limit= چنانچه سرعت کلی دانلود تمام تورنت‌ها کمتر از SPEED باشد، aria2 موقتاً تعداد همتاها را برای تلاش در جهت دستیابی به سرعت بیشتر افزایش می‌دهد. پیکربندی این گزینه با سرعت دانلود دلخواهتان می‌تواند در برخی موارد سرعت دانلود شما را بالا ببرد. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). پیش‌فرض: \fB50K\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-save\-metadata [true|false] ذخیره متادیتا به عنوان پرونده \(dq.torrent\(dq. این گزینه تنها زمانی اعمال می‌شود که از نشانی مگنت بیت‌تورنت استفاده شود. نام فایل، رشته هگز هش اطلاعات (info hash) به همراه پسوند \(dq.torrent\(dq است. دایرکتوری ذخیره‌سازی، همان دایرکتوری است که فایل دانلودشده در آن ذخیره می‌شود. اگر همان فایل از قبل وجود داشته باشد، متادیتا ذخیره نمی‌شود. همچنین گزینه \fI\%\-\-bt\-metadata\-only\fP را ببینید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-seed\-unverified [true|false] سید کردن فایل‌های از پیش دانلودشده بدون تأیید هش قطعات. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-stop\-timeout= توقف دانلود بیت‌تورنت در صورتی که سرعت دانلود برای SEC ثانیه متوالی برابر 0 باشد. اگر مقدار \fB0\fP داده شود، این ویژگی غیرفعال است. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-tracker=[,...] فهرست جداشده با کاما از نشانی‌های (URI) اعلام ترکر اضافی بیت‌تورنت. این نشانی‌ها تحت تأثیر گزینه \fI\%\-\-bt\-exclude\-tracker\fP قرار نمی‌گیرند زیرا پس از حذف نشانی‌های گزینه \fI\%\-\-bt\-exclude\-tracker\fP اضافه می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-tracker\-connect\-timeout= تنظیم زمان انقضای اتصال بر حسب ثانیه برای برقراری اتصال با ترکر. پس از برقراری اتصال، این گزینه بی‌تأثیر بوده و در عوض از گزینه \fI\%\-\-bt\-tracker\-timeout\fP استفاده می‌شود. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-tracker\-interval= تنظیم بازه زمانی بر حسب ثانیه میان درخواست‌های ترکر. این تنظیم مقدار بازه را کاملاً بازنویسی می‌کند و aria2 صرفاً از همین مقدار استفاده نموده و حداقل بازه و مقدار بازه موجود در پاسخ ترکر را نادیده می‌گیرد. اگر روی \fB0\fP تنظیم شود، aria2 بازه زمانی را بر اساس پاسخ ترکر و پیشرفت دانلود تعیین می‌کند. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-bt\-tracker\-timeout= تنظیم زمان انقضا بر حسب ثانیه. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-entry\-point=: تنظیم میزبان و پورت به عنوان نقطه ورود به شبکه IPv4 DHT. .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-entry\-point6=: تنظیم میزبان و پورت به عنوان نقطه ورود به شبکه IPv6 DHT. .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-file\-path= تغییر فایل جدول مسیریابی IPv4 DHT به PATH. پیش‌فرض: \fB$HOME/.aria2/dht.dat\fP در صورت وجود، در غیر این صورت \fB$XDG_CACHE_HOME/aria2/dht.dat\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-file\-path6= تغییر فایل جدول مسیریابی IPv6 DHT به PATH. پیش‌فرض: \fB$HOME/.aria2/dht6.dat\fP در صورت وجود، در غیر این صورت \fB$XDG_CACHE_HOME/aria2/dht6.dat\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-listen\-addr6= مشخص کردن آدرس جهت مقیدسازی سوکت برای IPv6 DHT. این آدرس باید یک آدرس یونیکست سراسری IPv6 متعلق به میزبان باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-listen\-port=... تنظیم پورت شنود UDP مورد استفاده توسط DHT (IPv4، IPv6) و ترکر UDP. چند پورت را می‌توان با استفاده از \fB,\fP مشخص کرد، برای مثال: \fB6881,6885\fP\&. همچنین می‌توانید از \fB\-\fP برای تعیین یک بازه استفاده کنید: \fB6881\-6999\fP\&. \fB,\fP و \fB\-\fP می‌توانند با یکدیگر استفاده شوند. پیش‌فرض: \fB6881\-6999\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اطمینان حاصل کنید که پورت‌های مشخص‌شده برای ترافیک ورودی UDP باز هستند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-dht\-message\-timeout= تنظیم زمان انقضا بر حسب ثانیه. پیش‌فرض: \fB10\fP .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-dht [true|false] فعال‌سازی قابلیت IPv4 DHT. این گزینه همچنین پشتیبانی از ترکر UDP را فعال می‌کند. اگر فلگ خصوصی در یک تورنت تنظیم شده باشد، aria2 حتی در صورت مشخص شدن \fBtrue\fP از DHT برای آن دانلود استفاده نمی‌کند. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-dht6 [true|false] فعال‌سازی قابلیت IPv6 DHT. اگر فلگ خصوصی در یک تورنت تنظیم شده باشد، aria2 حتی در صورت مشخص شدن \fBtrue\fP برای آن دانلود از DHT استفاده نمی‌کند. از گزینه \fI\%\-\-dht\-listen\-port\fP برای مشخص کردن شماره پورت جهت شنود استفاده کنید. همچنین گزینه \fI\%\-\-dht\-listen\-addr6\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-peer\-exchange [true|false] فعال‌سازی افزونه تبادل همتا (Peer Exchange یا PEX). اگر فلگ خصوصی در یک تورنت تنظیم شده باشد، این ویژگی برای آن دانلود غیرفعال خواهد بود حتی اگر \fBtrue\fP داده شود. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-follow\-torrent=true|false|mem اگر \fBtrue\fP یا \fBmem\fP مشخص شود، هنگامی که فایلی با پسوند \fB\&.torrent\fP یا نوع محتوای \fBapplication/x\-bittorrent\fP دانلود گردد، aria2 آن را به عنوان فایل تورنت پردازش کرده و فایل‌های نام‌برده در آن را دانلود می‌کند. اگر \fBmem\fP مشخص شود، فایل تورنت بر روی دیسک نوشته نشده و تنها در حافظه نگه‌داری می‌شود. اگر \fBfalse\fP مشخص شود، فایل \fB\&.torrent\fP بر روی دیسک دانلود می‌شود، اما به عنوان تورنت پردازش نشده و محتویات آن دانلود نخواهند شد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-O, \-\-index\-out== تنظیم مسیر فایل برای فایل با index=INDEX. می‌توانید ایندکس فایل را با استفاده از گزینه \fI\%\-\-show\-files\fP پیدا کنید. PATH یک مسیر نسبی نسبت به مسیر مشخص‌شده در گزینه \fI\%\-\-dir\fP است. می‌توانید از این گزینه چندین بار استفاده کنید. با استفاده از این گزینه، می‌توانید نام فایل‌های خروجی دانلودهای بیت‌تورنت را مشخص کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-listen\-port=... تنظیم شماره پورت TCP برای دانلودهای بیت‌تورنت. چندین پورت را می‌توان با استفاده از \fB,\fP مشخص کرد، برای مثال: \fB6881,6885\fP\&. همچنین می‌توانید از \fB\-\fP برای تعیین یک محدوده استفاده کنید: \fB6881\-6999\fP\&. \fB,\fP و \fB\-\fP می‌توانند همراه یکدیگر استفاده شوند: \fB6881\-6889,6999\fP\&. پیش‌فرض: \fB6881\-6999\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اطمینان حاصل کنید که پورت‌های مشخص‌شده برای ترافیک ورودی TCP باز هستند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-max\-overall\-upload\-limit= تنظیم حداکثر سرعت آپلود کلی بر حسب بایت/ثانیه. مقدار \fB0\fP به معنای نامحدود است. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). جهت محدود کردن سرعت آپلود به ازای هر تورنت، از گزینه \fI\%\-\-max\-upload\-limit\fP استفاده کنید. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-u, \-\-max\-upload\-limit= تنظیم حداکثر سرعت آپلود به ازای هر تورنت بر حسب بایت/ثانیه. مقدار \fB0\fP به معنای نامحدود است. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). جهت محدود کردن سرعت آپلود کلی، از گزینه \fI\%\-\-max\-overall\-upload\-limit\fP استفاده کنید. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-peer\-id\-prefix= مشخص کردن پیشوند شناسه همتا (peer ID). شناسه همتا در بیت‌تورنت دارای طول ۲۰ بایت است. اگر بیش از ۲۰ بایت تعیین شود، تنها ۲۰ بایت نخست استفاده می‌شود. اگر کمتر از ۲۰ بایت مشخص شود، داده‌های بایتی تصادفی افزوده می‌شوند تا طول آن به ۲۰ بایت برسد. .sp پیش‌فرض: \fBA2\-$MAJOR\-$MINOR\-$PATCH\-\fP، که در آن $MAJOR، $MINOR و $PATCH به ترتیب با شماره نسخه‌های اصلی، فرعی و وصله جایگزین می‌شوند. برای مثال، نسخه 1.18.8 از aria2 دارای شناسه پیشوند \fBA2\-1\-18\-8\-\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-peer\-agent= مشخص کردن رشته مورد استفاده در حین دست‌تکانی توسعه‌یافته بیت‌تورنت برای نسخه کلاینت همتا. .sp پیش‌فرض: \fBaria2/$MAJOR.$MINOR.$PATCH\fP، که در آن $MAJOR، $MINOR و $PATCH به ترتیب با شماره نسخه‌های اصلی، فرعی و وصله جایگزین می‌شوند. برای مثال، نسخه 1.18.8 از aria2 دارای عامل همتای \fBaria2/1.18.8\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-seed\-ratio= مشخص کردن نسبت اشتراک‌گذاری. سید کردن تورنت‌های تکمیل‌شده تا زمانی که نسبت اشتراک‌گذاری به RATIO برسد. اکیداً توصیه می‌شود در اینجا مقداری برابر یا بیشتر از \fB1.0\fP مشخص کنید. اگر قصد دارید صرف‌نظر از نسبت اشتراک‌گذاری به سید کردن ادامه دهید، مقدار \fB0.0\fP را تعیین کنید. چنانچه گزینه \fI\%\-\-seed\-time\fP به همراه این گزینه مشخص شده باشد، فرایند سید کردن زمانی به پایان می‌رسد که حداقل یکی از شرایط برآورده شود. پیش‌فرض: \fB1.0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-seed\-time= مشخص کردن زمان سید کردن بر حسب دقیقه (کسری). همچنین گزینه \fI\%\-\-seed\-ratio\fP را ببینید. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تعیین \fI\%\-\-seed\-time=0\fP عملیات سید کردن را پس از تکمیل دانلود غیرفعال می‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-T, \-\-torrent\-file= مسیر پرونده \(dq.torrent\(dq. نیازی به استفاده الزامی از این گزینه نیست چرا که می‌توانید فایل‌های \(dq.torrent\(dq را بدون \fI\%\-\-torrent\-file\fP نیز مشخص نمایید. .UNINDENT .SS "گزینه‌های اختصاصی متالینک (Metalink Specific Options)" .INDENT 0.0 .TP .B \-\-follow\-metalink=true|false|mem اگر \fBtrue\fP یا \fBmem\fP مشخص شود، زمانی که فایلی با پسوند \fB\&.meta4\fP یا \fB\&.metalink\fP یا با نوع محتوای \fBapplication/metalink4+xml\fP یا \fBapplication/metalink+xml\fP دانلود گردد، aria2 آن را به عنوان یک فایل متالینک پردازش کرده و فایل‌های ذکرشده در آن را دانلود می‌کند. اگر \fBmem\fP مشخص شود، فایل متالینک بر روی دیسک نوشته نشده و تنها در حافظه نگه‌داری می‌شود. اگر \fBfalse\fP مشخص شود، فایل \fB\&.metalink\fP بر روی دیسک دانلود می‌شود، اما به عنوان فایل متالینک پردازش نشده و محتویات آن دانلود نخواهد شد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-base\-uri= مشخص کردن نشانی پایه (URI پایه) برای حل نشانی‌های نسبی در عناصر metalink:url و metalink:metaurl درون یک فایل متالینک ذخیره‌شده بر روی دیسک محلی. اگر نشانی به یک دایرکتوری اشاره داشته باشد، نشانی باید با \fB/\fP پایان یابد. .UNINDENT .INDENT 0.0 .TP .B \-M, \-\-metalink\-file= مسیر فایل به فایل‌های \(dq.meta4\(dq و \(dq.metalink\(dq. هنگام مشخص شدن \fB\-\fP، ورودی را از \fBstdin\fP می‌خواند. نیازی به استفاده الزامی از این گزینه نیست زیرا می‌توانید فایل‌های \(dq.metalink\(dq را بدون \fI\%\-\-metalink\-file\fP نیز مشخص نمایید. .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-language= زبان فایل مورد نظر برای دانلود. .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-location=[,...] موقعیت مکانی سرور ترجیحی. فهرست جداشده با کاما از موقعیت‌ها پذیرفته می‌شود، برای مثال \fBjp,us\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-os= سیستم‌عامل فایل مورد نظر برای دانلود. .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-version= نسخه فایل مورد نظر برای دانلود. .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-preferred\-protocol= مشخص کردن پروتکل ترجیحی. مقادیر مجاز عبارتند از \fBhttp\fP، \fBhttps\fP، \fBftp\fP و \fBnone\fP\&. برای غیرفعال کردن این ویژگی، مقدار \fBnone\fP را مشخص نمایید. پیش‌فرض: \fBnone\fP .UNINDENT .INDENT 0.0 .TP .B \-\-metalink\-enable\-unique\-protocol [true|false] اگر \fBtrue\fP داده شود و چند پروتکل برای یک آینه (mirror) در یک فایل متالینک موجود باشد، aria2 از یکی از آن‌ها استفاده می‌کند. از گزینه \fI\%\-\-metalink\-preferred\-protocol\fP برای مشخص کردن ترجیح پروتکل استفاده نمایید. پیش‌فرض: \fBtrue\fP .UNINDENT .SS "گزینه‌های آرپی‌سی (RPC Options)" .INDENT 0.0 .TP .B \-\-enable\-rpc [true|false] فعال‌سازی سرور JSON\-RPC/XML\-RPC. اکیداً توصیه می‌شود که با استفاده از گزینه \fI\%\-\-rpc\-secret\fP یک توکن محرمانه برای احراز هویت تنظیم کنید. همچنین گزینه \fI\%\-\-rpc\-listen\-port\fP را ببینید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-pause [true|false] مکث دانلود پس از افزوده شدن. این گزینه تنها زمانی مؤثر است که مقدار \fI\%\-\-enable\-rpc=true\fP داده شده باشد. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-pause\-metadata [true|false] مکث دانلودهای ایجادشده در نتیجه دانلود متادیتا. در aria2 ۳ نوع دانلود متادیتا وجود دارد: (۱) دانلود فایل .torrent، (۲) دانلود متادیتای تورنت با استفاده از لینک مگنت، (۳) دانلود فایل متالینک. این دانلودهای متادیتا، دانلودهایی را بر اساس متادیتای خود ایجاد خواهند کرد. این گزینه این دانلودهای متوالی را به حالت مکث درمی‌آورد. این گزینه تنها زمانی مؤثر است که مقدار \fI\%\-\-enable\-rpc=true\fP داده شده باشد. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-allow\-origin\-all [true|false] افزودن فیلد سرایند (header) Access\-Control\-Allow\-Origin با مقدار \fB*\fP به پاسخ RPC. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-certificate= استفاده از گواهی موجود در FILE برای سرور RPC. این گواهی باید یا در قالب PKCS12 (.p12, .pfx) باشد یا در قالب PEM. .sp فایل‌های PKCS12 باید شامل گواهی، یک کلید و به صورت اختیاری زنجیره‌ای از گواهی‌های اضافی باشند. تنها فایل‌های PKCS12 دارای گذرواژه واردسازی (import password) خالی قابل باز شدن هستند! .sp هنگام استفاده از PEM، باید کلید خصوصی را نیز از طریق \fI\%\-\-rpc\-private\-key\fP مشخص کنید. برای فعال‌سازی رمزگذاری از گزینه \fI\%\-\-rpc\-secure\fP استفاده کنید. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 در حال حاضر \fIWinTLS\fP از فایل‌های PEM پشتیبانی نمی‌کند. کاربران باید از فایل‌های PKCS12 استفاده نمایند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 کاربران \fIAppleTLS\fP باید از ابزار KeyChain Access استفاده کرده تا ابتدا یک گواهی SSL-Server خودامضا (self\-signed) تولید کنند (مثلاً با استفاده از ویژارد)، و اثرانگشت SHA\-1 را از کادر گفتگوی اطلاعات مربوط به آن گواهی جدید دریافت نمایند. جهت آغاز به کار aria2c به همراه \fI\%\-\-rpc\-secure\fP از \fI\-\-rpc\-certificate=\fP استفاده کنید. به عنوان جایگزین، فایل‌های PKCS12 نیز پشتیبانی می‌شوند. با این حال، فایل‌های PEM پشتیبانی نمی‌شوند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-listen\-all [true|false] شنود درخواست‌های ورودی JSON\-RPC/XML\-RPC بر روی تمامی رابط‌های شبکه. اگر مقدار false داده شود، تنها بر روی رابط لوپ‌بک محلی شنود می‌کند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-listen\-port= مشخص کردن شماره پورت برای شنود سرور JSON\-RPC/XML\-RPC. مقادیر ممکن: \fB1024\fP \-\fB65535\fP پیش‌فرض: \fB6800\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-max\-request\-size= تنظیم حداکثر اندازه درخواست JSON\-RPC/XML\-RPC. اگر aria2 تشخیص دهد که درخواست بیش از SIZE بایت است، اتصال را قطع می‌کند. پیش‌فرض: \fB2M\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-passwd= تنظیم گذرواژه JSON\-RPC/XML\-RPC. .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 گزینه \fI\%\-\-rpc\-passwd\fP در نسخه‌های آتی منسوخ خواهد شد. در اولین فرصت به گزینه \fI\%\-\-rpc\-secret\fP مهاجرت کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-private\-key= استفاده از کلید خصوصی موجود در FILE برای سرور RPC. کلید خصوصی باید رمزگشایی شده و در قالب PEM باشد. از گزینه \fI\%\-\-rpc\-secure\fP برای فعال‌سازی رمزگذاری استفاده نمایید. همچنین گزینه \fI\%\-\-rpc\-certificate\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-save\-upload\-metadata [true|false] ذخیره متادیتای آپلودشده تورنت یا متالینک در دایرکتوری مشخص‌شده توسط گزینه \fI\%\-\-dir\fP. نام فایل متشکل از رشته هگز هش SHA\-1 متادیتا به همراه پسوند است. برای تورنت، پسوند \(aq.torrent\(aq است. برای متالینک، این پسوند \(aq.meta4\(aq است. اگر مقدار false به این گزینه داده شود، دانلودهای اضافه‌شده توسط \fI\%aria2.addTorrent()\fP یا \fI\%aria2.addMetalink()\fP توسط گزینه \fI\%\-\-save\-session\fP ذخیره نخواهند شد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-secret= تنظیم توکن محرمانه احراز هویت RPC. بخش \fI\%RPC authorization secret token\fP را بخوانید تا بدانید مقدار این گزینه چگونه استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-secure [true|false] انتقال داده‌های RPC توسط SSL/TLS رمزگذاری خواهد شد. کلاینت‌های RPC باید از طرح‌واره https جهت دسترسی به سرور استفاده کنند. برای کلاینت‌های WebSocket، از طرح‌واره wss استفاده نمایید. از گزینه‌های \fI\%\-\-rpc\-certificate\fP و \fI\%\-\-rpc\-private\-key\fP برای مشخص کردن گواهی و کلید خصوصی سرور استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-rpc\-user= تنظیم کاربر JSON\-RPC/XML\-RPC. .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 گزینه \fI\%\-\-rpc\-user\fP در نسخه‌های آتی منسوخ خواهد شد. در اولین فرصت به گزینه \fI\%\-\-rpc\-secret\fP مهاجرت کنید. .UNINDENT .UNINDENT .UNINDENT .SS گزینه‌های پیشرفته (Advanced Options) .INDENT 0.0 .TP .B \-\-allow\-overwrite [true|false] اگر فایل کنترلی متناظر وجود نداشته باشد، دانلود را از ابتدا آغاز می‌کند. همچنین گزینه \fI\%\-\-auto\-file\-renaming\fP را مشاهده کنید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-allow\-piece\-length\-change [true|false] در صورت تعیین false، چنانچه اندازه قطعه با آنچه در فایل کنترلی ثبت شده متفاوت باشد، aria2 دانلود را لغو می‌کند. در صورت تعیین true، می‌توانید ادامه دهید اما مقداری از پیشرفت دانلود از دست خواهد رفت. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-always\-resume [true|false] همیشه دانلود را ادامه می‌دهد. اگر مقدار \fBtrue\fP داده شود، aria2 همواره تلاش می‌کند دانلود را ادامه دهد و در صورتی که ادامه دانلود ممکن نباشد، دانلود را لغو می‌کند. اگر مقدار \fBfalse\fP داده شود، هنگامی که همه نشانی‌های (URI) ارائه‌شده از ادامه دانلود پشتیبانی نکنند یا aria2 با \fBN\fP نشانی مواجه شود که از ادامه دانلود پشتیبانی نمی‌کنند (\fBN\fP مقداری است که با استفاده از گزینه \fI\%\-\-max\-resume\-failure\-tries\fP تعیین می‌شود)، aria2 فایل را از ابتدا دانلود می‌کند. گزینه \fI\%\-\-max\-resume\-failure\-tries\fP را ببینید. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-async\-dns [true|false] فعال‌سازی DNS ناهمگام (Asynchronous DNS). پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-async\-dns\-server=[,...] فهرستی از آدرس‌های کارساز DNS جداشده با کاما که در تحلیل‌گر DNS ناهمگام استفاده می‌شود. معمولاً تحلیل‌گر DNS ناهمگام آدرس‌های سرور DNS را از \fB/etc/resolv.conf\fP\& می‌خواند. هنگامی که از این گزینه استفاده شود، به جای موارد موجود در \fB/etc/resolv.conf\fP\& از سرورهای DNS مشخص‌شده در این گزینه استفاده می‌کند. می‌توانید هم آدرس IPv4 و هم IPv6 را مشخص کنید. این گزینه زمانی مفید است که سیستم فاقد \fB/etc/resolv.conf\fP باشد و کاربر نیز مجوز لازم برای ایجاد آن را نداشته باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-auto\-file\-renaming [true|false] تغییر نام فایل در صورتی که فایلی با همان نام از پیش وجود داشته باشد. این گزینه فقط در دانلودهای HTTP(S)/FTP عمل می‌کند. نام جدید فایل دارای یک نقطه و یک عدد (۱..۹۹۹۹) خواهد بود که پس از نام و پیش از پسوند فایل (در صورت وجود) اضافه می‌شود. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-auto\-save\-interval= ذخیره یک فایل کنترلی (*.aria2) در هر SEC ثانیه. اگر مقدار \fB0\fP داده شود، فایل کنترلی در حین دانلود ذخیره نمی‌شود. صرف‌نظر از این مقدار، aria2 هنگام توقف خود فایل کنترلی را ذخیره می‌کند. مقادیر مجاز بین \fB0\fP تا \fB600\fP\& است. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-\-conditional\-get [true|false] دانلود فایل تنها زمانی که فایل محلی قدیمی‌تر از فایل سرور دوردست باشد. این قابلیت تنها در دانلودهای HTTP(S) کار می‌کند. اگر اندازه فایل در متالینک مشخص شده باشد کار نخواهد کرد. همچنین هدر Content\-Disposition را نادیده می‌گیرد. در صورت وجود فایل کنترلی، این گزینه نادیده گرفته خواهد شد. این تابع از هدر If\-Modified\-Since برای دریافت مشروط فایل جدیدتر استفاده می‌کند. هنگام دریافت زمان تغییر فایل محلی، از نام فایل ارائه‌شده توسط کاربر (گزینه \fI\%\-\-out\fP را ببینید) یا بخش نام فایل در نشانی (URI) در صورتی که \fI\%\-\-out\fP مشخص نشده باشد، استفاده می‌شود. برای رونویسی فایل موجود، گزینه \fI\%\-\-allow\-overwrite\fP الزامی است. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-conf\-path= تغییر مسیر فایل پیکربندی به PATH. پیش‌فرض: \fB$HOME/.aria2/aria2.conf\fP در صورت وجود، در غیر این صورت \fB$XDG_CONFIG_HOME/aria2/aria2.conf\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-console\-log\-level= تنظیم سطح گزارش وقایع (لاگ) برای نمایش در کنسول. LEVEL یکی از مقادیر \fBdebug\fP، \fBinfo\fP، \fBnotice\fP، \fBwarn\fP یا \fBerror\fP\& است. پیش‌فرض: \fBnotice\fP .UNINDENT .INDENT 0.0 .TP .B \-\-content\-disposition\-default\-utf8 [true|false] پردازش رشته نقل‌قول‌شده در هدر Content\-Disposition با قالب UTF\-8 به جای ISO\-8859\-1، برای نمونه پارامتر filename، اما نه نسخه گسترش‌یافته filename*. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-D, \-\-daemon [true|false] اجرا به عنوان دیمن (پس‌زمینه). دایرکتوری کاری جاری به \fB/\fP تغییر می‌یابد و ورودی استاندارد، خروجی استاندارد و خطای استاندارد به \fB/dev/null\fP\& هدایت می‌شوند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-deferred\-input [true|false] در صورت تعیین \fBtrue\fP، برنامه aria2 تمام نشانی‌ها (URI) و گزینه‌ها را در ابتدای اجرا از فایل مشخص‌شده با گزینه \fI\%\-\-input\-file\fP نمی‌خواند، بلکه بعداً در زمان نیاز آن‌ها را یکی‌یکی می‌خواند. اگر فایل ورودی شامل نشانی‌های متعددی برای دانلود باشد، این کار ممکن است مصرف حافظه را کاهش دهد. در صورت تعیین \fBfalse\fP، برنامه aria2 تمام نشانی‌ها و گزینه‌ها را در ابتدای راه‌اندازی می‌خواند. پیش‌فرض: \fBfalse\fP .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 در صورت استفاده هم‌زمان از گزینه \fI\%\-\-save\-session\fP، گزینه \fI\%\-\-deferred\-input\fP غیرفعال خواهد شد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-ipv6 [true|false] غیرفعال کردن IPv6. این گزینه زمانی مفید است که ناچار به استفاده از یک DNS معیوب هستید و می‌خواهید از پرس‌وجوی فوق‌العاده کند رکوردهای AAAA اجتناب کنید. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-disk\-cache= فعال‌سازی حافظه پنهان دیسک (Disk cache). اگر مقدار SIZE برابر با \fB0\fP باشد، حافظه پنهان دیسک غیرفعال می‌شود. این قابلیت داده‌های دانلودشده را در حافظه رم نگه‌داری می‌کند که حداکثر تا SIZE بایت افزایش می‌یابد. فضای حافظه پنهان برای هر نمونه از aria2 ایجاد شده و بین همه دانلودها به اشتراک گذاشته می‌شود. یکی از مزایای حافظه پنهان دیسک کاهش ورودی/خروجی (I/O) دیسک است زیرا داده‌ها در واحدهای بزرگ‌تر نوشته شده و بر اساس آفست فایل بازآرایی می‌شوند. چنانچه بررسی هش در میان باشد و داده‌ها در حافظه کش شده باشند، دیگر نیازی به خواندن مجدد آن‌ها از دیسک نداریم. مقدار SIZE می‌تواند شامل \fBK\fP یا \fBM\fP باشد (1K = 1024, 1M = 1024K). پیش‌فرض: \fB16M\fP .UNINDENT .INDENT 0.0 .TP .B \-\-download\-result= این گزینه نحوه قالب‌بندی \fBنتایج دانلود (Download Results)\fP را تغییر می‌دهد. اگر مقدار OPT برابر با \fBdefault\fP باشد، شناسه GID، وضعیت، میانگین سرعت دانلود و مسیر/نشانی چاپ می‌شوند. اگر چندین فایل در میان باشد، مسیر/نشانی اولین فایل درخواست‌شده چاپ شده و باقی موارد حذف می‌شوند. اگر مقدار OPT برابر با \fBfull\fP باشد، شناسه GID، وضعیت، میانگین سرعت دانلود، درصد پیشرفت و مسیر/نشانی چاپ می‌شوند. درصد پیشرفت و مسیر/نشانی برای هر فایل درخواست‌شده در یک سطر جداگانه نمایش می‌یابند. اگر OPT برابر با \fBhide\fP باشد، \fBنتایج دانلود\fP پنهان خواهد شد. پیش‌فرض: \fBdefault\fP .UNINDENT .INDENT 0.0 .TP .B \-\-dscp= تنظیم مقدار DSCP در بسته‌های IP خروجی مربوط به ترافیک بیت‌تورنت برای کیفیت خدمات (QoS). این پارامتر فقط بیت‌های DSCP را در فیلد TOS بسته‌های IP تنظیم می‌کند، نه کل فیلد را. اگر مقادیر را از \fI/usr/include/netinet/ip.h\fP استخراج می‌کنید، آن‌ها را بر ۴ تقسیم کنید (در غیر این صورت مقادیر نادرست خواهند بود، مثلاً کلاس \fBCS1\fP شما به \fBCS4\fP تبدیل می‌شود). اگر مقادیر پرکاربرد را از RFC، مستندات سازندگان تجهیزات شبکه، ویکی‌پدیا یا هر منبع دیگری برمی‌دارید، از آن‌ها همان‌گونه که هستند استفاده نمایید. .UNINDENT .INDENT 0.0 .TP .B \-\-rlimit\-nofile= تنظیم حد نرم (Soft Limit) برای توصیف‌کننده‌های باز فایل. این گزینه تنها در شرایط زیر تأثیرگذار خواهد بود: .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .IP a. 3 سیستم از آن پشتیبانی کند (posix) .IP b. 3 حد تعیین‌شده از حد سخت (Hard Limit) فراتر نرود. .IP c. 3 حد مشخص‌شده از حد نرم فعلی بزرگ‌تر باشد. .UNINDENT .UNINDENT .UNINDENT .sp این معادل تنظیم nofile از طریق ulimit است، با این تفاوت که هرگز حد را کاهش نمی‌دهد. .sp این گزینه فقط در سیستم‌هایی که از API تابع rlimit پشتیبانی می‌کنند در دسترس است. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-color [true|false] فعال‌سازی خروجی رنگی در ترمینال. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-mmap [true|false] نگاشت فایل‌ها در حافظه (mmap). در صورتی که فضای فایل از پیش تخصیص نیافته باشد، ممکن است این گزینه کار نکند. گزینه \fI\%\-\-file\-allocation\fP\& را مشاهده کنید. .sp پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-event\-poll= تعیین روش نظرسنجی رویدادها (Event Polling). مقادیر ممکن عبارتند از \fBepoll\fP، \fBkqueue\fP، \fBport\fP، \fBpoll\fP و \fBselect\fP\&. هر یک از روش‌های \fBepoll\fP، \fBkqueue\fP، \fBport\fP و \fBpoll\fP در صورتی که سیستم از آن پشتیبانی کند در دسترس است. روش \fBepoll\fP در لینوکس‌های مدرن در دسترس است. \fBkqueue\fP در سیستم‌های گوناگون *BSD از جمله Mac OS X در دسترس است. \fBport\fP در Open Solaris در دسترس است. مقدار پیش‌فرض بسته به سیستم مورد استفاده شما ممکن است متغیر باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-file\-allocation= تعیین روش تخصیص فضای فایل. روش \fBnone\fP فضای فایل را از پیش تخصیص نمی‌دهد. \fBprealloc\fP فضای فایل را پیش از آغاز دانلود از پیش تخصیص می‌دهد. این کار بسته به اندازه فایل ممکن است مقداری زمان ببرد. اگر از سیستم‌فایل‌های جدیدتر مانند ext4 (با پشتیبانی از extents)، btrfs، xfs یا NTFS (فقط در بیلد MinGW) استفاده می‌کنید، \fBfalloc\fP بهترین گزینه شماست. این روش فضای فایل‌های حجیم (چند گیگابایت) را تقریباً بی‌درنگ تخصیص می‌دهد. از \fBfalloc\fP در سیستم‌فایل‌های قدیمی‌تر مانند ext3 و FAT32 استفاده نکنید چرا که تقریباً همانند \fBprealloc\fP زمان می‌برد و تا زمان اتمام تخصیص، برنامه aria2 را به‌طور کامل متوقف (بلاک) می‌کند. در صورتی که سیستم شما فاقد تابع \fBposix_fallocate(3)\fP باشد ممکن است \fBfalloc\fP در دسترس نباشد. روش \fBtrunc\fP از فراخوانی سیستمی \fBftruncate(2)\fP یا معادل مخصوص پلتفرم آن برای بریدن یا گسترش طول فایل به اندازه مشخص استفاده می‌کند. .sp مقادیر ممکن: \fBnone\fP، \fBprealloc\fP، \fBtrunc\fP، \fBfalloc\fP پیش‌فرض: \fBprealloc\fP .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 استفاده از \fBtrunc\fP در ظاهر فضای دیسک را بسیار سریع تخصیص می‌دهد، اما آنچه در واقع انجام می‌دهد این است که فراداده طول فایل را در سیستم‌فایل تنظیم می‌کند و هیچ فضای واقعی روی دیسک تخصیص نمی‌دهد. این بدان معناست که به جلوگیری از تکه‌تکه شدن فایل‌ها کمکی نمی‌کند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 در دانلودهای تورنت چندفایلی، فایل‌های مجاور بعدی فایل‌های مشخص‌شده نیز در صورتی که در همان قطعه (piece) مشترک باشند تخصیص داده می‌شوند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-force\-save [true|false] ذخیره وضعیت دانلود با گزینه \fI\%\-\-save\-session\fP حتی اگر دانلود تکمیل یا حذف شده باشد. این گزینه در آن شرایط فایل کنترلی را نیز ذخیره می‌کند. این قابلیت ممکن است برای ذخیره اشتراک‌گذاری (Seeding) بیت‌تورنت که به عنوان وضعیت تکمیل‌شده شناخته می‌شود مفید باشد. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-save\-not\-found [true|false] ذخیره وضعیت دانلود با گزینه \fI\%\-\-save\-session\fP حتی اگر فایل در سرور یافت نشده باشد. این گزینه در آن شرایط فایل کنترلی را نیز ذخیره می‌کند. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-gid= تنظیم دستی شناسه GID. برنامه aria2 هر دانلود را با شناسه‌ای به نام GID مشخص می‌کند. مقدار GID باید یک رشته هگزادسیمال ۱۶ کاراکتری باشد، بنابراین [0\-9a\-fA\-F] مجاز بوده و صفرهای اول نباید حذف شوند. مقدار GID تماماً صفر رزرو شده است و نباید استفاده شود. مقدار GID باید یکتا باشد، در غیر این صورت خطا گزارش شده و دانلود اضافه نمی‌شود. این گزینه هنگام بازیابی نشست‌های ذخیره‌شده با گزینه \fI\%\-\-save\-session\fP مفید است. در صورت عدم استفاده از این گزینه، یک GID جدید توسط aria2 تولید می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-hash\-check\-only [true|false] در صورت تعیین \fBtrue\fP، پس از بررسی هش با استفاده از گزینه \fI\%\-\-check\-integrity\fP، صرف‌نظر از اینکه دانلود تکمیل شده باشد یا خیر، دانلود لغو می‌شود. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-human\-readable [true|false] چاپ اندازه‌ها و سرعت‌ها با قالبی خوانا برای انسان (مانند 1.2Ki, 3.4Mi) در خروجی کنسول. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-interface= اتصال سوکت‌ها به واسط شبکه (اینترفیس) داده‌شده. می‌توانید نام واسط، آدرس IP و نام میزبان را مشخص کنید. مقادیر ممکن: interface, IP address, host name .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اگر یک واسط دارای چندین آدرس است، اکیداً توصیه می‌شود که آدرس IP را به صراحت مشخص کنید. همچنین گزینه \fI\%\-\-disable\-ipv6\fP\& را ببینید. در صورتی که سیستم شما فاقد تابع \fBgetifaddrs(3)\fP باشد، این گزینه نام واسط را نمی‌پذیرد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-keep\-unfinished\-download\-result [true|false] نگه‌داری نتایج دانلودهای ناتمام حتی اگر انجام این کار از حد \fI\%\-\-max\-download\-result\fP\& فراتر رود. این گزینه زمانی مفید است که بخواهید تمام دانلودهای ناتمام در فایل نشست ذخیره شوند (گزینه \fI\%\-\-save\-session\fP را ببینید). لطفاً توجه داشته باشید که هیچ حد بالایی برای تعداد نتایج دانلودهای ناتمام نگه‌داری‌شده وجود ندارد. اگر این وضعیت مطلوب نیست، این گزینه را خاموش کنید. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-download\-result= تنظیم حداکثر تعداد نتایج دانلودی که در حافظه نگه‌داری می‌شوند. نتایج دانلود شامل دانلودهای تکمیل‌شده/خطادار/حذف‌شده هستند. نتایج دانلود در یک صف FIFO نگه‌داری می‌شوند و حداکثر می‌توانند NUM نتیجه دانلود را در خود ذخیره کنند. زمانی که صف پر باشد و نتیجه دانلود جدیدی ایجاد شود، قدیمی‌ترین نتیجه دانلود از ابتدای صف حذف شده و مورد جدید به انتهای آن افزوده می‌شود. تنظیم عددی بزرگ برای این گزینه ممکن است پس از هزاران دانلود به مصرف بالای حافظه منجر شود. مشخص کردن مقدار 0 به این معنی است که هیچ نتیجه دانلودی نگه‌داری نمی‌شود. توجه داشته باشید که دانلودهای ناتمام صرف‌نظر از مقدار این گزینه در حافظه حفظ می‌شوند. گزینه \fI\%\-\-keep\-unfinished\-download\-result\fP را ببینید. پیش‌فرض: \fB1000\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-mmap\-limit= تنظیم حداکثر اندازه فایل برای فعال‌سازی نگاشت حافظه mmap (گزینه \fI\%\-\-enable\-mmap\fP را ببینید). اندازه فایل با مجموع تمامی فایل‌های موجود در یک دانلود تعیین می‌شود. برای مثال، اگر یک دانلود شامل ۵ فایل باشد، اندازه فایل برابر با حجم کل آن فایل‌ها خواهد بود. اگر اندازه فایل اکیداً بزرگ‌تر از مقدار مشخص‌شده در این گزینه باشد، mmap غیرفعال خواهد شد. پیش‌فرض: \fB9223372036854775807\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-resume\-failure\-tries= هنگام استفاده همراه با \fI\%\-\-always\-resume=false،\fP برنامه aria2 زمانی که N نشانی (URI) بدون پشتیبانی از ادامه دانلود را تشخیص دهد، دانلود فایل را از ابتدا آغاز می‌کند. اگر مقدار N برابر با \fB0\fP باشد، aria2 تنها زمانی فایل را از ابتدا دانلود می‌کند که تمامی نشانی‌های ارائه‌شده از ادامه دانلود پشتیبانی نکنند. گزینه \fI\%\-\-always\-resume\fP را ببینید. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-min\-tls\-version= مشخص کردن حداقل نسخه SSL/TLS مجاز جهت فعال‌سازی. مقادیر ممکن: \fBTLSv1.1\fP, \fBTLSv1.2\fP, \fBTLSv1.3\fP پیش‌فرض: \fBTLSv1.2\fP .UNINDENT .INDENT 0.0 .TP .B \-\-multiple\-interface= فهرستی از واسط‌های شبکه جداشده با کاما جهت اتصال سوکت‌ها به آن‌ها. درخواست‌ها بین این واسط‌ها تقسیم می‌شوند تا تجمیع پیوند (Link aggregation) حاصل شود. می‌توانید نام واسط، آدرس IP و نام میزبان را مشخص کنید. اگر گزینه \fI\%\-\-interface\fP استفاده شده باشد، این گزینه نادیده گرفته خواهد شد. مقادیر ممکن: interface, IP address, hostname .UNINDENT .INDENT 0.0 .TP .B \-\-log\-level= تنظیم سطح ثبت وقایع برای خروجی. مقدار LEVEL یکی از مقادیر \fBdebug\fP، \fBinfo\fP، \fBnotice\fP، \fBwarn\fP یا \fBerror\fP\& است. پیش‌فرض: \fBdebug\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-bt\-download\-complete= در بیت‌تورنت، دستوری که در \fI\%\-\-on\-download\-complete\fP مشخص می‌شود پس از تکمیل دانلود و پایان سیدینگ (اشتراک‌گذاری) فراخوانی می‌گردد. از سوی دیگر، این گزینه دستوری را مشخص می‌کند که پس از تکمیل دانلود اما پیش از سیدینگ اجرا شود. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-download\-complete= تنظیم دستوری که پس از تکمیل دانلود اجرا شود. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. همچنین گزینه \fI\%\-\-on\-download\-stop\fP را مشاهده کنید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-download\-error= تنظیم دستوری که پس از متوقف شدن دانلود به دلیل خطا اجرا شود. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. همچنین گزینه \fI\%\-\-on\-download\-stop\fP را مشاهده کنید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-download\-pause= تنظیم دستوری که پس از متوقف شدن موقت (مکث) دانلود اجرا شود. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-download\-start= تنظیم دستوری که پس از شروع دانلود اجرا شود. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-on\-download\-stop= تنظیم دستوری که پس از توقف دانلود اجرا شود. می‌توانید با استفاده از گزینه‌های \fI\%\-\-on\-download\-complete\fP و \fI\%\-\-on\-download\-error\fP\& دستور قابل اجرا برای نتیجه دانلودی خاص را لغو (override) کنید. در صورت مشخص شدن آن‌ها، دستور تعیین‌شده در این گزینه اجرا نخواهد شد. برای جزئیات بیشتر درباره COMMAND بخش \fI\%قلاب رویداد (Event Hook)\fP را ببینید. مقادیر ممکن: \fB/path/to/command\fP .UNINDENT .INDENT 0.0 .TP .B \-\-optimize\-concurrent\-downloads [true|false|:] بهینه‌سازی تعداد دانلودهای هم‌زمان با توجه به پهنای باند در دسترس. برنامه aria2 از سرعت دانلود مشاهده‌شده در دانلودهای قبلی برای تطبیق تعداد دانلودهای موازی بر اساس رابطه N = A + B Log10(speed in Mbps) استفاده می‌کند. ضرایب A و B را می‌توان در آرگومان‌های این گزینه با جدا کردن A و B توسط دونقطه شخصی‌سازی کرد. مقادیر پیش‌فرض (A=5, B=25) معمولاً منجر به ۵ دانلود موازی در شبکه‌های 1Mbps و بیش از ۵۰ دانلود در شبکه‌های 100Mbps می‌شود. تعداد دانلودهای موازی همواره کمتر از حداکثر تعیین‌شده در پارامتر \fI\%\-\-max\-concurrent\-downloads\fP باقی خواهد ماند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-piece\-length= تنظیم طول قطعه برای دانلودهای HTTP/FTP. این مرزی است که aria2 بر اساس آن یک فایل را تقسیم می‌کند. تمامی تقسیم‌ها در مضاربی از این طول رخ می‌دهند. این گزینه در دانلودهای بیت‌تورنت نادیده گرفته می‌شود. همچنین در صورتی که فایل متالینک حاوی هش قطعات باشد، نادیده گرفته خواهد شد. پیش‌فرض: \fB1M\fP .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 یک کاربرد محتمل برای گزینه \fI\%\-\-piece\-length\fP تغییر محدوده درخواست در یک درخواست پایپ‌لاین‌شده HTTP است. جهت فعال‌سازی پایپ‌لاین HTTP از گزینه \fI\%\-\-enable\-http\-pipelining\fP\& استفاده کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-show\-console\-readout [true|false] نمایش خروجی وضعیت در کنسول. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-stderr [true|false] هدایت تمام خروجی‌های کنسول که در غیر این صورت در stdout چاپ می‌شدند به خطای استاندارد (stderr). پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-summary\-interval= تنظیم فاصله زمانی به ثانیه برای چاپ خلاصه پیشرفت دانلود. تنظیم مقدار \fB0\fP مانع چاپ این خروجی می‌شود. پیش‌فرض: \fB60\fP .UNINDENT .INDENT 0.0 .TP .B \-Z, \-\-force\-sequential [true|false] دریافت ترتیبی نشانی‌های (URI) موجود در خط فرمان و دانلود هر نشانی در یک نشست جداگانه، همانند ابزارهای متداول دانلود خط فرمان. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-overall\-download\-limit= تنظیم حداکثر سرعت کلی دانلود بر حسب بایت در ثانیه. مقدار \fB0\fP به معنای نامحدود است. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). برای محدود کردن سرعت دانلود به ازای هر دانلود، از گزینه \fI\%\-\-max\-download\-limit\fP استفاده کنید. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-max\-download\-limit= تنظیم حداکثر سرعت دانلود به ازای هر دانلود بر حسب بایت در ثانیه. مقدار \fB0\fP به معنای نامحدود است. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). برای محدود کردن سرعت کلی دانلود، از گزینه \fI\%\-\-max\-overall\-download\-limit\fP استفاده کنید. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-no\-conf [true|false] غیرفعال کردن بارگذاری فایل aria2.conf. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-file\-allocation\-limit= هیچ تخصیص فضایی برای فایل‌هایی که اندازه آن‌ها کوچک‌تر از SIZE باشد انجام نمی‌شود. می‌توانید \fBK\fP یا \fBM\fP را اضافه کنید (1K = 1024, 1M = 1024K). پیش‌فرض: \fB5M\fP .UNINDENT .INDENT 0.0 .TP .B \-P, \-\-parameterized\-uri [true|false] فعال‌سازی پشتیبانی از نشانی‌های (URI) پارامتری. می‌توانید مجموعه‌ای از بخش‌ها را مشخص کنید: \fBhttp://{sv1,sv2,sv3}/foo.iso\fP\&. همچنین می‌توانید دنباله‌های عددی با شمارنده گام مشخص کنید: \fBhttp://host/image[000\-100:2].img\fP\&. شمارنده گام می‌تواند حذف شود. اگر همه نشانی‌ها به یک فایل اشاره نکنند، همانند مثال دوم در بالا، گزینه \-Z مورد نیاز است. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet [true|false] حالت بی‌صدا برای aria2 (بدون خروجی کنسول). پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-realtime\-chunk\-checksum [true|false] اعتبارسنجی تکه‌های داده با محاسبه جمع کنترلی (checksum) در حین دانلود فایل، در صورتی که جمع کنترلی تکه‌ها ارائه شده باشد. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-\-remove\-control\-file [true|false] حذف فایل کنترلی پیش از دانلود. در صورت استفاده همراه با \fI\%\-\-allow\-overwrite=true،\fP دانلود همواره از ابتدا آغاز می‌شود. این گزینه برای کاربرانی که پشت سرور پروکسی هستند و پروکسی امکان ادامه دانلود را غیرفعال کرده است مفید خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-save\-session= ذخیره دانلودهای خطادار/ناتمام در FILE در هنگام خروج. می‌توانید این فایل خروجی را هنگام راه‌اندازی مجدد با گزینه \fI\%\-\-input\-file\fP به aria2c ارسال کنید. اگر تمایل دارید خروجی فشرده‌سازی شود (gzip)، پسوند gz. را به انتهای نام فایل اضافه کنید. لطفاً توجه داشته باشید دانلودهایی که با متدهای RPC با نام‌های \fI\%aria2.addTorrent()\fP و \fI\%aria2.addMetalink()\fP اضافه شده‌اند و فراداده‌های آن‌ها نتوانسته به عنوان فایل ذخیره شود، ذخیره نخواهند شد. دانلودهای حذف‌شده با استفاده از \fI\%aria2.remove()\fP و \fI\%aria2.forceRemove()\fP نیز ذخیره نمی‌شوند. شناسه GID نیز به همراه \fI\%gid\fP ذخیره می‌شود، اما محدودیت‌هایی وجود دارد که در ادامه آمده است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 به‌طور معمول، GID خود دانلود ذخیره می‌شود. اما برخی دانلودها از فراداده (مانند BitTorrent و Metalink) استفاده می‌کنند. در این حالت، برخی محدودیت‌ها وجود دارد. .INDENT 0.0 .TP .B نشانی مگنت (magnet URI)، و به دنبال آن دانلود تورنت شناسه GID دانلود فراداده بیت‌تورنت ذخیره می‌شود. .TP .B نشانی به فایل تورنت، و به دنبال آن دانلود تورنت شناسه GID دانلود فایل تورنت ذخیره می‌شود. .TP .B نشانی به فایل متالینک، و به دنبال آن دانلود فایل‌های شرح‌داده‌شده در فایل متالینک شناسه GID دانلود فایل متالینک ذخیره می‌شود. .TP .B فایل تورنت محلی شناسه GID دانلود تورنت ذخیره می‌شود. .TP .B فایل متالینک محلی هیچ GID معناداری ذخیره نمی‌شود. .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-save\-session\-interval= ذخیره دانلودهای خطادار/ناتمام در فایل مشخص‌شده توسط گزینه \fI\%\-\-save\-session\fP در هر SEC ثانیه. اگر مقدار \fB0\fP داده شود، فایل تنها زمانی که aria2 خارج شود ذخیره خواهد شد. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-socket\-recv\-buffer\-size= تنظیم حداکثر بافر دریافت سوکت بر حسب بایت. مشخص کردن \fB0\fP این گزینه را غیرفعال می‌کند. این مقدار با استفاده از گزینه سوکت \fBSO_RCVBUF\fP همراه با فراخوانی تابع \fBsetsockopt()\fP روی توصیف‌کننده فایل سوکت تنظیم می‌شود. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-stop= توقف برنامه پس از سپری شدن SEC ثانیه. اگر مقدار \fB0\fP داده شود، این قابلیت غیرفعال است. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-stop\-with\-process= توقف برنامه هنگامی که فرآیند PID در حال اجرا نباشد. این ویژگی زمانی مفید است که فرآیند aria2 از یک فرآیند والد ایجاد (fork) شده باشد. فرآیند والد می‌تواند aria2 را با شناسه pid خود منشعب کند و هنگامی که فرآیند والد به هر دلیلی خارج شود، aria2 می‌تواند آن را تشخیص داده و خود را خاموش کند. .UNINDENT .INDENT 0.0 .TP .B \-\-truncate\-console\-readout [true|false] کوتاه کردن خروجی وضعیت کنسول به منظور جا گرفتن در یک سطر. پیش‌فرض: \fBtrue\fP .UNINDENT .INDENT 0.0 .TP .B \-v, \-\-version چاپ شماره نسخه، کپی‌رایت و اطلاعات پیکربندی و خروج از برنامه. .UNINDENT .SS نکاتی پیرامون گزینه‌ها (Notes for Options) .SS آرگومان‌های اختیاری (Optional arguments) .sp گزینه‌هایی که آرگومان آن‌ها داخل براکت ([]) قرار دارد، یک آرگومان اختیاری می‌پذیرند. معمولاً حذف آرگومان معادل \fBtrue\fP ارزیابی می‌شود. اگر از فرم کوتاه این گزینه‌ها (مانند \fB\-V\fP) استفاده کرده و آرگومانی ارائه دهید، نام گزینه و آرگومان آن باید به هم متصل باشند (مثلاً \fB\-Vfalse\fP). در صورتی که هر فاصله‌ای بین نام گزینه و آرگومان درج شود، آرگومان به عنوان نشانی (URI) تلقی خواهد شد و معمولاً این چیزی نیست که انتظار دارید. .SS واحدها (K و M) (Units (K and M)) .sp برخی گزینه‌ها مقادیر \fBK\fP و \fBM\fP را برای نمایش آسان‌تر ۱۰۲۴ و ۱۰۴۸۵۷۶ به کار می‌برند. برنامه aria2 این نویسه‌ها را بدون حساسیت به حروف کوچک و بزرگ تشخیص می‌دهد. به بیان دیگر، \fBk\fP و \fBm\fP را می‌توان دقیقاً همانند \fBK\fP و \fBM\fP استفاده کرد. .SS نشانی، مگنت، فایل تورنت، فایل متالینک (URI, MAGNET, TORRENT_FILE, METALINK_FILE) .sp می‌توانید چندین نشانی (URI) را در خط فرمان مشخص کنید. مگر اینکه گزینه \fI\%\-\-force\-sequential\fP را مشخص کرده باشید، تمام نشانی‌ها باید به یک فایل یکسان اشاره کنند وگرنه دانلود با شکست مواجه خواهد شد. .sp می‌توانید تعداد دلخواهی نشانی مگنت بیت‌تورنت (BitTorrent Magnet URI) مشخص کنید. لطفاً توجه داشته باشید که آن‌ها همواره به عنوان دانلود جداگانه تلقی می‌شوند. هم مقدار Info Hash کدگذاری‌شده در مبنای ۱۶ با ۴۰ نویسه و هم در مبنای ۳۲ با ۳۲ نویسه پشتیبانی می‌شوند. پارامترهای متعدد \fBtr\fP پشتیبانی می‌شوند. به دلیل آنکه نشانی‌های مگنت بیت‌تورنت معمولاً حاوی نویسه \fB&\fP هستند، اکیداً توصیه می‌شود که همیشه نشانی را با گیومه تکی (\fB\(aq\fP) یا جفتی (\fB\(dq\fP) محصور کنید. فعال‌سازی DHT به ویژه در زمانی که پارامتر \fBtr\fP وجود ندارد شدیداً توصیه می‌شود. برای اطلاعات بیشتر درباره نشانی‌های مگنت بیت‌تورنت به \fI\%http://www.bittorrent.org/beps/bep_0009.html\fP مراجعه کنید. .sp همچنین می‌توانید تعداد دلخواهی فایل تورنت و اسناد متالینک ذخیره‌شده روی دیسک محلی را مشخص کنید. لطفاً توجه داشته باشید که با آن‌ها همیشه به عنوان دانلود جداگانه برخورد می‌شود. هر دو نسخه Metalink4 و Metalink نسخه 3.0 پشتیبانی می‌شوند. .sp می‌توانید هم فایل تورنت را با گزینه \-T و هم نشانی‌ها را مشخص کنید. با انجام این کار، می‌توانید یک فایل را هم‌زمان از گروه اشتراک‌گذاری تورنت (swarm) و سرور HTTP(S)/FTP/SFTP دانلود کنید، در حالی که داده‌های حاصل از HTTP(S)/FTP/SFTP در گروه تورنت آپلود می‌شوند. برای تورنت‌های تک‌فایلی، نشانی می‌تواند یک نشانی کامل باشد که به منبع اشاره می‌کند یا اگر نشانی به / ختم شود، نام فایل موجود در فایل تورنت به آن افزوده می‌شود. برای تورنت‌های چندفایلی، نام و مسیر افزوده می‌شوند تا برای هر فایل یک نشانی ساخته شود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اطمینان حاصل کنید در صورتی که نشانی حاوی \fB&\fP یا هر نویسه‌ای است که در شل معنای خاصی دارد، با گیومه تکی (\fB\(aq\fP) یا جفتی (\fB\(dq\fP) نقل‌قول شود. .UNINDENT .UNINDENT .SS ادامه دانلود (Resuming Download) .sp معمولاً اگر انتقال پیشین توسط aria2 انجام شده باشد، می‌توانید تنها با اجرای مجدد همان دستور (aria2c URI) انتقال را از سر بگیرید. .sp اگر انتقال قبلی توسط مرورگر یا ابزارهای دانلود ترتیبی مانند wget انجام شده باشد، از گزینه \fI\%\-\-continue\fP برای ادامه انتقال استفاده نمایید. .SS قلاب رویداد (Event Hook) .sp برنامه aria2 گزینه‌هایی را جهت تعیین دستوری دلخواه پس از رخ دادن یک رویداد خاص فراهم می‌کند. در حال حاضر گزینه‌های زیر در دسترس هستند: \fI\%\-\-on\-bt\-download\-complete\fP، \fI\%\-\-on\-download\-pause\fP، \fI\%\-\-on\-download\-complete\fP\&. \fI\%\-\-on\-download\-start\fP، \fI\%\-\-on\-download\-error\fP، \fI\%\-\-on\-download\-stop\fP\&. .sp هنگام اجرای دستور تعیین‌شده، aria2 تعداد ۳ آرگومان به آن ارسال می‌کند. این آرگومان‌ها عبارتند از: شناسه GID، تعداد فایل‌ها و مسیر فایل. برای دانلودهای HTTP، FTP و SFTP معمولاً تعداد فایل‌ها ۱ است. دانلود بیت‌تورنت می‌تواند شامل چندین فایل باشد. اگر تعداد فایل‌ها بیش از یک مورد باشد، مسیر فایل همان اولین فایل است. به بیان دیگر، این مقدار کلید path در اولین ساختاری است که مقدار کلید selected آن در پاسخ متد RPC به نام \fI\%aria2.getFiles()\fP برابر با true باشد. اگر مایل به دریافت مسیر همه فایل‌ها هستید، استفاده از JSON\-RPC/XML\-RPC را مد نظر قرار دهید. لطفاً توجه داشته باشید که مسیر فایل در دانلودهای HTTP ممکن است به دلیل تغییر مسیر (ریدایرکت) یا هدر Content\-Disposition در طول دانلود تغییر کند. .sp بیایید نمونه‌ای از نحوه ارسال آرگومان‌ها به دستور را مشاهده کنیم: .INDENT 0.0 .INDENT 3.5 .sp .EX $ cat hook.sh #!/bin/sh echo \(dqCalled with [$1] [$2] [$3]\(dq $ aria2c \-\-on\-download\-complete hook.sh http://example.org/file.iso Called with [1] [1] [/path/to/file.iso] .EE .UNINDENT .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp از آنجا که aria2 می‌تواند چندین دانلود را به‌طور هم‌زمان مدیریت کند، ممکن است در یک نشست با خطاهای متعددی روبرو شود. ابزار aria2 بر اساس آخرین خطای رخ‌داده، وضعیت‌های خروج زیر را بازمی‌گرداند: .INDENT 0.0 .TP .B 0 اگر تمامی دانلودها موفقیت‌آمیز بوده باشند. .TP .B 1 اگر خطای ناشناخته‌ای رخ داده باشد. .TP .B 2 اگر مهلت زمانی (timeout) رخ داده باشد. .TP .B 3 اگر منبع یافت نشده باشد. .TP .B 4 اگر aria2 به تعداد مشخص‌شده با خطای \(dqresource not found\(dq مواجه شود. گزینه \fI\%\-\-max\-file\-not\-found\fP را ببینید. .TP .B 5 اگر دانلودی به دلیل سرعت بسیار پایین متوقف شود. گزینه \fI\%\-\-lowest\-speed\-limit\fP را ببینید. .TP .B 6 اگر مشکل شبکه رخ داده باشد. .TP .B 7 اگر دانلودهای ناتمامی وجود داشته باشند. این خطا فقط در صورتی گزارش می‌شود که تمامی دانلودهای پایان‌یافته موفقیت‌آمیز بوده باشند و هنگام خروج aria2 با فشردن کلیدهای \fBCtrl\-C\fP توسط کاربر یا ارسال سیگنال TERM یا INT، دانلودهای ناتمامی در صف باقی مانده باشند. .TP .B 8 اگر سرور دوردست از ادامه دانلود (resume) پشتیبانی نکند، در حالی که برای تکمیل دانلود به ازسرگیری نیاز بوده است. .TP .B 9 اگر فضای دیسک کافی در دسترس نباشد. .TP .B 10 اگر اندازه قطعه با مقدار موجود در فایل کنترلی .aria2 متفاوت باشد. گزینه \fI\%\-\-allow\-piece\-length\-change\fP را ببینید. .TP .B 11 اگر aria2 در همان لحظه در حال دانلود همان فایل باشد. .TP .B 12 اگر aria2 در همان لحظه در حال دانلود تورنتی با همان هش اطلاعاتی (info hash) باشد. .TP .B 13 اگر فایل از قبل وجود داشته باشد. گزینه \fI\%\-\-allow\-overwrite\fP را ببینید. .TP .B 14 اگر تغییر نام فایل ناموفق باشد. گزینه \fI\%\-\-auto\-file\-renaming\fP را ببینید. .TP .B 15 اگر aria2 نتواند فایل موجود را باز کند. .TP .B 16 اگر aria2 نتواند فایل جدیدی بسازد یا اندازه فایل موجود را تغییر دهد (truncate کند). .TP .B 17 اگر خطای ورودی/خروجی (I/O) فایل رخ دهد. .TP .B 18 اگر aria2 نتواند دایرکتوری را بسازد. .TP .B 19 اگر تحلیل نام (name resolution) با شکست مواجه شود. .TP .B 20 اگر aria2 نتواند سند متالینک (Metalink) را تجزیه کند. .TP .B 21 اگر دستور FTP با شکست مواجه شود. .TP .B 22 اگر سرآیند پاسخ HTTP نامعتبر یا غیرمنتظره باشد. .TP .B 23 اگر تعداد تغییر مسیرها (redirects) بیش از حد باشد. .TP .B 24 اگر احراز هویت HTTP ناموفق باشد. .TP .B 25 اگر aria2 نتواند فایل کدگذاری‌شده با bencode (معمولاً فایل \(dq.torrent\(dq) را تجزیه کند. .TP .B 26 اگر فایل \(dq.torrent\(dq آسیب دیده باشد یا اطلاعات مورد نیاز aria2 در آن موجود نباشد. .TP .B 27 اگر نشانی Magnet نامعتبر باشد. .TP .B 28 اگر گزینه نامعتبر/ناشناخته‌ای داده شود یا آرگومان غیرمنتظره‌ای برای یک گزینه مشخص گردد. .TP .B 29 اگر سرور دوردست به دلیل بار کاری موقت یا عملیات نگهداری قادر به رسیدگی به درخواست نباشد. .TP .B 30 اگر aria2 نتواند درخواست JSON\-RPC را تجزیه کند. .TP .B 31 رزرو شده است. استفاده نمی‌شود. .TP .B 32 اگر اعتبارسنجی جمع کنترلی (checksum) با شکست مواجه شود. .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 خطایی که در یک دانلودِ به پایان رسیده رخ دهد، به عنوان وضعیت خروج گزارش نخواهد شد. .UNINDENT .UNINDENT .SH "متغیرهای محیطی (ENVIRONMENT)" .sp برنامه aria2 متغیرهای محیطی زیر را شناسایی می‌کند. .INDENT 0.0 .TP .B \fBhttp_proxy [http://][USER:PASSWORD@]HOST[:PORT]\fP مشخص کردن سرور پروکسی برای استفاده در پروتکل HTTP. بر مقدار http\-proxy در فایل پیکربندی اولویت دارد. گزینه خط فرمان \fI\%\-\-http\-proxy\fP بر این مقدار اولویت خواهد داشت. .TP .B \fBhttps_proxy [http://][USER:PASSWORD@]HOST[:PORT]\fP مشخص کردن سرور پروکسی برای استفاده در پروتکل HTTPS. بر مقدار https\-proxy در فایل پیکربندی اولویت دارد. گزینه خط فرمان \fI\%\-\-https\-proxy\fP بر این مقدار اولویت خواهد داشت. .TP .B \fBftp_proxy [http://][USER:PASSWORD@]HOST[:PORT]\fP مشخص کردن سرور پروکسی برای استفاده در پروتکل FTP. بر مقدار ftp\-proxy در فایل پیکربندی اولویت دارد. گزینه خط فرمان \fI\%\-\-ftp\-proxy\fP بر این مقدار اولویت خواهد داشت. .TP .B \fBall_proxy [http://][USER:PASSWORD@]HOST[:PORT]\fP مشخص کردن سرور پروکسی در صورتی که پروکسی اختصاصی برای پروتکل تعیین نشده باشد. بر مقدار all\-proxy در فایل پیکربندی اولویت دارد. گزینه خط فرمان \fI\%\-\-all\-proxy\fP بر این مقدار اولویت خواهد داشت. .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اگرچه aria2 طرح‌های \fBftp://\fP و \fBhttps://\fP را در نشانی پروکسی می‌پذیرد، اما صرفاً فرض می‌کند که \fBhttp://\fP مشخص شده است و رفتار خود را بر اساس طرح مشخص‌شده تغییر نمی‌دهد. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \fBno_proxy [DOMAIN,...]\fP مشخص کردن فهرستی جداشده با کاما از نام‌های میزبان، دامنه‌ها و نشانی‌های شبکه با یا بدون ماسک زیرشبکه که نباید در آن‌ها از پروکسی استفاده شود. بر مقدار \fIno\-proxy\fP در فایل پیکربندی اولویت دارد. گزینه خط فرمان \fI\%\-\-no\-proxy\fP بر این مقدار اولویت خواهد داشت. .UNINDENT .SH "فایل‌ها (FILES)" .SS aria2.conf .sp به‌طور پیش‌فرض، aria2 بررسی می‌کند که آیا مسیر قدیمی \fB$HOME/.aria2/aria2.conf\fP موجود است یا خیر، در غیر این صورت \fB$XDG_CONFIG_HOME/aria2/aria2.conf\fP را به عنوان فایل پیکربندی خود تجزیه می‌کند. شما می‌توانید با استفاده از گزینه \fI\%\-\-conf\-path\fP مسیر فایل پیکربندی را مشخص کنید. اگر نمی‌خواهید از فایل پیکربندی استفاده کنید، از گزینه \fI\%\-\-no\-conf\fP استفاده کنید. .sp فایل پیکربندی یک فایل متنی است و در هر خط ۱ گزینه قرار می‌گیرد. در هر خط، می‌توانید جفت نام\-مقدار را با قالب \fBNAME=VALUE\fP مشخص کنید، که در آن name نام طولانی گزینه در خط فرمان بدون پیشوند \fB\-\-\fP است. می‌توانید از همان نحو برای گزینه‌های خط فرمان استفاده کنید. خطوطی که با \fB#\fP شروع می‌شوند به عنوان کامنت در نظر گرفته می‌شوند: .INDENT 0.0 .INDENT 3.5 .sp .EX # sample configuration file for aria2c listen\-port=60000 dht\-listen\-port=60000 seed\-ratio=1.0 max\-upload\-limit=50K ftp\-pasv=true .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 ممکن است اطلاعات محرمانه‌ای مانند نام کاربری/گذرواژه در فایل پیکربندی گنجانده شود. توصیه می‌شود بیت‌های دسترسی حالت فایل (file mode bits) فایل پیکربندی را تغییر دهید (مانند \fBchmod 600 aria2.conf\fP) تا کاربران دیگر نتوانند محتوای فایل را ببینند. .UNINDENT .UNINDENT .sp متغیرهای محیطی، مانند \fB${HOME}\fP، توسط پوسته بسط داده می‌شوند. این بدان معناست که آن متغیرهای استفاده‌شده در فایل پیکربندی به‌طور خودکار بسط داده نمی‌شوند. با این حال، استفاده از \fB${HOME}\fP برای ارجاع به دایرکتوری خانگی کاربر در فایل پیکربندی جهت تعیین مسیر فایل‌ها بسیار سودمند است. از این رو، aria2 متغیر \fB${HOME}\fP را که در مقادیر گزینه‌های زیر یافت شود به دایرکتوری خانگی کاربر بسط می‌دهد: .INDENT 0.0 .IP \(bu 2 \fI\%ca\-certificate\fP .IP \(bu 2 \fI\%certificate\fP .IP \(bu 2 \fI\%dht\-file\-path\fP .IP \(bu 2 \fI\%dht\-file\-path6\fP .IP \(bu 2 \fI\%dir\fP .IP \(bu 2 \fI\%input\-file\fP .IP \(bu 2 \fI\%load\-cookies\fP .IP \(bu 2 \fI\%log\fP .IP \(bu 2 \fI\%metalink\-file\fP .IP \(bu 2 \fI\%netrc\-path\fP .IP \(bu 2 \fI\%on\-bt\-download\-complete\fP .IP \(bu 2 \fI\%on\-download\-complete\fP .IP \(bu 2 \fI\%on\-download\-error\fP .IP \(bu 2 \fI\%on\-download\-start\fP .IP \(bu 2 \fI\%on\-download\-stop\fP .IP \(bu 2 \fI\%on\-download\-pause\fP .IP \(bu 2 \fI\%out\fP .IP \(bu 2 \fI\%private\-key\fP .IP \(bu 2 \fI\%rpc\-certificate\fP .IP \(bu 2 \fI\%rpc\-private\-key\fP .IP \(bu 2 \fI\%save\-cookies\fP .IP \(bu 2 \fI\%save\-session\fP .IP \(bu 2 \fI\%server\-stat\-if\fP .IP \(bu 2 \fI\%server\-stat\-of\fP .IP \(bu 2 \fI\%torrent\-file\fP .UNINDENT .sp توجه داشته باشید که این بسط حتی در صورتی که گزینه‌های بالا در خط فرمان استفاده شوند نیز رخ می‌دهد. این بدان معناست که بسط ممکن است ۲ بار رخ دهد: ابتدا، پوسته و سپس aria2c. .SS dht.dat .sp مگر در مواردی که مسیرهای فایل قدیمی \fB$HOME/.aria2/dht.dat\fP و \fB$HOME/.aria2/dht6.dat\fP به فایل‌های موجود اشاره داشته باشند، جدول مسیریابی DHT مربوط به IPv4 در مسیر \fB$XDG_CACHE_HOME/aria2/dht.dat\fP و جدول مسیریابی DHT مربوط به IPv6 در مسیر \fB$XDG_CACHE_HOME/aria2/dht6.dat\fP ذخیره می‌شود. .SS Netrc .sp پشتیبانی از Netrc به‌طور پیش‌فرض برای HTTP(S)/FTP/SFTP فعال است. برای غیرفعال کردن پشتیبانی از netrc، گزینه \fI\%\-\-no\-netrc\fP را مشخص کنید. فایل .netrc شما باید دارای مجوزهای دسترسی صحیح (600) باشد. .sp اگر نام ماشین با \fB\&.\fP شروع شود، aria2 به‌جای تطابق دقیق، تطابق دامنه (domain\-match) انجام می‌دهد. این قابلیت یکی از افزونه‌های aria2 است. برای نمونه‌ای از تطابق دامنه، ورودی .netrc زیر را در نظر بگیرید: .INDENT 0.0 .INDENT 3.5 .sp .EX machine .example.org login myid password mypasswd .EE .UNINDENT .UNINDENT .sp دامنه \fBaria2.example.org\fP با \fB\&.example.org\fP تطابق دامنه‌ای پیدا کرده و از \fBmyid\fP و \fBmypasswd\fP استفاده می‌کند. .sp چند مثال از تطابق دامنه در ادامه آمده است: \fBexample.net\fP با \fB\&.example.org\fP تطابق دامنه ندارد. \fBexample.org\fP به دلیل وجود \fB\&.\fP در ابتدا، با \fB\&.example.org\fP تطابق دامنه ندارد. اگر می‌خواهید با \fBexample.org\fP تطابق پیدا کند، \fBexample.org\fP را مشخص نمایید. .SS "فایل کنترلی (Control File)" .sp برنامه aria2 برای رهگیری پیشرفت دانلود از یک فایل کنترلی استفاده می‌کند. یک فایل کنترلی در همان دایرکتوری فایل در حال دانلود قرار داده می‌شود و نام فایل آن برابر با نام فایل در حال دانلود به همراه \fB\&.aria2\fP در انتهای آن است. به عنوان مثال، اگر در حال دانلود file.zip هستید، آنگاه فایل کنترلی باید file.zip.aria2 باشد. (یک استثنا برای این قاعده نام‌گذاری وجود دارد. اگر در حال دانلود یک تورنت چندگانه (multi torrent) هستید، فایل کنترلی آن برابر با نام دایرکتوری اصلی (\(dqtop directory\(dq) تورنت به همراه \fB\&.aria2\fP در انتهای آن است. نام دایرکتوری اصلی مقدار کلید \(dqname\(dq در دایرکتوری \(dqinfo\(dq درون فایل تورنت است.) .sp معمولاً پس از تکمیل دانلود، فایل کنترلی حذف می‌شود. اگر aria2 تشخیص دهد که دانلود قابل ازسرگیری نیست (به عنوان مثال هنگام دانلود فایلی از یک سرور HTTP که از ازسرگیری دانلود پشتیبانی نمی‌کند)، فایل کنترلی ایجاد نمی‌شود. .sp به‌طور معمول اگر یک فایل کنترلی را گم کنید، نمی‌توانید دانلود را ادامه دهید. اما اگر یک تورنت یا متالینک با جمع کنترلی قطعات (chunk checksums) برای آن فایل دارید، می‌توانید با دادن گزینه \-V به aria2c در خط فرمان، دانلود را بدون فایل کنترلی از سر بگیرید. .SS "فایل ورودی (Input File)" .sp فایل ورودی می‌تواند شامل فهرستی از نشانی‌ها (URIs) باشد تا aria2 آن‌ها را دانلود کند. شما می‌توانید چندین نشانی را برای یک موجودیت واحد مشخص کنید: نشانی‌ها را روی یک خط واحد با استفاده از نویسه TAB جدا کنید. .sp با هر خط به‌گونه‌ای رفتار می‌شود که گویی در آرگومان خط فرمان ارائه شده است. بنابراین آن‌ها تحت تأثیر گزینه‌های \fI\%\-\-force\-sequential\fP و \fI\%\-\-parameterized\-uri\fP قرار می‌گیرند. .sp از آنجا که نشانی‌های موجود در فایل ورودی مستقیماً توسط aria2 خوانده می‌شوند، نباید با نقل‌قول‌های تکی (\fB\(aq\fP) یا دوتایی (\fB\(dq\fP) محصور شوند. .sp خطوطی که با \fB#\fP شروع می‌شوند به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شوند. .sp علاوه بر این، گزینه‌های زیر را می‌توان پس از هر خط از نشانی‌ها مشخص کرد. این خطوط گزینه‌ها باید حتماً با یک یا چند نویسه فاصله (whitespace) شروع شوند. .INDENT 0.0 .INDENT 2.0 .IP \(bu 2 \fI\%all\-proxy\fP .IP \(bu 2 \fI\%all\-proxy\-passwd\fP .IP \(bu 2 \fI\%all\-proxy\-user\fP .IP \(bu 2 \fI\%allow\-overwrite\fP .IP \(bu 2 \fI\%allow\-piece\-length\-change\fP .IP \(bu 2 \fI\%always\-resume\fP .IP \(bu 2 \fI\%async\-dns\fP .IP \(bu 2 \fI\%auto\-file\-renaming\fP .IP \(bu 2 \fI\%bt\-enable\-hook\-after\-hash\-check\fP .IP \(bu 2 \fI\%bt\-enable\-lpd\fP .IP \(bu 2 \fI\%bt\-exclude\-tracker\fP .IP \(bu 2 \fI\%bt\-external\-ip\fP .IP \(bu 2 \fI\%bt\-force\-encryption\fP .IP \(bu 2 \fI\%bt\-hash\-check\-seed\fP .IP \(bu 2 \fI\%bt\-load\-saved\-metadata\fP .IP \(bu 2 \fI\%bt\-max\-peers\fP .IP \(bu 2 \fI\%bt\-metadata\-only\fP .IP \(bu 2 \fI\%bt\-min\-crypto\-level\fP .IP \(bu 2 \fI\%bt\-prioritize\-piece\fP .IP \(bu 2 \fI\%bt\-remove\-unselected\-file\fP .IP \(bu 2 \fI\%bt\-request\-peer\-speed\-limit\fP .IP \(bu 2 \fI\%bt\-require\-crypto\fP .IP \(bu 2 \fI\%bt\-save\-metadata\fP .IP \(bu 2 \fI\%bt\-seed\-unverified\fP .IP \(bu 2 \fI\%bt\-stop\-timeout\fP .IP \(bu 2 \fI\%bt\-tracker\fP .IP \(bu 2 \fI\%bt\-tracker\-connect\-timeout\fP .IP \(bu 2 \fI\%bt\-tracker\-interval\fP .IP \(bu 2 \fI\%bt\-tracker\-timeout\fP .IP \(bu 2 \fI\%check\-integrity\fP .IP \(bu 2 \fI\%checksum\fP .IP \(bu 2 \fI\%conditional\-get\fP .IP \(bu 2 \fI\%connect\-timeout\fP .IP \(bu 2 \fI\%content\-disposition\-default\-utf8\fP .IP \(bu 2 \fI\%continue\fP .IP \(bu 2 \fI\%dir\fP .IP \(bu 2 \fI\%dry\-run\fP .UNINDENT .INDENT 2.0 .IP \(bu 2 \fI\%enable\-http\-keep\-alive\fP .IP \(bu 2 \fI\%enable\-http\-pipelining\fP .IP \(bu 2 \fI\%enable\-mmap\fP .IP \(bu 2 \fI\%enable\-peer\-exchange\fP .IP \(bu 2 \fI\%file\-allocation\fP .IP \(bu 2 \fI\%follow\-metalink\fP .IP \(bu 2 \fI\%follow\-torrent\fP .IP \(bu 2 \fI\%force\-save\fP .IP \(bu 2 \fI\%ftp\-passwd\fP .IP \(bu 2 \fI\%ftp\-pasv\fP .IP \(bu 2 \fI\%ftp\-proxy\fP .IP \(bu 2 \fI\%ftp\-proxy\-passwd\fP .IP \(bu 2 \fI\%ftp\-proxy\-user\fP .IP \(bu 2 \fI\%ftp\-reuse\-connection\fP .IP \(bu 2 \fI\%ftp\-type\fP .IP \(bu 2 \fI\%ftp\-user\fP .IP \(bu 2 \fI\%gid\fP .IP \(bu 2 \fI\%hash\-check\-only\fP .IP \(bu 2 \fI\%header\fP .IP \(bu 2 \fI\%http\-accept\-gzip\fP .IP \(bu 2 \fI\%http\-auth\-challenge\fP .IP \(bu 2 \fI\%http\-no\-cache\fP .IP \(bu 2 \fI\%http\-passwd\fP .IP \(bu 2 \fI\%http\-proxy\fP .IP \(bu 2 \fI\%http\-proxy\-passwd\fP .IP \(bu 2 \fI\%http\-proxy\-user\fP .IP \(bu 2 \fI\%http\-user\fP .IP \(bu 2 \fI\%https\-proxy\fP .IP \(bu 2 \fI\%https\-proxy\-passwd\fP .IP \(bu 2 \fI\%https\-proxy\-user\fP .IP \(bu 2 \fI\%index\-out\fP .IP \(bu 2 \fI\%lowest\-speed\-limit\fP .IP \(bu 2 \fI\%max\-connection\-per\-server\fP .IP \(bu 2 \fI\%max\-download\-limit\fP .IP \(bu 2 \fI\%max\-file\-not\-found\fP .IP \(bu 2 \fI\%max\-mmap\-limit\fP .IP \(bu 2 \fI\%max\-resume\-failure\-tries\fP .UNINDENT .INDENT 2.0 .IP \(bu 2 \fI\%max\-tries\fP .IP \(bu 2 \fI\%max\-upload\-limit\fP .IP \(bu 2 \fI\%metalink\-base\-uri\fP .IP \(bu 2 \fI\%metalink\-enable\-unique\-protocol\fP .IP \(bu 2 \fI\%metalink\-language\fP .IP \(bu 2 \fI\%metalink\-location\fP .IP \(bu 2 \fI\%metalink\-os\fP .IP \(bu 2 \fI\%metalink\-preferred\-protocol\fP .IP \(bu 2 \fI\%metalink\-version\fP .IP \(bu 2 \fI\%min\-split\-size\fP .IP \(bu 2 \fI\%no\-file\-allocation\-limit\fP .IP \(bu 2 \fI\%no\-netrc\fP .IP \(bu 2 \fI\%no\-proxy\fP .IP \(bu 2 \fI\%out\fP .IP \(bu 2 \fI\%parameterized\-uri\fP .IP \(bu 2 \fI\%pause\fP .IP \(bu 2 \fI\%pause\-metadata\fP .IP \(bu 2 \fI\%piece\-length\fP .IP \(bu 2 \fI\%proxy\-method\fP .IP \(bu 2 \fI\%realtime\-chunk\-checksum\fP .IP \(bu 2 \fI\%referer\fP .IP \(bu 2 \fI\%remote\-time\fP .IP \(bu 2 \fI\%remove\-control\-file\fP .IP \(bu 2 \fI\%retry\-wait\fP .IP \(bu 2 \fI\%reuse\-uri\fP .IP \(bu 2 \fI\%rpc\-save\-upload\-metadata\fP .IP \(bu 2 \fI\%seed\-ratio\fP .IP \(bu 2 \fI\%seed\-time\fP .IP \(bu 2 \fI\%select\-file\fP .IP \(bu 2 \fI\%split\fP .IP \(bu 2 \fI\%ssh\-host\-key\-md\fP .IP \(bu 2 \fI\%stream\-piece\-selector\fP .IP \(bu 2 \fI\%timeout\fP .IP \(bu 2 \fI\%uri\-selector\fP .IP \(bu 2 \fI\%use\-head\fP .IP \(bu 2 \fI\%user\-agent\fP .UNINDENT .UNINDENT .sp این گزینه‌ها دقیقاً همان مفهوم گزینه‌های خط فرمان را دارند، اما فقط روی نشانی‌هایی اعمال می‌شوند که به آن‌ها تعلق دارند. لطفاً توجه داشته باشید که برای گزینه‌های درون فایل ورودی، پیشوند \fB\-\-\fP باید حذف شود. .sp به عنوان مثال، محتوای uri.txt به این صورت است: .INDENT 0.0 .INDENT 3.5 .sp .EX http://server/file.iso http://mirror/file.iso dir=/iso_images out=file.img http://foo/bar .EE .UNINDENT .UNINDENT .sp اگر aria2 با گزینه‌های \fB\-i uri.txt \-d /tmp\fP اجرا شود، آنگاه \fBfile.iso\fP در \fB/iso_images/file.img\fP ذخیره شده و از \fBhttp://server/file.iso\fP و \fBhttp://mirror/file.iso\fP دانلود می‌شود. فایل \fBbar\fP از \fBhttp://foo/bar\fP دانلود شده و در \fB/tmp/bar\fP ذخیره می‌گردد. .sp در برخی موارد، پارامتر \fI\%out\fP هیچ تأثیری ندارد. برای اطلاع از محدودیت‌ها، نکته مربوط به گزینه \fI\%\-\-out\fP را ببینید. .SS "پروفایل عملکرد سرور (Server Performance Profile)" .sp این بخش قالب پروفایل عملکرد سرور را توصیف می‌کند. این فایل یک متن ساده است و هر خط شامل چندین جفت \fBNAME=VALUE\fP است که با کاما از هم جدا شده‌اند. در حال حاضر نام‌های (NAME) زیر شناسایی می‌شوند: .INDENT 0.0 .TP .B \fBhost\fP نام میزبان سرور. الزامی. .TP .B \fBprotocol\fP پروتکل برای این پروفایل، مانند ftp یا http. الزامی. .TP .B \fBdl_speed\fP میانگین سرعت دانلود مشاهده‌شده در دانلود قبلی بر حسب بایت بر ثانیه. الزامی. .TP .B \fBsc_avg_speed\fP میانگین سرعت دانلود مشاهده‌شده در دانلود قبلی بر حسب بایت بر ثانیه. این مقدار تنها در صورتی به‌روزرسانی می‌شود که دانلود در محیط تک‌اتصالی انجام شده باشد و تنها توسط AdaptiveURISelector استفاده می‌شود. اختیاری. .TP .B \fBmc_avg_speed\fP میانگین سرعت دانلود مشاهده‌شده در دانلود قبلی بر حسب بایت بر ثانیه. این مقدار تنها در صورتی به‌روزرسانی می‌شود که دانلود در محیط چنداتصالی انجام شده باشد و تنها توسط AdaptiveURISelector استفاده می‌شود. اختیاری. .TP .B \fBcounter\fP تعداد دفعاتی که از سرور استفاده شده است. در حال حاضر این مقدار تنها توسط AdaptiveURISelector استفاده می‌شود. اختیاری. .TP .B \fBlast_updated\fP آخرین زمان تماس با این سرور به وقت گرینویچ (GMT)، مشخص‌شده بر حسب ثانیه‌های سپری‌شده از مبدأ یونیکس یا Epoch (ساعت 00:00:00 در ۱ ژانویه ۱۹۷۰، UTC). الزامی. .TP .B \fBstatus\fP هنگامی که سرور غیرقابل دسترس باشد یا از سرویس‌دهی خارج شده باشد یا مهلت زمانی پایان یابد، مقدار ERROR تنظیم می‌شود. در غیر این صورت، مقدار OK تنظیم خواهد شد. .UNINDENT .sp این فیلدها باید در یک خط وجود داشته باشند. ترتیب فیلدها اهمیتی ندارد. شما می‌توانید جفت‌هایی غیر از موارد بالا را نیز قرار دهید؛ آن‌ها صرفاً نادیده گرفته می‌شوند. .sp نمونه‌ای در ادامه آمده است: .INDENT 0.0 .INDENT 3.5 .sp .EX host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR .EE .UNINDENT .UNINDENT .SH "رابط RPC (RPC INTERFACE)" .sp برنامه aria2 رابط‌های JSON\-RPC بر بستر HTTP و XML\-RPC بر بستر HTTP را ارائه می‌دهد که اساساً قابلیت‌های یکسانی دارند. همچنین aria2 رابط JSON\-RPC بر بستر وب‌سوکت (WebSocket) را نیز فراهم می‌کند. پروتکل JSON\-RPC بر بستر وب‌سوکت از همان امضاهای متد و قالب‌های پاسخ JSON\-RPC بر بستر HTTP استفاده می‌کند، اما علاوه بر آن، اعلان‌های ارائه‌شده از سمت سرور را نیز مهیا می‌سازد. برای اطلاعات بیشتر بخش \fI\%JSON\-RPC over WebSocket\fP را ببینید. .sp مسیر درخواست رابط JSON\-RPC (هم بر بستر HTTP و هم بر بستر وب‌سوکت) برابر با \fB/jsonrpc\fP\& است. مسیر درخواست رابط XML\-RPC برابر با \fB/rpc\fP\& است. .sp نشانی وب‌سوکت برای JSON\-RPC بر بستر وب‌سوکت به‌صورت \fBws://HOST:PORT/jsonrpc\fP\& است. در صورتی که رمزنگاری SSL/TLS را فعال کرده‌اید، به جای آن از \fBwss://HOST:PORT/jsonrpc\fP\& استفاده کنید. .sp پیاده‌سازی JSON\-RPC بر پایه استاندارد JSON\-RPC 2.0 <\fI\%http://jsonrpc.org/specification\fP> است و از روش‌های HTTP POST و GET (JSONP) پشتیبانی می‌کند. انتقال بر بستر وب‌سوکت یکی از افزونه‌های اختصاصی aria2 است. .sp رابط JSON\-RPC از اعلان‌ها بر بستر HTTP پشتیبانی نمی‌کند، اما سرور RPC اعلان‌ها را بر بستر وب‌سوکت ارسال خواهد کرد. همچنین این رابط از اعداد اعشاری ممیز شناور پشتیبانی نمی‌کند. کدگذاری نویسه‌ها باید حتماً UTF\-8 باشد. .sp هنگام مطالعه مستندات زیر برای JSON\-RPC، ساختارها (structs) را به عنوان اشیاء JSON در نظر بگیرید. .SS "اصطلاحات (Terminology)" .sp GID .INDENT 0.0 .INDENT 3.5 شناسه GID (یا gid) کلیدی برای مدیریت هر دانلود است. به هر دانلود یک GID یکتا اختصاص داده می‌شود. شناسه GID در aria2 به‌صورت یک مقدار باینری ۶۴ بیتی ذخیره می‌شود. برای دسترسی از طریق RPC، این شناسه به‌صورت یک رشته هگزادسیمال ۱۶ کاراکتری نمایش داده می‌شود (مانند \fB2089b05ecca3d829\fP). به‌طور معمول، aria2 این GID را برای هر دانلود تولید می‌کند، اما کاربر می‌تواند با استفاده از گزینه \fI\%\-\-gid\fP شناسه‌های GID را به‌صورت دستی نیز مشخص کند. هنگام پرس‌وجوی دانلودها بر اساس GID، تا زمانی که پیشوند واردشده میان سایر شناسه‌ها یکتا باشد، می‌توانید تنها پیشوندی از GID را مشخص کنید. .UNINDENT .UNINDENT .SS "توکن محرمانه احراز هویت RPC (RPC authorization secret token)" .sp از نسخه 1.18.4 به بعد، برنامه aria2 علاوه بر احراز هویت پایه HTTP، احراز هویت در سطح متدهای RPC را نیز فراهم کرده است. در انتشار‌های آینده، احراز هویت پایه HTTP حذف خواهد شد و احراز هویت در سطح متد RPC اجباری می‌شود. .sp برای استفاده از احراز هویت در سطح متد RPC، کاربر باید با استفاده از گزینه \fI\%\-\-rpc\-secret\fP یک توکن امنیتی محرمانه تعیین کند. برای فراخوانی هر متد RPC، فراخواننده باید این توکن را با پیشوند \fBtoken:\fP\& ارسال کند. حتی زمانی که از گزینه \fI\%\-\-rpc\-secret\fP استفاده نشده باشد، اگر اولین پارامتر در متد RPC یک رشته باشد و با \fBtoken:\fP شروع شود، پیش از پردازش درخواست از لیست پارامترها حذف خواهد شد. .sp به عنوان مثال، اگر توکن محرمانه RPC برابر با \fB$$secret$$\fP باشد، فراخوانی متد RPC با نام \fIaria2.addUri\fP باید بدین صورت باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX aria2.addUri(\(dqtoken:$$secret$$\(dq, [\(dqhttp://example.org/file\(dq]) .EE .UNINDENT .UNINDENT .sp با متد RPC به نام \fIsystem.multicall\fP به‌طور ویژه‌ای برخورد می‌شود. از آنجا که مشخصات XML\-RPC فقط اجازه ارسال یک آرایه منفرد به عنوان پارامتر برای این متد را می‌دهد، ما توکن را در خود فراخوانی مشخص نمی‌کنیم. در عوض، هر فراخوانی متد تو در تو باید طبق توضیحات بالا، توکن را به عنوان پارامتر اول مهیا سازد. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اعتبارسنجی توکن محرمانه در aria2 طوری طراحی شده است که حداقل مدت زمان مشخصی طول بکشد تا حملات بروت‌فورس/فرهنگ‌لغتی (brute\-force/dictionary) علیه رابط RPC خنثی شوند. بنابراین توصیه می‌شود در موارد مناسب، از درخواست‌های دسته‌ای (Batch) یا \fIsystem.multicall\fP استفاده کنید. .sp متدهای \fIsystem.listMethods\fP و \fIsystem.listNotifications\fP را می‌توان بدون توکن اجرا کرد. از آنجا که این متدها صرفاً متدها/اعلان‌های موجود را بازمی‌گردانند و چیزی را تغییر نمی‌دهند، بدون توکن محرمانه نیز امن هستند. .UNINDENT .UNINDENT .SS "متدها (Methods)" .sp تمام مثال‌های کد با مفسر پایتون 2.7 سازگار هستند. برای اطلاعات درباره پارامتر \fIsecret\fP، بخش \fI\%RPC authorization secret token\fP\& را ببینید. .INDENT 0.0 .TP .B aria2.addUri([secret], uris[, options[, position]]) این متد یک دانلود جدید اضافه می‌کند. \fIuris\fP یک آرایه از نشانی‌های URIs (رشته‌ها) برای پروتکل‌های HTTP/FTP/SFTP/BitTorrent است که به یک منبع یکسان اشاره دارند. اگر نشانی‌های اشاره‌کننده به منابع مختلف را با هم ترکیب کنید، دانلود ممکن است با شکست مواجه شود یا بدون اعلام خطایی از سوی aria2 خراب گردد. هنگام افزودن نشانی‌های مگنت بیت‌تورنت (BitTorrent Magnet URIs)، پارامتر \fIuris\fP باید تنها دارای یک عنصر باشد و آن عنصر نیز باید نشانی Magnet بیت‌تورنت باشد. پارامتر \fIoptions\fP یک ساختار (struct) است و اعضای آن جفت‌های نام گزینه و مقدار هستند. برای جزئیات بیشتر، بخش \fI\%گزینه‌ها (Options)\fP در ادامه را ببینید. در صورت تعیین \fIposition\fP، این مقدار باید یک عدد صحیح از 0 به بالا باشد. دانلود جدید در موقعیت \fIposition\fP در صف انتظار درج خواهد شد. اگر \fIposition\fP حذف شود یا مقدار آن از اندازه فعلی صف بزرگ‌تر باشد، دانلود جدید به انتهای صف افزوده می‌شود. این متد شناسه GID دانلود جدیداً ثبت‌شده را بازمی‌گرداند. .sp \fBمثال JSON\-RPC\fP .sp مثال زیر نشانی \fBhttp://example.org/file\fP را اضافه می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.addUri\(aq, \&... \(aqparams\(aq:[[\(aqhttp://example.org/file\(aq]]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> c.read() \(aq{\(dqid\(dq:\(dqqwer\(dq,\(dqjsonrpc\(dq:\(dq2.0\(dq,\(dqresult\(dq:\(dq2089b05ecca3d829\(dq}\(aq .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .sp مثال زیر نشانی \fBhttp://example.org/file\fP را اضافه می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.addUri([\(aqhttp://example.org/file\(aq]) \(aq2089b05ecca3d829\(aq .EE .UNINDENT .UNINDENT .sp مثال زیر یک دانلود جدید را با دو منبع و چند گزینه اضافه می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> s.aria2.addUri([\(aqhttp://example.org/file\(aq, \(aqhttp://mirror/file\(aq], dict(dir=\(dq/tmp\(dq)) \(aqd2703803b52216d1\(aq .EE .UNINDENT .UNINDENT .sp مثال زیر یک دانلود اضافه کرده و آن را در ابتدای صف قرار می‌دهد: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> s.aria2.addUri([\(aqhttp://example.org/file\(aq], {}, 0) \(aqca3d829cee549a4d\(aq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.addTorrent([secret], torrent[, uris[, options[, position]]]) این متد با بارگذاری یک فایل \(dq.torrent\(dq یک دانلود بیت‌تورنت اضافه می‌کند. اگر می‌خواهید یک نشانی مگنت بیت‌تورنت اضافه کنید، به جای آن از متد \fI\%aria2.addUri()\fP استفاده نمایید. پارامتر \fItorrent\fP باید یک رشته کدگذاری‌شده با base64 شامل محتویات فایل \(dq.torrent\(dq باشد. پارامتر \fIuris\fP یک آرایه از نشانی‌های URIs (رشته) است. از \fIuris\fP برای سیدینگ وب (Web\-seeding) استفاده می‌شود. برای تورنت‌های تک‌فایلی، این نشانی می‌تواند یک URI کامل با اشاره به منبع باشد؛ اگر URI با / خاتمه یابد، نام موجود در فایل تورنت به آن افزوده می‌شود. برای تورنت‌های چندفایلی، نام و مسیر در تورنت اضافه می‌شوند تا یک URI برای هر فایل تشکیل دهند. پارامتر \fIoptions\fP یک ساختار (struct) است و اعضای آن جفت‌های نام گزینه و مقدار هستند. برای جزئیات بیشتر بخش \fI\%گزینه‌ها (Options)\fP در ادامه را ببینید. در صورت تعیین \fIposition\fP، این مقدار باید یک عدد صحیح از 0 به بالا باشد. دانلود جدید در موقعیت \fIposition\fP در صف انتظار درج خواهد شد. اگر \fIposition\fP حذف شود یا مقدار آن از اندازه فعلی صف بزرگ‌تر باشد، دانلود جدید به انتهای صف افزوده می‌شود. این متد شناسه GID دانلود جدیداً ثبت‌شده را بازمی‌گرداند. اگر گزینه \fI\%\-\-rpc\-save\-upload\-metadata\fP برابر با \fBtrue\fP باشد، داده‌های بارگذاری‌شده به‌صورت یک فایل با نامی شامل رشته هگز هش SHA\-1 داده‌ها به همراه پسوند \(dq.torrent\(dq در پوشه مشخص‌شده با گزینه \fI\%\-\-dir\fP ذخیره می‌شوند؛ برای مثال نام فایل ممکن است \fB0a3893293e27ac0490424c06de4d09242215f0a6.torrent\fP\& باشد. اگر فایلی با همین نام از قبل وجود داشته باشد، بازنویسی (overwrite) خواهد شد! اگر فایل نتواند با موفقیت ذخیره شود یا گزینه \fI\%\-\-rpc\-save\-upload\-metadata\fP برابر با \fBfalse\fP باشد، دانلودهای اضافه‌شده توسط این متد توسط گزینه \fI\%\-\-save\-session\fP\& ذخیره نمی‌شوند. .sp مثال‌های زیر فایل محلی \fBfile.torrent\fP\& را اضافه می‌کنند. .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json, base64 >>> torrent = base64.b64encode(open(\(aqfile.torrent\(aq).read()) >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqasdf\(aq, \&... \(aqmethod\(aq:\(aqaria2.addTorrent\(aq, \(aqparams\(aq:[torrent]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> c.read() \(aq{\(dqid\(dq:\(dqasdf\(dq,\(dqjsonrpc\(dq:\(dq2.0\(dq,\(dqresult\(dq:\(dq2089b05ecca3d829\(dq}\(aq .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.addTorrent(xmlrpclib.Binary(open(\(aqfile.torrent\(aq, mode=\(aqrb\(aq).read())) \(aq2089b05ecca3d829\(aq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.addMetalink([secret], metalink[, options[, position]]) این متد با بارگذاری یک فایل \(dq.metalink\(dq یک دانلود متالینک اضافه می‌کند. پارامتر \fImetalink\fP یک رشته کدگذاری‌شده با base64 است که محتویات فایل \(dq.metalink\(dq را در بر دارد. پارامتر \fIoptions\fP یک ساختار (struct) است و اعضای آن جفت‌های نام گزینه و مقدار هستند. برای جزئیات بیشتر بخش \fI\%گزینه‌ها (Options)\fP در ادامه را ببینید. در صورت تعیین \fIposition\fP، این مقدار باید یک عدد صحیح از 0 به بالا باشد. دانلود جدید در موقعیت \fIposition\fP در صف انتظار درج خواهد شد. اگر \fIposition\fP حذف شود یا مقدار آن از اندازه فعلی صف بزرگ‌تر باشد، دانلود جدید به انتهای صف افزوده می‌شود. این متد آرایه‌ای از شناسه‌های GID دانلودهای جدیداً ثبت‌شده را بازمی‌گرداند. اگر گزینه \fI\%\-\-rpc\-save\-upload\-metadata\fP برابر با \fBtrue\fP باشد، داده‌های بارگذاری‌شده به‌صورت یک فایل با نامی شامل رشته هگز هش SHA\-1 داده‌ها به همراه پسوند \(dq.metalink\(dq در پوشه مشخص‌شده با گزینه \fI\%\-\-dir\fP ذخیره می‌شوند؛ برای مثال نام فایل ممکن است \fB0a3893293e27ac0490424c06de4d09242215f0a6.metalink\fP\& باشد. اگر فایلی با همین نام از قبل وجود داشته باشد، بازنویسی خواهد شد! اگر فایل نتواند با موفقیت ذخیره شود یا گزینه \fI\%\-\-rpc\-save\-upload\-metadata\fP برابر با \fBfalse\fP باشد، دانلودهای اضافه‌شده توسط این متد توسط \fI\%\-\-save\-session\fP\& ذخیره نمی‌شوند. .sp مثال‌های زیر فایل محلی file.meta4 را اضافه می‌کنند. .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json, base64 >>> metalink = base64.b64encode(open(\(aqfile.meta4\(aq).read()) >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.addMetalink\(aq, \&... \(aqparams\(aq:[metalink]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> c.read() \(aq{\(dqid\(dq:\(dqqwer\(dq,\(dqjsonrpc\(dq:\(dq2.0\(dq,\(dqresult\(dq:[\(dq2089b05ecca3d829\(dq]}\(aq .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.addMetalink(xmlrpclib.Binary(open(\(aqfile.meta4\(aq, mode=\(aqrb\(aq).read())) [\(aq2089b05ecca3d829\(aq] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.remove([secret], gid) این متد دانلودی که با \fIgid\fP (رشته) مشخص شده را حذف می‌کند. اگر دانلود مشخص‌شده در حال انجام باشد، ابتدا متوقف می‌شود. وضعیت دانلود حذف‌شده به \fBremoved\fP\& تغییر می‌یابد. این متد شناسه GID دانلود حذف‌شده را بازمی‌گرداند. .sp مثال‌های زیر دانلودی با GID#2089b05ecca3d829 را حذف می‌کنند. .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.remove\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> c.read() \(aq{\(dqid\(dq:\(dqqwer\(dq,\(dqjsonrpc\(dq:\(dq2.0\(dq,\(dqresult\(dq:\(dq2089b05ecca3d829\(dq}\(aq .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.remove(\(aq2089b05ecca3d829\(aq) \(aq2089b05ecca3d829\(aq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.forceRemove([secret], gid) این متد دانلود مشخص‌شده با \fIgid\fP\& را حذف می‌کند. عملکرد این متد دقیقاً شبیه به \fI\%aria2.remove()\fP است، با این تفاوت که دانلود را بدون انجام اقدامات زمان‌بر (مانند تماس با ترکرهای بیت‌تورنت برای لغو ثبت اولیه دانلود) حذف می‌کند. .UNINDENT .INDENT 0.0 .TP .B aria2.pause([secret], gid) این متد دانلود مشخص‌شده با \fIgid\fP (رشته) را متوقف موقت (pause) می‌کند. وضعیت دانلود متوقف‌شده به \fBpaused\fP\& تبدیل می‌شود. اگر دانلود فعال بود، در ابتدای صف انتظار قرار می‌گیرد. تا زمانی که وضعیت \fBpaused\fP باشد، دانلود شروع نخواهد شد. برای تغییر وضعیت به \fBwaiting\fP، از متد \fI\%aria2.unpause()\fP استفاده کنید. این متد شناسه GID دانلود متوقف‌شده را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.pauseAll([secret]) این متد معادل فراخوانی \fI\%aria2.pause()\fP برای تمام دانلودهای فعال/در حال انتظار است. این متد مقدار \fBOK\fP\& را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.forcePause([secret], gid) این متد دانلود مشخص‌شده با \fIgid\fP\& را متوقف موقت می‌کند. عملکرد این متد دقیقاً شبیه به \fI\%aria2.pause()\fP است، با این تفاوت که دانلودها را بدون انجام اقدامات زمان‌بر (مانند تماس با ترکرهای بیت‌تورنت برای لغو ثبت دانلود) متوقف می‌کند. .UNINDENT .INDENT 0.0 .TP .B aria2.forcePauseAll([secret]) این متد معادل فراخوانی \fI\%aria2.forcePause()\fP برای تمام دانلودهای فعال/در حال انتظار است. این متد مقدار \fBOK\fP\& را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.unpause([secret], gid) این متد وضعیت دانلود مشخص‌شده با \fIgid\fP (رشته) را از \fBpaused\fP به \fBwaiting\fP تغییر داده و آن را واجد شرایط ازسرگیری دانلود می‌کند. این متد شناسه GID دانلود ازسرگرفته‌شده را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.unpauseAll([secret]) این متد معادل فراخوانی \fI\%aria2.unpause()\fP برای تمام دانلودهای متوقف‌شده است. این متد مقدار \fBOK\fP\& را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.tellStatus([secret], gid[, keys]) این متد میزان پیشرفت دانلود مشخص‌شده با \fIgid\fP (رشته) را بازمی‌گرداند. \fIkeys\fP آرایه‌ای از رشته‌ها است. در صورت تعیین شدن، پاسخ فقط شامل کلیدهای موجود در آرایه \fIkeys\fP خواهد بود. اگر \fIkeys\fP خالی باشد یا حذف شود، پاسخ شامل تمامی کلیدها خواهد بود. این ویژگی زمانی مفید است که شما فقط به دنبال دریافت کلیدهای خاصی هستید و می‌خواهید از انتقال‌های غیرضروری داده جلوگیری کنید. برای مثال، \fBaria2.tellStatus(\(dq2089b05ecca3d829\(dq, [\(dqgid\(dq, \(dqstatus\(dq])\fP تنها کلیدهای \fIgid\fP و \fIstatus\fP را بازمی‌گرداند. پاسخ یک ساختار (struct) است و شامل کلیدهای زیر است. مقادیر به‌صورت رشته هستند. .INDENT 7.0 .TP .B \fBgid\fP شناسه GID دانلود. .TP .B \fBstatus\fP مقدار \fBactive\fP برای دانلودهایی که هم‌اکنون در حال دریافت/سیدینگ هستند. مقدار \fBwaiting\fP برای دانلودهای حاضر در صف؛ دانلود هنوز شروع نشده است. مقدار \fBpaused\fP برای دانلودهای متوقف‌شده به صورت موقت. مقدار \fBerror\fP برای دانلودهایی که به دلیل خطا متوقف شده‌اند. مقدار \fBcomplete\fP برای دانلودهای متوقف‌شده و تکمیل‌شده. مقدار \fBremoved\fP برای دانلودهایی که توسط کاربر حذف شده‌اند. .TP .B \fBtotalLength\fP طول کلی دانلود به بایت. .TP .B \fBcompletedLength\fP طول تکمیل‌شده دانلود به بایت. .TP .B \fBuploadLength\fP طول آپلودشده دانلود به بایت. .TP .B \fBbitfield\fP نمایش هگزادسیمال پیشرفت دانلود. بالاترین بیت متناظر با قطعه در اندیس 0 است. هر بیت فعال نشان‌دهنده قطعات بارگیری‌شده است، در حالی که بیت‌های غیرفعال نشان می‌دهند قطعات هنوز دریافت نشده‌اند یا مفقود هستند. هر بیت اضافی در انتها با صفر پر می‌شود. هنگامی که دانلود هنوز شروع نشده باشد، این کلید در پاسخ گنجانده نخواهد شد. .TP .B \fBdownloadSpeed\fP سرعت دانلود این مورد بر حسب بایت بر ثانیه. .TP .B \fBuploadSpeed\fP سرعت آپلود این مورد بر حسب بایت بر ثانیه. .TP .B \fBinfoHash\fP هش اطلاعاتی (InfoHash). فقط مخصوص بیت‌تورنت. .TP .B \fBnumSeeders\fP تعداد سیدرهایی که aria2 به آن‌ها متصل شده است. فقط مخصوص بیت‌تورنت. .TP .B \fBseeder\fP مقدار \fBtrue\fP اگر نقطه پایانی محلی یک سیدر باشد؛ در غیر این صورت \fBfalse\fP\&. فقط مخصوص بیت‌تورنت. .TP .B \fBpieceLength\fP طول قطعه به بایت. .TP .B \fBnumPieces\fP تعداد قطعات. .TP .B \fBconnections\fP تعداد همتاها/سرورهایی که aria2 به آن‌ها متصل شده است. .TP .B \fBerrorCode\fP کد آخرین خطای رخ‌داده برای این مورد، در صورت وجود. مقدار یک رشته است. کدهای خطا در بخش \fI\%EXIT STATUS\fP تعریف شده‌اند. این مقدار تنها برای دانلودهای متوقف‌شده/تکمیل‌شده در دسترس است. .TP .B \fBerrorMessage\fP پیام خطای خوانا برای انسان که با \fBerrorCode\fP\& مرتبط است. .TP .B \fBfollowedBy\fP فهرستی از شناسه‌های GID که در نتیجه این دانلود تولید شده‌اند. به عنوان مثال، هنگامی که aria2 یک فایل متالینک را دانلود می‌کند، دانلودهای توصیف‌شده در متالینک را ایجاد می‌کند (گزینه \fI\%\-\-follow\-metalink\fP را ببینید). این مقدار برای ردیابی دانلودهای تولیدشده خودکار مفید است. اگر چنین دانلودهایی وجود نداشته باشد، این کلید در پاسخ گنجانده نخواهد شد. .TP .B \fBfollowing\fP پیوند معکوس برای \fBfollowedBy\fP\&. دانلودی که در \fBfollowedBy\fP گنجانده شده باشد، شناسه GID این شیء را در مقدار \fBfollowing\fP خود دارد. .TP .B \fBbelongsTo\fP شناسه GID دانلود والد. برخی از دانلودها بخشی از دانلودی دیگر هستند. برای مثال، اگر فایلی در متالینک دارای منابع بیت‌تورنت باشد، دانلودهای فایل‌های \(dq.torrent\(dq بخشی از آن والد هستند. اگر این دانلود والدی نداشته باشد، این کلید در پاسخ گنجانده نخواهد شد. .TP .B \fBdir\fP دایرکتوری برای ذخیره فایل‌ها. .TP .B \fBfiles\fP فهرست فایل‌ها را بازمی‌گرداند. عناصر این فهرست همان ساختارهایی هستند که در متد \fI\%aria2.getFiles()\fP استفاده می‌شوند. .TP .B \fBbittorrent\fP ساختاری حاوی اطلاعات استخراج‌شده از فایل تورنت (.torrent). فقط مخصوص بیت‌تورنت. این ساختار شامل کلیدهای زیر است: .INDENT 7.0 .TP .B \fBannounceList\fP فهرستی از فهرست‌های نشانی‌های اعلام (announce URIs). اگر تورنت حاوی \fBannounce\fP باشد و فاقد \fBannounce\-list\fP باشد، مقدار \fBannounce\fP به قالب \fBannounce\-list\fP تبدیل می‌شود. .TP .B \fBcomment\fP توضیح تورنت. در صورت در دسترس بودن، از \fBcomment.utf\-8\fP استفاده می‌شود. .TP .B \fBcreationDate\fP زمان ایجاد تورنت. این مقدار یک عدد صحیح از زمان مبدا (epoch) بر حسب ثانیه است. .TP .B \fBmode\fP حالت فایل در تورنت. مقدار یا \fBsingle\fP است یا \fBmulti\fP\&. .TP .B \fBinfo\fP ساختاری حاوی داده‌های واژه‌نامه Info. این ساختار شامل کلیدهای زیر است: .INDENT 7.0 .TP .B \fBname\fP نام در واژه‌نامه info. در صورت در دسترس بودن، از \fBname.utf\-8\fP استفاده می‌شود. .UNINDENT .UNINDENT .TP .B \fBverifiedLength\fP تعداد بایت‌های تاییدشده در حین بررسی هش فایل‌ها. این کلید تنها زمانی وجود دارد که این دانلود در حال بررسی هش باشد. .TP .B \fBverifyIntegrityPending\fP مقدار \fBtrue\fP اگر این دانلود در صف در انتظار بررسی هش باشد. این کلید تنها زمانی وجود دارد که این دانلود در صف باشد. .UNINDENT .sp \fBمثال JSON\-RPC\fP .sp مثال زیر اطلاعات مربوط به دانلود با شناسه GID#2089b05ecca3d829 را دریافت می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.tellStatus\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqbitfield\(aq: u\(aq0000000000\(aq, u\(aqcompletedLength\(aq: u\(aq901120\(aq, u\(aqconnections\(aq: u\(aq1\(aq, u\(aqdir\(aq: u\(aq/downloads\(aq, u\(aqdownloadSpeed\(aq: u\(aq15158\(aq, u\(aqfiles\(aq: [{u\(aqindex\(aq: u\(aq1\(aq, u\(aqlength\(aq: u\(aq34896138\(aq, u\(aqcompletedLength\(aq: u\(aq34896138\(aq, u\(aqpath\(aq: u\(aq/downloads/file\(aq, u\(aqselected\(aq: u\(aqtrue\(aq, u\(aquris\(aq: [{u\(aqstatus\(aq: u\(aqused\(aq, u\(aquri\(aq: u\(aqhttp://example.org/file\(aq}]}], u\(aqgid\(aq: u\(aq2089b05ecca3d829\(aq, u\(aqnumPieces\(aq: u\(aq34\(aq, u\(aqpieceLength\(aq: u\(aq1048576\(aq, u\(aqstatus\(aq: u\(aqactive\(aq, u\(aqtotalLength\(aq: u\(aq34896138\(aq, u\(aquploadLength\(aq: u\(aq0\(aq, u\(aquploadSpeed\(aq: u\(aq0\(aq}} .EE .UNINDENT .UNINDENT .sp مثال زیر تنها کلیدهای خاصی را دریافت می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.tellStatus\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq, \&... [\(aqgid\(aq, \&... \(aqtotalLength\(aq, \&... \(aqcompletedLength\(aq]]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqcompletedLength\(aq: u\(aq5701632\(aq, u\(aqgid\(aq: u\(aq2089b05ecca3d829\(aq, u\(aqtotalLength\(aq: u\(aq34896138\(aq}} .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .sp مثال زیر اطلاعات مربوط به دانلود با شناسه GID#2089b05ecca3d829 را دریافت می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.tellStatus(\(aq2089b05ecca3d829\(aq) >>> pprint(r) {\(aqbitfield\(aq: \(aqffff80\(aq, \(aqcompletedLength\(aq: \(aq34896138\(aq, \(aqconnections\(aq: \(aq0\(aq, \(aqdir\(aq: \(aq/downloads\(aq, \(aqdownloadSpeed\(aq: \(aq0\(aq, \(aqerrorCode\(aq: \(aq0\(aq, \(aqfiles\(aq: [{\(aqindex\(aq: \(aq1\(aq, \(aqlength\(aq: \(aq34896138\(aq, \(aqcompletedLength\(aq: \(aq34896138\(aq, \(aqpath\(aq: \(aq/downloads/file\(aq, \(aqselected\(aq: \(aqtrue\(aq, \(aquris\(aq: [{\(aqstatus\(aq: \(aqused\(aq, \(aquri\(aq: \(aqhttp://example.org/file\(aq}]}], \(aqgid\(aq: \(aq2089b05ecca3d829\(aq, \(aqnumPieces\(aq: \(aq17\(aq, \(aqpieceLength\(aq: \(aq2097152\(aq, \(aqstatus\(aq: \(aqcomplete\(aq, \(aqtotalLength\(aq: \(aq34896138\(aq, \(aquploadLength\(aq: \(aq0\(aq, \(aquploadSpeed\(aq: \(aq0\(aq} .EE .UNINDENT .UNINDENT .sp مثال زیر تنها کلیدهای خاصی را دریافت می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> r = s.aria2.tellStatus(\(aq2089b05ecca3d829\(aq, [\(aqgid\(aq, \(aqtotalLength\(aq, \(aqcompletedLength\(aq]) >>> pprint(r) {\(aqcompletedLength\(aq: \(aq34896138\(aq, \(aqgid\(aq: \(aq2089b05ecca3d829\(aq, \(aqtotalLength\(aq: \(aq34896138\(aq} .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getUris([secret], gid) این متد نشانی‌های URIs استفاده‌شده در دانلود مشخص‌شده با \fIgid\fP (رشته) را بازمی‌گرداند. پاسخ یک آرایه از ساختارها است و شامل کلیدهای زیر می‌باشد. مقادیر از نوع رشته هستند. .INDENT 7.0 .TP .B \fBuri\fP نشانی URI .TP .B \fBstatus\fP مقدار \(aqused\(aq اگر URI در حال استفاده باشد. مقدار \(aqwaiting\(aq اگر URI همچنان در صف انتظار باشد. .UNINDENT .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getUris\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [{u\(aqstatus\(aq: u\(aqused\(aq, u\(aquri\(aq: u\(aqhttp://example.org/file\(aq}]} .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getUris(\(aq2089b05ecca3d829\(aq) >>> pprint(r) [{\(aqstatus\(aq: \(aqused\(aq, \(aquri\(aq: \(aqhttp://example.org/file\(aq}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getFiles([secret], gid) این متد فهرست فایل‌های دانلود مشخص‌شده با \fIgid\fP (رشته) را بازمی‌گرداند. پاسخ یک آرایه از ساختارها است که شامل کلیدهای زیر می‌باشند. مقادیر از نوع رشته هستند. .INDENT 7.0 .TP .B \fBindex\fP اندیس فایل، با شروع از 1، به همان ترتیبی که فایل‌ها در تورنت چندفایلی ظاهر می‌شوند. .TP .B \fBpath\fP مسیر فایل. .TP .B \fBlength\fP اندازه فایل به بایت. .TP .B \fBcompletedLength\fP طول تکمیل‌شده این فایل به بایت. لطفاً توجه داشته باشید که ممکن است مجموع مقادیر \fBcompletedLength\fP کمتر از \fBcompletedLength\fP بازگردانده‌شده توسط متد \fI\%aria2.tellStatus()\fP باشد. دلیل این امر این است که \fBcompletedLength\fP در \fI\%aria2.getFiles()\fP تنها شامل قطعات تکمیل‌شده است. از سوی دیگر، \fBcompletedLength\fP در \fI\%aria2.tellStatus()\fP قطعاتی را که تا حدی تکمیل شده‌اند نیز شامل می‌شود. .TP .B \fBselected\fP مقدار \fBtrue\fP اگر این فایل با گزینه \fI\%\-\-select\-file\fP انتخاب شده باشد. اگر \fI\%\-\-select\-file\fP مشخص نشده باشد یا این مورد یک تورنت تک‌فایل یا اصولاً دانلودی غیر از تورنت باشد، این مقدار همیشه \fBtrue\fP\& خواهد بود؛ در غیر این صورت \fBfalse\fP\& است. .TP .B \fBuris\fP فهرستی از نشانی‌های URIs را برای این فایل بازمی‌گرداند. نوع عناصر همان ساختاری است که در متد \fI\%aria2.getUris()\fP استفاده می‌شود. .UNINDENT .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getFiles\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [{u\(aqindex\(aq: u\(aq1\(aq, u\(aqlength\(aq: u\(aq34896138\(aq, u\(aqcompletedLength\(aq: u\(aq34896138\(aq, u\(aqpath\(aq: u\(aq/downloads/file\(aq, u\(aqselected\(aq: u\(aqtrue\(aq, u\(aquris\(aq: [{u\(aqstatus\(aq: u\(aqused\(aq, u\(aquri\(aq: u\(aqhttp://example.org/file\(aq}]}]} .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getFiles(\(aq2089b05ecca3d829\(aq) >>> pprint(r) [{\(aqindex\(aq: \(aq1\(aq, \(aqlength\(aq: \(aq34896138\(aq, \(aqcompletedLength\(aq: \(aq34896138\(aq, \(aqpath\(aq: \(aq/downloads/file\(aq, \(aqselected\(aq: \(aqtrue\(aq, \(aquris\(aq: [{\(aqstatus\(aq: \(aqused\(aq, \(aquri\(aq: \(aqhttp://example.org/file\(aq}]}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getPeers([secret], gid) این متد فهرستی از همتاهای دانلود مشخص‌شده با \fIgid\fP (رشته) را بازمی‌گرداند. این متد فقط مخصوص بیت‌تورنت است. پاسخ یک آرایه از ساختارها است و شامل کلیدهای زیر می‌باشد. مقادیر از نوع رشته هستند. .INDENT 7.0 .TP .B \fBpeerId\fP شناسه همتا (peer ID) با کدگذاری درصدی (Percent\-encoded). .TP .B \fBip\fP آدرس IP همتا. .TP .B \fBport\fP شماره پورت همتا. .TP .B \fBbitfield\fP نمایش هگزادسیمال پیشرفت دانلود همتا. بالاترین بیت متناظر با قطعه در اندیس 0 است. بیت‌های فعال نشان می‌دهند که قطعه در دسترس است و بیت‌های غیرفعال نشان‌دهنده مفقود بودن قطعه هستند. هر بیت اضافی در انتها برابر صفر تنظیم می‌شود. .TP .B \fBamChoking\fP مقدار \fBtrue\fP اگر aria2 همتا را مسدود (choking) کرده باشد؛ در غیر این صورت \fBfalse\fP\&. .TP .B \fBpeerChoking\fP مقدار \fBtrue\fP اگر همتا aria2 را مسدود کرده باشد؛ در غیر این صورت \fBfalse\fP\&. .TP .B \fBdownloadSpeed\fP سرعت دانلود (بایت بر ثانیه) که این کلاینت از همتا دریافت می‌کند. .TP .B \fBuploadSpeed\fP سرعت آپلود (بایت بر ثانیه) که این کلاینت به همتا ارسال می‌کند. .TP .B \fBseeder\fP مقدار \fBtrue\fP اگر این همتا یک سیدر باشد؛ در غیر این صورت \fBfalse\fP\&. .UNINDENT .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getPeers\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [{u\(aqamChoking\(aq: u\(aqtrue\(aq, u\(aqbitfield\(aq: u\(aqffffffffffffffffffffffffffffffffffffffff\(aq, u\(aqdownloadSpeed\(aq: u\(aq10602\(aq, u\(aqip\(aq: u\(aq10.0.0.9\(aq, u\(aqpeerChoking\(aq: u\(aqfalse\(aq, u\(aqpeerId\(aq: u\(aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\(aq, u\(aqport\(aq: u\(aq6881\(aq, u\(aqseeder\(aq: u\(aqtrue\(aq, u\(aquploadSpeed\(aq: u\(aq0\(aq}, {u\(aqamChoking\(aq: u\(aqfalse\(aq, u\(aqbitfield\(aq: u\(aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\(aq, u\(aqdownloadSpeed\(aq: u\(aq8654\(aq, u\(aqip\(aq: u\(aq10.0.0.30\(aq, u\(aqpeerChoking\(aq: u\(aqfalse\(aq, u\(aqpeerId\(aq: u\(aqbittorrent client758\(aq, u\(aqport\(aq: u\(aq37842\(aq, u\(aqseeder\(aq: u\(aqfalse\(aq, u\(aquploadSpeed\(aq: u\(aq6890\(aq}]} .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getPeers(\(aq2089b05ecca3d829\(aq) >>> pprint(r) [{\(aqamChoking\(aq: \(aqtrue\(aq, \(aqbitfield\(aq: \(aqffffffffffffffffffffffffffffffffffffffff\(aq, \(aqdownloadSpeed\(aq: \(aq10602\(aq, \(aqip\(aq: \(aq10.0.0.9\(aq, \(aqpeerChoking\(aq: \(aqfalse\(aq, \(aqpeerId\(aq: \(aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\(aq, \(aqport\(aq: \(aq6881\(aq, \(aqseeder\(aq: \(aqtrue\(aq, \(aquploadSpeed\(aq: \(aq0\(aq}, {\(aqamChoking\(aq: \(aqfalse\(aq, \(aqbitfield\(aq: \(aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\(aq, \(aqdownloadSpeed\(aq: \(aq8654\(aq, \(aqip\(aq: \(aq10.0.0.30\(aq, \(aqpeerChoking\(aq: \(aqfalse\(aq, \(aqpeerId\(aq: \(aqbittorrent client758\(aq, \(aqport\(aq: \(aq37842\(aq, \(aqseeder\(aq: \(aqfalse, \(aquploadSpeed\(aq: \(aq6890\(aq}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getServers([secret], gid) این متد سرورهای HTTP(S)/FTP/SFTP متصل فعلی را برای دانلود مشخص‌شده با \fIgid\fP (رشته) بازمی‌گرداند. پاسخ یک آرایه از ساختارها است و شامل کلیدهای زیر می‌باشد. مقادیر از نوع رشته هستند. .INDENT 7.0 .TP .B \fBindex\fP اندیس فایل، با شروع از 1، به همان ترتیبی که فایل‌ها در متالینک چندفایلی ظاهر می‌شوند. .TP .B \fBservers\fP فهرستی از ساختارها که شامل کلیدهای زیر هستند: .INDENT 7.0 .TP .B \fBuri\fP نشانی URI اصلی. .TP .B \fBcurrentUri\fP این نشانی URI است که در حال حاضر برای دانلود استفاده می‌شود. اگر تغییر مسیر (redirection) رخ داده باشد، currentUri و uri ممکن است متفاوت باشند. .TP .B \fBdownloadSpeed\fP سرعت دانلود (بایت بر ثانیه) .UNINDENT .UNINDENT .sp \fBمثال JSON\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getServers\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [{u\(aqindex\(aq: u\(aq1\(aq, u\(aqservers\(aq: [{u\(aqcurrentUri\(aq: u\(aqhttp://example.org/file\(aq, u\(aqdownloadSpeed\(aq: u\(aq10467\(aq, u\(aquri\(aq: u\(aqhttp://example.org/file\(aq}]}]} .EE .UNINDENT .UNINDENT .sp \fBمثال XML\-RPC\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getServers(\(aq2089b05ecca3d829\(aq) >>> pprint(r) [{\(aqindex\(aq: \(aq1\(aq, \(aqservers\(aq: [{\(aqcurrentUri\(aq: \(aqhttp://example.org/dl/file\(aq, \(aqdownloadSpeed\(aq: \(aq20285\(aq, \(aquri\(aq: \(aqhttp://example.org/file\(aq}]}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.tellActive([secret][, keys]) این متد فهرستی از دانلودهای فعال را بازمی‌گرداند. پاسخ آرایه‌ای از همان ساختارهایی است که توسط متد \fI\%aria2.tellStatus()\fP بازگردانده می‌شوند. برای پارامتر \fIkeys\fP، لطفاً به متد \fI\%aria2.tellStatus()\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B aria2.tellWaiting([secret], offset, num[, keys]) این متد فهرستی از دانلودهای در حال انتظار، شامل دانلودهای متوقف‌شده موقت (paused) را بازمی‌گرداند. پارامتر \fIoffset\fP یک عدد صحیح است و فاصله (offset) را از دانلودی که در جلوی صف انتظار قرار دارد مشخص می‌کند. پارامتر \fInum\fP یک عدد صحیح است و حداکثر تعداد دانلودهایی را که باید بازگردانده شوند تعیین می‌کند. برای پارامتر \fIkeys\fP، لطفاً به متد \fI\%aria2.tellStatus()\fP مراجعه کنید. .sp اگر \fIoffset\fP یک عدد صحیح مثبت باشد، این متد دانلودها را در محدوده [\fIoffset\fP, \fIoffset\fP + \fInum\fP) بازمی‌گرداند. .sp پارامتر \fIoffset\fP می‌تواند یک عدد صحیح منفی باشد. مقدار \fIoffset\fP == \-1 به آخرین دانلود در صف انتظار اشاره دارد و \fIoffset\fP == \-2 به دانلود قبل از آخرین دانلود اشاره می‌کند و الی آخر. در این حالت دانلودهای موجود در پاسخ به ترتیب معکوس خواهند بود. .sp برای مثال، فرض کنید سه دانلود \(dqA\(dq، \(dqB\(dq و \(dqC\(dq به همین ترتیب در حال انتظار هستند. فراخوانی \fBaria2.tellWaiting(0, 1)\fP مقدار \fB[\(dqA\(dq]\fP\& را بازمی‌گرداند. فراخوانی \fBaria2.tellWaiting(1, 2)\fP مقدار \fB[\(dqB\(dq, \(dqC\(dq]\fP\& را بازمی‌گرداند. فراخوانی \fBaria2.tellWaiting(\-1, 2)\fP مقدار \fB[\(dqC\(dq, \(dqB\(dq]\fP\& را بازمی‌گرداند. .sp پاسخ آرایه‌ای از همان ساختارهایی است که توسط متد \fI\%aria2.tellStatus()\fP بازگردانده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B aria2.tellStopped([secret], offset, num[, keys]) این متد فهرستی از دانلودهای متوقف‌شده را بازمی‌گرداند. پارامتر \fIoffset\fP یک عدد صحیح است و فاصله (offset) را از قدیمی‌ترین دانلود متوقف‌شده مشخص می‌کند. پارامتر \fInum\fP یک عدد صحیح است و حداکثر تعداد دانلودهایی را که باید بازگردانده شوند تعیین می‌کند. برای پارامتر \fIkeys\fP، لطفاً به متد \fI\%aria2.tellStatus()\fP مراجعه کنید. .sp پارامترهای \fIoffset\fP و \fInum\fP دارای همان مفاهیمی هستند که در متد \fI\%aria2.tellWaiting()\fP توضیح داده شد. .sp پاسخ آرایه‌ای از همان ساختارهایی است که توسط متد \fI\%aria2.tellStatus()\fP بازگردانده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B aria2.changePosition([secret], gid, pos, how) این متد موقعیت دانلودی را که با \fIgid\fP مشخص شده است در صف تغییر می‌دهد. \fIpos\fP یک عدد صحیح است. \fIhow\fP یک رشته است. اگر \fIhow\fP برابر با \fBPOS_SET\fP باشد، دانلود را به موقعیتی نسبت به ابتدای صف منتقل می‌کند. اگر \fIhow\fP برابر با \fBPOS_CUR\fP باشد، دانلود را به موقعیتی نسبت به موقعیت فعلی جابه‌جا می‌کند. اگر \fIhow\fP برابر با \fBPOS_END\fP باشد، دانلود را به موقعیتی نسبت به انتهای صف منتقل می‌کند. اگر موقعیت مقصد کمتر از ۰ یا فراتر از انتهای صف باشد، دانلود را به ترتیب به ابتدای صف یا انتهای صف منتقل می‌کند. پاسخ یک عدد صحیح است که موقعیت نهایی حاصل‌شده را نشان می‌دهد. .sp برای مثال، اگر GID#2089b05ecca3d829 در حال حاضر در موقعیت ۳ باشد، فراخوانی \fBaria2.changePosition(\(aq2089b05ecca3d829\(aq, \-1, \(aqPOS_CUR\(aq)\fP موقعیت آن را به ۲ تغییر می‌دهد. علاوه بر این، فراخوانی \fBaria2.changePosition(\(aq2089b05ecca3d829\(aq, 0, \(aqPOS_SET\(aq)\fP موقعیت آن را به ۰ (ابتدای صف) تغییر خواهد داد. .sp مثال‌های زیر دانلود با شناسه GID#2089b05ecca3d829 را به ابتدای صف منتقل می‌کنند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.changePosition\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq, 0, \(aqPOS_SET\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: 0} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.changePosition(\(aq2089b05ecca3d829\(aq, 0, \(aqPOS_SET\(aq) 0 .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.changeUri([secret], gid, fileIndex, delUris, addUris[, position]) این متد نشانی‌های وب موجود در \fIdelUris\fP را حذف کرده و نشانی‌های موجود در \fIaddUris\fP را به دانلود مشخص‌شده توسط \fIgid\fP اضافه می‌کند. \fIdelUris\fP و \fIaddUris\fP لیست‌هایی از رشته‌ها هستند. یک دانلود می‌تواند شامل چندین فایل باشد و نشانی‌های وب به هر فایل پیوست می‌شوند. از \fIfileIndex\fP برای انتخاب فایلی که قرار است نشانی‌های داده‌شده از آن حذف یا به آن افزوده شوند استفاده می‌شود. مقدار \fIfileIndex\fP مبتنی بر ۱ (1\-based) است. از \fIposition\fP برای تعیین مکانی که نشانی‌ها در لیست نشانی‌های منتظر درج می‌شوند استفاده می‌شود. مقدار \fIposition\fP مبتنی بر ۰ (0\-based) است. هنگامی که \fIposition\fP مشخص نشود، نشانی‌ها به انتهای لیست اضافه می‌شوند. این متد ابتدا عملیات حذف و سپس عملیات افزودن را انجام می‌دهد. \fIposition\fP موقعیت پس از حذف نشانی‌ها است، نه موقعیت در هنگام فراخوانی متد. در هنگام حذف نشانی، اگر نشانی‌های یکسانی در دانلود وجود داشته باشد، به ازای هر نشانی موجود در \fIdelUris\fP تنها یکی از آن‌ها حذف می‌شود. به عبارت دیگر، اگر سه نشانی \fBhttp://example.org/aria2\fP وجود دارد و می‌خواهید همه آن‌ها را حذف کنید، باید (حداقل) ۳ بار \fBhttp://example.org/aria2\fP را در \fIdelUris\fP مشخص کنید. این متد لیستی شامل دو عدد صحیح بازمی‌گرداند؛ عدد صحیح اول تعداد نشانی‌های حذف‌شده و عدد صحیح دوم تعداد نشانی‌های اضافه‌شده است. .sp مثال‌های زیر نشانی \fBhttp://example.org/file\fP را به فایلی که اندیس آن \fB1\fP است و به دانلود GID#2089b05ecca3d829 تعلق دارد اضافه می‌کنند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.changeUri\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq, 1, [], [\(aqhttp://example.org/file\(aq]]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [0, 1]} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.changeUri(\(aq2089b05ecca3d829\(aq, 1, [], [\(aqhttp://example.org/file\(aq]) [0, 1] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getOption([secret], gid) این متد گزینه‌های دانلودی را که با \fIgid\fP مشخص شده است بازمی‌گرداند. پاسخ یک ساختار (struct) است که در آن کلیدها نام گزینه‌ها هستند. مقادیر از نوع رشته می‌باشند. توجه داشته باشید که این متد گزینه‌هایی را که مقدار پیش‌فرضی ندارند و در خط فرمان، فایل‌های پیکربندی یا متدهای RPC تنظیم نشده‌اند بازنمی‌گرداند. .sp مثال‌های زیر گزینه‌های دانلود GID#2089b05ecca3d829 را دریافت می‌کنند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getOption\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqallow\-overwrite\(aq: u\(aqfalse\(aq, u\(aqallow\-piece\-length\-change\(aq: u\(aqfalse\(aq, u\(aqalways\-resume\(aq: u\(aqtrue\(aq, u\(aqasync\-dns\(aq: u\(aqtrue\(aq, ... .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getOption(\(aq2089b05ecca3d829\(aq) >>> pprint(r) {\(aqallow\-overwrite\(aq: \(aqfalse\(aq, \(aqallow\-piece\-length\-change\(aq: \(aqfalse\(aq, \(aqalways\-resume\(aq: \(aqtrue\(aq, \(aqasync\-dns\(aq: \(aqtrue\(aq, .... .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.changeOption([secret], gid, options) این متد گزینه‌های دانلودی را که با \fIgid\fP (رشته) مشخص شده است به‌صورت پویا تغییر می‌دهد. \fIoptions\fP یک ساختار (struct) است. گزینه‌های ذکرشده در زیربخش \fI\%Input File\fP در دسترس هستند، \fBبه‌جز\fP گزینه‌های زیر: .INDENT 7.0 .IP \(bu 2 \fI\%dry\-run\fP .IP \(bu 2 \fI\%metalink\-base\-uri\fP .IP \(bu 2 \fI\%parameterized\-uri\fP .IP \(bu 2 \fI\%pause\fP .IP \(bu 2 \fI\%piece\-length\fP .IP \(bu 2 \fI\%rpc\-save\-upload\-metadata\fP .UNINDENT .sp به‌جز گزینه‌های زیر، تغییر دادن سایر گزینه‌های یک دانلود فعال باعث راه‌اندازی مجدد آن می‌شود (راه‌اندازی مجدد توسط خود aria2 مدیریت می‌شود و نیازی به دخالت کاربر نیست): .INDENT 7.0 .IP \(bu 2 \fI\%bt\-max\-peers\fP .IP \(bu 2 \fI\%bt\-request\-peer\-speed\-limit\fP .IP \(bu 2 \fI\%bt\-remove\-unselected\-file\fP .IP \(bu 2 \fI\%force\-save\fP .IP \(bu 2 \fI\%max\-download\-limit\fP .IP \(bu 2 \fI\%max\-upload\-limit\fP .UNINDENT .sp این متد در صورت موفقیت مقدار \fBOK\fP را بازمی‌گرداند. .sp مثال‌های زیر گزینه \fI\%max\-download\-limit\fP را برای دانلود GID#2089b05ecca3d829 روی مقدار \fB20K\fP تنظیم می‌کنند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.changeOption\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq, \&... {\(aqmax\-download\-limit\(aq:\(aq10K\(aq}]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: u\(aqOK\(aq} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.changeOption(\(aq2089b05ecca3d829\(aq, {\(aqmax\-download\-limit\(aq:\(aq20K\(aq}) \(aqOK\(aq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getGlobalOption([secret]) این متد گزینه‌های سراسری را بازمی‌گرداند. پاسخ یک ساختار (struct) است. کلیدهای آن نام گزینه‌ها هستند و مقادیر از نوع رشته می‌باشند. توجه داشته باشید که این متد گزینه‌هایی را که مقدار پیش‌فرضی ندارند و در خط فرمان، فایل‌های پیکربندی یا متدهای RPC تنظیم نشده‌اند برنمی‌گرداند. از آنجا که گزینه‌های سراسری به‌عنوان قالبی برای گزینه‌های دانلودهای تازه اضافه‌شده به کار می‌روند، پاسخ شامل کلیدهایی است که توسط متد \fI\%aria2.getOption()\fP نیز بازگردانده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B aria2.changeGlobalOption([secret], options) این متد گزینه‌های سراسری را به‌صورت پویا تغییر می‌دهد. \fIoptions\fP یک ساختار (struct) است. گزینه‌های زیر در دسترس هستند: .INDENT 7.0 .IP \(bu 2 \fI\%bt\-max\-open\-files\fP .IP \(bu 2 \fI\%download\-result\fP .IP \(bu 2 \fI\%keep\-unfinished\-download\-result\fP .IP \(bu 2 \fI\%log\fP .IP \(bu 2 \fI\%log\-level\fP .IP \(bu 2 \fI\%max\-concurrent\-downloads\fP .IP \(bu 2 \fI\%max\-download\-result\fP .IP \(bu 2 \fI\%max\-overall\-download\-limit\fP .IP \(bu 2 \fI\%max\-overall\-upload\-limit\fP .IP \(bu 2 \fI\%optimize\-concurrent\-downloads\fP .IP \(bu 2 \fI\%save\-cookies\fP .IP \(bu 2 \fI\%save\-session\fP .IP \(bu 2 \fI\%server\-stat\-of\fP .UNINDENT .sp علاوه بر این، گزینه‌های ذکرشده در زیربخش \fI\%Input File\fP نیز در دسترس هستند، \fBبه‌جز\fP گزینه‌های زیر: \fI\%checksum\fP, \fI\%index\-out\fP, \fI\%out\fP, \fI\%pause\fP و \fI\%select\-file\fP\&. .sp با استفاده از گزینه \fI\%log\fP، می‌توانید ثبت لاگ را به‌صورت پویا آغاز کنید یا فایل لاگ را تغییر دهید. برای توقف ثبت لاگ، یک رشته خالی (\(dq\(dq) را به‌عنوان مقدار پارامتر تعیین کنید. توجه داشته باشید که فایل لاگ همیشه در حالت الحاق (append mode) باز می‌شود. این متد در صورت موفقیت مقدار \fBOK\fP را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.getGlobalStat([secret]) این متد آمار و وضعیت سراسری مانند سرعت کلی دانلود و آپلود را بازمی‌گرداند. پاسخ یک ساختار (struct) است و شامل کلیدهای زیر می‌باشد. مقادیر از نوع رشته هستند. .INDENT 7.0 .TP .B \fBdownloadSpeed\fP سرعت کلی دانلود (بایت بر ثانیه). .TP .B \fBuploadSpeed\fP سرعت کلی آپلود (بایت بر ثانیه). .TP .B \fBnumActive\fP تعداد دانلودهای فعال. .TP .B \fBnumWaiting\fP تعداد دانلودهای در صف انتظار. .TP .B \fBnumStopped\fP تعداد دانلودهای متوقف‌شده در نشست جاری. این مقدار توسط گزینه \fI\%\-\-max\-download\-result\fP محدود می‌شود. .TP .B \fBnumStoppedTotal\fP تعداد دانلودهای متوقف‌شده در نشست جاری که با گزینه \fI\%\-\-max\-download\-result\fP محدود \fIنمی‌شود\fP\&. .UNINDENT .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getGlobalStat\(aq}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqdownloadSpeed\(aq: u\(aq21846\(aq, u\(aqnumActive\(aq: u\(aq2\(aq, u\(aqnumStopped\(aq: u\(aq0\(aq, u\(aqnumWaiting\(aq: u\(aq0\(aq, u\(aquploadSpeed\(aq: u\(aq0\(aq}} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getGlobalStat() >>> pprint(r) {\(aqdownloadSpeed\(aq: \(aq23136\(aq, \(aqnumActive\(aq: \(aq2\(aq, \(aqnumStopped\(aq: \(aq0\(aq, \(aqnumWaiting\(aq: \(aq0\(aq, \(aquploadSpeed\(aq: \(aq0\(aq} .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.purgeDownloadResult([secret]) این متد دانلودهای تکمیل‌شده، دارای خطا یا حذف‌شده را برای آزادسازی حافظه پاک‌سازی می‌کند. این متد مقدار \fBOK\fP را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.removeDownloadResult([secret], gid) این متد نتیجه یک دانلود تکمیل‌شده، دارای خطا یا حذف‌شده را که با \fIgid\fP مشخص شده است از حافظه حذف می‌کند. این متد در صورت موفقیت مقدار \fBOK\fP را بازمی‌گرداند. .sp مثال‌های زیر نتیجه دانلود مربوط به شناسه GID#2089b05ecca3d829 را حذف می‌کنند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.removeDownloadResult\(aq, \&... \(aqparams\(aq:[\(aq2089b05ecca3d829\(aq]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: u\(aqOK\(aq} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.removeDownloadResult(\(aq2089b05ecca3d829\(aq) \(aqOK\(aq .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getVersion([secret]) این متد نگارش aria2 و فهرست ویژگی‌های فعال‌شده را بازمی‌گرداند. پاسخ یک ساختار (struct) است و شامل کلیدهای زیر می‌باشد. .INDENT 7.0 .TP .B \fBversion\fP شماره نگارش aria2 به‌صورت یک رشته. .TP .B \fBenabledFeatures\fP فهرست ویژگی‌های فعال‌شده. هر ویژگی به‌صورت یک رشته ارائه می‌شود. .UNINDENT .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getVersion\(aq}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqenabledFeatures\(aq: [u\(aqAsync DNS\(aq, u\(aqBitTorrent\(aq, u\(aqFirefox3 Cookie\(aq, u\(aqGZip\(aq, u\(aqHTTPS\(aq, u\(aqMessage Digest\(aq, u\(aqMetalink\(aq, u\(aqXML\-RPC\(aq], u\(aqversion\(aq: u\(aq1.11.0\(aq}} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> r = s.aria2.getVersion() >>> pprint(r) {\(aqenabledFeatures\(aq: [\(aqAsync DNS\(aq, \(aqBitTorrent\(aq, \(aqFirefox3 Cookie\(aq, \(aqGZip\(aq, \(aqHTTPS\(aq, \(aqMessage Digest\(aq, \(aqMetalink\(aq, \(aqXML\-RPC\(aq], \(aqversion\(aq: \(aq1.11.0\(aq} .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.getSessionInfo([secret]) این متد اطلاعات نشست را بازمی‌گرداند. پاسخ یک ساختار (struct) است و شامل کلید زیر می‌باشد. .INDENT 7.0 .TP .B \fBsessionId\fP شناسه نشست (Session ID)، که هر بار با فراخوانی و اجرای aria2 تولید می‌شود. .UNINDENT .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.getSessionInfo\(aq}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: {u\(aqsessionId\(aq: u\(aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\(aq}} .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.aria2.getSessionInfo() {\(aqsessionId\(aq: \(aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\(aq} .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.shutdown([secret]) این متد برنامه aria2 را خاموش و متوقف می‌کند. این متد مقدار \fBOK\fP را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.forceShutdown([secret]) این متد \fBaria2()\fP را خاموش و متوقف می‌کند. این متد رفتاری مشابه با :func:\(aqaria2.shutdown\(ga دارد با این تفاوت که بدون انجام اقدامات زمان‌بر (مانند تماس با تراکرهای بیت‌تورنت برای لغو ثبت دانلودها پیش از خروج) عمل می‌کند. این متد مقدار \fBOK\fP را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B aria2.saveSession([secret]) این متد نشست فعلی را در فایلی که توسط گزینه \fI\%\-\-save\-session\fP مشخص شده است ذخیره می‌کند. این متد در صورت موفقیت مقدار \fBOK\fP را بازمی‌گرداند. .UNINDENT .INDENT 0.0 .TP .B system.multicall(methods) این متد چندین فراخوانی متد را در قالب یک درخواست کپسوله‌سازی می‌کند. \fImethods\fP آرایه‌ای از ساختارها (structs) است. این ساختارها شامل دو کلید هستند: \fBmethodName\fP و \fBparams\fP\&. کلید \fBmethodName\fP نام متد مورد نظر برای فراخوانی است و \fBparams\fP آرایه‌ای حاوی پارامترهای فراخوانی متد می‌باشد. این متد آرایه‌ای از پاسخ‌ها را بازمی‌گرداند. عناصر این آرایه یا یک آرایه تک‌عضوی شامل مقدار بازگشتی فراخوانی متد خواهند بود، یا در صورتی که یکی از فراخوانی‌های کپسوله‌شده ناموفق باشد، ساختاری از عنصر خطا (fault element) خواهند بود. .sp در مثال‌های زیر، ۲ دانلود اضافه می‌کنیم. مورد اول \fBhttp://example.org/file\fP و مورد دوم \fBfile.torrent\fP است. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json, base64 >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqsystem.multicall\(aq, \&... \(aqparams\(aq:[[{\(aqmethodName\(aq:\(aqaria2.addUri\(aq, \&... \(aqparams\(aq:[[\(aqhttp://example.org\(aq]]}, \&... {\(aqmethodName\(aq:\(aqaria2.addTorrent\(aq, \&... \(aqparams\(aq:[base64.b64encode(open(\(aqfile.torrent\(aq).read())]}]]}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [[u\(aq2089b05ecca3d829\(aq], [u\(aqd2703803b52216d1\(aq]]} .EE .UNINDENT .UNINDENT .sp سیستم JSON\-RPC علاوه بر این از درخواست‌های دسته‌ای (Batch requests) مطابق با مشخصات JSON\-RPC 2.0 پشتیبانی می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> jsonreq = json.dumps([{\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqaria2.addUri\(aq, \&... \(aqparams\(aq:[[\(aqhttp://example.org\(aq]]}, \&... {\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqasdf\(aq, \&... \(aqmethod\(aq:\(aqaria2.addTorrent\(aq, \&... \(aqparams\(aq:[base64.b64encode(open(\(aqfile.torrent\(aq).read())]}]) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) [{u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: u\(aq2089b05ecca3d829\(aq}, {u\(aqid\(aq: u\(aqasdf\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: u\(aqd2703803b52216d1\(aq}] .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> mc = xmlrpclib.MultiCall(s) >>> mc.aria2.addUri([\(aqhttp://example.org/file\(aq]) >>> mc.aria2.addTorrent(xmlrpclib.Binary(open(\(aqfile.torrent\(aq, mode=\(aqrb\(aq).read())) >>> r = mc() >>> tuple(r) (\(aq2089b05ecca3d829\(aq, \(aqd2703803b52216d1\(aq) .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B system.listMethods() این متد تمام متدهای RPC در دسترس را در قالب یک آرایه از رشته‌ها بازمی‌گرداند. برخلاف متدهای دیگر، این متد نیازی به توکن امنیتی (secret token) ندارد. این متد کاملاً ایمن است زیرا صرفاً نام متدهای موجود را بازمی‌گرداند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqsystem.listMethods\(aq}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [u\(aqaria2.addUri\(aq, u\(aqaria2.addTorrent\(aq, \&... .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.system.listMethods() [\(aqaria2.addUri\(aq, \(aqaria2.addTorrent\(aq, ... .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B system.listNotifications() این متد تمام اعلان‌های RPC موجود را در قالب یک آرایه از رشته‌ها بازمی‌گرداند. برخلاف متدهای دیگر، این متد نیازی به توکن امنیتی (secret token) ندارد. این متد کاملاً ایمن است زیرا صرفاً نام اعلان‌های موجود را بازمی‌گرداند. .sp \fBنمونه JSON\-RPC (JSON\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json.dumps({\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \&... \(aqmethod\(aq:\(aqsystem.listNotifications\(aq}) >>> c = urllib2.urlopen(\(aqhttp://localhost:6800/jsonrpc\(aq, jsonreq) >>> pprint(json.loads(c.read())) {u\(aqid\(aq: u\(aqqwer\(aq, u\(aqjsonrpc\(aq: u\(aq2.0\(aq, u\(aqresult\(aq: [u\(aqaria2.onDownloadStart\(aq, u\(aqaria2.onDownloadPause\(aq, \&... .EE .UNINDENT .UNINDENT .sp \fBنمونه XML\-RPC (XML\-RPC Example)\fP .INDENT 7.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> s.system.listNotifications() [\(aqaria2.onDownloadStart\(aq, \(aqaria2.onDownloadPause\(aq, ... .EE .UNINDENT .UNINDENT .UNINDENT .SS "مدیریت خطا (Error Handling)" .sp در بستر JSON\-RPC، برنامه aria2 یک شیء JSON بازمی‌گرداند که شامل کد خطا در فیلد \fBcode\fP و پیام خطا در فیلد \fBmessage\fP است. .sp در بستر XML\-RPC، برنامه aria2 مقدار \fBfaultCode=1\fP و پیام خطا را در فیلد \fBfaultString\fP بازمی‌گرداند. .SS "گزینه‌ها (Options)" .sp همان گزینه‌های موجود برای \fI\%\-\-input\-file\fP در دسترس هستند. برای مشاهده فهرست کامل گزینه‌ها به زیربخش \fI\%Input File\fP مراجعه کنید. .sp در ساختار گزینه (option struct)، عنصر name نام گزینه (بدون پیشوند \fB\-\-\fP) و عنصر value آرگومان مورد نظر به‌صورت یک رشته است. .SS "نمونه JSON-RPC (JSON-RPC Example)" .INDENT 0.0 .INDENT 3.5 .sp .EX {\(aqsplit\(aq:\(aq1\(aq, \(aqhttp\-proxy\(aq:\(aqhttp://proxy/\(aq} .EE .UNINDENT .UNINDENT .SS "نمونه XML-RPC (XML-RPC Example)" .INDENT 0.0 .INDENT 3.5 .sp .EX split 1 http\-proxy http://proxy/ .EE .UNINDENT .UNINDENT .sp گزینه‌های \fI\%header\fP و \fI\%index\-out\fP چندین بار در خط فرمان مجاز هستند. از آنجا که نام در یک ساختار (struct) باید یکتا باشد (بسیاری از پیاده‌سازی‌های کتابخانه XML\-RPC از یک درهم‌سازی/هش یا دیکشنری برای struct استفاده می‌کنند)، یک رشته تکی کافی نیست. برای غلبه بر این محدودیت، می‌توانید علاوه بر رشته، از یک آرایه نیز به‌عنوان مقدار استفاده کنید. .SS "نمونه JSON-RPC (JSON-RPC Example)" .INDENT 0.0 .INDENT 3.5 .sp .EX {\(aqheader\(aq:[\(aqAccept\-Language: ja\(aq, \(aqAccept\-Charset: utf\-8\(aq]} .EE .UNINDENT .UNINDENT .SS "نمونه XML-RPC (XML-RPC Example)" .INDENT 0.0 .INDENT 3.5 .sp .EX header Accept\-Language: ja Accept\-Charset: utf\-8 .EE .UNINDENT .UNINDENT .sp مثال زیر یک دانلود را با دو گزینه اضافه می‌کند: \fBdir\fP و \fBheader\fP\&. گزینه \fBheader\fP نیازمند دو مقدار است، بنابراین از یک لیست استفاده می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy(\(aqhttp://localhost:6800/rpc\(aq) >>> opts = dict(dir=\(aq/tmp\(aq, \&... header=[\(aqAccept\-Language: ja\(aq, \&... \(aqAccept\-Charset: utf\-8\(aq]) >>> s.aria2.addUri([\(aqhttp://example.org/file\(aq], opts) \(aq1\(aq .EE .UNINDENT .UNINDENT .SS "استفاده از JSON-RPC از طریق HTTP GET (JSON-RPC using HTTP GET)" .sp رابط JSON\-RPC همچنین از درخواست‌ها از طریق HTTP GET پشتیبانی می‌کند. طرح‌واره کدگذاری در پارامترهای GET بر اساس مشخصات JSON\-RPC over HTTP Specification [2008\-1\-15(RC1)] است. کدگذاری پارامترهای GET به شرح زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX /jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS .EE .UNINDENT .UNINDENT .sp پارامترهای \fBmethod\fP و \fBid\fP همیشه به‌عنوان رشته JSON در نظر گرفته می‌شوند و کدگذاری آن‌ها باید UTF\-8 باشد. .sp برای مثال، رشته کدگذاری‌شده \fBaria2.tellStatus(\(aq2089b05ecca3d829\(aq)\fP همراه با \fBid=\(aqfoo\(aq\fP به شکل زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX /jsonrpc?method=aria2.tellStatus&id=foo¶ms=WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D .EE .UNINDENT .UNINDENT .sp پارامتر \fBparams\fP یک آرایه JSON کدگذاری‌شده با Base64 است که معمولاً در ویژگی \fBparams\fP در شیء درخواست JSON\-RPC ظاهر می‌شود. در مثال بالا، params برابر با \fB[\(dq2089b05ecca3d829\(dq]\fP است، بنابراین: .INDENT 0.0 .INDENT 3.5 .sp .EX [\(dq2089b05ecca3d829\(dq] \-\-(Base64)\-\-> WyIyMDg5YjA1ZWNjYTNkODI5Il0= \-\-(Percent Encode)\-\-> WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D .EE .UNINDENT .UNINDENT .sp رابط JSON\-RPC همچنین از JSONP پشتیبانی می‌کند. می‌توانید تابع بازخوانی (callback) را در پارامتر \fBjsoncallback\fP مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX /jsonrpc?method=aria2.tellStatus&id=foo¶ms=WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D&jsoncallback=cb .EE .UNINDENT .UNINDENT .sp برای درخواست‌های دسته‌ای (Batch requests)، پارامترهای \fBmethod\fP و \fBid\fP نباید مشخص شوند. کل درخواست باید در پارامتر \fBparams\fP تعیین شود. برای مثال، یک درخواست دسته‌ای: .INDENT 0.0 .INDENT 3.5 .sp .EX [{\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqqwer\(aq, \(aqmethod\(aq:\(aqaria2.getVersion\(aq}, {\(aqjsonrpc\(aq:\(aq2.0\(aq, \(aqid\(aq:\(aqasdf\(aq, \(aqmethod\(aq:\(aqaria2.tellActive\(aq}] .EE .UNINDENT .UNINDENT .sp باید به این صورت کدگذاری شود: .INDENT 0.0 .INDENT 3.5 .sp .EX /jsonrpc?params=W3sianNvbnJwYyI6ICIyLjAiLCAiaWQiOiAicXdlciIsICJtZXRob2QiOiAiYXJpYTIuZ2V0VmVyc2lvbiJ9LCB7Impzb25ycGMiOiAiMi4wIiwgImlkIjogImFzZGYiLCAibWV0aG9kIjogImFyaWEyLnRlbGxBY3RpdmUifV0%3D .EE .UNINDENT .UNINDENT .SS "JSON-RPC روی وب‌سوکت (JSON-RPC over WebSocket)" .sp پروتکل JSON\-RPC روی وب‌سوکت (WebSocket) از همان امضاهای متد و قالب پاسخ JSON\-RPC روی HTTP استفاده می‌کند. نگارش وب‌سوکت پشتیبانی‌شده 13 است که در \fI\%RFC 6455\fP به تفصیل شرح داده شده است. .sp برای ارسال یک درخواست RPC به کارساز (سرور) RPC، یک رشته JSON سریال‌شده را در یک فریم متنی (Text frame) ارسال کنید. پاسخ کارساز RPC نیز در یک فریم متنی تحویل داده می‌شود. .SS "اعلان‌ها (Notifications)" .sp کارساز (سرور) RPC ممکن است اعلان‌هایی را برای کلاینت ارسال کند. اعلان‌ها یک‌طرفه هستند، بنابراین کلاینتی که اعلان را دریافت می‌کند نباید به آن پاسخی دهد. امضای متد یک اعلان بسیار شبیه به یک درخواست متد معمولی است اما فاقد کلید id می‌باشد. مقدار کلید params همان داده‌ای است که این اعلان به همراه دارد. قالب مقدار بسته به متد اعلان متفاوت است. متدهای اعلان زیر تعریف شده‌اند: .INDENT 0.0 .TP .B aria2.onDownloadStart(event) این اعلان زمانی که یک دانلود آغاز شود ارسال می‌گردد. آرگومان \fIevent\fP از نوع ساختار (struct) است و شامل کلیدهای زیر می‌باشد. نوع مقدار رشته است. .INDENT 7.0 .TP .B \fBgid\fP شناسه GID دانلود مربوطه. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B aria2.onDownloadPause(event) این اعلان زمانی که یک دانلود متوقف موقت (pause) شود ارسال می‌گردد. آرگومان \fIevent\fP همان ساختاری است که در آرگومان \fIevent\fP در متد \fI\%aria2.onDownloadStart()\fP وجود دارد. .UNINDENT .INDENT 0.0 .TP .B aria2.onDownloadStop(event) این اعلان زمانی که یک دانلود توسط کاربر متوقف شود ارسال می‌گردد. آرگومان \fIevent\fP همان ساختاری است که در آرگومان \fIevent\fP در متد \fI\%aria2.onDownloadStart()\fP وجود دارد. .UNINDENT .INDENT 0.0 .TP .B aria2.onDownloadComplete(event) این اعلان زمانی که یک دانلود کامل شود ارسال می‌گردد. برای دانلودهای بیت‌تورنت، این اعلان پس از اتمام دانلود و پایان بذردهی (seeding) ارسال می‌شود. آرگومان \fIevent\fP همان ساختاری است که در آرگومان \fIevent\fP در متد \fI\%aria2.onDownloadStart()\fP وجود دارد. .UNINDENT .INDENT 0.0 .TP .B aria2.onDownloadError(event) این اعلان هنگامی که یک دانلود به دلیل بروز خطا متوقف شود ارسال می‌گردد. آرگومان \fIevent\fP همان ساختاری است که در آرگومان \fIevent\fP در متد \fI\%aria2.onDownloadStart()\fP وجود دارد. .UNINDENT .INDENT 0.0 .TP .B aria2.onBtDownloadComplete(event) این اعلان زمانی ارسال می‌شود که دانلود یک تورنت کامل شده باشد اما بذردهی (seeding) همچنان در حال انجام باشد. آرگومان \fIevent\fP همان ساختاری است که در آرگومان \fIevent\fP در متد \fI\%aria2.onDownloadStart()\fP وجود دارد. .UNINDENT .SS "نمونه کد کلاینت XML-RPC (Sample XML-RPC Client Code)" .sp اسکریپت روبی (Ruby) زیر فایل \fBhttp://localhost/aria2.tar.bz2\fP را به برنامه aria2c (در حال اجرا روی localhost) با گزینه \fI\%\-\-dir=/downloads\fP اضافه کرده و پاسخ RPC را چاپ می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX #!/usr/bin/env ruby require \(aqxmlrpc/client\(aq require \(aqpp\(aq client=XMLRPC::Client.new2(\(dqhttp://localhost:6800/rpc\(dq) options={ \(dqdir\(dq => \(dq/downloads\(dq } result=client.call(\(dqaria2.addUri\(dq, [ \(dqhttp://localhost/aria2.tar.bz2\(dq ], options) pp result .EE .UNINDENT .UNINDENT .sp اگر از علاقه‌مندان به پایتون (Python) هستید، می‌توانید از xmlrpclib (پایتون ۳ در عوض از xmlrpc.client استفاده می‌کند) برای تعامل با aria2 استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX import xmlrpclib from pprint import pprint s = xmlrpclib.ServerProxy(\(dqhttp://localhost:6800/rpc\(dq) r = s.aria2.addUri([\(dqhttp://localhost/aria2.tar.bz2\(dq], {\(dqdir\(dq:\(dq/downloads\(dq}) pprint(r) .EE .UNINDENT .UNINDENT .SH "متفرقه (MISC)" .SS "خوانش کنسول (Console Readout)" .sp هنگام دانلود پرونده‌ها، aria2 برای نمایش پیشرفت دانلودها اطلاعاتی را در کنسول چاپ می‌کند. خروجی کنسول به این صورت است: .INDENT 0.0 .INDENT 3.5 .sp .EX [#2089b0 400.0KiB/33.2MiB(1%) CN:1 DL:115.7KiB ETA:4m51s] .EE .UNINDENT .UNINDENT .sp این بخش معنای این اعداد و رشته‌ها را شرح می‌دهد. .INDENT 0.0 .TP .B \fB#NNNNNN\fP ۶ نویسه نخست GID به‌صورت یک رشته هگزادسیمال (hex). شناسه GID یک شناسه یکتا برای هر دانلود و داخلی برای aria2 است. GID به‌ویژه هنگام تعامل با aria2 با استفاده از رابط RPC بسیار سودمند است. .TP .B \fBX/Y(Z%)\fP حجم دانلودشده، حجم کل پرونده و درصد پیشرفت آن. اگر گزینه \fI\%\-\-select\-file\fP به کار رفته باشد، این مقدار مجموع پرونده‌های انتخاب‌شده است. .TP .B \fBSEED\fP نسبت اشتراک‌گذاری (share ratio) هنگامی که aria2 در حال سید کردن یک تورنت پایان‌یافته است. .TP .B \fBCN\fP تعداد اتصال‌هایی که aria2 برقرار کرده است. .TP .B \fBSD\fP تعداد سیدرهایی که aria2 به آن‌ها متصل است. .TP .B \fBDL\fP سرعت دانلود (بایت بر ثانیه). .TP .B \fBUL\fP سرعت آپلود (بایت بر ثانیه) و حجم بایت‌های آپلودشده. .TP .B \fBETA\fP زمان تخمینی باقی‌مانده تا پایان دانلود. .UNINDENT .sp هنگامی که بیش از یک دانلود در حال انجام است، برخی از اطلاعات شرح داده شده در بالا به منظور نمایش اطلاعات چندین دانلود حذف می‌شوند. همچنین سرعت کلی دانلود و آپلود در ابتدای خط نمایش داده می‌شود. .sp هنگامی که aria2 در حال تخصیص فضای پرونده یا اعتبارسنجی جمع‌های کنترلی (checksums) است، علاوه بر این، پیشرفت این عملیات را چاپ می‌کند: .INDENT 0.0 .TP .B FileAlloc شناسه GID، حجم تخصیص‌یافته تاکنون و حجم کل به بایت. .TP .B Checksum شناسه GID، حجم اعتبارسنجی‌شده تاکنون و حجم کل به بایت. .UNINDENT .SH "مثال‌ها (EXAMPLE)" .SS "دانلودهای چندبخشی HTTP/FTP" .SS "دانلود یک پرونده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \(dqhttp://host/file.zip\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای توقف دانلود، کلیدهای \fBCtrl\-C\fP را فشار دهید. می‌توانید انتقال را با اجرای مجدد aria2c با همان آرگومان در همان پوشه از سر بگیرید. تا زمانی که نشانی‌های URI به همان پرونده اشاره دارند، می‌توانید آن‌ها را تغییر دهید. .UNINDENT .UNINDENT .SS "دانلود یک پرونده از دو سرور HTTP متفاوت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \(dqhttp://host/file.zip\(dq \(dqhttp://mirror/file.zip\(dq .EE .UNINDENT .UNINDENT .SS "دانلود یک پرونده از یک هاست با استفاده از چند اتصال" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-x2 \-k1M \(dqhttp://host/file.zip\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 گزینه \-x تعداد اتصال‌های مجاز را مشخص می‌کند، در حالی که گزینه \-k اندازه قطعات (chunks) را تعیین می‌نماید. .UNINDENT .UNINDENT .SS "دانلود هم‌زمان یک پرونده از سرورهای HTTP و FTP" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \(dqhttp://host1/file.zip\(dq \(dqftp://host2/file.zip\(dq .EE .UNINDENT .UNINDENT .SS "دانلود هم‌زمان پرونده‌های فهرست‌شده در یک فایل متنی" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-ifiles.txt \-j2 .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 گزینه \-j تعداد دانلودهای موازی را مشخص می‌کند. .UNINDENT .UNINDENT .SS "استفاده از پروکسی" .sp برای HTTP: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-http\-proxy=\(dqhttp://proxy:8080\(dq \(dqhttp://host/file\(dq .EE .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-http\-proxy=\(dqhttp://proxy:8080\(dq \-\-no\-proxy=\(dqlocalhost,127.0.0.1,192.168.0.0/16\(dq \(dqhttp://host/file\(dq .EE .UNINDENT .UNINDENT .sp برای FTP: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-ftp\-proxy=\(dqhttp://proxy:8080\(dq \(dqftp://host/file\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای جزئیات بیشتر به \fI\%\-\-http\-proxy\fP، \fI\%\-\-https\-proxy\fP، \fI\%\-\-ftp\-proxy\fP، \fI\%\-\-all\-proxy\fP و \fI\%\-\-no\-proxy\fP مراجعه کنید. می‌توانید پروکسی را در متغیرهای محیطی نیز تعیین نمایید؛ به بخش \fI\%ENVIRONMENT\fP مراجعه کنید. .UNINDENT .UNINDENT .SS "استفاده از پروکسی همراه با احراز هویت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-http\-proxy=\(dqhttp://username:password@proxy:8080\(dq \(dqhttp://host/file\(dq .EE .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-http\-proxy=\(dqhttp://proxy:8080\(dq \-\-http\-proxy\-user=\(dqusername\(dq \-\-http\-proxy\-passwd=\(dqpassword\(dq \(dqhttp://host/file\(dq .EE .UNINDENT .UNINDENT .SS "دانلود متالینک (Metalink)" .SS "دانلود پرونده‌ها با متالینک از راه دور" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-follow\-metalink=mem \(dqhttp://host/file.metalink\(dq .EE .UNINDENT .UNINDENT .SS "دانلود با استفاده از یک پرونده متالینک محلی" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-p \-\-lowest\-speed\-limit=4000 file.metalink .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای متوقف کردن دانلود، کلیدهای \fBCtrl\-C\fP را فشار دهید. می‌توانید با اجرای مجدد aria2c با همان آرگومان در همان پوشه، انتقال را از سر بگیرید. .UNINDENT .UNINDENT .SS "دانلود هم‌زمان چند پرونده متالینک محلی" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-j2 file1.metalink file2.metalink .EE .UNINDENT .UNINDENT .SS "تنها دانلود پرونده‌های انتخاب‌شده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-select\-file=1\-4,8 file.metalink .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 نمایه پرونده‌ها با استفاده از گزینه \-S در کنسول چاپ می‌شود. .UNINDENT .UNINDENT .SS "دانلود پرونده با استفاده از پرونده متالینک محلی بر اساس اولویت کاربر" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-metalink\-location=jp,us \-\-metalink\-version=1.1 \-\-metalink\-language=en\-US file.metalink .EE .UNINDENT .UNINDENT .SS "دانلود بیت‌تورنت (BitTorrent)" .SS "دانلود پرونده‌ها با استفاده از پرونده بیت‌تورنت از راه دور" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-follow\-torrent=mem \(dqhttp://host/file.torrent\(dq .EE .UNINDENT .UNINDENT .SS "دانلود با استفاده از یک پرونده تورنت محلی" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-max\-upload\-limit=40K file.torrent .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 گزینه \-\-max\-upload\-limit حداکثر نرخ ارسال (آپلود) را تعیین می‌کند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای متوقف کردن دانلود، کلیدهای \fBCtrl\-C\fP را فشار دهید. بعداً می‌توانید با اجرای مجدد aria2c با همان آرگومان در همان پوشه انتقال را از سر بگیرید. .UNINDENT .UNINDENT .SS "دانلود با استفاده از نشانی مغناطیسی (Magnet URI) بیت‌تورنت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \(dqmagnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 فراموش نکنید هنگام تعیین نشانی‌های Magnet بیت‌تورنت حاوی نویسه \fB&\fP در خط فرمان، آن‌ها را میان علامت‌های نقل‌قول تکی (\fB\(aq\fP) یا دوتایی (\fB\(dq\fP) قرار دهید. .UNINDENT .UNINDENT .SS "دانلود ۲ تورنت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-j2 file1.torrent file2.torrent .EE .UNINDENT .UNINDENT .SS "دانلود موازی یک پرونده از طریق تورنت و سرور HTTP/FTP" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-Ttest.torrent \(dqhttp://host1/file\(dq \(dqftp://host2/file\(dq .EE .UNINDENT .UNINDENT .SS "تنها دانلود پرونده‌های خاص (معمولاً موسوم به \(dqدانلود انتخابی\(dq)" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-select\-file=1\-4,8 file.torrent .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 نمایه پرونده‌ها با استفاده از گزینه \-S در کنسول چاپ می‌شود. .UNINDENT .UNINDENT .SS "دانلود یک پرونده .torrent بدون دانلود محتوای تورنت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-follow\-torrent=false \(dqhttp://host/file.torrent\(dq .EE .UNINDENT .UNINDENT .SS "تعیین نام پرونده خروجی" .sp برای مشخص کردن نام پرونده خروجی در دانلودهای بیت‌تورنت، باید نمایه پرونده را در تورنت بدانید (به \fI\%\-\-show\-files\fP مراجعه کنید). برای مثال، خروجی به این صورت است: .INDENT 0.0 .INDENT 3.5 .sp .EX idx|path/length ===+====================== 1|dist/base\-2.6.18.iso |99.9MiB \-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- 2|dist/driver\-2.6.18.iso |169.0MiB \-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EE .UNINDENT .UNINDENT .sp برای ذخیره \(aqdist/base\-2.6.18.iso\(aq در \(aq/tmp/mydir/base.iso\(aq و \(aqdist/driver\-2.6.18.iso\(aq در \(aq/tmp/dir/driver.iso\(aq، از دستور زیر استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-dir=/tmp \-\-index\-out=1=mydir/base.iso \-\-index\-out=2=dir/driver.iso file.torrent .EE .UNINDENT .UNINDENT .SS "تغییر درگاه‌های شنود برای اتصال‌های ورودی همتایان" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-listen\-port=7000\-7001,8000 file.torrent .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 از آنجا که aria2 دیوار آتش یا مسیریاب‌ها را برای هدایت درگاه (port forwarding) پیکربندی نمی‌کند، انجام دستی این کار بر عهده خود شماست. .UNINDENT .UNINDENT .SS "تعیین شرایط توقف سید کردن پس از پایان دانلود تورنت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-seed\-time=120 \-\-seed\-ratio=1.0 file.torrent .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 در مثال بالا، برنامه پس از گذشت ۱۲۰ دقیقه از تکمیل دانلود، یا زمانی که نسبت اشتراک‌گذاری (seed ratio) به ۱٫۰ برسد، ارسال (سید کردن) را متوقف می‌کند. .UNINDENT .UNINDENT .SS "محدود کردن سرعت آپلود" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-max\-upload\-limit=100K file.torrent .EE .UNINDENT .UNINDENT .SS "فعال‌سازی DHT برای IPv4" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-enable\-dht \-\-dht\-listen\-port=6881 file.torrent .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 سرویس DHT از پروتکل UDP استفاده می‌کند. از آنجا که aria2 دیوار آتش یا مسیریاب‌ها را برای هدایت درگاه (port forwarding) پیکربندی نمی‌کند، انجام دستی آن بر عهده خود شماست. .UNINDENT .UNINDENT .SS "فعال‌سازی DHT برای IPv6" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-enable\-dht6 \-\-dht\-listen\-port=6881 \-\-dht\-listen\-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برنامه aria2 برای IPv6 از همان درگاه‌های IPv4 استفاده می‌کند. .UNINDENT .UNINDENT .SS "افزودن و حذف نشانی‌های ردیاب (Tracker)" .sp صرف‌نظر کردن از تمام نشانی‌های اعلام ردیاب (announce URIs) تعریف‌شده در file.torrent و استفاده از \fBhttp://tracker1/announce\fP و \fBhttp://tracker2/announce\fP به‌جای آن‌ها: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-bt\-exclude\-tracker=\(dq*\(dq \-\-bt\-tracker=\(dqhttp://tracker1/announce,http://tracker2/announce\(dq file.torrent .EE .UNINDENT .UNINDENT .SS "قابلیت‌های پیشرفته‌تر HTTP" .SS "بارگذاری کوکی‌ها" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-load\-cookies=cookies.txt \(dqhttp://host/file.zip\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 می‌توانید پرونده‌های کوکی مرورگرهای Firefox/Mozilla/Chromium را بدون دستکاری استفاده نمایید. .UNINDENT .UNINDENT .SS "از سرگیری دانلودی که توسط مرورگرهای وب یا سایر برنامه‌ها آغاز شده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-c \-s2 \(dqhttp://host/partiallydownloadedfile.zip\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 این کار تنها زمانی پاسخگو خواهد بود که دانلود اولیه به‌صورت چندبخشی انجام نشده باشد. .UNINDENT .UNINDENT .SS "احراز هویت با گواهی کلاینت برای SSL/TLS" .sp یک پرونده PKCS12 را به این صورت تعیین کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-certificate=/path/to/mycert.p12 .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 پرونده مشخص‌شده در \fI\%\-\-certificate\fP باید شامل یک گواهی و کلید کدگذاری‌شده با PKCS12 باشد. گذرواژه باید خالی باشد. .UNINDENT .UNINDENT .sp همچنین اگر پرونده‌های PEM پشتیبانی می‌شوند، از دستوری مشابه زیر استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-certificate=/path/to/mycert.pem \-\-private\-key=/path/to/mykey.pem https://host/file .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 پرونده مشخص‌شده در \fI\%\-\-private\-key\fP باید رمزگشایی‌شده (decrypted) باشد؛ کلید رمزگذاری‌شده ممکن است موجب رفتاری تعریف‌نشده شود. .UNINDENT .UNINDENT .SS "اعتبارسنجی سرورهای SSL/TLS با استفاده از گواهی‌های CA مشخص‌شده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-ca\-certificate=/path/to/ca\-certificates.crt \-\-check\-certificate https://host/file .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 این گزینه تنها زمانی در دسترس است که aria2 در برابر GnuTLS یا OpenSSL کامپایل شده باشد. سامانه‌های WinTLS و AppleTLS همواره از مخزن گواهی سیستم استفاده خواهند کرد. به‌جای \fB\(ga\-\-ca\-certificate\fP گواهی را در همان مخزن نصب کنید. .UNINDENT .UNINDENT .SS "کنترل از راه دور (RPC)" .SS "رمزنگاری ترافیک RPC با SSL/TLS" .sp مشخص کردن یک پرونده PKCS12 سرور: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-enable\-rpc \-\-rpc\-certificate=/path/to/server.p12 \-\-rpc\-secure .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 پرونده مشخص‌شده در \fI\%\-\-rpc\-certificate\fP باید شامل یک گواهی و کلید کدگذاری‌شده با PKCS12 باشد. گذرواژه باید خالی باشد. .UNINDENT .UNINDENT .sp همچنین در صورتی که پرونده‌های PEM پشتیبانی می‌شوند (GnuTLS و OpenSSL)، پرونده گواهی سرور و کلید خصوصی را به روش زیر مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-enable\-rpc \-\-rpc\-certificate=/path/to/server.crt \-\-rpc\-private\-key=/path/to/server.key \-\-rpc\-secure .EE .UNINDENT .UNINDENT .SS "و امکانات پیشرفته‌تر" .SS "محدود کردن سرعت دانلود" .sp برای هر دانلود: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-max\-download\-limit=100K file.metalink .EE .UNINDENT .UNINDENT .sp سرعت کلی: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-max\-overall\-download\-limit=100K file.metalink .EE .UNINDENT .UNINDENT .SS "ترمیم یک دانلود آسیب‌دیده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-V file.metalink .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 ترمیم دانلودهای آسیب‌دیده هنگام استفاده با BitTorrent یا Metalink دارای جمع کنترلی قطعات (chunk checksums) به شکلی بسیار کارآمد انجام می‌شود. .UNINDENT .UNINDENT .SS "قطع اتصال در صورتی که سرعت دانلود کمتر از حد مشخص‌شده باشد" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-lowest\-speed\-limit=10K file.metalink .EE .UNINDENT .UNINDENT .SS "پشتیبانی از نشانی‌های پارامتریک (Parameterized URI)" .sp می‌توانید مجموعه‌ای از بخش‌ها را مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-P \(dqhttp://{host1,host2,host3}/file.iso\(dq .EE .UNINDENT .UNINDENT .sp می‌توانید یک توالی عددی مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-Z \-P \(dqhttp://host/image[000\-100].png\(dq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اگر نشانی‌های URI همانند مثال بالا به پرونده یکسانی اشاره نکنند، استفاده از گزینه \-Z الزامی است. .UNINDENT .UNINDENT .sp می‌توانید شمارنده گام را مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-Z \-P \(dqhttp://host/image[A\-Z:2].png\(dq .EE .UNINDENT .UNINDENT .SS "اعتبارسنجی جمع‌های کنترلی (Checksums)" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-checksum=sha\-1=0192ba11326fe2298c8cb4de616f4d4140213837 http://example.org/file .EE .UNINDENT .UNINDENT .SS "دانلود هم‌زمان تعداد دلخواهی نشانی، متالینک و تورنت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-j3 \-Z \(dqhttp://host/file1\(dq file2.torrent file3.metalink .EE .UNINDENT .UNINDENT .SS "رمزنگاری بیت‌تورنت (BitTorrent Encryption)" .sp رمزنگاری کل محموله با استفاده از ARC4 (مبهم‌سازی): .INDENT 0.0 .INDENT 3.5 .sp .EX $ aria2c \-\-bt\-min\-crypto\-level=arc4 \-\-bt\-require\-crypto=true file.torrent .EE .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp وب‌گاه پروژه: \fI\%https://aria2.github.io\fP .sp صفحه اصلی متالینک: \fI\%http://www.metalinker.org\fP .sp قالب توصیف دانلود متالینک: \fI\%RFC 5854\fP .SH "حق نشر (COPYRIGHT)" .sp حق نشر (C) 2006, 2015 متعلق به Tatsuhiro Tsujikawa است. .sp این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) طبق آنچه توسط «بنیاد نرم‌افزار آزاد» (Free Software Foundation) منتشر شده است، چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخه بعدی آن، بازتوزیع کرده یا تغییر دهید. .sp این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید. .sp شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر نامه بنویسید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA .sp علاوه بر این، به عنوان یک استثنای خاص، دارندگان حق نشر اجازه می‌دهند تا بخش‌هایی از کد این برنامه با کتابخانه OpenSSL تحت شرایط خاصی که در هر پرونده مبدأ به صورت جداگانه شرح داده شده است پیوند داده شود و ترکیب‌های پیوندیافته از جمله هر دوی آن‌ها توزیع گردد. شما باید در مورد تمام کدهای استفاده‌شده به جز OpenSSL، در کلیه جنبه‌ها از پروانه عمومی همگانی گنو تبعیت نمایید. اگر پرونده(ها) را با این استثنا تغییر دهید، می‌توانید این استثنا را به نسخه خود از پرونده(ها) تعمیم دهید، اما ملزم به این کار نیستید. اگر مایل به انجام این کار نیستید، این بیانیه استثنا را از نسخه خود حذف کنید. چنانچه این بیانیه استثنا را از تمام پرونده‌های مبدأ در برنامه حذف کردید، آن را از اینجا نیز حذف کنید. .\" Generated by docutils manpage writer. .