کتابخانه‌ی استاندارد · شبکه

اف‌تی‌پی ftp

کارخواه FTP و FTPS: فهرست پوشه، بارگذاری و دریافت پرونده.

واردسازی اف‌تی‌پی

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

با این بسته به سرورهای FTP وصل می‌شوید؛ مثلاً برای بارگذاری سایت روی میزبانی اشتراکی یا گرفتن پرونده‌ها از دستگاه‌های قدیمی و سرور تأمین‌کنندگان. FTP ساده گذرواژه و داده را بی‌رمز می‌فرستد؛ هر جا سرور پشتیبانی می‌کند اتصال امن را به کار ببرید که با AUTH TLS هم فرمان‌ها و هم داده را رمز می‌کند. اگر سرور SSH هم دارد، SFTP از راه اس اس اچ گزینه‌ی بهتری است: یک اتصال رمزشده و بدون کانال داده‌ی جدا.

انتقال‌ها در حالت غیرفعال انجام می‌شوند (EPSV، یا PASV اگر سرور آن را نداشته باشد) که از پشت دیوار آتش هم کار می‌کند؛ حالت فعال (PORT) پشتیبانی نمی‌شود. تابع‌های تجزیه، مثل تحلیل خط فهرست، برای نوشتن ابزارهای خودتان هم در دسترس‌اند.

نکته‌هایی که باید بدانید:

  • پیش از انتقال دودویی را صدا بزنید، وگرنه سروری که در حالت ASCII است ممکن است پایان سطرها را درون تصویر و بایگانی عوض کند.
  • ارسال و دریافت کل پرونده را در حافظه نگه می‌دارند و انتقالی که قطع شود از اول شروع می‌شود؛ ادامه‌ی انتقال در کار نیست. برای پرونده‌های سایت و گزارش‌ها مناسب است، نه برای پشتیبان چند گیگابایتی.
  • خواندن، نوشتن و افزودن با رشته کار می‌کنند، پس برای متن‌اند: محتوای دودویی در نخستین بایت صفر قطع می‌شود. برای هر چیز دیگر ارسال و دریافت را به کار ببرید.
  • سرورهایی که بازاستفاده از نشست TLS را روی اتصال داده می‌خواهند همه‌ی انتقال‌ها را رد می‌کنند؛ بخش آخر را ببینید.

بارگذاری سایت روی میزبانی اشتراکی

کار معمول این است: با اتصال امن وصل شوید، اگر فرمان‌ها و داده هر دو رمز نشده‌اند ادامه ندهید، وارد شوید و پوشه‌ی ساخته شده را با ارسال پوشه بالا بفرستید. پیش از هر انتقال با دودویی به حالت دودویی بروید، وگرنه برخی سرورها پایان خط‌ها را درون تصویرها و فایل‌های فشرده عوض می‌کنند. نگه داشتن index.html قبلی با نامی دیگر به کمک تغییر نام راه برگشتی برایتان می‌گذارد.

ftp-publish-site.salam
واردسازی اف‌تی‌پی

تابع ریشه:
    ناپایا کارخواه := اف‌تی‌پی.اتصال امن("ftp.example-host.com"، ۲۱)
    اگر وارونه اف‌تی‌پی.سالم(کارخواه):
        سرچاپ "اتصال برقرار نشد:"، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        برگشت ۱
    پایان
    اگر وارونه اف‌تی‌پی.امن(کارخواه) یا وارونه اف‌تی‌پی.داده امن(کارخواه):
        سرچاپ "سرور نشست را رمز نکرد، کار متوقف شد"
        اف‌تی‌پی.بستن(کارخواه)
        برگشت ۱
    پایان
    اگر وارونه اف‌تی‌پی.ورود(کارخواه، "site-user"، "app-password"):
        سرچاپ "ورود ناموفق:"، اف‌تی‌پی.آخرین کد(کارخواه)، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        اف‌تی‌پی.بستن(کارخواه)
        برگشت ۱
    پایان
    _ := اف‌تی‌پی.دودویی(کارخواه)
    _ := اف‌تی‌پی.ساخت مسیر کامل(کارخواه، "/public_html")
    اگر اف‌تی‌پی.وجود دارد(کارخواه، "/public_html/index.html"):
        _ := اف‌تی‌پی.تغییر نام(کارخواه، "/public_html/index.html"، "/public_html/index.old.html")
    پایان
    اگر وارونه اف‌تی‌پی.ارسال پوشه(کارخواه، "dist"، "/public_html"):
        سرچاپ "بارگذاری ناموفق:"، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        برگشت ۱
    پایان
    سرچاپ "بارگذاری شد، اندازه‌ی index.html:"، اف‌تی‌پی.اندازه(کارخواه، "/public_html/index.html")، "بایت"
    اف‌تی‌پی.خروج(کارخواه)
    اف‌تی‌پی.بستن(کارخواه)
    برگشت ۰
پایان

این برنامه به یک سرور واقعی نیاز دارد، پس این‌جا فقط بررسی می‌شود. هر تابعی که با سرور حرف می‌زند پاسخ را در آخرین کد و آخرین پاسخ می‌گذارد، پس پس از هر نادرست همیشه می‌توانید چاپ کنید سرور چه گفته است.

فقط فایل‌های تازه را بگیرید

فهرست برای هر مدخل یک اطلاعات پرونده با نام، اندازه و این‌که پوشه یا پیوند است برمی‌گرداند. مقایسه‌ی آن با چیزی که روی دیسک هست، دانلود کامل را به یک همگام‌سازی ارزان تبدیل می‌کند؛ این برای کاری شبانه که گزارش‌ها را از یک تامین‌کننده جمع می‌کند مناسب است.

ftp-sync-down.salam
واردسازی اف‌تی‌پی
واردسازی سیستم عامل

تابع ریشه:
    ناپایا کارخواه := اف‌تی‌پی.اتصال امن("files.example.com"، ۲۱)
    اگر وارونه اف‌تی‌پی.سالم(کارخواه) یا وارونه اف‌تی‌پی.ورود(کارخواه، "reports"، "app-password"):
        سرچاپ "ورود ممکن نشد:"، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        برگشت ۱
    پایان
    _ := اف‌تی‌پی.دودویی(کارخواه)
    _ := سیستم عامل.ساخت پوشه ها("reports")
    ناپایا گرفته شده := ۰
    ناپایا رد شده := ۰
    هر پرونده در اف‌تی‌پی.فهرست(کارخواه، "/daily"):
        اگر پرونده.پوشه یا پرونده.پیوند:
            گذر
        پایان
        مسیر محلی := "reports/" + پرونده.نام
        اگر سیستم عامل.وجود دارد(مسیر محلی):
            رد شده++
            گذر
        پایان
        اگر اف‌تی‌پی.دریافت(کارخواه، "/daily/" + پرونده.نام، مسیر محلی):
            گرفته شده++
        وگرنه:
            سرچاپ "ناموفق:"، پرونده.نام، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        پایان
    پایان
    سرچاپ "گرفته شد"، گرفته شده، "پرونده‌ی تازه، رد شد"، رد شده
    اف‌تی‌پی.خروج(کارخواه)
    اف‌تی‌پی.بستن(کارخواه)
    برگشت ۰
پایان

برای بررسی سخت‌گیرانه‌تر از «فایل وجود دارد»، size را با اندازه‌ی فایل محلی مقایسه کنید، یا زمان تغییر را با زمانی که پس از اجرای قبلی نگه داشته‌اید.

خواندن فهرست پوشه به دست خودتان

FTP برای فهرست پوشه قالب ثابتی ندارد؛ بیشتر سرورها همان ستون‌های ls -l را می‌فرستند. تحلیل خط فهرست چنین خطی را در یک اطلاعات پرونده می‌خواند. این وقتی به کار می‌آید که فهرست را از جای دیگری گرفته‌اید، مثلاً از یک گزارش یا از فهرست خام، و می‌خواهید بدون اتصال با آن کار کنید.

ftp-listing-report.salam
واردسازی اف‌تی‌پی
واردسازی رشته

تابع ریشه:
    خام := "drwxr-xr-x    2 ftp ftp     4096 Jan 01  2026 old\n-rw-r--r--    1 ftp ftp   120034 Oct 02 08:10 sales-2026-10-01.csv\n-rw-r--r--    1 ftp ftp   118702 Oct 03 08:10 sales-2026-10-02.csv\n-rw-r--r--    1 ftp ftp  2251800 Oct 03 08:12 photos.zip\nlrwxrwxrwx    1 ftp ftp       20 Oct 03 08:12 latest.csv -> sales-2026-10-02.csv"

    ناپایا مجموع := ۰ برگردان صحیح۶۴
    ناپایا شمار پرونده := ۰
    ناپایا بزرگ‌ترین := اف‌تی‌پی.اطلاعات پرونده {}
    هر خط در رشته.تفکیک کردن(خام، "\n"):
        پرونده := اف‌تی‌پی.تحلیل خط فهرست(خط)
        اگر پرونده.پوشه:
            سرچاپ "پوشه"، پرونده.نام
            گذر
        پایان
        اگر پرونده.پیوند:
            سرچاپ "پیوند"، پرونده.نام
            گذر
        پایان
        سرچاپ "پرونده"، پرونده.نام، پرونده.اندازه، پرونده.تاریخ خام
        شمار پرونده++
        مجموع += پرونده.اندازه
        اگر پرونده.اندازه بزرگتر بزرگ‌ترین.اندازه:
            بزرگ‌ترین = پرونده
        پایان
    پایان
    سرچاپ شمار پرونده، "پرونده،"، مجموع، "بایت؛ بزرگ‌ترین:"، بزرگ‌ترین.نام
پایان
خروجیپوشه old پرونده sales-2026-10-01.csv 120034 Oct 02 08:10 پرونده sales-2026-10-02.csv 118702 Oct 03 08:10 پرونده photos.zip 2251800 Oct 03 08:12 پیوند latest.csv 3 پرونده، 2490536 بایت؛ بزرگ‌ترین: photos.zip

سرورهایی که ادامه‌ی نشست TLS را می‌خواهند

برخی سرورهای FTPS اصرار دارند که اتصال داده همان نشست TLS اتصال فرمان را ادامه دهد. vsftpd با تنظیم پیش‌فرض require_ssl_reuse=YES چنین می‌کند و FileZilla Server و سرور آزمایشی Rebex هم همین‌طور. این بسته هنوز نشست را ادامه نمی‌دهد، پس روی این سرورها ورود کار می‌کند ولی هر فهرست و انتقالی با پاسخ ۴۲۵ رد می‌شود:

ftp-public-demo.salam
واردسازی اف‌تی‌پی

تابع ریشه:
    ناپایا کارخواه := اف‌تی‌پی.اتصال امن("test.rebex.net"، ۲۱)
    اگر وارونه اف‌تی‌پی.سالم(کارخواه) یا وارونه اف‌تی‌پی.ورود(کارخواه، "demo"، "password"):
        سرچاپ "ورود ممکن نشد:"، اف‌تی‌پی.آخرین کد(کارخواه)، اف‌تی‌پی.آخرین پاسخ(کارخواه)
        برگشت ۱
    پایان
    سرچاپ "رمز شده:"، اف‌تی‌پی.امن(کارخواه)، اف‌تی‌پی.داده امن(کارخواه)
    سرچاپ "سامانه:"، اف‌تی‌پی.سامانه(کارخواه)
    مدخل‌ها := اف‌تی‌پی.فهرست(کارخواه، "/")
    اگر مدخل‌ها.طول() برابر ۰ و اف‌تی‌پی.آخرین کد(کارخواه) بزرگتربرابر ۴۰۰:
        سرچاپ "فهرست رد شد:"، اف‌تی‌پی.آخرین پاسخ(کارخواه)
    پایان
    هر پرونده در مدخل‌ها:
        سرچاپ پرونده.نام، پرونده.پوشه
    پایان
    اف‌تی‌پی.خروج(کارخواه)
    اف‌تی‌پی.بستن(کارخواه)
    برگشت ۰
پایان

اجرا در برابر test.rebex.net این را چاپ کرد:

رمز شده: true true
سامانه: 215 UNIX Type: L8
فهرست رد شد: 425 Cannot secure data connection - TLS session resumption required.

اگر سرور دست شماست، در vsftpd مقدار require_ssl_reuse=NO را بگذارید. اگر نیست و سرور SFTP دارد، به جای این بسته از ssh استفاده کنید؛ اتصال ساده را فقط در شبکه‌ای که به آن اعتماد دارید به کار ببرید، چون گذرواژه را بی‌رمز می‌فرستد.

کدام تابع برای کدام کار

کارتابع
اتصال امناتصال امن، یا برای مرجع گواهی خصوصی اتصال امن با تنظیمات؛ اتصال و سپس احراز تی‌ال‌اس همین کار را در دو گام می‌کند
اطمینان از روشن بودن رمزگذاریامن برای فرمان‌ها، داده امن برای فایل‌ها
فایل‌های متنی کوچکخواندن، نوشتن، افزودن
فایل‌های روی دیسکارسال، دریافت، ارسال پوشه، دریافت پوشه
نگاه کردن پیش از کاروجود دارد، پوشه است، اندازه، زمان تغییر، فهرست
فرمانی که تابع جدا نداردفرمان که کد پاسخ را برمی‌گرداند

گونه‌ها

اطلاعات پرونده FileInfo

ساختار اطلاعات پرونده
اطلاعات یک پرونده از فهرست سرور.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
اندازهsizeصحیح۶۴ = 0اندازه.
پوشهis_dirمنطقی = نادرستپوشه است.
پیوندis_linkمنطقی = نادرستپیوند است.
مجوزهاmodeرشته = ""مجوزها، مثل rw-r--r--.
تاریخ خامraw_dateرشته = ""تاریخ همان‌طور که سرور نوشته.
ftp-Parse.salam
واردسازی اف‌تی‌پی

تابع ریشه:
    سرچاپ اف‌تی‌پی.کد پاسخ("230 Login successful.")، اف‌تی‌پی.کد پاسخ("خراب")
    سرچاپ اف‌تی‌پی.خط پایانی است("211-Features:")، اف‌تی‌پی.خط پایانی است("211 End")
    سرچاپ اف‌تی‌پی.تحلیل پسیو("227 Entering Passive Mode (192,168,1,10,19,137)")
    سرچاپ اف‌تی‌پی.تحلیل پسیو گسترده("229 Entering Extended Passive Mode (|||50000|)")
    ا := اف‌تی‌پی.تحلیل خط فهرست("-rw-r--r--    1 ftp      ftp          1024 Sep 30 12:00 notes.txt")
    سرچاپ ا.نام، ا.اندازه، ا.پوشه، ا.پیوند، ا.مجوزها، ا.تاریخ خام
    پ := اف‌تی‌پی.تحلیل خط فهرست("drwxr-xr-x    2 ftp      ftp          4096 Jan 01  2026 backup")
    سرچاپ پ.نام، پ.پوشه
    ل := اف‌تی‌پی.تحلیل خط فهرست("lrwxrwxrwx    1 ftp      ftp             7 Mar 03 09:15 current -> backup")
    سرچاپ ل.نام، ل.پیوند
پایان
خروجی230 0 false true 192.168.1.10:5001 50000 notes.txt 1024 false false rw-r--r-- Sep 30 12:00 backup true current true

کارخواه Client

ساختار کارخواه
یک اتصال FTP.
نامانگلیسیگونهتوضیح
اتصالconnتی سی پی.اتصال شبکهاتصال TCP فرمان‌ها.
سالمokمنطقی = نادرستاتصال سالم است.
میزبانhostرشته = ""میزبان.
درگاهportصحیح = 21درگاه.
بافر دریافتrxbufرشته = ""داده‌ی خوانده‌شده.
آخرین پاسخlast_replyرشته = ""آخرین پاسخ سرور.
آخرین کدlast_codeصحیح = 0کد آخرین پاسخ.
امنsecureمنطقی = نادرستکانال فرمان رمز شده است.
شناسه درونی تی‌ال‌اسtls_idxصحیح = -1شماره‌ی اتصال TLS.
داده رمزشدهprot_pمنطقی = نادرستکانال داده هم رمز می‌شود.
پیکربندی تی‌ال‌اسtls_cfgتی ال اس.پیکربندیپیکربندی TLS.
ftp-Client.salam
واردسازی اف‌تی‌پی
واردسازی تی ال اس

تابع ریشه:
    ناپایا ک := اف‌تی‌پی.اتصال امن("ftp.example.com"، ۲۱)
    اگر وارونه اف‌تی‌پی.سالم(ک) یا وارونه اف‌تی‌پی.ورود(ک، "ali"، "s3cret"):
        سرچاپ اف‌تی‌پی.آخرین کد(ک)، اف‌تی‌پی.آخرین پاسخ(ک)
        برگشت
    پایان
    سرچاپ اف‌تی‌پی.امن(ک)، اف‌تی‌پی.داده امن(ک)
    سرچاپ اف‌تی‌پی.سامانه(ک)
    سرچاپ اف‌تی‌پی.قابلیت‌ها(ک)
    _ := اف‌تی‌پی.دودویی(ک)
    سرچاپ اف‌تی‌پی.مسیر جاری(ک)
    _ := اف‌تی‌پی.ساخت مسیر کامل(ک، "/site/assets")
    _ := اف‌تی‌پی.تغییر مسیر(ک، "/site")
    _ := اف‌تی‌پی.نوشتن(ک، "index.html"، "<h1>سلام</h1>")
    _ := اف‌تی‌پی.افزودن(ک، "log.txt"، "یک خط تازه\n")
    سرچاپ اف‌تی‌پی.خواندن(ک، "index.html")
    سرچاپ اف‌تی‌پی.ارسال(ک، "logo.png"، "assets/logo.png")
    سرچاپ اف‌تی‌پی.دریافت(ک، "log.txt"، "log-copy.txt")
    هر ا در اف‌تی‌پی.فهرست(ک، "."):
        سرچاپ ا.نام، ا.اندازه، ا.پوشه
    پایان
    هر نام در اف‌تی‌پی.فهرست نام‌ها(ک، "assets"):
        سرچاپ نام
    پایان
    سرچاپ اف‌تی‌پی.فهرست خام(ک، ".").طول() > ۰
    سرچاپ اف‌تی‌پی.اندازه(ک، "index.html")، اف‌تی‌پی.زمان تغییر(ک، "index.html")
    سرچاپ اف‌تی‌پی.پوشه است(ک، "assets")، اف‌تی‌پی.پیوند است(ک، "current")، اف‌تی‌پی.وجود دارد(ک، "old.html")
    _ := اف‌تی‌پی.تغییر نام(ک، "log.txt"، "log-1.txt")
    _ := اف‌تی‌پی.انتقال(ک، "log-1.txt"، "archive/log-1.txt")
    _ := اف‌تی‌پی.حذف(ک، "archive/log-1.txt")
    _ := اف‌تی‌پی.یک سطح بالا(ک)
    _ := اف‌تی‌پی.ساخت پوشه(ک، "tmp")
    _ := اف‌تی‌پی.حذف پوشه(ک، "tmp")
    _ := اف‌تی‌پی.حذف همه(ک، "/site/old")
    _ := اف‌تی‌پی.ارسال پوشه(ک، "public"، "/site")
    _ := اف‌تی‌پی.دریافت پوشه(ک، "/site"، "backup")
    سرچاپ اف‌تی‌پی.فرمان(ک، "SITE CHMOD 644 index.html")
    سرچاپ اف‌تی‌پی.بی‌کار(ک)
    _ := اف‌تی‌پی.متنی(ک)
    اف‌تی‌پی.خروج(ک)
    اف‌تی‌پی.بستن(ک)

    ناپایا س := اف‌تی‌پی.اتصال("ftp.example.com"، ۲۱)
    سرچاپ اف‌تی‌پی.احراز تی‌ال‌اس(س)
    ناپایا پ := تی ال اس.پیکربندی جدید("ftp.example.com")
    پ.پرونده گواهی ریشه = "company-ca.pem"
    ناپایا ب := اف‌تی‌پی.اتصال امن با تنظیمات("ftp.example.com"، ۲۱، پ)
    ناپایا د := اف‌تی‌پی.اتصال("ftp.example.com"، ۲۱)
    سرچاپ اف‌تی‌پی.ارتقا به تی‌ال‌اس(د، پ)
    اف‌تی‌پی.بستن(س)
    اف‌تی‌پی.بستن(ب)
    اف‌تی‌پی.بستن(د)
پایان

تابع‌ها

اتصال Dial

تابع اتصال(host: رشته، port: صحیح): کارخواه
به سرور FTP وصل می‌شود؛ هنوز وارد نشده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ارتقا به تی‌ال‌اس AuthTLSWith

تابع ارتقا به تی‌ال‌اس(c &: کارخواه، cfg: تی ال اس.پیکربندی): منطقی
اتصال را با AUTH TLS و پیکربندی داده‌شده امن می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

احراز تی‌ال‌اس AuthTLS

تابع احراز تی‌ال‌اس(c &: کارخواه): منطقی
اتصال را با AUTH TLS امن می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

اتصال امن DialTLS

تابع اتصال امن(host: رشته، port: صحیح): کارخواه
وصل می‌شود و بی‌درنگ با AUTH TLS امن می‌کند؛ FTPS صریح.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

اتصال امن با تنظیمات DialTLSWith

تابع اتصال امن با تنظیمات(host: رشته، port: صحیح، cfg: تی ال اس.پیکربندی): کارخواه
مثل تابع بالا، با پیکربندی TLS.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

امن Secure

تابع امن(c: کارخواه): منطقی
کانال فرمان رمز شده است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

داده امن SecureData

تابع داده امن(c: کارخواه): منطقی
کانال داده هم رمز می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ورود Login

تابع ورود(c &: کارخواه، user: رشته، password: رشته): منطقی
وارد می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

خروج Quit

تابع خروج(c &: کارخواه)
با QUIT خارج می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

بستن Close

تابع بستن(c &: کارخواه)
اتصال را می‌بندد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

سالم Ok

تابع سالم(c: کارخواه): منطقی
اتصال سالم است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

آخرین پاسخ LastReply

تابع آخرین پاسخ(c: کارخواه): رشته
متن آخرین پاسخ.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

آخرین کد LastCode

تابع آخرین کد(c: کارخواه): صحیح
کد آخرین پاسخ، مثل ۲۳۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

فرمان Command

تابع فرمان(c &: کارخواه، line: رشته): صحیح
یک فرمان خام می‌فرستد و کد پاسخ را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

بی‌کار Noop

تابع بی‌کار(c &: کارخواه): منطقی
فرمان NOOP برای زنده نگه داشتن اتصال.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

سامانه System

تابع سامانه(c &: کارخواه): رشته
نوع سامانه‌ی سرور.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

قابلیت‌ها Features

تابع قابلیت‌ها(c &: کارخواه): رشته
قابلیت‌هایی که سرور با FEAT اعلام می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

دودویی Binary

تابع دودویی(c &: کارخواه): منطقی
حالت انتقال دودویی؛ برای همه‌چیز جز متن ساده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

متنی Ascii

تابع متنی(c &: کارخواه): منطقی
حالت انتقال متنی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

مسیر جاری Pwd

تابع مسیر جاری(c &: کارخواه): رشته
پوشه‌ی جاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

تغییر مسیر Cwd

تابع تغییر مسیر(c &: کارخواه، path: رشته): منطقی
پوشه را عوض می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

یک سطح بالا CdUp

تابع یک سطح بالا(c &: کارخواه): منطقی
به پوشه‌ی بالاتر می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ساخت پوشه Mkdir

تابع ساخت پوشه(c &: کارخواه، path: رشته): منطقی
پوشه می‌سازد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

حذف پوشه Rmdir

تابع حذف پوشه(c &: کارخواه، path: رشته): منطقی
پوشه‌ی خالی را حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ساخت مسیر کامل MkdirAll

تابع ساخت مسیر کامل(c &: کارخواه، path: رشته): منطقی
پوشه و پوشه‌های بالاترش را می‌سازد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

فهرست خام ListRaw

تابع فهرست خام(c &: کارخواه، path: رشته): رشته
فهرست پوشه همان‌طور که سرور می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

فهرست List

تابع فهرست(c &: کارخواه، path: رشته): وکتور<اطلاعات پرونده>
فهرست پوشه، تجزیه‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam

فهرست نام‌ها NameList

تابع فهرست نام‌ها(c &: کارخواه، path: رشته): وکتور<رشته>
فقط نام‌های پوشه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

اندازه Size

تابع اندازه(c &: کارخواه، path: رشته): صحیح۶۴
اندازه‌ی پرونده؛ اگر نشد، ۱-.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

زمان تغییر ModTime

تابع زمان تغییر(c &: کارخواه، path: رشته): رشته
زمان تغییر به قالب YYYYMMDDHHMMSS.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

پوشه است IsDir

تابع پوشه است(c &: کارخواه، path: رشته): منطقی
پوشه است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

تابع پیوند است(c &: کارخواه، path: رشته): منطقی
پیوند است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

وجود دارد Exists

تابع وجود دارد(c &: کارخواه، path: رشته): منطقی
پرونده یا پوشه هست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

خواندن Read

تابع خواندن(c &: کارخواه، remote: رشته): رشته
پرونده‌ی دور را به شکل متن می‌خواند؛ محتوای دودویی در نخستین بایت صفر قطع می‌شود، پس برای آن دریافت را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

نوشتن Write

تابع نوشتن(c &: کارخواه، remote: رشته، data: رشته): منطقی
متن را در پرونده‌ی سرور می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

افزودن Append

تابع افزودن(c &: کارخواه، remote: رشته، data: رشته): منطقی
متن را به انتهای پرونده می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

دریافت Download

تابع دریافت(c &: کارخواه، remote: رشته، local: رشته): منطقی
پرونده‌ی دور را بایت به بایت در پرونده‌ی محلی دریافت می‌کند؛ کل پرونده اول در حافظه نگه داشته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ارسال Upload

تابع ارسال(c &: کارخواه، local: رشته، remote: رشته): منطقی
پرونده‌ی محلی را بایت به بایت می‌فرستد؛ پیش از انتقال کامل در حافظه خوانده می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

حذف Delete

تابع حذف(c &: کارخواه، path: رشته): منطقی
پرونده را حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

تغییر نام Rename

تابع تغییر نام(c &: کارخواه، from_path: رشته، to_path: رشته): منطقی
نام را عوض می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

انتقال Move

تابع انتقال(c &: کارخواه، from_path: رشته، to_path: رشته): منطقی
جابه‌جا می‌کند؛ پوشه‌ی مقصد اگر نباشد ساخته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

حذف همه RemoveAll

تابع حذف همه(c &: کارخواه، path: رشته): منطقی
پوشه و همه‌ی محتوایش را حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

دریافت پوشه DownloadDir

تابع دریافت پوشه(c &: کارخواه، remote: رشته، local: رشته): منطقی
پوشه را با همه‌ی محتوا دریافت می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

ارسال پوشه UploadDir

تابع ارسال پوشه(c &: کارخواه، local: رشته، remote: رشته): منطقی
پوشه‌ی محلی را با همه‌ی محتوا می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Client.salam

کد پاسخ ReplyCode

تابع کد پاسخ(line: رشته): صحیح
کد سه‌رقمی یک خط پاسخ؛ اگر نباشد، صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam

خط پایانی است IsFinalLine

تابع خط پایانی است(line: رشته): منطقی
خط پایانی پاسخ چندخطی است؛ خط پایانی بعد از کد فاصله دارد، نه خط تیره.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam

تحلیل پسیو ParsePasv

تابع تحلیل پسیو(reply: رشته): رشته
نشانی و درگاه داده را از پاسخ PASV درمی‌آورد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam

تحلیل پسیو گسترده ParseEpsv

تابع تحلیل پسیو گسترده(reply: رشته): صحیح
درگاه داده را از پاسخ EPSV درمی‌آورد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam

تحلیل خط فهرست ParseListLine

تابع تحلیل خط فهرست(line: رشته): اطلاعات پرونده
یک خط فهرست به سبک یونیکس را تجزیه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: ftp-Parse.salam