| ncftpput(1) | General Commands Manual | ncftpput(1) |
نام (NAME)
ncftpput - برنامه انتقال فایل اینترنتی برای اسکریپتها
خلاصه دستور (SYNOPSIS)
ncftpput [گزینهها] remote-host remote-directory local-files...
ncftpput [گزینهها] bookmark-name remote-directory local-files...
ncftpput -f login.cfg [گزینهها] remote-directory local-files...
ncftpput -c remote-host remote-path-name < stdin
ncftpput -C remote-host local-path-name remote-path-name
گزینهها (OPTIONS)
پرچمهای خط فرمان:
- -u XX
- استفاده از نام کاربری XX به جای anonymous.
- -p XX
- استفاده از گذرواژه XX همراه با نام کاربری.
- -P XX
- استفاده از شماره درگاه XX به جای درگاه پیشفرض سرویس FTP (21).
- -j XX
- استفاده از حساب XX به عنوان مکمل نام کاربری و گذرواژه (منسوخشده).
- -d XX
- استفاده از فایل XX برای ثبت وقایع اشکالزدایی.
- -a
- استفاده از نوع انتقال ASCII به جای دودویی (binary).
- -m
- تلاش برای ایجاد دایرکتوری مقصد دوردست پیش از رونوشتبرداری.
- -t XX
- اتمام مهلت زمانی (timeout) پس از XX ثانیه.
- -U XX
- استفاده از مقدار XX برای umask.
- -v/-V
- استفاده کردن (یا نکردن) از نشانگرهای پیشرفت. پیشفرض این است که اگر جریان خروجی یک TTY باشد، از نشانگرهای پیشرفت استفاده شود.
- -f XX
- خواندن فایل XX برای اطلاعات میزبان، کاربر و گذرواژه.
- -c
- خواندن محلی از ورودی استاندارد (stdin) و نوشتن در مسیر مشخصشده روی میزبان دوردست.
- -C
- مشابه با -c، با این تفاوت که یک مسیر محلی مشخص میشود.
- -A
- پیوست کردن به انتهای فایلهای دوردست، به جای بازنویسی آنها.
- -T XX
- بارگذاری در فایلهای موقت با پیشوند XX.
- -S XX
- بارگذاری در فایلهای موقت با پسوند XX.
- -R
- حالت بازگشتی؛ رونوشتبرداری از کل درختهای دایرکتوری.
- -r XX
- تلاش مجدد حداکثر تا XX بار تا زمان برقراری اتصال به سرور FTP دوردست.
- -z/-Z
- تلاش کردن (یا نکردن) برای از سرگیری انتقالها. پیشفرض این است که برای از سرگیری تلاش نشود (-Z).
- -E
- استفاده از اتصالات داده عادی (PORT).
- -F
- استفاده از اتصالات داده غیرفعال (PASV). پیشفرض استفاده از حالت غیرفعال است، اما در صورت ناموفق بودن اتصال غیرفعال یا اتمام مهلت زمانی، به حالت عادی بازگردانی میشود.
- -DD
- حذف فایل محلی پس از بارگذاری موفقیتآمیز آن.
- -y
- تلاش برای استفاده از "SITE UTIME" به منظور حفظ برچسبهای زمانی در میزبان دوردست. سرورهای FTP دوردست زیادی از این قابلیت پشتیبانی نمیکنند، بنابراین ممکن است کار نکند.
- -b
- اجرا در پسزمینه (با ارسال یک کار دستهای و سپس اجرای فرایند ncftpbatch).`
- -bb
- مشابه گزینه -b است، اما تنها کار دستهای را ارسال میکند. برای پردازش کار دستهای نیاز به اجرای دستی ncftpbatch خواهید داشت. این گزینه در صورتی مفید است که از قبل یک فرایند ncftpbatch در حال اجرا داشته باشید، یا بخواهید کنترل بهتری بر زمان پردازش کارهای دستهای داشته باشید.
- برای نمونه، اگر میخواهید پردازش پسزمینه سه فایل را که همگی روی یک سرور دوردست یکسان هستند انجام دهید، بسیار مناسبتر است که تنها از یک فرایند ncftpbatch برای پردازش ترتیبی هر سه کار استفاده کنید، تا اینکه سه فرایند ncftpbatch بهطور همزمان سه نشست FTP به همان سرور باز کنند.
- -B XX
- تلاش برای تنظیم اندازه بافر سوکت TCP/IP روی XX بایت.
- -W XX
- ارسال دستور خام FTP با مشخصات XX پس از ورود به سیستم.
- -X XX
- ارسال دستور خام FTP با مشخصات XX پس از انتقال هر فایل.
- -Y XX
- ارسال دستور خام FTP با مشخصات XX پیش از خروج از سیستم.
- گزینههای -W، -X و -Y برای کاربران پیشرفتهای که نیاز به سفارشیسازی رفتار در برخی سرورها دارند مفید هستند. به عنوان مثال، کاربرانی که به بزرگرایانهها دسترسی دارند ممکن است نیاز داشته باشند دستورهای ویژه SITE را برای تنظیم اندازه بلوک و اطلاعات قالب رکورد ارسال کنند..IP برای این گزینهها، در صورتی که نیاز به ارسال چندین دستور دارید، میتوانید از هر کدام چندین بار استفاده کنید. برای گزینهٔ -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)
هدف ncftpput انجام انتقال فایل از خط فرمان بدون ورود به یک پوستهٔ تعاملی است. این قابلیت به شما امکان میدهد تا اسکریپتهای پوسته یا دیگر فرایندهای خودکار را بنویسید که میتوانند کار با FTP را انجام دهند. همچنین برای کاربران پیشرفتهای که میخواهند فایلها را بدون ورود به یک برنامهٔ تعاملی FTP مانند ncftp. ارسال کنند، مفید است.
بهطور پیشفرض برنامه تلاش میکند تا به میزبان دوردست متصل شده و بهصورت ناشناس وارد شود، اما میتوانید نام کاربری و اطلاعات گذرواژه را نیز مشخص کنید. گزینهٔ -u برای تعیین نام کاربری جهت ورود استفاده میشود و گزینهٔ -p برای تعیین گذرواژه به کار میرود. اگر برنامه را از پوسته اجرا میکنید، میتوانید گزینهٔ -p را حذف کنید تا برنامه گذرواژه را از شما بپرسد.
استفاده از گزینههای -u و -p توصیه نمیشود، زیرا اطلاعات حساب شما برای هر کسی که بتواند اسکریپت پوسته یا اطلاعات فرایند شما را ببیند فاش میشود. برای مثال، فردی که از برنامهٔ ps استفاده میکند میتواند گذرواژهٔ شما را در حین اجرای برنامه مشاهده کند.
در عوض میتوانید از گزینهٔ -f برای تعیین فایلی حاوی اطلاعات حساب کاربری استفاده کنید. با این حال، این روش نیز همچنان امن نیست زیرا هر کسی که دسترسی خواندن به فایل اطلاعات را داشته باشد میتواند اطلاعات حساب را ببیند. با این وجود، اگر تصمیم به استفاده از گزینهٔ -f بگیرید، محتوای فایل باید چیزی شبیه به این باشد:
host sphygmomanometer.ncftp.com
user gleason
pass mypassword
گزینهٔ -d زمانی که در حال عیبیابی دلیل شکست یک انتقال فایل هستید بسیار مفید است. این گزینه کل مکالمهٔ FTP را در فایلی که مشخص کردهاید چاپ میکند تا بتوانید از اشکال رخداده مطلع شوید. اگر نام ویژهٔ stdout را به عنوان نام فایل خروجی اشکالزدایی مشخص کنید، خروجی در صفحه نمایش چاپ خواهد شد.
استفاده از حالت ASCII زمانی مفید است که قالب متنی میزبان شما با قالب متنی میزبان دوردست تفاوت دارد. برای نمونه، اگر در حال ارسال یک فایل متنی از یک سیستم UNIX به یک میزبان مبتنی بر Windows هستید، میتوانید از پرچم -a استفاده کنید تا از حالت انتقال ASCII بهره ببرد؛ بهطوری که فایل ایجاد شده روی ماشین Windows به جای قالب متنی UNIX، در قالب متنی بومی خود ذخیره شود.
میتوانید با استفاده از پرچم -R یک درخت دایرکتوری کامل از فایلها را بارگذاری کنید. مثال:
$ ncftpput -R pikachu.nintendo.co.jp /incoming /tmp/stuff
گزینههای -T و -S زمانی مفید هستند که میخواهید فایلی را به میزبان دوردست بارگذاری کنید، اما نمیخواهید تا زمان تکمیل انتقال، از نام مسیر مقصد استفاده شود. با استفاده از این گزینهها، تا زمانی که انتقال فایل شما به پایان نرسد، فایل دوردستی با همان نام را خراب (رونویسی) نخواهید کرد. همچنین این گزینهها زمانی کاربرد دارند که یک فرایند دوردست در میزبان مقصد، نام فایل خاصی را مرتباً بررسی میکند و شما نمیخواهید آن فرایند تا قبل از اتمام کامل ارسال، فایل را ببیند. در اینجا مثالی آمده است که فایلی را در /pub/incoming/README با استفاده از نام فایل موقت /pub/incoming/README.tmp بارگذاری میکند:
$ ncftpput -S .tmp bowser.nintendo.co.jp /pub/incoming /a/README
یک راه مناسب برای هدایت خروجی از هر دستور محلی به یک فایل دوردست، استفاده از گزینهٔ -c است که مشخص میکند شما از stdin بهعنوان ورودی استفاده میکنید. مثال زیر نحوهٔ ایجاد یک نسخهٔ پشتیبان و ذخیرهٔ آن را در یک ماشین دوردست نشان میدهد:
$ tar cf - / | ncftpput -c sonic.sega.co.jp /usr/local/backup.tar
دستور ncftpput مقادیر خروج زیر را بازمیگرداند:
- 0
- موفقیت.
- 1
- اتصال به میزبان راه دور برقرار نشد.
- 2
- اتصال به میزبان راه دور برقرار نشد - مهلت زمانی به پایان رسید.
- 3
- انتقال ناموفق بود.
- 4
- انتقال ناموفق بود - مهلت زمانی به پایان رسید.
- 5
- تغییر دایرکتوری ناموفق بود.
- 6
- تغییر دایرکتوری ناموفق بود - مهلت زمانی به پایان رسید.
- 7
- نشانی اینترنتی (URL) با قالب نادرست.
- 8
- خطا در نحوه استفاده.
- 9
- خطا در فایل پیکربندی ورود.
- 10
- مقداردهی اولیه کتابخانه ناموفق بود.
- 11
- مقداردهی اولیه نشست ناموفق بود.
نویسندگان (AUTHORS)
Mike Gleason، NcFTP Software (http://www.ncftp.com).
همچنین ببینید (SEE ALSO)
ncftpget(1), ncftp(1), ftp(1), rcp(1), tftp(1).
LibNcFTP (http://www.ncftp.com/libncftp).
| NcFTP Software | ncftpput |