نام (NAME)

axel - شتاب‌دهنده سبک بارگیری در خط فرمان

خلاصه دستور (SYNOPSIS)

axel [OPTIONS] url1 [url2] [url...]

توضیحات (DESCRIPTION)

برنامهٔ Axel ابزاری است که فایلی را از طریق چندین اتصال از کارساز FTP یا HTTP بارگیری می‌کند. هر اتصال بخش مربوط به خود از فایل را بارگیری می‌نماید.

برخلاف بیشتر برنامه‌ها، Axel تمام داده‌ها را مستقیماً درون فایل مقصد می‌نویسد. این کار در پایان بارگیری موجب صرفه‌جویی در زمان می‌شود، زیرا برنامه نیازی به چسباندن بخش‌های بارگیری‌شده به یکدیگر نخواهد داشت.

برنامهٔ Axel از پروتکل‌های HTTP، HTTPS، FTP و FTPS پشتیبانی می‌کند.

گزینه‌ها (OPTIONS)

یک آرگومان الزامی است: URL فایلی که می‌خواهید بارگیری کنید. هنگام بارگیری از طریق FTP، ممکن است نام فایل شامل نویسه‌های عام (wildcard) باشد و برنامه برای پیدا کردن نام کامل فایل تلاش خواهد کرد. همچنین می‌توان چندین URL آینه‌ای (mirror) را برای یک فایل یکسان مشخص کرد تا برنامه از تمام آن نشانی‌ها برای بارگیری استفاده کند.

لطفاً توجه داشته باشید که برنامه یکسان بودن محتوای فایل‌ها را بررسی نمی‌کند.

سایر گزینه‌ها:

--max-speed=x, -s x: تعیین حداکثر سرعت (بایت در ثانیه) برای نگه‌داشتن میانگین سرعت بارگیری در حول‌وحوش این مقدار. این گزینه زمانی مفید است که نمی‌خواهید برنامه تمام پهنای باند شبکهٔ شما را مصرف کند.
--num-connections=x, -n x: تعیین تعداد متفاوتی برای اتصال‌ها.
--max-redirect=x: تعیین تعداد بازهدایت‌هایی (redirections) که برنامه هنگام اتصال به سرور مجاز به دنبال کردن آن‌هاست (پیش‌فرض 20 است).
--output=x, -o x: داده‌های بارگیری‌شده در فایلی محلی با همان نام ذخیره می‌شوند، مگر این‌که با این گزینه نام دیگری را مشخص کنید. همچنین می‌توانید یک دایرکتوری را تعیین کنید که در این حالت برنامه نام فایل را به انتهای آن اضافه خواهد کرد.
--search[=x], -S[x]: برنامهٔ Axel می‌تواند با استفاده از موتور جستجوی filesearching.com آینه‌ها را جستجو کند. با مشخص کردن این گزینه، این جستجو انجام خواهد شد. همچنین می‌توانید تعیین کنید چه تعداد آینهٔ مختلف باید برای بارگیری استفاده شود. جستجوی آینه‌ها ممکن است زمان‌بر باشد، زیرا برنامه سرعت تک‌تک سرورها را می‌سنجد و در دسترس بودن فایل را بررسی می‌کند.
--ipv6, -6: تنها استفاده از پروتکل IPv6 هنگام اتصال به میزبان.
--ipv4, -4: تنها استفاده از پروتکل IPv4 هنگام اتصال به میزبان.
--no-proxy, -N: عدم استفاده از هیچ‌گونه سرور پروکسی برای بارگیری فایل. البته در صورتی که یک پروکسی شفاف (transparent proxy) فعال باشد، این کار ممکن نخواهد بود.
--insecure, -k: عدم اعتبارسنجی گواهی SSL. تنها در صورتی از این گزینه استفاده کنید که با خطای گواهی مواجه می‌شوید و از اصالت وبگاه اطمینان دارید.

--no-clobber, -c در صورتی که فایلی با همین نام در پوشهٔ جاری موجود باشد و هیچ فایل وضعیتی یافت نشود، بارگیری را نادیده بگیر.

--verbose, -v: نمایش پیام‌های وضعیت بیشتر. برای مشاهدهٔ جزئیات بیشتر، از این گزینه بیش از یک‌بار استفاده کنید.
--quiet, -q: عدم ارسال هرگونه خروجی به stdout.
--alternate, -a: نمایش یک نشانگر پیشرفت جایگزین. این نوار، وضعیت و پیشرفت ریسه‌های مختلف را همراه با سرعت فعلی و تخمینی از زمان باقی‌ماندهٔ بارگیری نمایش می‌دهد.
--header=x, -H x: افزودن یک هدر HTTP اضافی. این گزینه باید در قالب "Header: Value" باشد. برای جزئیات مربوط به قالب‌بندی و هدرهای استاندارد، بخش‌های 4.2 و 14 از RFC 2616 را ببینید.
--user-agent=x, -U x: تنظیم عامل کاربر (User Agent) در HTTP. برخی وبگاه‌ها بر اساس این پارامتر محتوای متفاوتی را ارائه می‌دهند. مقدار پیش‌فرض شامل "Axel"، نسخهٔ آن و مشخصات پلتفرم خواهد بود.
--help, -h: نمایش خلاصه‌ای کوتاه از تمام گزینه‌ها.
--timeout=x, -T x: تنظیم مهلت زمانی (timeout) برای اتصال و I/O.
--version, -V: دریافت اطلاعات نسخه.

نکته (NOTE)

گزینه‌های طولانی (دو خط تیره) تنها در صورتی پشتیبانی می‌شوند که پلتفرم شما با فراخوان getopt_long سازگار باشد. در غیر این صورت (مانند *BSD)، تنها گزینه‌های کوتاه قابل استفاده خواهند بود.

وضعیت خروج (EXIT STATUS)

این برنامه در صورت موفقیت‌آمیز بودن بارگیری مقدار 0، در صورت بروز خطای جدی مقدار 1 و در صورت متوقف شدن بارگیری مقدار 2 را بازمی‌گرداند. اگر مقدار دیگری برگردانده شود، ناشی از یک باگ است.

مثال‌ها (EXAMPLES)

ساده‌ترین روش برای بارگیری یک فایل به این صورت است:

$ axel http://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-9.1.0-amd64-netinst.iso
$ axel ftp://ftp.nl.kernel.org/pub/linux/kernel/v2.2/linux-2.2.20.tar.bz2

دستور زیر از آینه‌های بلژیک، هلند، انگلستان و آلمان در kernel.org برای بارگیری تصویر کرنل لینوکس 2.4.17 استفاده می‌کند:

$ axel ftp://ftp.{be,nl,uk,de}.kernel.org/pub/linux/kernel/v2.4/linux-2.4.17.tar.bz2

دستور زیر فایل linux-2.4.17.tar.bz2 را در وبگاه filesearching.com جستجو می‌کند و از چهار آینهٔ سریع‌تر (در صورت امکان) برای بارگیری استفاده خواهد کرد (که ممکن است شامل ftp.kernel.org نیز باشد):

$ axel -S4 ftp://ftp.kernel.org/pub/linux/kernel/v2.4/linux-2.4.17.tar.bz2

فایل‌ها (FILES)

/etc/axelrc: فایل پیکربندی سراسری سیستم.
~/.axelrc: فایل پیکربندی شخصی کاربر.

این فایل‌ها در هیچ صفحه‌ راهنمایی مستند نشده‌اند، اما فایل نمونه‌ای که همراه برنامه ارائه می‌شود حاوی اطلاعات کافی است. مکان فایل پیکربندی سراسری سیستم ممکن است در سیستم‌های گوناگون متفاوت باشد. در کد مبدأ، این فایل نمونه در دایرکتوری doc/ قرار دارد. این فایل عموماً در مسیر /usr/share/doc/axel/examples/ یا معادل آن در سیستم شما نصب می‌شود.

کپی‌رایت و تکثیر (COPYRIGHT)

برنامهٔ Axel در اصل توسط Wilmer van der Gaast و در طول زمان توسط دیگر نویسندگان توسعه یافته است. لطفاً فایل‌های AUTHORS و CREDITS را ببینید.

صفحهٔ اصلی پروژه: <https://github.com/axel-download-accelerator/axel>

کمک به این پروژه (HELP THIS PROJECT)

اگر قصد مشارکت و کمک به این پروژه را دارید، لطفاً فایل CONTRIBUTING.md را بخوانید. در سیستم‌های دبیان، این فایل در دایرکتوری /usr/share/doc/axel/ در دسترس خواهد بود.