.TH ncftpget 1 "NcFTP Software" ncftpget
.SH "نام (NAME)"
ncftpget \- برنامه انتقال فایل اینترنتی برای اسکریپت‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B ncftpget
.RI [ "options" ]
.I "remote-host" "local-directory" "remote-files..."
.PP
.B ncftpget
.RI [ "options" ]
.I "bookmark-name" "local-directory" "remote-files..."
.PP
.B ncftpget
\-f login.cfg
.RI [ "options" ]
.I "local-directory" "remote-files..."
.PP
.B ncftpget
.RI [ "options" ]
.I "ftp://url.style.host/path/name"
.PP
.B ncftpget
\-c
.RI [ "options" ]
.I "remote-host" "remote-file"
> stdout
.PP
.B ncftpget
\-C
.RI [ "options" ]
.I "remote-host" "remote-file" "local-path-name"
.PP
.B ncftpget
\-c
.RI [ "options" ]
.I "ftp://url.style.host/path/name"
> stdout
.\"-------
.SH "گزینه‌ها (OPTIONS)"
.\"-------
.SS
فلگ‌های خط فرمان:
.TP 8
.BI "-u " "XX"
استفاده از نام کاربری
.I XX
به جای کاربر ناشناس (anonymous).
.TP 8
.BI "-p " "XX"
استفاده از گذرواژه
.I XX
همراه با نام کاربری.
.TP 8
.BI "-P " "XX"
استفاده از شماره درگاه (پورت)
.I XX
به جای درگاه پیش‌فرض سرویس FTP (۲۱).
.TP 8
.BI "-j " "XX"
استفاده از حساب
.I XX
به عنوان مکمل نام کاربری و گذرواژه (منسوخ شده).
.TP 8
.BI "-d " "XX"
استفاده از فایل
.I XX
برای ثبت گزارش اشکال‌زدایی (debug log).
.TP 8
.B -a
استفاده از نوع انتقال ASCII به جای باینری.
.TP 8
.BI "-t " "XX"
اتمام مهلت زمانی پس از
.I XX
ثانیه.
.TP 8
.BR "-v" "/" "-V"
استفاده کردن (یا نکردن) از نشانگر پیشرفت انتقال.
حالت پیش‌فرض استفاده از نشانگر پیشرفت در صورت خروجی به TTY است.
.TP 8
.BI "-f " "XX"
خواندن فایل
.I XX
برای دریافت اطلاعات میزبان، نام کاربری و گذرواژه.
.TP 8
.B -c
خواندن از میزبان دوردست و نوشتن محلی در خروجی استاندارد (stdout).
.TP 8
.B -C
خواندن از میزبان دوردست و نوشتن محلی در مسیر مشخص‌شده.
.TP 8
.B -A
الحاق به انتهای فایل‌های محلی، به جای رونویسی روی آن‌ها.
.TP 8
.BR "-z" "/" "-Z"
تلاش (یا عدم تلاش) برای ازسرگیری انتقال‌های متوقف‌شده.
حالت پیش‌فرض تلاش برای ازسرگیری انتقال است (\-z).
.TP 8
.B -E
استفاده از اتصالات داده معمولی (PORT).
.TP 8
.B -F
استفاده از اتصالات داده غیرفعال (PASV).
حالت پیش‌فرض استفاده از حالت غیرفعال است، اما در صورت عدم موفقیت اتصال غیرفعال یا اتمام مهلت زمانی، به حالت معمولی بازمی‌گردد.
.TP 8
.B -DD
حذف فایل دوردست پس از بارگیری موفقیت‌آمیز آن.
.TP 8
.B -R
حالت بازگشتی؛ کپی کردن کل ساختار درخت دایرکتوری‌ها.
.TP 8
.B -T
عدم استفاده از حالت خودکار TAR در حین انتقال برای بارگیری درخت دایرکتوری‌ها.
برنامه
.I ncftpget
در صورت امکان از TAR استفاده می‌کند زیرا معمولاً پیوندهای نمادین و مجوزهای فایل‌ها را حفظ می‌نماید.
حالت TAR همچنین می‌تواند انتقال دایرکتوری‌های حاوی فایل‌های کوچک متعدد را سریع‌تر کند، زیرا به جای باز کردن یک اتصال داده FTP به ازای هر فایل کوچک، از یک اتصال داده واحد استفاده می‌شود.
نقطه ضعف TAR این است که بارگیری کل دایرکتوری را اجباری می‌کند، حتی اگر بخشی از آن را قبلاً بارگیری کرده باشید؛ بنابراین اگر می‌خواهید بارگیری یک دایرکتوری را از سر بگیرید، ممکن است بخواهید از این گزینه استفاده کنید.
.TP 8
.BI "-r " "XX"
تلاش مجدد برای برقراری اتصال حداکثر تا
.I XX
بار تا زمان اتصال به کارساز دوردست FTP.
.TP 8
.B -b
اجرا در پس‌زمینه (با ثبت یک وظیفه دسته‌ای و سپس راه‌اندازی
.IR ncftpbatch ").
.TP 8
.B -bb
مشابه گزینه
.B -b
است، اما فقط وظیفه دسته‌ای را ثبت می‌کند.
برای پردازش این وظیفه باید برنامه
.I ncftpbatch
را اجرا کنید.
این گزینه در صورتی مفید است که از قبل فرآیند
.I ncftpbatch
در حال اجرا داشته باشید، یا بخواهید کنترل بهتری بر زمان پردازش وظایف دسته‌ای داشته باشید.
.IP
به عنوان مثال، اگر قصد پردازش سه فایل در پس‌زمینه روی یک کارساز دوردست را دارید، بهتر است تنها از یک فرآیند
.I ncftpbatch
برای پردازش ترتیبی سه وظیفه استفاده کنید، تا اینکه سه فرآیند
.I ncftpbatch
سه نشست هم‌زمان FTP به یک کارساز باز کنند.
.TP 8
.BI "-B " "XX"
تلاش برای تنظیم اندازه بافر سوکت TCP/IP به
.I XX
بایت.
.TP 8
.BI "-W " "XX"
ارسال دستور خام FTP با مقدار
.I XX
پس از ورود به سیستم.
.TP 8
.BI "-X " "XX"
ارسال دستور خام FTP با مقدار
.I XX
پس از انتقال هر فایل.
.TP 8
.BI "-Y " "XX"
ارسال دستور خام FTP با مقدار
.I XX
پیش از خروج از سیستم.
.IP
گزینه‌های
.BR "-W" "، " "-X" " و " "-Y"
برای کاربران پیشرفته‌ای مفید است که نیاز به دستکاری رفتار کارساز دارند.
برای نمونه، کاربرانی که به سیستم‌های بزرگ (mainframe) متصل می‌شوند ممکن است برای تنظیم اندازه بلوک و اطلاعات قالب رکوردها، نیاز به ارسال دستورات خاص SITE داشته باشند.
.IP
برای هر یک از این گزینه‌ها در صورت نیاز به ارسال چندین دستور، می‌توانید چندین بار از آن‌ها استفاده کنید.
برای گزینه
.B "-X"
می‌توانید از کوکی
.B %s
برای بسط به نام فایلی که منتقل شده است استفاده کنید.
.TP 8
.BI "-o " "XX"
تنظیم گزینه پیشرفته
.IR "XX" "."
.IP
این گزینه در درجه اول برای اشکال‌زدایی استفاده می‌شود و مقدار یک متغیر داخلی را روی یک عدد صحیح تنظیم می‌کند.
یک نمونه از کاربرد آن به صورت زیر است:
.BI "-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.
.\"-------
.SH "توضیحات (DESCRIPTION)"
.\"-------
.PP
هدف از
.I ncftpget
انتقال فایل از خط فرمان بدون ورود به یک پوسته تعاملی است.
این ابزار به شما امکان می‌دهد اسکریپت‌های پوسته یا فرآیندهای خودکاری بنویسید که قادر به انجام FTP باشند.
همچنین برای کاربران پیشرفته‌ای که می‌خواهند بدون ورود به برنامه‌های تعاملی FTP نظیر
.IR ncftp
فایل‌ها را مستقیماً از خط فرمان دریافت کنند، بسیار کاربردی است.
.PP
یکی از ویژگی‌های بسیار سودمند این برنامه این است که می‌توانید نشانی
.I URL
را به عنوان تنها آرگومان به آن بدهید تا فایل را بارگیری کند.
سپس می‌توانید نشانی را از مرورگر وب یا خبرخوان کپی کرده و در خط فرمان استفاده کنید.
مثال:
.RS 4
.sp
$ cd /tmp
.br
$ ncftpget ftp://ftp.ncftp.com/pub/ncftp/ncftp.tar.Z
.br
$ zcat ncftp.tar.Z | tar xf -
.br
.RE
.PP
به‌طور پیش‌فرض، برنامه تلاش می‌کند به میزبان دوردست متصل شده و به‌صورت ناشناس (anonymous) وارد شود، اما می‌توانید اطلاعات نام کاربری و گذرواژه را نیز مشخص کنید.
گزینه
.B -u
برای تعیین نام کاربری جهت ورود و گزینه
.B -p
برای تعیین گذرواژه استفاده می‌شود.
اگر برنامه را از درون پوسته اجرا می‌کنید، می‌توانید گزینه
.B -p
را حذف کنید تا برنامه گذرواژه را از شما بپرسد.
.PP
استفاده از گزینه‌های
.B -u
و
.B -p
توصیه نمی‌شود، زیرا اطلاعات حساب شما برای هر کسی که بتواند اسکریپت پوسته یا اطلاعات فرآیندهای شما را ببیند فاش می‌شود. به عنوان مثال، شخصی که از برنامه
.I ps
استفاده می‌کند می‌تواند گذرواژه شما را در حین اجرای برنامه مشاهده کند.
.PP
در عوض می‌توانید از گزینه
.B -f
برای تعیین فایلی حاوی اطلاعات حساب کاربری استفاده کنید.
با این حال، این روش نیز کاملاً امن نیست، زیرا هر کاربری که دسترسی خواندن به آن فایل را داشته باشد می‌تواند اطلاعات حساب را ببیند.
اگر با این وجود تصمیم به استفاده از گزینه
.B -f
گرفتید، ساختار فایل باید مشابه زیر باشد:
.RS 4
.sp
host sphygmomanometer.ncftp.com
.br
user gleason
.br
pass mypasswd
.br
.sp
.RE
فراموش نکنید که مجوزهای دسترسی این فایل را طوری تغییر دهید که هیچ کاربر دیگری نتواند آن را بخواند.
.PP
گزینه
.B -d
هنگامی که سعی در عیب‌یابی دلیل شکست انتقال فایل دارید بسیار کاربردی است.
این گزینه کل مکالمه FTP را در فایلی که مشخص می‌کنید ثبت می‌کند تا بتوانید بفهمید اشکال از کجاست.
اگر نام ویژه
.I stdout
را به عنوان نام فایل خروجی اشکال‌زدایی تعیین کنید، خروجی به جای فایل روی صفحه نمایش چاپ خواهد شد. مثال:
.RS 4
.sp
$ ncftpget -d stdout bowser.nintendo.co.jp . /pub/README
.br
220: FTP server ready.
.br
Connected to bowser.nintendo.co.jp.
.br
Cmd: USER anonymous
.br
331: Guest login ok, send your complete e-mail address as password.
.br
Cmd: PASS xxxxxxxx
.br
230: Welcome!
.br
Logged in to bowser.nintendo.co.jp as anonymous.
.br
Cmd: TYPE I
.br
200: Type set to I.
.br
Cmd: PORT 192,168,9,37,6,76
.br
200: PORT command successful.
.br
Cmd: RETR /pub/README
.br
550: /pub/README: File in use.
.br
Cmd: QUIT
.br
221: Goodbye.
.br
.RE
.PP
استفاده از حالت ASCII زمانی مفید است که قالب متنی میزبان محلی شما با میزبان دوردست تفاوت دارد.
برای نمونه، اگر در حال دریافت یک فایل \.TXT از میزبانی با سیستم‌عامل ویندوز به یک سیستم یونیکس هستید، می‌توانید از فلگ
.B -a
استفاده کنید تا حالت انتقال ASCII اعمال شود و فایل ایجادشده در سیستم یونیکس در قالب متنی یونیکس ذخیره شود نه قالب متنی MS\-DOS.
.PP
با استفاده از فلگ
.B -R
می‌توانید کل درخت دایرکتوری فایل‌ها را دریافت کنید.
با این حال، این ویژگی تنها در صورتی کار می‌کند که کارساز FTP دوردست یک سیستم یونیکس باشد یا از خروجی فهرست‌بندی مشابه یونیکس استفاده کند.
مثال:
.RS 4
.sp
$ ncftpget -R ftp.ncftp.com /tmp /pub/ncftp
.br
.sp
.RE
این دستور ساختار دایرکتوری /tmp/ncftp را ایجاد خواهد کرد.
.\"-------
.SH "عیب‌یابی (DIAGNOSTICS)"
.\"-------
.PP
برنامه
.I ncftpget
مقدارهای خروج زیر را بازمی‌گرداند:
.TP 8
0
موفقیت‌آمیز.
.TP 8
1
عدم امکان برقراری اتصال به میزبان دوردست.
.TP 8
2
عدم امکان برقراری اتصال به میزبان دوردست \- اتمام مهلت زمانی.
.TP 8
3
شکست در انتقال.
.TP 8
4
شکست در انتقال \- اتمام مهلت زمانی.
.TP 8
5
تغییر دایرکتوری با شکست مواجه شد.
.TP 8
6
تغییر دایرکتوری با شکست مواجه شد \- اتمام مهلت زمانی.
.TP 8
7
نشانی URL نامعتبر است.
.TP 8
8
خطای استفاده (نحوه فراخوانی نادرست).
.TP 8
9
خطا در فایل پیکربندی ورود.
.TP 8
10
شکست در مقداردهی اولیه کتابخانه.
.TP 8
11
شکست در مقداردهی اولیه نشست (session).
.\"-------
.SH "نویسنده (AUTHOR)"
.\"-------
.PP
Mike Gleason, NcFTP Software (http://www.ncftp.com).
.\"-------
.SH "همچنین ببینید (SEE ALSO)"
.\"-------
.PP
.IR ncftpput (1),
.IR ncftp (1),
.IR ftp (1),
.IR rcp (1),
.IR tftp (1).
.PP
.IR "LibNcFTP" " (http://www.ncftp.com/libncftp)."