نام (NAME)

simpleftp - یک کلاینت مقدماتی FTP و HTTP(S)

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

simpleftp url [...]

توضیحات (DESCRIPTION)

simpleftp یک اسکریپت Perl است که پشتیبانی اولیه‌ای برای دریافت دسته‌ای (batch) فایل‌ها فراهم می‌کند. این ابزار یک یا چند نشانی اینترنتی (URL) پروتکل‌های FTP یا HTTP(S) را در خط فرمان دریافت می‌کند. فایل(ها) از سرور(های) دوردست وب یا FTP واکشی شده و با همان نام پایه (basename) فایل دوردست در دایرکتوری فعلی ذخیره می‌شوند؛ برای مثال، https://downloads.isc.org/pub/usenet/CONFIG/active.gz به صورت active.gz در دایرکتوری فعلی ذخیره می‌شود.

این اسکریپت نام‌های کاربری، گذرواژه‌ها و درگاه‌های (port) مشخص‌شده به صورت زیر را به درستی درک می‌کند:

ftp://user:password@host:port/path/file

simpleftp دارای یک زمان انتظار (timeout) ثابت ۳۰ ثانیه‌ای است. این ابزار برای انتقال داده‌های FTP از حالت دودویی (binary mode) و حالت غیرفعال (passive mode) استفاده می‌کند.

این برنامه در صورت موفقیت با وضعیت خروج ۰ خارج می‌شود. در غیر این صورت، وضعیت خروج برابر با تعداد انتقال‌های ناموفق خواهد بود.

بسته INN تنها هنگام اجرای actsyncd از simpleftp استفاده می‌کند. اگر wget (یا همچنین ncftpget یا ncftp صرفاً برای پروتکل FTP) در زمان پیکربندی یافت شود، به جای این اسکریپت استفاده خواهد شد.

گزارش باگ‌ها (BUGS)

simpleftp جایگزینی بسیار ضعیف برای برنامه‌های کامل‌تری مانند ابزار آزاد wget است که توصیه می‌شود به جای آن استفاده شود. این اسکریپت فقط برای ارائه پشتیبانی مقدماتی در INN جهت دریافت غیرتعاملی فایل‌ها در https://downloads.isc.org/pub/pgpcontrol یا https://downloads.isc.org/pub/usenet/CONFIG بدون نیاز به نصب بسته‌ای دیگر توسط مدیران سیستم نوشته شده است. کاستی‌های آن به عنوان یک برنامه چندمنظوره فراتر از آن است که ذکر شود، اما یکی از موارد برجسته این است که فایل‌های بارگیری‌شده توسط simpleftp، فایل‌های موجود با همان نام را در دایرکتوری محلی بازنویسی می‌کنند (override).

پشتیبانی از HTTP نیازمند ماژول پرل "HTTP::Tiny" است که تنها در Perl نسخه 5.14.0 و بالاتر به عنوان یک ماژول هسته پرل نصب شده است. علاوه بر این، ماژول‌های پرل "IO::Socket::SSL" و "Net::SSLeay" برای پشتیبانی از HTTPS الزامی هستند. در صورتی که این ماژول‌ها نصب نباشند، simpleftp نمی‌تواند این پروتکل‌ها را مدیریت کند.

تاریخچه (HISTORY)

توسط David C Lawrence <tale@isc.org> برای InterNetNews با عجله نوشته شد. برای استفاده از "HTTP::Tiny" و "Net::FTP" توسط Julien Élie بازنویسی شد.

همچنین ببینید (SEE ALSO)

actsync(8).