.TH ncftpput 1 "NcFTP Software" ncftpput
.SH "نام (NAME)"
ncftpput \- برنامه انتقال فایل اینترنتی برای اسکریپت‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B ncftpput
.RI [ "گزینه‌ها" ]
.I "remote-host" "remote-directory" "local-files..."
.PP
.B ncftpput
.RI [ "گزینه‌ها" ]
.I "bookmark-name" "remote-directory" "local-files..."
.PP
.B ncftpput
-f
.I "login.cfg"
.RI [ "گزینه‌ها" ]
.I "remote-directory" "local-files..."
.PP
.B ncftpput
-c
.I "remote-host" "remote-path-name"
<
.I "stdin"
.PP
.B ncftpput
-C
.I "remote-host" "local-path-name" "remote-path-name"
.\"-------
.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 (21).
.TP 8
.BI "-j " "XX"
استفاده از حساب
.I XX
به عنوان مکمل نام کاربری و گذرواژه (منسوخ‌شده).
.TP 8
.BI "-d " "XX"
استفاده از فایل
.I XX
برای ثبت وقایع اشکال‌زدایی.
.TP 8
.B -a
استفاده از نوع انتقال ASCII به جای دودویی (binary).
.TP 8
.B -m
تلاش برای ایجاد دایرکتوری مقصد دوردست پیش از رونوشت‌برداری.
.TP 8
.BI "-t " "XX"
اتمام مهلت زمانی (timeout) پس از
.I XX
ثانیه.
.TP 8
.BI "-U " "XX"
استفاده از مقدار
.I XX
برای umask.
.TP 8
.BR "-v" "/" "-V"
استفاده کردن (یا نکردن) از نشانگرهای پیشرفت.
پیش‌فرض این است که اگر جریان خروجی یک TTY باشد، از نشانگرهای پیشرفت استفاده شود.
.TP 8
.BI "-f " "XX"
خواندن فایل
.I XX
برای اطلاعات میزبان، کاربر و گذرواژه.
.TP 8
.B -c
خواندن محلی از ورودی استاندارد (stdin) و نوشتن در مسیر مشخص‌شده روی میزبان دوردست.
.TP 8
.B -C
مشابه با
.BR "-c" "،"
با این تفاوت که یک مسیر محلی مشخص می‌شود.
.TP 8
.B -A
پیوست کردن به انتهای فایل‌های دوردست، به جای بازنویسی آن‌ها.
.TP 8
.BI "-T " "XX"
بارگذاری در فایل‌های موقت با پیشوند
.IR "XX" "."
.TP 8
.BI "-S " "XX"
بارگذاری در فایل‌های موقت با پسوند
.IR "XX" "."
.TP 8
.B -R
حالت بازگشتی؛ رونوشت‌برداری از کل درخت‌های دایرکتوری.
.TP 8
.BI "-r " "XX"
تلاش مجدد حداکثر تا
.I XX
بار تا زمان برقراری اتصال به سرور FTP دوردست.
.TP 8
.BR "-z" "/" "-Z"
تلاش کردن (یا نکردن) برای از سرگیری انتقال‌ها.
پیش‌فرض این است که برای از سرگیری تلاش
.I نشود
(\-Z).
.TP 8
.B -E
استفاده از اتصالات داده عادی (PORT).
.TP 8
.B -F
استفاده از اتصالات داده غیرفعال (PASV).
پیش‌فرض استفاده از حالت غیرفعال است، اما در صورت ناموفق بودن اتصال غیرفعال یا اتمام مهلت زمانی، به حالت عادی بازگردانی می‌شود.
.TP 8
.B -DD
حذف فایل محلی پس از بارگذاری موفقیت‌آمیز آن.
.TP 8
.B -y
تلاش برای استفاده از "SITE UTIME" به منظور حفظ برچسب‌های زمانی در میزبان دوردست.
سرورهای 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"
برای کاربران پیشرفته‌ای که نیاز به سفارشی‌سازی رفتار در برخی سرورها دارند مفید هستند.
به عنوان مثال، کاربرانی که به بزرگ‌رایانه‌ها دسترسی دارند ممکن است نیاز داشته باشند دستورهای ویژه 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 ncftpput
انجام انتقال فایل از خط فرمان بدون ورود به یک پوستهٔ تعاملی است.
این قابلیت به شما امکان می‌دهد تا اسکریپت‌های پوسته یا دیگر فرایندهای خودکار را بنویسید که می‌توانند کار با FTP را انجام دهند.
همچنین برای کاربران پیشرفته‌ای که می‌خواهند فایل‌ها را بدون ورود به یک برنامهٔ تعاملی FTP مانند
.IR ncftp "."
ارسال کنند، مفید است.
.PP
به‌طور پیش‌فرض برنامه تلاش می‌کند تا به میزبان دوردست متصل شده و به‌صورت ناشناس وارد شود، اما می‌توانید نام کاربری و اطلاعات گذرواژه را نیز مشخص کنید.
گزینهٔ
.B -u
برای تعیین نام کاربری جهت ورود استفاده می‌شود و گزینهٔ
.B -p
برای تعیین گذرواژه به کار می‌رود.
اگر برنامه را از پوسته اجرا می‌کنید، می‌توانید گزینهٔ
.B -p
را حذف کنید تا برنامه گذرواژه را از شما بپرسد.
.PP
استفاده از گزینه‌های
.B -u
و
.B -p
توصیه نمی‌شود، زیرا اطلاعات حساب شما برای هر کسی که بتواند اسکریپت پوسته یا اطلاعات فرایند شما را ببیند فاش می‌شود. برای مثال، فردی که از برنامهٔ
.I ps
استفاده می‌کند می‌تواند گذرواژهٔ شما را در حین اجرای برنامه مشاهده کند.
.PP
در عوض می‌توانید از گزینهٔ
.B -f
برای تعیین فایلی حاوی اطلاعات حساب کاربری استفاده کنید.
با این حال، این روش نیز همچنان امن نیست زیرا هر کسی که دسترسی خواندن به فایل اطلاعات را داشته باشد می‌تواند اطلاعات حساب را ببیند.
با این وجود، اگر تصمیم به استفاده از گزینهٔ
.B -f
بگیرید، محتوای فایل باید چیزی شبیه به این باشد:
.RS
.sp
host sphygmomanometer.ncftp.com
.br
user gleason
.br
pass mypassword
.br
.sp
.RE
فراموش نکنید که مجوزهای دسترسی این فایل را تغییر دهید تا هیچ‌کس دیگری نتواند آن را بخواند.
.PP
گزینهٔ
.B -d
زمانی که در حال عیب‌یابی دلیل شکست یک انتقال فایل هستید بسیار مفید است.
این گزینه کل مکالمهٔ FTP را در فایلی که مشخص کرده‌اید چاپ می‌کند تا بتوانید از اشکال رخ‌داده مطلع شوید.
اگر نام ویژهٔ
.I stdout
را به عنوان نام فایل خروجی اشکال‌زدایی مشخص کنید، خروجی در صفحه نمایش چاپ خواهد شد.
.PP
استفاده از حالت ASCII زمانی مفید است که قالب متنی میزبان شما با قالب متنی میزبان دوردست تفاوت دارد.
برای نمونه، اگر در حال ارسال یک فایل متنی از یک سیستم UNIX به یک میزبان مبتنی بر Windows هستید، می‌توانید از پرچم
.B -a
استفاده کنید تا از حالت انتقال ASCII بهره ببرد؛ به‌طوری که فایل ایجاد شده روی ماشین Windows به جای قالب متنی UNIX، در قالب متنی بومی خود ذخیره شود.
.PP
می‌توانید با استفاده از پرچم
.B -R
یک درخت دایرکتوری کامل از فایل‌ها را بارگذاری کنید.
مثال:
.RS 4
.sp
$ ncftpput -R pikachu.nintendo.co.jp /incoming /tmp/stuff
.br
.sp
.RE
این دستور سلسله‌مراتب /incoming/stuff را در میزبان دوردست ایجاد خواهد کرد.
.PP
گزینه‌های
.B -T
و
.B -S
زمانی مفید هستند که می‌خواهید فایلی را به میزبان دوردست بارگذاری کنید، اما نمی‌خواهید تا زمان تکمیل انتقال، از نام مسیر مقصد استفاده شود.
با استفاده از این گزینه‌ها، تا زمانی که انتقال فایل شما به پایان نرسد، فایل دوردستی با همان نام را خراب (رونویسی) نخواهید کرد.
همچنین این گزینه‌ها زمانی کاربرد دارند که یک فرایند دوردست در میزبان مقصد، نام فایل خاصی را مرتباً بررسی می‌کند و شما نمی‌خواهید آن فرایند تا قبل از اتمام کامل ارسال، فایل را ببیند.
در اینجا مثالی آمده است که فایلی را در
/pub/incoming/README
با استفاده از نام فایل موقت
/pub/incoming/README.tmp
بارگذاری می‌کند:
.RS 4
.sp
$ ncftpput -S \.tmp bowser\.nintendo\.co\.jp /pub/incoming /a/README
.RE
.PP
یک راه مناسب برای هدایت خروجی از هر دستور محلی به یک فایل دوردست، استفاده از گزینهٔ
.B -c
است که مشخص می‌کند شما از
.I stdin
به‌عنوان ورودی استفاده می‌کنید.
مثال زیر نحوهٔ ایجاد یک نسخهٔ پشتیبان و ذخیرهٔ آن را در یک ماشین دوردست نشان می‌دهد:
.RS 4
.sp
$ tar cf - / | ncftpput -c sonic\.sega\.co\.jp /usr/local/backup.tar
.RE
.\"-------.SH "خطاها (DIAGNOSTICS)"
.\"-------
.PP
دستور
.I ncftpput
مقادیر خروج زیر را بازمی‌گرداند:
.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
مقداردهی اولیه نشست ناموفق بود.
.\"-------
.SH "نویسندگان (AUTHORS)"
.\"-------
.PP
Mike Gleason، NcFTP Software (http://www.ncftp.com).
.\"-------
.SH "همچنین ببینید (SEE ALSO)"
.\"-------
.PP
.IR ncftpget (1),
.IR ncftp (1),
.IR ftp (1),
.IR rcp (1),
.IR tftp (1).
.PP
.IR "LibNcFTP" " (http://www.ncftp.com/libncftp)."