نام (NAME)

ncftpls - برنامه انتقال فایل اینترنتی برای اسکریپت‌ها

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

ncftpls [گزینه‌ها] ftp://url.style/host/path/name/

گزینه‌ها (OPTIONS)

پرچم‌های خط فرمان:

-m: استفاده از قالب فهرست‌بندی ماشین‌خوان، در صورتی که کارساز (سرور) از آن پشتیبانی کند. این ویژگی نیازمند پشتیبانی نرم‌افزار کارساز از افزونه‌های MLSD است و بسیاری از پیاده‌سازی‌ها فاقد این امکانات هستند.
-1: ابتدایی‌ترین قالب، یک مورد در هر سطر.
-l: قالب فهرست‌بندی کامل (بلند).
-C: قالب فهرست‌بندی ستونی. این قالب، حالت پیش‌فرض فهرست‌بندی است.
-R: پیمایش بازگشتی همهٔ زیرشاخه‌ها هنگام فهرست‌کردن.
-a: نمایش تمام فایل‌ها، در صورتی که کارساز اجازه دهد (مشابه "/bin/ls -a").
-i XX: فیلتر کردن فهرست (در صورت پشتیبانی کارساز) با نویسه‌بدل (wildcard) XX.
-x -XX: تنظیم پرچم‌های ls برای استفاده در کارساز.
-u XX: استفاده از نام کاربری XX به جای anonymous.
-p XX: استفاده از گذرواژه XX همراه با نام کاربری.
-P XX: استفاده از شماره درگاه (پورت) XX به جای درگاه پیش‌فرض سرویس FTP (21).
-d XX: استفاده از فایل XX برای ثبت گزارش‌های اشکال‌زدایی (debug logging).
-t XX: اتمام مهلت زمانی (timeout) پس از XX ثانیه.
-E: استفاده از اتصالات داده معمولی (PORT).
-F: استفاده از اتصالات داده غیرفعال (PASV). حالت پیش‌فرض استفاده از اتصال غیرفعال است، اما در صورت ناموفق بودن یا اتمام مهلت زمانی، به حالت معمولی بازمی‌گردد.
-r XX: تلاش مجدد برای برقراری ارتباط حداکثر تا XX بار تا زمان اتصال به کارساز FTP دوردست.
-W XX: ارسال دستور خام FTP XX پس از ورود به سیستم.
-X XX: ارسال دستور خام FTP XX پس از انتقال هر فایل.
-Y XX: ارسال دستور خام FTP XX پیش از خروج از سیستم.

: گزینه‌های -W، -X و -Y برای کاربران پیشرفته‌ای که نیاز به تغییر رفتار برنامه در برخی کارسازها دارند، کاربردی هستند. برای نمونه، کاربرانی که به رایانه‌های بزرگ (mainframe) متصل می‌شوند ممکن است نیاز داشته باشند دستورهای ویژه SITE را برای تنظیم اندازه بلوک (blocksize) و اطلاعات قالب رکورد ارسال کنند.
: برای این گزینه‌ها، در صورتی که نیاز به ارسال چندین دستور دارید، می‌توانید از هر کدام چند بار استفاده کنید. برای گزینه -X می‌توانید از شناسه %s استفاده کنید تا به نام فایلی که منتقل شده است بسط یابد.

-o XX: تنظیم گزینه پیشرفته XX.

: این گزینه اساساً برای اشکال‌زدایی استفاده می‌شود. این گزینه مقدار یک متغیر داخلی را روی یک مقدار عددی صحیح تنظیم می‌کند. یک نمونه کاربرد: -o useFEAT=0,useCLNT=1 که در این حالت، استفاده از دستور FEAT را غیرفعال و دستور CLNT را فعال می‌کند. متغیرهای موجود عبارتند از: usePASV، useSIZE، useMDTM، useREST، useNLST_a، useNLST_d، useFEAT، useMLSD، useMLST، useCLNT، useHELP_SITE، useSITE_UTIME، STATfileParamWorks، NLSTfileParamWorks، require20، allowProxyForPORT، doNotGetStartCWD.

توضیحات (DESCRIPTION)

هدف از ncftpls فهرست‌کردن دایرکتوری‌های دوردست با استفاده از پروتکل انتقال فایل (FTP) بدون ورود به یک شل تعاملی است. این امر به شما اجازه می‌دهد اسکریپت‌های شل یا دیگر فرآیندهای خودکار و بدون نظارت را بنویسید که می‌توانند با FTP کار کنند.

رفتار پیش‌فرض، چاپ فهرست دایرکتوری در قالبی ستونی است (یعنی ls -CF)، اما این حالت برای اسکریپت‌نویسی چندان مناسب نیست. این مثال از پرچم -1 برای چاپ یک فایل در هر سطر استفاده می‌کند:

$ ncftpls -1 ftp://ftp.ncftp.com/pub/ncftp/

شما همچنین می‌توانید با استفاده از «ncftpls -l»، دستور «ls -l» را روی سیستم دوردست اجرا کنید. اگر می‌خواهید پرچم‌های دیگری را امتحان کنید، باید آن‌ها را همراه با پرچم -x به کار ببرید. برای نمونه، اگر بخواهید یک «ls -lrt» دوردست بگیرید، می‌توانید این کار را انجام دهید:

$ ncftpls -x "-lrt" ftp://ftp.ncftp.com/pub/ncftp/

به‌طور پیش‌فرض، برنامه تلاش می‌کند به میزبان دوردست متصل شده و به‌صورت ناشناس (anonymous) وارد شود، اما می‌توانید همانند برنامه‌های ncftpget یا ncftpput. اطلاعات نام کاربری و گذرواژه را مشخص کنید.

توجه داشته باشید که بر اساس استاندارد، مسیرهای URL مسیرهای نسبی هستند. برای FTP، این بدان معناست که URLها مسیرهای نسبی را از دایرکتوری آغازین مشخص می‌کنند، که برای ورود کاربران، معمولاً دایرکتوری خانگی کاربر است. اگر می‌خواهید از مسیرهای مطلق استفاده کنید، باید با استفاده از کد «%2F» برای نویسه «/»، یک اسلش صریح بگنجانید. مثال‌ها:

$ ncftpls -u linus ftp://ftp.kernel.org/%2Fusr/src/
$ ncftpls ftp://steve@ftp.apple.com/%2Fetc/

خطاها (DIAGNOSTICS)

ncftpls مقدارهای خروج زیر را بازمی‌گرداند:

0: موفقیت.
1: عدم امکان اتصال به میزبان دوردست.
2: عدم امکان اتصال به میزبان دوردست - اتمام مهلت زمانی.
3: انتقال ناموفق بود.
4: انتقال ناموفق بود - اتمام مهلت زمانی.
5: تغییر دایرکتوری ناموفق بود.
6: تغییر دایرکتوری ناموفق بود - اتمام مهلت زمانی.
7: نشانی URL نامعتبر است.
8: خطای نحوهٔ استفاده.
9: خطا در فایل پیکربندی ورود.
10: مقداردهی اولیه کتابخانه ناموفق بود.
11: مقداردهی اولیه نشست (session) ناموفق بود.

نویسندگان (AUTHORS)

Mike Gleason, NcFTP Software (http://www.ncftp.com).

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

ncftpput(1), ncftpget(1), ncftp(1), ftp(1), rcp(1), tftp(1).

LibNcFTP (http://www.ncftp.com/libncftp).