.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SIMPLEFTP 1"
.TH SIMPLEFTP 1 2025-03-29 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
simpleftp \- یک کلاینت مقدماتی FTP و HTTP(S)
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBsimpleftp\fR \fIurl\fR [...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBsimpleftp\fR یک اسکریپت Perl است که پشتیبانی اولیه‌ای برای دریافت دسته‌ای (batch) فایل‌ها
فراهم می‌کند. این ابزار یک یا چند نشانی اینترنتی (URL) پروتکل‌های FTP یا HTTP(S) را در
خط فرمان دریافت می‌کند. فایل(ها) از سرور(های) دوردست وب یا FTP واکشی شده و با همان
نام پایه (basename) فایل دوردست در دایرکتوری فعلی ذخیره می‌شوند؛ برای مثال،
<https://downloads.isc.org/pub/usenet/CONFIG/active.gz> به صورت \fIactive.gz\fR
در دایرکتوری فعلی ذخیره می‌شود.
.PP
این اسکریپت نام‌های کاربری، گذرواژه‌ها و درگاه‌های (port) مشخص‌شده به صورت زیر را
به درستی درک می‌کند:
.PP
.Vb 1
\&    ftp://user:password@host:port/path/file
.Ve
.PP
\&\fBsimpleftp\fR دارای یک زمان انتظار (timeout) ثابت ۳۰ ثانیه‌ای است. این ابزار برای انتقال داده‌های
FTP از حالت دودویی (binary mode) و حالت غیرفعال (passive mode) استفاده می‌کند.
.PP
این برنامه در صورت موفقیت با وضعیت خروج ۰ خارج می‌شود. در غیر این صورت، وضعیت خروج برابر با
تعداد انتقال‌های ناموفق خواهد بود.
.PP
بسته INN تنها هنگام اجرای \fBactsyncd\fR از \fBsimpleftp\fR استفاده می‌کند. اگر \fBwget\fR (یا همچنین
\&\fBncftpget\fR یا \fBncftp\fR صرفاً برای پروتکل FTP) در زمان پیکربندی یافت شود، به جای این اسکریپت
استفاده خواهد شد.
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
\&\fBsimpleftp\fR جایگزینی بسیار ضعیف برای برنامه‌های کامل‌تری مانند ابزار آزاد \fBwget\fR است که
توصیه می‌شود به جای آن استفاده شود. این اسکریپت فقط برای ارائه پشتیبانی مقدماتی در INN
جهت دریافت غیرتعاملی فایل‌ها در <https://downloads.isc.org/pub/pgpcontrol>
یا <https://downloads.isc.org/pub/usenet/CONFIG> بدون نیاز به نصب بسته‌ای دیگر توسط مدیران سیستم
نوشته شده است. کاستی‌های آن به عنوان یک برنامه چندمنظوره فراتر از آن است که ذکر شود، اما یکی از
موارد برجسته این است که فایل‌های بارگیری‌شده توسط \fBsimpleftp\fR، فایل‌های موجود با همان نام را در
دایرکتوری محلی بازنویسی می‌کنند (override).
.PP
پشتیبانی از HTTP نیازمند ماژول پرل \f(CW\*(C`HTTP::Tiny\*(C'\fR است که تنها در Perl نسخه 5.14.0 و بالاتر
به عنوان یک ماژول هسته پرل نصب شده است. علاوه بر این، ماژول‌های پرل \f(CW\*(C`IO::Socket::SSL\*(C'\fR و
\&\f(CW\*(C`Net::SSLeay\*(C'\fR برای پشتیبانی از HTTPS الزامی هستند. در صورتی که این ماژول‌ها نصب نباشند،
\&\fBsimpleftp\fR نمی‌تواند این پروتکل‌ها را مدیریت کند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
توسط David C Lawrence <tale@isc.org> برای InterNetNews با عجله نوشته شد.
برای استفاده از \f(CW\*(C`HTTP::Tiny\*(C'\fR و \f(CW\*(C`Net::FTP\*(C'\fR توسط Julien Élie بازنویسی شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
actsync(8).