.\" .\" lftp.1 - Sophisticated file transfer program .\" .\" This file is part of lftp. .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 3 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . .\" .\"------- .\" Sp space down the interparagraph distance .\"------- .de Sp .sp \\n(Ddu .. .\"------- .\" Ds begin a display, indented .5 inches from the surrounding text. .\" .\" Note that uses of Ds and De may NOT be nested. .\"------- .de Ds .Sp .RS .nf .. .\"------- .\" De end a display (no trailing vertical spacing) .\"------- .de De .RE .fi .. .TH lftp 1 "11 June 2022" .SH "نام (NAME)" lftp \- برنامه پیشرفته انتقال فایل .SH "خلاصه دستور (SYNOPSIS)" .B lftp [\fB\-d\fR] [\fB\-e \fIcmd\fR] [\fB\-p \fIport\fR] [\fB\-u \fIuser\fR[\fB,\fIpass\fR]] [\fIsite\fR] .br .BI "lftp \-f " script_file .br .BI "lftp \-c " commands .br .B lftp \-\-version .br .B lftp \-\-help .SH "نسخه (VERSION)" این صفحهٔ راهنما نسخهٔ 4.8.1 از lftp را مستند می‌کند. .SH "توضیحات (DESCRIPTION)" \fBlftp\fR یک برنامه انتقال فایل است که امکان برقراری اتصالات پیشرفتهٔ FTP، HTTP و سایر پروتکل‌ها را به میزبان‌های دیگر فراهم می‌کند. اگر \fIsite\fR مشخص شده باشد، lftp به آن متصل می‌شود؛ در غیر این صورت اتصال باید با دستور open برقرار گردد. .PP \fBlftp\fP می‌تواند چندین روش دسترسی به فایل را مدیریت کند \- FTP، FTPS، HTTP، HTTPS، HFTP، FISH، SFTP و file (پروتکل‌های HTTPS و FTPS تنها در صورتی در دسترس هستند که lftp با کتابخانهٔ GNU TLS یا OpenSSL کامپایل شده باشد). می‌توانید روش مورد استفاده را در دستور \(lqopen URL\(rq مشخص کنید، مانند \(lqopen http://www.us.kernel.org/pub/linux\(rq. پروتکل HFTP در واقع ftp-over-http-proxy است. اگر ftp:proxy روی \(lqhttp://proxy[:port]\(rq تنظیم شده باشد، می‌تواند به طور خودکار به جای FTP استفاده شود. Fish پروتکلی است که بر روی اتصال ssh به یک حساب کاربری unix کار می‌کند. SFtp پروتکلی است که در SSH2 به عنوان زیرسیستم SFTP پیاده‌سازی شده است. .PP علاوه بر پروتکل‌های شبیه به FTP، lftp از پروتکل BitTorrent نیز در قالب دستور \(lqtorrent\(rq پشتیبانی می‌کند. سیدینگ (Seeding) نیز پشتیبانی می‌شود. .PP هر عملیاتی در \fBlftp\fP قابل‌اطمینان است؛ به این معنا که هر خطای غیرمهلکی به درستی مدیریت شده و عملیات تکرار می‌شود. بنابراین اگر دانلود قطع شود، به طور خودکار از همان نقطه از سر گرفته خواهد شد. حتی اگر کارگزار FTP از دستور REST پشتیبانی نکند، \fBlftp\fP تلاش می‌کند فایل را از همان ابتدا بازیابی کند تا زمانی که فایل به طور کامل منتقل شود. \fBlftp\fP دارای ساختار دستوری شبیه به شل است که به شما امکان می‌دهد چندین دستور را به صورت موازی در پس‌زمینه (&) اجرا کنید. همچنین می‌توان دستورها را در () گروه‌بندی کرد و در پس‌زمینه اجرا نمود. تمام کارهای پس‌زمینه در همان تک‌فرایند اجرا می‌شوند. می‌توانید یک کار پیش‌زمینه را با ^Z (c-z) به پس‌زمینه ببرید و با دستور \(lqwait\(rq (یا \(lqfg\(rq که نام مستعاری برای \(lqwait\(rq است) به پیش‌زمینه بازگردانید. برای فهرست کردن کارهای در حال اجرا، از دستور \(lqjobs\(rq استفاده کنید. برخی از دستورها امکان هدایت خروجی خود (cat، ls و ...) به فایل یا از طریق لوله (pipe) به یک دستور خارجی را دارند. دستورها را می‌توان بر اساس وضعیت خاتمهٔ دستور قبلی به صورت مشروط (&&، ||) اجرا کرد. .PP اگر پیش از پایان یافتن همه کارها از \fBlftp\fP خارج شوید، \fBlftp\fP خود را به حالت nohup در پس‌زمینه منتقل می‌کند. همین اتفاق در هنگام قطع شدن واقعی مودم یا زمانی که یک xterm را می‌بندید رخ می‌دهد. .PP \fBlftp\fP دارای ابزار آینه (mirror) داخلی است که می‌تواند یک درخت دایرکتوری را به طور کامل بارگیری یا به‌روزرسانی کند. همچنین آینه معکوس (mirror \-R) وجود دارد که یک درخت دایرکتوری را بر روی کارگزار بارگذاری یا به‌روزرسانی می‌کند. Mirror همچنین می‌تواند در صورت در دسترس بودن FXP، دایرکتوری‌ها را بین دو کارگزار دوردست همگام‌سازی کند. .PP دستور \(lqat\(rq برای راه‌اندازی یک کار در زمان مشخص در زمینهٔ فعلی، دستور \(lqqueue\(rq برای صف‌بندی دستورها جهت اجرای متوالی برای کارگزار فعلی، و موارد بسیار دیگری وجود دارد. .PP هنگام راه‌اندازی، \fBlftp\fP فایل \fI/etc/lftp.conf\fP و سپس \fI~/.lftprc\fP و \fI~/.lftp/rc\fP (یا در صورت عدم وجود \fI~/.lftp\fP، فایل \fI~/.config/lftp/rc\fP) را اجرا می‌کند. می‌توانید نام‌های مستعار و دستورهای \(lqset\(rq را در آنجا قرار دهید. برخی افراد ترجیح می‌دهند اشکال‌زدایی کامل پروتکل را ببینند؛ برای فعال کردن اشکال‌زدایی از \(lqdebug\(rq استفاده کنید. از \(lqdebug 3\(rq استفاده کنید تا تنها پیام‌های خوش‌آمدگویی و پیام‌های خطا را ببینید. .PP \fBlftp\fP تعدادی متغیر قابل تنظیم دارد. می‌توانید از \(lqset \-a\(rq برای مشاهدهٔ تمام متغیرها و مقادیر آن‌ها یا از \(lqset \-d\(rq برای دیدن فهرست پیش‌فرض‌ها استفاده کنید. نام متغیرها را می‌توان کوتاه کرد و پیشوند را حذف نمود، مگر اینکه باقی‌مانده مبهم شود. .PP اگر lftp با OpenSSL کامپایل شده باشد (configure \-\-with\-openssl)، شامل نرم‌افزارهای توسعه‌یافته توسط پروژه OpenSSL برای استفاده در جعبه‌ابزار OpenSSL است. (http://www.openssl.org).SS "دستورها (Commands)" .PP .BI ! " shell command" .PP اجرای پوسته یا یک دستور پوسته. .PP .Ds !ls .De .PP برای نمایش فهرست دایرکتوری میزبان محلی. .B alias .RI " [" name " [" value ]] .PP نام مستعار \fIname\fP را تعریف یا لغو تعریف می‌کند. اگر \fIvalue\fP حذف شود، نام مستعار لغو تعریف می‌شود، در غیر این صورت مقدار \fIvalue\fP را به خود می‌گیرد. اگر هیچ آرگومانی داده نشود، نام‌های مستعار فعلی فهرست می‌شوند. .PP .Ds alias dir ls \-lF alias less zmore .De .BR at " \fItime\fP [ \-\- \fIcommand\fP ] " .PP تا زمان مشخص‌شده صبر کرده و دستور داده‌شده (اختیاری) را اجرا می‌کند. همچنین ببینید: \fBat\fR(1). .B attach .RI " [" PID ] .PP ترمینال را به پردازهٔ پس‌زمینهٔ مشخص‌شدهٔ lftp متصل می‌کند. .B bookmark .RI " [" subcommand ] .PP دستور bookmark نشانک‌ها را مدیریت می‌کند. نام‌های سایت را می‌توان مستقیماً همان‌گونه که هستند در دستور \fIopen\fP یا در هر دستوری که نشانی‌های اینترنتی ورودی را می‌پذیرد با استفاده از قالب \fIbm:site/path\fP به کار برد. .Sp .RS .TS l lx . add [] T{ افزودن مکان فعلی یا موقعیت داده‌شده به نشانک‌ها و پیوند آن به نام مشخص‌شده T} del حذف نشانک با نام مشخص‌شده edit اجرای ویرایشگر روی فایل نشانک‌ها import وارد کردن نشانک‌های خارجی list فهرست کردن نشانک‌ها (پیش‌فرض) .TE .RE .P .B cache .RI " [" subcommand ] .PP دستور cache حافظهٔ موقت (کَش) محلی را مدیریت می‌کند. زیردستورهای زیر شناخته‌شده هستند: .Sp .RE .TS l lx . stat چاپ وضعیت کَش (پیش‌فرض) on|off روشن/خاموش کردن کَش flush تخلیهٔ کَش size \fIlim\fP تنظیم محدودیت حافظه، مقدار -1 یعنی نامحدود expire \fINx\fP T{ تنظیم زمان انقضای کَش روی \fIN\fP ثانیه (\fIx\fP=s)، دقیقه (\fIx\fP=m)، ساعت (\fIx\fP=h) یا روز (\fIx\fP=d) T} .TE .RE .P .BR cat " \fIfiles\fP" .PP دستور cat فایل(های) دوردست را به خروجی استاندارد (stdout) می‌فرستد. (همچنین ببینید: \fBmore\fR، \fBzcat\fR و \fBzmore\fR) .BR cd " rdir" .PP تغییر دایرکتوری دوردست فعلی. دایرکتوری دوردست قبلی به عنوان `\-' ذخیره می‌شود. می‌توانید برای بازگشت به دایرکتوری قبلی از `cd \-' استفاده کنید. دایرکتوری قبلی برای هر سایت روی دیسک نیز ذخیره می‌شود، بنابراین حتی پس از راه‌اندازی مجدد lftp نیز می‌توانید `open site; cd \-' را اجرا کنید. .BR chmod " [" OPTS "] " "\fImode files...\fP" .PP تغییر ماسک دسترسی روی فایل‌های دوردست. حالت (mode) می‌تواند یک عدد هشت‌هشتی (اکتال) یا یک حالت نمادین باشد (chmod(1) را ببینید). .PP .Sp .RS .TS l1 l lx . -c, --changes مشابه verbose، اما تنها زمانی گزارش می‌دهد که تغییری ایجاد شود -f, --quiet نادیده گرفتن بیشتر پیام‌های خطا -v, --verbose خروجی دادن یک پیام تشخیصی برای هر فایل پردازش‌شده -R, --recursive تغییر بازگشتی فایل‌ها و دایرکتوری‌ها .TE .RE .P .BR close " [" \-a "]" .PP بستن اتصال‌های بیکار. به طور پیش‌فرض فقط با سرور فعلی؛ از \-a برای بستن تمام اتصال‌های بیکار استفاده کنید. .BR cls " [" OPTS "] " \fIfiles...\fP .PP دستور `cls' تلاش می‌کند اطلاعات مربوط به فایل‌ها یا دایرکتوری‌های مشخص‌شده را دریافت کرده و اطلاعات را بر اساس گزینه‌های قالب‌بندی خروجی دهد. تفاوت بین `ls' و `cls' در این است که `ls' از سرور درخواست می‌کند تا فهرست فایل‌ها را قالب‌بندی کند، اما `cls' پس از دریافت تمامی اطلاعات مورد نیاز، خودش آن را قالب‌بندی می‌نماید. .PP .Sp .RS .TS l1 l lx . \-1 خروجی تک‌ستونی \-a, \-\-all نمایش فایل‌های نقطه‌دار (مخفی) \-B, \-\-basename فقط نمایش نام پایه (basename) فایل‌ها \-\-block\-size=SIZ استفاده از بلوک‌های SIZ بایتی \-d, \-\-directory T{ فهرست کردن مدخل‌های دایرکتوری به جای محتویات آن‌ها T} \-F, \-\-classify T{ افزودن نشانگر (یکی از /@) به مدخل‌ها T} \-h, \-\-human\-readable T{ چاپ اندازه‌ها در قالبی خوانا برای انسان (مثلاً 1K) T} \-\-si T{ همانند مورد قبل، اما با استفاده از توان‌های ۱۰۰۰ به جای ۱۰۲۴ T} \-k, \-\-kilobytes T{ مشابه \-\-block\-size=1024 T} \-l, \-\-long T{ استفاده از قالب فهرست بلند T} \-q, \-\-quiet عدم نمایش وضعیت \-s, \-\-size چاپ اندازهٔ هر فایل \-\-filesize T{ در صورت چاپ اندازه، تنها برای فایل‌ها اندازه چاپ شود T} \-i, \-\-nocase T{ تطبیق الگو بدون حساسیت به بزرگی و کوچکی حروف T} \-I, \-\-sortnocase T{ مرتب‌سازی نام‌ها بدون حساسیت به بزرگی و کوچکی حروف T} \-D, \-\-dirsfirst T{ فهرست کردن دایرکتوری‌ها در ابتدا T} \-\-sort=OPT T{ "name" ،"size" ،"date" T} \-S مرتب‌سازی بر اساس اندازهٔ فایل \-\-user, \-\-group, \-\-perms, \-\-date, \-\-linkcount, \-\-links نمایش فیلدهای مجزا \-\-time\-style=STYLE T{ استفاده از قالب زمانی مشخص‌شده T} .TE .RE .P .BR command " \fIcmd args...\fP .PP دستور داده‌شده را با نادیده گرفتن نام‌های مستعار اجرا می‌کند. .BR debug " [" OPTS "] " \fIlevel\fP | off .PP اشکال‌زدایی را به \fIlevel\fP تغییر می‌دهد یا آن را خاموش می‌کند. گزینه‌ها: .Sp .RS .TS l1 l lx . \-T کوتاه/خالی کردن فایل خروجی (truncate) \-o هدایت خروجی اشکال‌زدایی به فایل \-c نمایش زمینه (context) پیام \-p نمایش PID \-t نمایش برچسب‌های زمانی .TE .RE.P .BR du " [" OPTS "] " \fIpath...\fP .PP خلاصه مصرف فضای دیسک را نمایش می‌دهد. گزینه‌ها: .Sp .RS .TS l1 l lx . \-a, \-\-all T{ شمارش اندازه را برای تمام فایل‌ها بنویس، نه فقط دایرکتوری‌ها T} \-\-block\-size=SIZ استفاده از بلوک‌های SIZ بایتی \-b, \-\-bytes چاپ اندازه بر حسب بایت \-c, \-\-total محاسبه مجموع کل \-d, \-\-max\-depth=N T{ چاپ مجموع برای یک دایرکتوری (یا فایل، همراه با \-\-all) تنها در صورتی که N سطح یا کمتر پایین‌تر از آرگومان خط فرمان باشد؛ \-\-max\-depth=0 معادل \-\-summarize است T} \-F, \-\-files چاپ تعداد فایل‌ها به‌جای اندازه‌ها \-h, \-\-human\-readable T{ چاپ اندازه‌ها در قالبی خوانا برای انسان (مانند 1K 234M 2G) T} \-H, \-\-si مشابه قبل، اما با استفاده از توان‌های ۱۰۰۰ به‌جای ۱۰۲۴ \-k, \-\-kilobytes مشابه \-\-block\-size=1024 \-m, \-\-megabytes مشابه \-\-block\-size=1048576 \-S, \-\-separate\-dirs شامل نکردن اندازه زیردایرکتوری‌ها \-s, \-\-summarize تنها نمایش یک مجموع برای هر آرگومان \-\-exclude=PAT مستثنی کردن فایل‌های منطبق با PAT .TE .RE .P .BR echo " [" \-n "] \fIstring\fR" .PP رشته داده‌شده را روی صفحه نمایش چاپ (echo) می‌کند. .BR edit " [" OPTS "] " \fIfile\fP .PP دریافت فایل دوردست در یک مکان موقت، اجرای یک ویرایشگر محلی روی آن و بارگذاری مجدد فایل در صورت تغییر. گزینه‌ها: .Sp .RS .TS l1 l lx . \-k نگه‌داشتن فایل موقت \-o تعیین صریح مکان فایل موقت .TE .RE .P .BR eval " [" -f " \fIformat\fR ] " \fIargs...\fR .PP بدون -f آرگومان‌های داده‌شده را به عنوان یک دستور اجرا می‌کند. با -f، آرگومان‌ها به یک دستور جدید تبدیل می‌شوند. قالب می‌تواند شامل متن ساده و جانگهدارنده‌های $0...$9 و $@ متناظر با آرگومان‌ها باشد. .BR exit " [" bg "]" .RB [ top ] .RB [ parent ] .RB [ kill ] .RI [ code ] .PP دستور exit از lftp خارج می‌شود یا در صورت وجود کارهای فعال، به پس‌زمینه انتقال می‌یابد. اگر هیچ کاری فعال نباشد، \fIcode\fP به عنوان وضعیت خروج lftp به سیستم‌عامل فرستاده می‌شود. اگر \fIcode\fP مشخص نشود، از کد خروج آخرین دستور استفاده خواهد شد. .PP دستور \(lqexit bg\(rq انتقال اجباری به پس‌زمینه را زمانی که cmd:move-background نادرست (false) است انجام می‌دهد. دستور \(lqexit top\(rq موجب خاتمه یافتن \(lqshell\(rq سطح بالا (اجراکننده داخلی دستورات lftp) می‌شود. دستور \(lqexit parent\(rq پوسته والد را هنگام اجرای یک اسکریپت تودرتو خاتمه می‌دهد. دستور \(lqexit kill\(rq تمام کارهای شماره‌دار را پیش از خروج متوقف می‌کند (kill می‌کند). این گزینه‌ها را می‌توان ترکیب کرد، برای مثال: \(lqat 08:00 \-\- exit top kill &\(rq همه کارها را متوقف کرده و کاری می‌کند که lftp در زمان مشخص‌شده خارج شود. .B fg .PP نام مستعاری برای \(lqwait\(rq. .BR find " [" OPTS "] " \fIdirectory...\fP .PP فهرست کردن فایل‌ها در دایرکتوری (به‌طور پیش‌فرض دایرکتوری جاری) به‌صورت بازگشتی. این قابلیت می‌تواند در سرورهایی که فاقد پشتیبانی از ls \-R هستند مفید باشد. می‌توانید خروجی این دستور را تغییر مسیر دهید. گزینه‌ها: .Sp .RS .TS l1 l lx . \-d \fIMD\fP, \-\-max\-depth=\fIMD\fP تعیین بیشینه عمق پیمایش \-l, \-\-ls استفاده از قالب فهرست‌بندی بلند .TE .RE .P .BR ftpcopy .PP منسوخ شده است. به‌جای آن از یکی از موارد زیر استفاده کنید: .Ds get ftp://... \-o ftp://... get \-O ftp://... file1 file2... put ftp://... mput ftp://.../* mget \-O ftp://... ftp://.../* .De یا ترکیب‌های دیگر برای انجام انتقال FXP (به‌طور مستقیم بین دو سرور FTP). چنانچه انتقال FXP نتواند آغاز شود یا مقدار ftp:use-fxp نادرست باشد، lftp به کپی معمولی (از طریق کلاینت) بازمی‌گردد. .BR get " [" \-E ] .RB [ \-a "] [" \-c "] [" \-e ] .RB [ \-P " \fIN\fP]" .RB [ \-O " \fIbase\fP]" .RB "\fIrfile\fP [" \-o " \fIlfile\fP] ..." .PP فایل دوردست \fIrfile\fP را دریافت کرده و آن را در قالب فایل محلی \fIlfile\fP ذخیره می‌کند. اگر \-o حذف شود، فایل در یک فایل محلی با نام پایه \fIrfile\fP ذخیره می‌شود. می‌توانید با تعیین چندین نمونه از \fIrfile\fP (و \-o \fIlfile\fP) چندین فایل را دریافت کنید. کاراکترهای عام (wildcards) را بسط نمی‌دهد، برای این منظور از \fBmget\fR استفاده کنید. .Sp .RS .TS l lx . \-c ادامه دادن دریافت، reget \-E حذف فایل‌های مبدأ پس از انتقال موفقیت‌آمیز \-e حذف فایل مقصد پیش از انتقال \-a استفاده از حالت ascii (حالت باینری پیش‌فرض است) \-P \fIN\fP بارگیری همزمان \fIN\fP فایل \-O T{ دایرکتوری یا نشانی URL پایه‌ای را مشخص می‌کند که فایل‌ها باید در آن قرار گیرند T} .TE .RE .PP مثال‌ها: .Ds get README get README \-o debian.README get README README.mirrors get README \-o debian.README README.mirrors \-o debian.mirrors get README \-o ftp://some.host.org/debian.README get README \-o ftp://some.host.org/debian-dir/ \ \ \fB(اسلش انتهایی مهم است)\fP .De .BR get1 .RI [ OPTS "] " rfile .PP انتقال یک تک‌فایل. گزینه‌ها: .Sp .RS .TS l lx . \-o T{ نام فایل مقصد (پیش‌فرض \- نام پایه rfile) T} \-c ادامه دادن دریافت، reget \-E T{ حذف فایل‌های مبدأ پس از انتقال موفقیت‌آمیز T} \-a استفاده از حالت ascii (حالت باینری پیش‌فرض است) \-d ایجاد دایرکتوری فایل مقصد \-\-source\-region= T{ انتقال محدوده مشخص‌شده از فایل مبدأ T} \-\-target\-position= T{ موقعیت در فایل مقصد برای نوشتن داده در آن T} .TE .RE .P .B glob .RI " [" OPTS "] " .RI [ command "] " patterns .PP بسط الگوهای داده‌شده حاوی نویسه‌های عام و فرستادن نتیجه به دستور داده‌شده یا بازگرداندن وضعیت خروج مناسب. .Sp .RS .TS l lx . \-f فایل‌های عادی (پیش‌فرض) \-d دایرکتوری‌ها \-a تمام انواع \-\-exist بازگرداندن وضعیت خروج صفر هنگامی که الگوها به فهرستی غیرخالی بسط یابند \-\-not\-exist بازگرداندن وضعیت خروج صفر هنگامی که الگوها به فهرستی خالی بسط یابند .TE .RE.PP مثال‌ها: .Ds glob echo * glob --exist *.csv && echo "There are *.csv files" .De .B help [\fIcmd\fP] .PP چاپ راهنما برای \fIcmd\fP یا در صورت مشخص نشدن \fIcmd\fP، چاپ فهرستی از دستورهای موجود. .P .BR history " [" OPTS "] [" \fIcnt\fP "]" .PP مشاهده یا دستکاری تاریخچه دستورها. آرگومان اختیاری \fIcnt\fP تعداد خطوط تاریخچه برای فهرست کردن، یا "all" برای فهرست کردن تمام مدخل‌ها را مشخص می‌کند. گزینه‌ها: .Sp .RS .TS l1 l lx . \-w نوشتن تاریخچه در فایل. \-r خواندن تاریخچه از فایل؛ الحاق به تاریخچه فعلی. \-c پاک کردن تاریخچه. \-l فهرست کردن تاریخچه (پیش‌فرض). .TE .RE .P .B jobs .RI [ OPTS ] .RI [ job_no... ] .PP فهرست کردن کارهای در حال اجرا. اگر \fIjob_no\fP مشخص شده باشد، تنها کار با آن شماره فهرست می‌شود. گزینه‌ها: .Sp .RS .TS l lx . \-v پرگو، چند \-v سطح پرگویی را افزایش می‌دهد \-r فهرست کردن تنها یک کارِ مشخص‌شده بدون بازگشت .TE .RE .P .B kill all|\fIjob_no\fP .PP حذف کار مشخص‌شده با \fIjob_no\fP یا تمام کارها. (برای \fIjob_no\fP به \fBjobs\fP مراجعه کنید) .B lcd \fIldir\fP .PP تغییر دایرکتوری محلی فعلی به \fIldir\fP. دایرکتوری محلی قبلی به‌صورت `\-' ذخیره می‌شود. می‌توانید برای بازگشت به دایرکتوری قبلی از `lcd \-' استفاده کنید. .B ln .RB [ \-s ] \fIexisting-file\fP \fInew-link\fP .PP ایجاد پیوند سخت/نمادین به یک فایل موجود. گزینه \-s ایجاد پیوند نمادین را انتخاب می‌کند. .B local \fIcommand\fP .PP اجرای دستور مشخص‌شده با نشست دایرکتوری محلی file:// به‌جای نشست راه‌دور. مثال‌ها: .Ds local pwd local ls local mirror /dir1 /dir2 .De .B lpwd .PP چاپ دایرکتوری کاری فعلی در ماشین محلی. .B ls \fIparams\fP .PP فهرست کردن فایل‌های راه‌دور. می‌توانید خروجی این دستور را به فایل یا از طریق لوله به یک دستور خارجی هدایت کنید. به‌طور پیش‌فرض، خروجی ls در حافظه‌پنهان ذخیره می‌شود؛ برای مشاهده فهرست جدید از .B rels یا .B "cache flush." استفاده کنید. .BR mget " [" \-c "] [" \-d "]" .RB [ \-a "] [" \-E "]" .RB [ \-e ] .RB [ \-P " \fIN\fP]" .RB [ \-O " \fIbase\fP] \fIfiles\fP" .PP دریافت فایل‌های انتخاب‌شده با الگوهای عام بسط‌یافته (wildcards). .PP .Sp .RS .TS l lx . \-c ادامه، دریافت مجدد (reget). \-d T{ ایجاد دایرکتوری‌هایی همنام با نام فایل‌ها و دریافت فایل‌ها در آن‌ها به‌جای دایرکتوری فعلی. T} \-E حذف فایل‌های مبدا پس از انتقال موفقیت‌آمیز \-e حذف فایل مقصد پیش از انتقال \-a استفاده از حالت ascii (پیش‌فرض binary است) \-P \fIN\fP دانلود هم‌زمان \fIN\fP فایل به‌طور موازی \-O T{ دایرکتوری پایه یا URL که فایل‌ها باید در آن قرار گیرند را مشخص می‌کند T} .TE .RE .P .B mirror .RI [ OPTS "] [" source .RI "[" target "]]" .PP آینه‌کردن دایرکتوری مبدا مشخص‌شده به دایرکتوری مقصد. .PP به‌طور پیش‌فرض، مبدا راه‌دور و مقصد دایرکتوری محلی است. هنگام استفاده از \-R، دایرکتوری مبدا محلی و مقصد راه‌دور است. اگر دایرکتوری مقصد مشخص نشود، از نام پایه (base name) دایرکتوری مبدا استفاده می‌شود. اگر هر دو دایرکتوری مشخص نشوند، از دایرکتوری‌های فعلیِ محلی و راه‌دور استفاده می‌شود. .PP مبدا و/یا مقصد می‌توانند URLهایی باشند که به دایرکتوری‌ها اشاره دارند. .PP اگر دایرکتوری مقصد به یک ممیز (اسلش) ختم شود (به‌جز دایرکتوری ریشه)، نام پایه دایرکتوری مبدا به انتهای آن اضافه می‌شود. .PP .Sp .RS .TS l1 l lx . \-c, \-\-continue T{ ادامه یک کار mirror در صورت امکان T} \-e, \-\-delete T{ حذف فایل‌هایی که در مبدا موجود نیستند T} \-\-delete-excluded T{ حذف فایل‌های مستثناشده در مقصد T} \-\-delete\-first T{ حذف فایل‌های قدیمی پیش از انتقال موارد جدید T} \-\-depth\-first T{ ورود به زیردایرکتوری‌ها پیش از انتقال فایل‌ها T} \-\-scan\-all\-first T{ پویش بازگشتی تمام دایرکتوری‌ها پیش از انتقال فایل‌ها T} \-s, \-\-allow\-suid T{ تنظیم بیت‌های suid/sgid مطابق با مبدا T} \-\-allow\-chown T{ تلاش برای تنظیم مالک و گروه روی فایل‌ها T} \-\-ascii T{ استفاده از حالت انتقال ascii (مستلزم \-\-ignore\-size) T} \-\-ignore\-time T{ نادیده گرفتن زمان هنگام تصمیم‌گیری برای دانلود T} \-\-ignore\-size T{ نادیده گرفتن اندازه هنگام تصمیم‌گیری برای دانلود T} \-\-only\-missing T{ تنها دانلود فایل‌های ناموجود T} \-\-only\-existing T{ تنها دانلود فایل‌هایی که از قبل در مقصد موجودند T} \-n, \-\-only\-newer T{ تنها دانلود فایل‌های جدیدتر (\-c کار نخواهد کرد) T} \-\-upload\-older T{ بارگذاری فایل‌ها حتی در صورت قدیمی‌تر بودن از موارد مقصد T} \-\-transfer\-all T{ انتقال تمام فایل‌ها، حتی فایل‌هایی که ظاهراً در سایت مقصد یکسان هستند T} \-\-no\-empty\-dirs T{ ایجاد نکردن دایرکتوری‌های خالی (مستلزم \-\-depth\-first) T} \-r, \-\-no\-recursion T{ نرفتن به زیردایرکتوری‌ها T} \-\-recursion=\fIMODE\fP T{ ورود به زیردایرکتوری‌ها بر اساس شرط T} \-\-no\-symlinks T{ ایجاد نکردن پیوندهای نمادین T} \-p, \-\-no\-perms T{ تنظیم نکردن مجوزهای فایل T} \-\-no\-umask T{ اعمال نکردن umask بر حالت‌های فایل T} \-R, \-\-reverse T{ آینه‌کردن معکوس (ارسال/قرار دادن فایل‌ها) T} \-L, \-\-dereference T{ دانلود پیوندهای نمادین به‌صورت فایل T} \-\-overwrite T{ بازنویسی فایل‌های ساده بدون حذف اولیه آن‌ها T} \-\-no\-overwrite T{ حذف و ایجاد مجدد فایل‌های ساده به‌جای بازنویسی آن‌ها T} \-N, \-\-newer\-than=\fISPEC\fP T{ تنها دانلود فایل‌های جدیدتر از زمان مشخص‌شده، یا زمان تغییر فایل محلی مشخص‌شده. T} \-\-older\-than=\fISPEC\fP T{ تنها دانلود فایل‌های قدیمی‌تر از زمان مشخص‌شده، یا زمان تغییر فایل محلی مشخص‌شده. T} \-\-size\-range=\fIRANGE\fP T{ تنها دانلود فایل‌هایی با اندازه در محدوده مشخص‌شده T} \-P, \-\-parallel[=\fIN\fP] T{ دانلود N فایل به‌طور موازی T} \-\-use-pget[\-n=\fIN\fP] T{ استفاده از pget برای انتقال تک‌تک فایل‌ها T} \-\-on\-change=\fICMD\fP T{ اجرای دستور در صورت رخ دادن هرگونه تغییر T} \-\-loop T{ تکرار mirror تا زمانی که تغییری یافت نشود T} \-i \fIRX\fP, \-\-include=\fIRX\fP T{ شامل کردن فایل‌های منطبق T} \-x \fIRX\fP, \-\-exclude=\fIRX\fP T{ مستثنا کردن فایل‌های منطبق T} \-I \fIGP\fP, \-\-include\-glob=\fIGP\fP T{ شامل کردن فایل‌های منطبق T} \-X \fIGP\fP, \-\-exclude\-glob=\fIGP\fP T{ مستثنا کردن فایل‌های منطبق T} \-\-include\-rx\-from=\fIFILE\fP T{ T} \-\-exclude\-rx\-from=\fIFILE\fP T{ T} \-\-include\-glob\-from=\fIFILE\fP T{ T} \-\-exclude\-glob\-from=\fIFILE\fP T{ بارگیری الگوهای شمول/استثنا از فایل، هر الگو در یک خط T} \-f \fIFILE\fP, \-\-file=\fIFILE\fP T{ آینه‌کردن یک تک‌فایل یا گروه منطبق بر الگو (مانند /path/to/*.txt) T} \-F \fIDIR\fP, \-\-directory=\fIDIR\fP T{ آینه‌کردن یک تک‌دایرکتوری یا گروه منطبق بر الگو (مانند /path/to/dir*) T} \-O \fIDIR\fP, \-\-target-directory=\fIDIR\fP T{ مسیر پایه مقصد یا URL T} \-v, \-\-verbose[=level] T{ عملیات پرگو T} \-\-log=\fIFILE\fP T{ نوشتن دستورهای lftp در حال اجرا در FILE T} \-\-script=\fIFILE\fP T{ نوشتن دستورهای lftp در FILE، بدون اجرای آن‌ها T} \-\-just-print, \-\-dry-run T{ همانند \-\-script=\- T} \-\-max\-errors=\fIN\fP T{ توقف پس از این تعداد خطا T} \-\-skip\-noaccess T{ تلاش نکردن برای انتقال فایل‌های فاقد دسترسی خواندن. T} \-\-use-cache T{ استفاده از فهرست‌های دایرکتوری در حافظه‌پنهان T} \-\-Remove\-source\-files T{ حذف فایل‌های مبدا پس از انتقال (با احتیاط استفاده شود) T} \-\-Remove\-source\-dirs T{ حذف فایل‌ها و دایرکتوری‌های مبدا پس از انتقال (با احتیاط استفاده شود). دایرکتوری سطح بالا در صورتی که نام آن به ممیز ختم شود، حذف نمی‌شود. T} \-\-Move T{ همانند \-\-Remove\-source\-dirs T} \-a T{ همانند \-\-allow-chown \-\-allow-suid \-\-no-umask T}.TE .RE \fIRX\fP یک عبارت منظم گسترش‌یافته (extended regular expression) است، دقیقاً مانند \fBegrep\fR(1). .PP \fIGP\fP یک الگوی عمومی (glob pattern) است، مانند \(lq*.zip\(rq. .PP گزینه‌های include و exclude را می‌توان چندین بار مشخص کرد. این بدان معناست که یک فایل یا دایرکتوری در صورتی آینه‌سازی (mirror) می‌شود که با یک include مطابقت داشته باشد و با excludeهای بعد از آن include مطابقت نداشته باشد، یا با هیچ‌چیز مطابقت نداشته باشد و اولین بررسی از نوع exclude باشد. دایرکتوری‌ها با یک اسلش در انتها تطبیق داده می‌شوند. .PP توجه داشته باشید که هنگام بارگذاری روی سرور دوردست، پیوندهای نمادین (symbolic links) ایجاد نمی‌شوند، زیرا پروتکل FTP امکان انجام آن را ندارد. برای بارگذاری فایل‌هایی که پیوندها به آن‌ها اشاره می‌کنند، از دستور \(lqmirror \-RL\(rq استفاده کنید (پیوندهای نمادین را به عنوان فایل در نظر می‌گیرد). .PP برای گزینه‌های \-\-newer\-than و \-\-older\-than می‌توانید یک فایل محلی یا مشخصه زمانی مانند آنچه در دستور \fBat\fR(1) به کار می‌رود را تعیین کنید، مانند \(lqnow-7days\(rq یا \(lqweek ago\(rq. اگر فایلی را مشخص کنید، زمان آخرین تغییر آن فایل استفاده خواهد شد. .PP سطح پرگویی (verbosity) را می‌توان با استفاده از گزینه \-\-verbose=level یا چندین گزینه \-v مانند \-vvv مشخص کرد. سطوح عبارتند از: .Ds 0 - بدون خروجی (پیش‌فرض) 1 - چاپ اقدامات 2 - +چاپ نام فایل‌های حذف‌نشده (زمانی که \-e مشخص نشده باشد) 3 - +چاپ نام دایرکتوری‌هایی که آینه‌سازی می‌شوند .De .PP گزینه \-\-only\-newer مقایسه اندازه فایل‌ها را غیرفعال کرده و تنها فایل‌های جدیدتر را بارگذاری/بارگیری می‌کند، حتی اگر اندازه متفاوتی داشته باشند. به‌طور پیش‌فرض، فایل‌های قدیمی‌تر منتقل شده و جایگزین فایل‌های جدیدتر می‌شوند. .PP گزینه \-\-upload\-older امکان جایگزینی فایل‌های دوردست جدیدتر با فایل‌های قدیمی‌تر را فراهم می‌کند (زمانی که مقصد دوردست باشد). برخی از زیرسیستم‌های دوردست نمی‌توانند برچسب‌های زمانی (timestamps) را حفظ کنند، بنابراین پیش‌فرض بر نگه داشتن فایل‌های جدیدتر است. .PP حالت بازگشتی (recursion mode) می‌تواند یکی از مقادیر \(lqalways\(rq، \(lqnever\(rq، \(lqmissing\(rq یا \(lqnewer\(rq باشد. با گزینه \(lqnewer\(rq، دستور mirror برچسب‌های زمانی دایرکتوری‌ها را مقایسه می‌کند و تنها در صورتی وارد یک دایرکتوری می‌شود که در سمت مقصد قدیمی‌تر بوده یا وجود نداشته باشد. آگاه باشید که با تغییر یک فایل ممکن است برچسب زمانی دایرکتوری بدون تغییر باقی بماند، بنابراین mirror آن دایرکتوری را پردازش نخواهد کرد. .PP گزینه‌های \-\-file و \-\-directory را می‌توان چندین بار استفاده کرد و حتی با هم ترکیب نمود، به شرطی که دایرکتوری‌های پایه مسیرها یکسان باشند. .PP اگر به جای دایرکتوری‌ها از URL استفاده کنید، می‌توانید بین دو سرور آینه‌سازی انجام دهید. در صورت امکان، FXP به‌طور خودکار برای انتقال بین سرورهای FTP استفاده می‌شود. .PP برخی از سرورهای FTP به‌طور پیش‌فرض فایل‌های نقطه‌دار (dot-files مانند \fI.htaccess\fP) را مخفی می‌کنند و تنها در صورتی آن‌ها را نشان می‌دهند که دستور LIST همراه با گزینه \-a استفاده شود. در این صورت سعی کنید از \(lqset ftp:list-options \-a\(rq استفاده نمایید. .PP حالت‌های بازگشتی \(lqnewer\(rq و \(lqmissing\(rq با \-\-scan\-all\-first، \-\-depth\-first، \-\-no\-empty\-dirs و تنظیم mirror:no\-empty\-dirs=true تداخل دارند. .B mkdir .RB "[" \-p "] " .RB "[" \-f "] " .I dir(s) .PP ایجاد دایرکتوری‌های دوردست. اگر \-p استفاده شود، تمام مؤلفه‌های مسیر ایجاد می‌شوند. گزینه \-f باعث بی‌صدا شدن mkdir شده و پیام‌ها را فرومی‌نشاند. .B module .IR "module " [ " args " ] .PP بارگذاری ماژول داده‌شده با استفاده از تابع \fBdlopen\fR(3). اگر نام ماژول شامل اسلش نباشد، در دایرکتوری‌های مشخص‌شده توسط متغیر module:path جستجو می‌شود. آرگومان‌ها به تابع module_init ارسال می‌شوند. برای جزئیات فنی README.modules را ببینید. .B more \fIfiles\fP .PP مشابه \(lqcat \fIfiles\fP | more\(rq. اگر \fBPAGER\fP تنظیم شده باشد، به عنوان فیلتر استفاده می‌شود. (همچنین ببینید \fBcat\fR، \fBzcat\fR و \fBzmore\fR) .BR mput " [" \-c "] [" \-d "]" .RB [ \-a "] [" \-E "]" .RB [ \-e ] .RB [ \-P " \fIN\fP]" .RB [ \-O " \fIbase\fP] \fIfiles\fP" .PP بارگذاری فایل‌ها با بسط نویسه عمومی (wildcard expansion). به‌طور پیش‌فرض از نام پایه نام محلی به عنوان نام دوردست استفاده می‌کند. این رفتار را می‌توان با گزینه \(lq\-d\(rq تغییر داد. .Sp .RS .TS l lx . \-c ادامه، reput \-d T{ ایجاد دایرکتوری‌هایی مشابه با نام فایل‌ها و قرار دادن فایل‌ها در آن‌ها به جای دایرکتوری جاری T} \-E T{ حذف فایل‌های مبدأ پس از انتقال موفقیت‌آمیز (خطرناک) T} \-e حذف فایل مقصد پیش از انتقال \-a استفاده از حالت ascii (پیش‌فرض binary است) \-P \fIN\fP بارگذاری موازی \fIN\fP فایل \-O T{ دایرکتوری پایه یا URL محل قرارگیری فایل‌ها را مشخص می‌کند T} .TE .RE .P .B mrm \fIfile(s)\fP .PP مشابه \(lqglob rm\(rq. فایل(های) مشخص‌شده را با بسط نویسه عمومی حذف می‌کند. .B mmv .RB [ \-O " \fIdirectory\fP]" .RB "\fIfile(s)\fP \fIdirectory\fP" .PP انتقال فایل‌های مشخص‌شده به یک دایرکتوری مقصد. دایرکتوری مقصد را می‌توان پس از گزینه \-O یا به عنوان آخرین آرگومان مشخص کرد. .PP .Sp .RS .TS l lx . \-O T{ دایرکتوری مقصدی که فایل‌ها باید در آن قرار گیرند را مشخص می‌کند T} .TE .RE .P .B mv .RB "\fIfile1\fP \fIfile2\fP" .PP تغییر نام \fIfile1\fP به \fIfile2\fP. هیچ بسط نویسه عمومی انجام نمی‌شود. اگر بیش از دو آرگومان مشخص کنید، یا آخرین آرگومان با یک اسلش خاتمه یابد، دستور \fBmmv\fP به جای آن اجرا می‌شود. .B nlist .RB "[\fIargs\fP]" .PP فهرست کردن نام فایل‌های دوردست .B open .RI [ OPTS ] .I site .PP انتخاب یک سرور بر اساس نام میزبان، URL یا نشانک (bookmark). هنگامی که یک URL یا نشانک داده می‌شود، دایرکتوری کاری جاری به‌طور خودکار به دایرکتوری URL تغییر می‌یابد. گزینه‌ها: .Sp .RS .TS l lx . \-e \fIcmd\fP اجرای دستور بلافاصله پس از انتخاب سرور \-u \fIuser\fP[,\fIpass\fP] T{ استفاده از نام کاربری/گذرواژه برای احراز هویت. برای جداسازی کاربر و گذرواژه می‌توان از دونقطه نیز استفاده کرد. T} \-p \fIport\fP استفاده از پورت برای اتصال \-s \fIslot\fP اختصاص اتصال به این شیار (slot) \-d فعال‌سازی اشکال‌زدایی (debug) \-B نشانک‌ها بررسی نشوند \-\-user \fIuser\fP استفاده از کاربر برای احراز هویت \-\-password \fIpass\fP استفاده از گذرواژه برای احراز هویت \-\-env\-password دریافت گذرواژه از متغیر محیطی \fBLFTP_PASSWORD\fP \fIsite\fP نام میزبان، URL یا نام نشانک .TE .RE اگر نام کاربری شامل نویسه‌های خاص (کاما یا دونقطه) است از گزینه \-u استفاده نکنید، آن را با گزینه \-\-user مشخص نمایید یا در URL با استفاده از نمادگذاری درصدی %AB نقل‌قول کنید. .P .B pget .RI [ OPTS ] .I rfile .RI [ "\fB-o\fP lfile" ] فایل مشخص‌شده را با استفاده از چندین اتصال دریافت می‌کند. این کار می‌تواند سرعت انتقال را افزایش دهد، اما بار زیادی بر شبکه و سرور وارد کرده و بر سایر کاربران اثر می‌گذارد. تنها در صورتی استفاده کنید که واقعاً نیاز به انتقال فایل در سریع‌ترین زمان ممکن (ASAP) داشته باشید. گزینه‌ها: .Sp .RS .TS l lx . \-c T{ ادامه انتقال. نیازمند فایل \fIlfile.lftp-pget-status\fP است. T} \-n \fImaxconn\fP T{ تنظیم حداکثر تعداد اتصالات (پیش‌فرض از تنظیم \fBpget:default-n\fP گرفته می‌شود) T} .TE .RE.P .B put .RB [ \-E ] .RB [ \-a ] .RB [ \-c ] .RB [ \-e ] .RB [ \-P " \fIN\fP]" .RB [ "\-O \fIbase\fP" ] .I lfile .RB [ "\-o \fIrfile\fP" ] .PP بارگذاری \fIlfile\fP با نام دوردست \fIrfile\fP. در صورت حذف \-o، نام پایهٔ (basename) \fIlfile\fP به عنوان نام دوردست استفاده می‌شود. الگوهای نویسه‌بدل (wildcards) را بسط نمی‌دهد، برای این منظور از \fBmput\fR استفاده کنید. .Sp .RS .TS l lx . \-o T{ نام فایل دوردست را مشخص می‌کند (پیش‌فرض \- نام پایهٔ lfile) T} \-c T{ ادامه، reput. نیازمند مجوز برای بازنویسی فایل‌های دوردست است T} \-E T{ حذف فایل‌های مبدأ پس از انتقال موفقیت‌آمیز (خطرناک) T} \-e حذف فایل مقصد پیش از انتقال \-a استفاده از حالت ascii (حالت binary پیش‌فرض است) \-P \fIN\fP بارگذاری موازی \fIN\fP فایل \-O T{ دایرکتوری پایه یا URL محل قرارگیری فایل‌ها را مشخص می‌کند T} .TE .RE .P .B pwd .RB [ \-p ] .PP چاپ URL دوردست فعلی. از گزینهٔ `\-p' برای نمایش گذرواژه در URL استفاده کنید. .B queue .RB [ \-n " \fInum\fP ] \fIcmd\fP" .PP افزودن دستور داده‌شده به صف برای اجرای ترتیبی. هر سایت صف اختصاصی خود را دارد. `\-n' دستور را قبل از مورد مشخص‌شده در صف اضافه می‌کند. سعی نکنید دستورهای `cd' یا `lcd' را در صف قرار دهید، این کار ممکن است lftp را سردرگم کند. در عوض cd/lcd را قبل از دستور `queue' انجام دهید، تا مکانی را که دستور باید در آن اجرا شود به خاطر بسپارد. امکان قرار دادن یک کار در حال اجرا در صف با `queue wait ' وجود دارد، اما اجرای آن کار حتی اگر نخستین مورد در صف نباشد ادامه خواهد یافت. .PP دستور `queue stop' صف را متوقف می‌کند، این دستور مانع از اجرای دستورهای جدید می‌شود، اما کارهای در حال اجرا به کار خود ادامه می‌دهند. می‌توانید از `queue stop' برای ایجاد یک صف خالی متوقف‌شده استفاده کنید. دستور `queue start' اجرای صف را از سر می‌گیرد. هنگامی که از lftp خارج می‌شوید، به‌طور خودکار تمام صف‌های متوقف‌شده را آغاز خواهد کرد. .PP اجرای `queue' بدون آرگومان، یا یک صف متوقف‌شده ایجاد می‌کند یا وضعیت صف را چاپ می‌کند. .B queue .BR "\-\-delete|-d " "[\fIindex or wildcard expression\fP]" .PP حذف یک یا چند مورد از صف. در صورت داده‌نشدن آرگومان، آخرین مدخل صف حذف می‌شود. .B queue .BR "\-\-move|-m " "<\fIindex or wildcard expression\fP> [\fIindex\fP]" .PP انتقال موارد داده‌شده به قبل از نمایهٔ (index) مشخص‌شده در صف، یا به انتها در صورتی که مقصدی مشخص نشده باشد. .PP .Sp .RS .TS l lx . \-q بی‌صدا بودن. \-v نمایش با جزئیات (پُرگویی). \-Q T{ خروجی در قالبی که بتواند برای صف‌بندی دوباره استفاده شود. مفید همراه با \-\-delete. T} .TE .RE .PP مثال‌ها: .Ds > get file & [1] get file > queue wait 1 > queue get another_file > cd a_directory > queue get yet_another_file .De .PP .Sp .RS .TS l lx . queue \-d 3 حذف سومین مورد در صف. queue \-m 6 4 T{ انتقال ششمین مورد در صف به قبل از چهارمین مورد. T} queue \-m "get*zip" 1 T{ انتقال همهٔ دستورهای منطبق با "get*zip" به ابتدای صف. (ترتیب موارد حفظ می‌شود.) T} queue \-d "get*zip" T{ حذف همهٔ دستورهای منطبق با "get*zip". T} .TE .RE .P .B quote \fIcmd\fP .PP برای FTP \- ارسال دستور بدون تفسیر. با احتیاط استفاده شود \- این کار می‌تواند منجر به وضعیت ناشناختهٔ دوردست شده و در نتیجه سبب اتصال دوباره گردد. نمی‌توانید مطمئن باشید که هرگونه تغییر در وضعیت دوردست به دلیل دستور نقل‌شده (quoted) پایدار است \- ممکن است در هر زمانی با اتصال دوباره بازنشانی شود. .PP برای HTTP \- مختص کنش‌های HTTP. نحوهٔ نگارش: ``quote []''. دستور می‌تواند ``set-cookie'' یا ``post'' باشد. .Ds open http://www.site.net quote set-cookie "variable=value; othervar=othervalue" set http:post-content-type application/x-www-form-urlencoded quote post /cgi-bin/script.cgi "var=value&othervar=othervalue" > local_file .De .PP برای FISH \- ارسال دستور بدون تفسیر. این گزینه می‌تواند برای اجرای دستورهای دلخواه روی سرور استفاده شود. دستور نباید ورودی دریافت کند یا در ابتدای سطر جدید ### چاپ کند. در غیر این صورت، همگام‌سازی پروتکل از بین خواهد رفت. .Ds open fish://server quote find \-name \\*.zip .De .BR "reget \fIrfile\fP " [ \-o " \fIlfile\fP]" .PP همانند `get \-c'. .B rels [\fIargs\fP] .PP همانند `ls'، اما حافظهٔ نهان (cache) را نادیده می‌گیرد. .B renlist [\fIargs\fP] .PP همانند `nlist'، اما حافظهٔ نهان را نادیده می‌گیرد. .B repeat [\fIOPTS\fP] [[\fB\-d\fP] \fIdelay\fP] [\fIcommand\fP] .PP تکرار دستور مشخص‌شده با یک تاخیر بین دفعات اجرا. تاخیر پیش‌فرض یک ثانیه و دستور پیش‌فرض خالی است. .PP .Sp .RS .TS l lx . \-c حداکثر تعداد تکرارها \-d تاخیر بین تکرارها \-\-while\-ok توقف هنگامی که دستور با کد خروج غیر صفر خارج شود \-\-until\-ok توقف هنگامی که دستور با کد خروج صفر خارج شود \-\-weak توقف هنگامی که lftp به پس‌زمینه می‌رود. .TE .RE .PP مثال‌ها: .Ds repeat at tomorrow \-\- mirror repeat 1d mirror .De .BR reput " \fIlfile\fP [" \-o " \fIrfile\fP]" .PP همانند `put \-c'. .BR rm " [" \-r "] [" \-f ] \fIfiles\fP.PP حذف فایل‌های راه دور. جانشین‌ها (wildcards) را بسط نمی‌دهد؛ برای این کار از \fBmrm\fR استفاده کنید. گزینهٔ \-r برای حذف بازگشتی دایرکتوری است. احتیاط کنید؛ اگر اشتباهی رخ دهد ممکن است فایل‌هایتان را از دست بدهید. گزینهٔ \-f پیام‌های خطا را فرونشانی می‌کند. .B rmdir \fIdir(s)\fP .PP حذف دایرکتوری‌های راه دور. .B scache [\fIsession\fP] .PP فهرست کردن نشست‌های کَش‌شده یا تغییر به نشست مشخص‌شده. .B set [\fIvar\fP [\fIval\fP]] .PP مقداردهی متغیر به مقدار داده‌شده. اگر مقدار حذف شود، متغیر لغو مقداردهی (unset) می‌شود. نام متغیر قالب \(lqname/closure\(rq دارد، که در آن closure می‌تواند حوزهٔ کاربرد دقیق تنظیم را مشخص کند. برای جزئیات به ادامه مراجعه کنید. اگر set بدون هیچ متغیری فراخوانی شود، تنها تنظیمات تغییریافته فهرست می‌شوند. این رفتار را می‌توان با این گزینه‌ها تغییر داد: .PP .Sp .RS .TS l lx . \-a فهرست کردن تمام تنظیمات، از جمله مقادیر پیش‌فرض \-d فهرست کردن تنها مقادیر پیش‌فرض، نه لزوماً مقادیر جاری .TE .RE .P .B site \fIsite_cmd\fP .PP اجرای دستور site به نام \fIsite_cmd\fP و خروجی دادن نتیجه. می‌توانید خروجی آن را تغییر مسیر دهید. .BR sleep " \fIinterval\fP " .PP به اندازهٔ بازهٔ زمانی مشخص‌شده به خواب رفته و خارج می‌شود. بازه به‌طور پیش‌فرض به ثانیه است، اما می‌تواند به‌ترتیب پسوندهای \(aqm\(aq، \(aqh\(aq و \(aqd\(aq را برای دقیقه، ساعت و روز داشته باشد. همچنین \fBat\fP را ببینید. .BR slot " [\fIname\fP]" .PP انتخاب اسلات مشخص‌شده یا فهرست کردن تمام اسلات‌های تخصیص‌یافته. اسلات اتصالی به یک سرور است، تا حدودی شبیه به یک کنسول مجازی. می‌توانید چندین اسلات متصل به سرورهای مختلف ایجاد کرده و بین آن‌ها جابه‌جا شوید. همچنین می‌توانید از \fIslot:name\fP به‌عنوان یک شبه‌URL برای ارجاع به مکان آن اسلات استفاده کنید. .PP کلیدهای پیش‌فرض readline امکان جابه‌جایی سریع بین اسلات‌های نام‌گذاری‌شده از 0 تا 9 را با کلیدهای Meta-0 تا Meta-9 فراهم می‌کنند (اغلب می‌توانید به‌جای Meta از Alt استفاده کنید). .B source \fIfile\fP .br .B source \-e \fIcommand\fP .PP اجرای دستورهای ضبط‌شده در فایل \fIfile\fP یا دستورهایی که توسط دستور خارجی مشخص‌شده برگردانده شده‌اند. .Ds source ~/.lftp/rc source \-e echo help .De .B suspend .PP توقف فرایند lftp. توجه داشته باشید که انتقال‌ها نیز تا زمانی که فرایند را با دستورهای fg یا bg در پوسته ادامه ندهید، متوقف خواهند شد. .BR torrent " [" OPTS "] " \fItorrent-files...\fP .PP آغاز فرایند BitTorrent برای \fItorrent-files\fP داده‌شده، که می‌تواند یک فایل محلی، URL، پیوند آهنربایی (magnet link) یا \fIinfo_hash\fP سادهٔ نوشته‌شده به صورت hex یا base32 باشد. جانشین‌های محلی بسط داده می‌شوند. فایل‌های موجود ابتدا اعتبارسنجی می‌شوند مگر اینکه گزینهٔ \fI\-\-force\-valid\fP داده شده باشد. قطعات ناموجود بارگیری می‌شوند. فایل‌ها در \fIdirectory\fP مشخص‌شده یا به‌طور پیش‌فرض در دایرکتوری کاری جاری ذخیره می‌شوند. سید کردن (Seeding) تا زمانی ادامه می‌یابد که نسبت اشتراک به تنظیم \fItorrent:stop-on-ratio\fP برسد یا زمان \fItorrent:seed-max-time\fP تمام شود. .PP گزینه‌ها: .Sp .RS .TS l lx . \-O T{ دایرکتوری پایه‌ای را که فایل‌ها باید در آن قرار گیرند مشخص می‌کند T} \-\-force\-valid T{ صرف‌نظر کردن از اعتبارسنجی فایل‌ها (اگر مطمئن هستید مشکلی ندارند). T} \-\-only\-new T{ توقف در صورتی که فراداده (metadata) از قبل شناخته شده باشد یا تورنت کامل باشد. T} \-\-only\-incomplete T{ توقف در صورتی که تورنت از قبل کامل باشد. T} \-\-dht\-bootstrap= T{ راه‌اندازی اولیهٔ DHT با ارسال یک پرس‌وجو به \fInode\fP مشخص‌شده. این گزینه باید تنها یک بار برای پر کردن کَش گره محلی استفاده شود. شمارهٔ درگاه می‌تواند پس از دونقطه مشخص شود؛ مقدار پیش‌فرض 6881 است. چند گره برای راه‌اندازی اولیه: dht.transmissionbt.com، router.utorrent.com، router.bittorrent.com. T} \-\-share T{ به اشتراک‌گذاری فایل یا دایرکتوری مشخص‌شده با استفاده از پروتکل BitTorrent. پیوند آهنربایی هنگامی که آماده شود چاپ می‌شود. T} .TE .RE .P .B user \fIuser\fP [\fIpass\fP] .br .B user \fIURL\fP [\fIpass\fP] .PP استفاده از اطلاعات مشخص‌شده برای ورود به سیستم راه دور. اگر یک URL را همراه با نام کاربری مشخص کنید، گذرواژهٔ واردشده کَش خواهد شد تا مراجعات بعدی به URL بتوانند از آن استفاده کنند. .B version .PP چاپ نسخهٔ \fBlftp\fR. .B wait [\fIjobno\fP] .br .B wait all .PP منتظر ماندن برای پایان کار (job) مشخص‌شده. اگر jobno حذف شود، برای آخرین کار پس‌زمینه منتظر می‌ماند. .PP دستور \(lqwait all\(rq منتظر پایان یافتن تمام کارها می‌ماند. .B zcat \fIfiles\fP .PP مشابه cat، اما هر فایل را از طریق zcat فیلتر می‌کند. (همچنین \fBcat\fR، \fBmore\fR و \fBzmore\fR را ببینید) .B zmore \fIfiles\fP .PP مشابه more، اما هر فایل را از طریق zcat فیلتر می‌کند. (همچنین \fBcat\fR، \fBzcat\fR و \fBmore\fR را ببینید).SS "تنظیمات (Settings)" .PP در هنگام راه‌اندازی، lftp فایل‌های \fI~/.lftprc\fP و \fI~/.lftp/rc\fP (یا \fI~/.config/lftp/rc\fP در صورتی که \fI~/.lftp\fP وجود نداشته باشد) را اجرا می‌کند. می‌توانید نام‌های مستعار (aliasها) و دستورهای `set` را در آنجا قرار دهید. برخی افراد ترجیح می‌دهند اشکال‌زدایی کامل پروتکل را مشاهده کنند؛ از `debug` برای فعال کردن اشکال‌زدایی استفاده کنید. .PP همچنین یک فایل راه‌اندازی سراسری سیستم در .IR /etc/lftp.conf وجود دارد. این فایل می‌تواند در دایرکتوری متفاوتی باشد؛ بخش «فایل‌ها (FILES)» را ببینید. .PP .B lftp دارای متغیرهای قابل تنظیم زیر است (همچنین می‌توانید از `set \-a' برای مشاهدهٔ تمام متغیرها و مقادیر آن‌ها استفاده کنید): .TP .BR bmk:save-passwords \ (boolean) ذخیره کردن گذرواژه‌ها به صورت متن خام در \fI~/.local/share/lftp/bookmarks\fP یا \fI~/.lftp/bookmarks\fP هنگام اجرای دستور `bookmark add`. به‌طور پیش‌فرض غیرفعال است. .TP .BR cache:cache-empty-listings \ (boolean) وقتی false باشد، فهرست‌های خالی کَش نمی‌شوند. .TP .BR cache:enable \ (boolean) وقتی false باشد، کَش غیرفعال است. .TP .BR cache:expire " (time interval)" مدخل‌های مثبت کَش در این بازه زمانی منقضی می‌شوند. .TP .BR cache:expire-negative " (time interval)" مدخل‌های منفی کَش در این بازه زمانی منقضی می‌شوند. .TP .BR cache:size " (number)" حداکثر اندازهٔ کَش. در صورت فراتر رفتن از این مقدار، قدیمی‌ترین مدخل‌های کَش از حافظه حذف خواهند شد. .TP .BR cmd:at-exit \ (string) دستورهای موجود در رشته پیش از خروج lftp یا انتقال آن به پس‌زمینه اجرا می‌شوند. .TP .BR cmd:at-exit-bg \ (string) دستورهای موجود در رشته پیش از خروج lftp در پس‌زمینه اجرا می‌شوند. .TP .BR cmd:at-exit-fg \ (string) دستورهای موجود در رشته پیش از خروج lftp در پیش‌زمینه اجرا می‌شوند. .TP .BR cmd:at-background \ (string) دستورهای موجود در رشته پیش از انتقال lftp به پس‌زمینه اجرا می‌شوند. .TP .BR cmd:at-terminate \ (string) دستورهای موجود در رشته پیش از خاتمه یافتن lftp (چه در پس‌زمینه و چه در پیش‌زمینه) اجرا می‌شوند. .TP .BR cmd:at-finish \ (string) دستورهای موجود در رشته پس از اتمام تمام کارها، یک‌بار اجرا می‌شوند. .TP .BR cmd:at-queue-finish \ (string) دستورهای موجود در رشته پس از اتمام تمام کارهای درون یک صف، یک‌بار اجرا می‌شوند. .TP .BR cmd:cls-completion-default \ (string) گزینه‌های پیش‌فرض \fBcls\fR برای نمایش گزینه‌های تکمیل خودکار. به عنوان مثال، برای اینکه فهرست‌های تکمیل خودکار اندازهٔ فایل‌ها را نشان دهند، cmd:cls-completion-default را روی `-s' تنظیم کنید. .TP .BR cmd:cls-default \ (string) گزینه‌های پیش‌فرض دستور \fBcls\fR. این گزینه‌ها می‌توانند با گزینه‌هایی که به صورت صریح داده می‌شوند بازنویسی شوند. .TP .BR cmd:cls-exact-time \ (boolean) وقتی true باشد، \fBcls\fR تلاش می‌کند زمان دقیق تغییر فایل را به دست آورد، حتی اگر به معنای ارسال درخواست‌های بیشتری به سرور باشد. .TP .BR cmd:csh-history \ (boolean) بسط تاریخچه به سبک csh را فعال می‌کند. .TP .BR cmd:default-protocol \ (string) این مقدار زمانی استفاده می‌شود که دستور `open' تنها با نام میزبان و بدون مشخص کردن پروتکل به کار رود. پیش‌فرض `ftp' است. .TP .BR cmd:fail-exit \ (boolean) اگر true باشد، با شکست یک دستور و در صورتی که دستور پس از آن نامشروط باشد (یعنی با || یا && شروع نشود)، خارج می‌شود. lftp پس از صادر شدن دستور نامشروط و بدون اجرای آن خارج می‌شود. .TP .BR cmd:interactive \ (tri-boolean) وقتی true باشد، lftp به صورت تعاملی عمل می‌کند، سیگنال‌های ترمینال را مدیریت کرده و پیام‌های اضافی تولید می‌کند. پیش‌فرض auto است و به این بستگی دارد که stdin یک ترمینال باشد یا خیر. .TP .BR cmd:long-running \ (seconds) مدت زمان اجرای دستوری که «طولانی» تلقی می‌شود و قبل از اعلان بعدی یک بوق زده می‌شود. مقدار 0 به معنای غیرفعال بودن است. .TP .BR cmd:ls-default \ (string) آرگومان پیش‌فرض ls .TP .BR cmd:move-background " (boolean)" وقتی false باشد، lftp هنگام خروج از رفتن به پس‌زمینه خودداری می‌کند. برای اجبار آن، از `exit bg' استفاده کنید. .TP .BR cmd:move-background-detach " (boolean)" وقتی true باشد (پیش‌فرض)، lftp هنگام انتقال به پس‌زمینه خود را از ترمینال کنترلی جدا می‌کند و می‌توان با استفاده از دستور `attach' مجدداً به آن متصل شد؛ وقتی false باشد، lftp شِل را فریب می‌دهد تا lftp را به گروه پردازش پس‌زمینه منتقل کرده و به اجرا ادامه دهد؛ سپس دستور fg در شل lftp را به پیش‌زمینه بازمی‌گرداند، مگر اینکه تمام کارها انجام شده و برنامه خاتمه یافته باشد. .TP .BR cmd:prompt \ (string) اعلان فرمان (prompt). نرم‌افزار lftp نویسه‌های ویژهٔ زیر را که با ممیز وارونه (backslash) مشخص می‌شوند شناخته و به این ترتیب تفسیر می‌کند: .RS .PD 0 .TP .B \e@ درج @ در صورتی که کاربر فعلی سایت دوردست پیش‌فرض نباشد .TP .B \ea یک نویسهٔ زنگ اسکی (07) .TP .B \ee یک نویسهٔ گریز اسکی (033) .TP .B \eh نام میزبان دوری که به آن متصل هستید .TP .B \en خط جدید (newline) .TP .B \es نام کلاینت (lftp) .TP .B \eS نام اسلات فعلی .TP .B \eu نام کاربری سایت دوردستی که با آن وارد سیستم شده‌اید .TP .B \eU نشانی وب (URL) سایت دوردست (مانند ftp://g437.ub.gu.se/home/james/src/lftp) .TP .B \ev نسخهٔ \fBlftp\fP (مانند 2.0.3) .TP .B \ew دایرکتوری کاری فعلی در سایت دوردست .TP .B \eW نام پایه (basename) دایرکتوری کاری فعلی در سایت دوردست .TP .B \el دایرکتوری کاری فعلی در سیستم محلی .TP .B \eL نام پایه (basename) دایرکتوری کاری فعلی در سیستم محلی .TP .B \e\fInnn\fP نویسهٔ متناظر با عدد هشت‌هشتی \fInnn\fP .TP .B \e\e یک ممیز وارونه (backslash) .TP .B \e? اگر جایگزینی قبلی خالی بود، از نویسهٔ بعدی صرف‌نظر می‌کند. .TP .B \e[ آغاز دنباله‌ای از نویسه‌های غیرقابل‌چاپ، که می‌تواند برای قراردادن یک دنبالهٔ کنترلی ترمینال در داخل اعلان استفاده شود .TP .B \e] پایان یک دنباله از نویسه‌های غیرقابل‌چاپ .PD .RE .TP .BR cmd:parallel \ (number) تعداد کارهایی که در حالت غیرتعاملی به‌طور موازی اجرا می‌شوند. برای مثال، این گزینه ممکن است برای اسکریپت‌هایی با چندین دستور `get' مفید باشد. توجه داشته باشید که تنظیم این متغیر روی مقداری بزرگ‌تر از 1 رفتار اجرای مشروط را تغییر داده و اساساً آن را ناسازگار می‌سازد. .TP .BR cmd:queue-parallel \ (number) تعداد کارهایی که در یک صف به‌طور موازی اجرا می‌شوند. .TP .BR cmd:remote-completion \ (boolean) یک مقدار بولی برای کنترل اینکه آیا lftp از تکمیل خودکار دوردست استفاده کند یا خیر. وقتی true باشد، کلید \fBTab\fP حدس می‌زند که آیا کلمه‌ای که تکمیل می‌شود باید نام یک فایل دوردست باشد یا خیر. کلید \fBMeta-Tab\fP همیشه تکمیل خودکار دوردست را انجام می‌دهد. بنابراین می‌توانید با \fBMeta-Tab\fP تکمیل خودکار دوردست را اجبار کنید زمانی که \fBcmd:remote-completion\fP برابر false است یا زمانی که حدس برنامه اشتباه باشد..TP .BR cmd:save-cwd-history \ (boolean) وقتی روی true باشد، lftp آخرین CWD (دایرکتوری کاری جاری) هر سایت را در \fI~/.local/share/lftp/cwd_history\fR یا \fI~/.lftp/cwd_history\fR ذخیره می‌کند که امکان اجرای «cd \-» را پس از راه‌اندازی مجدد lftp فراهم می‌سازد. پیش‌فرض true است. .TP .BR cmd:save-rl-history \ (boolean) وقتی روی true باشد، lftp تاریخچهٔ readline را هنگام خروج در \fI~/.local/share/lftp/rl_history\fR یا \fI~/.lftp/rl_history\fR ذخیره می‌کند. پیش‌فرض true است. .TP .BR cmd:show-status \ (boolean) وقتی روی false باشد، lftp خط وضعیت را روی ترمینال نشان نمی‌دهد. پیش‌فرض true است. .TP .BR cmd:set-term-status \ (boolean) وقتی روی true باشد، lftp وضعیت ترمینال را در صورت پشتیبانی (مانند xterm) به‌روزرسانی می‌کند. بستار (closure) برای این تنظیم، نوع ترمینال برگرفته از متغیر محیطی TERM است. .TP .BR cmd:status-interval \ (time interval) بازهٔ زمانی میان به‌روزرسانی‌های وضعیت. .TP .BR cmd:stifle-rl-history \ (number) تعداد خطوطی که باید در تاریخچهٔ readline نگه‌داشته شوند. .TP .BR cmd:term-status \ (string) رشتهٔ قالب مورد استفاده برای نمایش وضعیت ترمینال. بستار (closure) برای این تنظیم، نوع ترمینال برگرفته از متغیر محیطی TERM است. پیش‌فرض از مقادیر termcap به نام‌های «tsl» و «fsl» استفاده می‌کند. دنباله‌های گریز (escape) زیر پشتیبانی می‌شوند: .Sp .RS .TS l lx . \\a زنگ (bell) \\e گریز (escape) \\n خط جدید (newline) \\s "lftp" \\v نسخهٔ lftp \\T رشتهٔ وضعیت .TE .RE .TP .BR cmd:time-style \ (string) این تنظیم، مقدار پیش‌فرض برای گزینهٔ cls \-\-time\-style است. .TP .BR cmd:trace \ (boolean) وقتی روی true باشد، lftp دستورهایی را که اجرا می‌کند چاپ می‌کند (مانند sh \-x). .TP .BR cmd:verify-host \ (boolean) اگر true باشد، lftp نام میزبان را در دستور «open» بلافاصله تفکیک (resolve) می‌کند. همچنین در صورتی که «&» داده شود، یا در حین بررسی کلیدهای ^Z فشرده شوند، می‌توان از این بررسی برای یک دستور «open» منفرد صرف‌نظر کرد. .TP .BR cmd:verify-path \ (boolean) اگر true باشد، lftp مسیر داده‌شده در دستور «cd» را بررسی می‌کند. همچنین در صورتی که «&» داده شود، یا در حین بررسی کلیدهای ^Z فشرده شوند، می‌توان از بررسی برای یک دستور «cd» منفرد صرف‌نظر کرد. مثال‌ها: .Ds set cmd:verify-path/hftp://* false cd directory & .De .TP .BR cmd:verify-path-cached \ (boolean) وقتی روی false باشد، اجرای «cd» به دایرکتوری‌ای که طبق کَش موجود شناخته شده است، بلافاصله با موفقیت انجام می‌شود. در غیر این صورت، درستی‌آزمایی به تنظیم cmd:verify-path بستگی خواهد داشت. .TP .BR color:use-color " (tri-boolean)" وقتی روی true باشد، دستور cls و تکمیل خودکار (completion)، فهرست فایل‌ها را بر اساس تنظیم color:dir-colors به‌صورت رنگی خروجی می‌دهند. هنگامی که روی auto تنظیم شود، رنگ‌ها تنها در صورتی استفاده می‌شوند که خروجی یک ترمینال باشد. .TP .BR color:dir-colors " (string)" توصیف رنگ‌های فهرست‌بندی فایل‌ها. به‌طور پیش‌فرض از مقدار متغیر محیطی LS_COLORS استفاده می‌شود. dircolors(1) را ببینید. .TP .BR dns:SRV-query \ (boolean) پرس‌وجو برای رکوردهای SRV و استفاده از آن‌ها پیش از gethostbyname. رکوردهای SRV تنها در صورتی استفاده می‌شوند که درگاه (پورت) به‌طور صریح مشخص نشده باشد. برای جزئیات، RFC2052 را ببینید. .TP .BR dns:cache-enable \ (boolean) فعال‌سازی کَش DNS. اگر خاموش باشد، lftp با هر بار اتصال مجدد، نام میزبان را تفکیک می‌کند. .TP .BR dns:cache-expire " (time interval)" طول عمر (TTL) برای مدخل‌های کَش DNS. این مقدار قالبی به‌صورت + دارد، مانند 1d12h30m5s یا فقط 36h. برای غیرفعال کردن انقضا، آن را روی «inf» یا «never» تنظیم کنید. .TP .BR dns:cache-size \ (number) حداکثر تعداد مدخل‌های کَش DNS. .TP .BR dns:fatal-timeout " (time interval)" محدود کردن زمان پرس‌وجوهای DNS. اگر کارساز DNS برای مدتی طولانی در دسترس نباشد، lftp در تفکیک نام میزبان مشخص‌شده با شکست مواجه می‌شود. برای غیرفعال کردن، آن را روی «never» تنظیم کنید. .TP .BR dns:order " (list of protocol names)" ترتیب پرس‌وجوهای DNS را تعیین می‌کند. پیش‌فرض «inet6 inet» است که یعنی ابتدا جستجوی نشانی در خانوادهٔ inet6، سپس inet و استفاده از آن‌ها به همان ترتیب. برای غیرفعال کردن جستجوی inet6 (AAAA)، این متغیر را روی «inet» تنظیم کنید. .TP .BR dns:use-fork \ (boolean) اگر true باشد، lftp پیش از تفکیک نشانی میزبان، یک فرآیند منشعب (fork) خواهد کرد. پیش‌فرض true است. .TP .BR dns:max-retries \ (number) اگر صفر باشد، هیچ محدودیتی برای تعداد تلاش‌های lftp جهت جستجوی یک نشانی وجود ندارد. اگر > 0 باشد، lftp فقط به همین تعداد دفعه برای جستجوی نشانی هر خانوادهٔ نشانی در dns:order تلاش خواهد کرد. .TP .BR dns:name \ (string) این تنظیم می‌تواند برای جایگزینی یک نام مستعار میزبان با یک نام دیگر یا نشانی IP استفاده شود. نام مستعار میزبان به عنوان بستار (closure) تنظیم استفاده می‌شود و نام یا نشانی IP جایگزین در مقدار قرار می‌گیرد. نام‌ها یا نشانی‌های IP متعدد را می‌توان با کاما از هم جدا کرد. .TP .BR file:charset \ (string) مجموعه نویسه‌های محلی (local character set). در ابتدا بر اساس لوکال جاری مقداردهی می‌شود. .TP .BR file:use-lock \ (boolean) وقتی روی true باشد، lftp هنگام باز کردن فایل‌های محلی از قفل‌گذاری توصیه‌ای (advisory locking) استفاده می‌کند. .TP .BR file:use-fallocate \ (boolean) وقتی روی true باشد، lftp از fallocate(2) یا posix_fallocate(3) برای تخصیص پیشاپیش فضای ذخیره‌سازی و کاهش تکه‌تکه شدن فایل (fragmentation) در دستورهای pget و torrent استفاده می‌کند. .TP .BR fish:auto-confirm \ (boolean) وقتی روی true باشد، lftp به تمام پرسش‌های ssh، به‌ویژه پرسش دربارهٔ کلید میزبان جدید، پاسخ «yes» می‌دهد. در غیر این صورت «no» پاسخ می‌دهد. .TP .BR fish:charset \ (string) مجموعه نویسه‌های مورد استفاده توسط کارساز fish در درخواست‌ها، پاسخ‌ها و فهرست فایل‌ها. پیش‌فرض خالی است که به معنای همان محلی است. .TP .BR fish:connect-program \ (string) برنامه‌ای که برای اتصال به کارساز دوردست استفاده می‌شود. این برنامه باید از گزینهٔ «\-l» برای نام کاربری و «\-p» برای شماره درگاه پشتیبانی کند. پیش‌فرض «ssh \-a \-x» است. برای نمونه می‌توانید آن را روی «rsh» تنظیم کنید. برای احراز هویت با کلید خصوصی، گزینهٔ «\-i» را به همراه فایل کلید اضافه کنید. .TP .BR fish:shell \ (string) استفاده از پوستهٔ مشخص‌شده در سمت کارساز. پیش‌فرض /bin/sh است. در برخی سیستم‌ها، /bin/sh هنگام اجرای cd به یک دایرکتوری ناموجود خارج می‌شود. lftp می‌تواند این حالت را مدیریت کند اما مجبور به اتصال مجدد خواهد بود. در چنین سیستم‌هایی، در صورت نصب بودن bash، آن را روی /bin/bash تنظیم کنید. .TP .BR ftp:acct \ (string) ارسال این رشته در دستور ACCT پس از ورود به سیستم. نتیجه نادیده گرفته می‌شود. بستار (closure) برای این تنظیم قالبی به‌صورت \fIuser@host\fP دارد. .TP .BR ftp:anon-pass \ (string) گذرواژهٔ مورد استفاده برای احراز هویت در دسترسی ناشناس به FTP را تنظیم می‌کند. پیش‌فرض "lftp@" است. .TP .BR ftp:anon-user \ (string) نام کاربری مورد استفاده برای احراز هویت در دسترسی ناشناس به FTP را تنظیم می‌کند. پیش‌فرض "anonymous" است. .TP .BR ftp:auto-sync-mode \ (regex) اگر نخستین پیام کارساز با این عبارت باقاعده (regex) مطابقت داشته باشد، حالت همگام‌سازی (sync mode) برای آن میزبان فعال می‌شود. .TP .BR ftp:catch-size \ (boolean) هنگامی که پشتیبانی از دستور SIZE وجود ندارد، تلاش می‌کند اندازهٔ فایل را از پاسخ «150 Opening data connection» استخراج کند. .TP .BR ftp:charset \ (string) مجموعه نویسه‌های مورد استفاده توسط کارساز FTP در درخواست‌ها، پاسخ‌ها و فهرست فایل‌ها. پیش‌فرض خالی است که به معنای همان محلی است. این تنظیم تنها زمانی استفاده می‌شود که کارساز از UTF8 پشتیبانی نکند. .TP .BR ftp:client \ (string) نام کلاینت FTP برای ارسال با دستور CLNT، در صورتی که توسط کارساز پشتیبانی شود. اگر خالی باشد، هیچ دستور CLNT ارسال نخواهد شد. .TP .BR ftp:compressed-re \ (regex) فایل‌هایی با نام منطبق، فشرده تلقی می‌شوند و «MODE Z» برای آن‌ها استفاده نخواهد شد. .TP .BR ftp:bind-data-socket \ (boolean) اتصال (bind) سوکت داده به رابط (interface) اتصال کنترلی (در حالت غیرفعال / passive mode). پیش‌فرض true است؛ استثنا رابط loopback است. .TP .BR ftp:fix-pasv-address \ (boolean) اگر true باشد، در حالتی که نشانی کارساز در یک شبکهٔ عمومی باشد و PASV نشانی‌ای از یک شبکهٔ خصوصی برگرداند، lftp تلاش می‌کند نشانی بازگردانده‌شده توسط کارساز برای دستور PASV را اصلاح کند. در این حالت lftp نشانی کارساز را به‌جای نشانی بازگردانده‌شده توسط دستور PASV جایگزین می‌کند؛ شماره درگاه تغییری نخواهد کرد. پیش‌فرض true است..TP .BR ftp:fxp-passive-source \ (boolean) اگر true باشد، lftp ابتدا تلاش می‌کند سرور FTP مبدأ را در حالت passive تنظیم کند، در غیر این صورت سرور مقصد را. اگر تلاش نخست ناموفق باشد، lftp سعی می‌کند آن‌ها را به صورت معکوس تنظیم کند. اگر حالت دیگر نیز ناموفق باشد، lftp به کپی ساده بازمی‌گردد. همچنین ftp:use-fxp را ببینید. .TP .BR ftp:home \ (string) دایرکتوری اولیه. پیش‌فرض رشته خالی است که به معنای خودکار (auto) می‌باشد. اگر از ظاهر %2F در نشانی‌های اینترنتی (URL) مربوط به FTP خوشتان نمی‌آید، این مقدار را روی `/' تنظیم کنید. بستار (closure) برای این تنظیم دارای قالب \fIuser@host\fP است. .TP .BR ftp:ignore-pasv-address \ (boolean) اگر true باشد، lftp برای اتصال داده، به جای نشانی بازگردانده‌شده در پاسخ PASV از نشانی اتصال کنترل استفاده می‌کند. این گزینه می‌تواند برای NATهای معیوب مفید باشد. پیش‌فرض false است. .TP .BR ftp:list-empty-ok \ (boolean) اگر روی false تنظیم شود، فهرست‌های خالی حاصل از دستور LIST به عنوان نادرست تلقی می‌شوند و روش دیگری (NLST) استفاده خواهد شد. .TP .BR ftp:list-options \ (string) گزینه‌هایی را تنظیم می‌کند که همیشه به دستور LIST پیوست می‌شوند. اگر سرور فایل‌های نقطه‌دار (مخفی) را به طور پیش‌فرض نشان نمی‌دهد، تنظیم این گزینه روی `\-a' می‌تواند مفید باشد. پیش‌فرض خالی است. .TP .BR ftp:mode-z-level \ (number) سطح فشرده‌سازی (0-9) برای بارگذاری با MODE Z. .TP .BR ftp:nop-interval \ (seconds) تأخیر بین دستورهای NOOP هنگام دانلود انتهای یک فایل. این گزینه برای سرورهای FTP مفید است که پیام "Transfer complete" را پیش از تخلیه کامل (flush) انتقال داده ارسال می‌کنند. در چنین مواردی دستورهای NOOP می‌توانند از اتمام مهلت زمانی اتصال (timeout) جلوگیری کنند. .TP .BR ftp:passive-mode \ (boolean) حالت passive را در FTP تنظیم می‌کند. این گزینه زمانی که پشت یک فایروال یا یک مسیریاب ساده بازنشانی (dumb masquerading router) هستید می‌تواند مفید باشد. در حالت passive، برنامه lftp از دستور PASV استفاده می‌کند، نه دستور PORT که در حالت active به کار می‌رود. در حالت passive خود lftp اتصال داده را به سرور برقرار می‌کند؛ در حالت active سرور برای انتقال داده به lftp متصل می‌شود. حالت passive پیش‌فرض است. .TP .BR ftp:port-ipv4 " (ipv4 address)" یک نشانی IPv4 را برای ارسال با دستور PORT مشخص می‌کند. پیش‌فرض خالی است که به معنای ارسال نشانی سمت محلی اتصال کنترل می‌باشد. .TP .BR ftp:port-range \ (from-to) محدوده پورت مجاز برای سمت محلی اتصال داده. قالب آن min-max، یا `full' یا `any' برای مشخص کردن هر پورتی است. پیش‌فرض `full' است. .TP .BR ftp:prefer-epsv \ (boolean) استفاده از EPSV به عنوان حالت passive ترجیحی. پیش‌فرض `false' است. .TP .BR ftp:proxy \ (URL) پروکسی FTP مورد استفاده را مشخص می‌کند. برای غیرفعال کردن پروکسی، این مقدار را روی یک رشته خالی قرار دهید. توجه داشته باشید که این یک پروکسی FTP است که از پروتکل FTP استفاده می‌کند، نه FTP روی HTTP. مقدار پیش‌فرض از متغیر محیطی \fBftp_proxy\fP گرفته می‌شود اگر با ``ftp://'' آغاز شود. اگر پروکسی FTP شما نیازمند احراز هویت است، نام کاربری و گذرواژه را در URL مشخص کنید. اگر ftp:proxy با http:// آغاز شود، پروتکل hftp (پروتکل FTP روی پروکسی HTTP) به طور خودکار به جای FTP استفاده می‌شود. .TP .BR ftp:proxy-auth-type \ (string) هنگامی که روی ``joined'' تنظیم شود، lftp عبارت ``user@proxy_user@ftp.example.org'' را به عنوان نام کاربری و ``password@proxy_password'' را به عنوان گذرواژه به پروکسی ارسال می‌کند. .IP هنگامی که روی ``joined-acct'' تنظیم شود، lftp عبارت ``user@ftp.example.org proxy_user'' (همراه با فاصله) را به عنوان نام کاربری به پروکسی ارسال می‌کند. گذرواژه سایت طبق معمول ارسال می‌شود و انتظار می‌رود گذرواژه پروکسی در دستور بعدی ACCT ارسال شود. .IP هنگامی که روی ``open'' تنظیم شود، lftp ابتدا کاربر پروکسی و گذرواژه پروکسی و سپس ``OPEN ftp.example.org'' و در ادامه ``USER user'' را ارسال می‌کند. سپس گذرواژه سایت طبق معمول ارسال می‌شود. .IP هنگامی که روی ``user'' (پیش‌فرض) تنظیم شود، lftp ابتدا کاربر پروکسی و گذرواژه پروکسی و سپس ``user@ftp.example.org'' را به عنوان نام کاربری ارسال می‌کند. سپس گذرواژه سایت طبق معمول ارسال می‌شود. .IP هنگامی که روی ``proxy-user@host'' تنظیم شود، lftp ابتدا ``USER proxy_user@ftp.example.org'' و سپس گذرواژه پروکسی را ارسال می‌کند. سپس کاربر و گذرواژه سایت طبق معمول ارسال می‌شوند. .TP .BR ftp:rest-list \ (boolean) اجازه استفاده از دستور REST پیش از دستور LIST را می‌دهد. این قابلیت ممکن است برای دایرکتوری‌های بزرگ مفید باشد، اما برخی سرورهای FTP به طور خاموش REST قبل از LIST را نادیده می‌گیرند. .TP .BR ftp:rest-stor \ (boolean) اگر false باشد، lftp تلاشی برای استفاده از REST قبل از STOR نخواهد کرد. این گزینه می‌تواند برای برخی سرورهای دارای باگ مفید باشد که در صورت استفاده از REST به دنبال STOR، فایل را خراب می‌کنند (آن را با صفر پر می‌کنند). .TP .BR ftp:retry-530 \ (regex) در صورتی که متن با این عبارت باقاعده مطابقت داشته باشد، روی پاسخ 530 سرور برای دستور PASS تلاش مجدد صورت می‌گیرد. این تنظیم برای تمایز قائل شدن بین سرور دارای بار بیش از حد (وضعیت موقت) و گذرواژه نادرست (وضعیت دائمی) مفید خواهد بود. .TP .BR ftp:retry-530-anonymous \ (regex) عبارت باقاعده اضافی برای ورود ناشناس (anonymous)، مشابه ftp:retry-530. .TP .BR ftp:site-group \ (string) ارسال این رشته در دستور SITE GROUP پس از ورود. نتیجه نادیده گرفته می‌شود. بستار (closure) برای این تنظیم دارای قالب \fIuser@host\fP است. .TP .BR ftp:skey-allow \ (boolean) اجازه ارسال پاسخ skey/opie در صورتی که به نظر برسد سرور از آن پشتیبانی می‌کند. به طور پیش‌فرض روشن (on) است. .TP .BR ftp:skey-force \ (boolean) گذرواژه را به صورت متن آشکار (plain text) روی شبکه ارسال نمی‌کند و به جای آن از skey/opie استفاده می‌کند. اگر skey/opie در دسترس نباشد، ورود به سیستم ناموفق در نظر گرفته می‌شود. به طور پیش‌فرض خاموش (off) است. .TP .BR ftp:ssl-allow \ (boolean) اگر true باشد، برای دسترسی غیرناشناس (non-anonymous)، تلاش می‌کند اتصال SSL را با سرور FTP مذاکره کند. پیش‌فرض true است. این تنظیم و سایر تنظیمات SSL تنها زمانی در دسترس هستند که lftp همراه با یک کتابخانه ssl/tls کامپایل شده باشد. .TP .BR ftp:ssl-auth \ (string) آرگومان دستور AUTH؛ می‌تواند یکی از مقادیر SSL، TLS، TLS-P یا TLS-C باشد. برای توضیحات به RFC4217 مراجعه کنید. به طور پیش‌فرض بسته به پاسخ FEAT، از TLS یا SSL استفاده خواهد شد. .TP .BR ftp:ssl-data-use-keys \ (boolean) اگر true باشد، lftp برای اتصال داده حفاظت‌شده نیز ssl:key-file را بارگذاری می‌کند. زمانی که false باشد، این کار را انجام نمی‌دهد و سرور می‌تواند اتصالات داده و کنترل را با شناسه نشست (session ID) مطابقت دهد. پیش‌فرض true است. .TP .BR ftp:ssl-force \ (boolean) اگر true باشد، در صورتی که سرور از SSL پشتیبانی نکند، از ارسال گذرواژه به صورت آشکار (clear) خودداری می‌کند. پیش‌فرض false است. .TP .BR ftp:ssl-protect-data \ (boolean) اگر true باشد، برای انتقال داده درخواست اتصال SSL می‌کند. این کار حریم خصوصی و تصحیح خطای انتقال را فراهم می‌آورد. این ویژگی روی پردازنده‌های قدیمی نیازمند توان پردازشی بالا بود. پیش‌فرض true است. .TP .BR ftp:ssl-protect-fxp \ (boolean) اگر true باشد، برای انتقال داده بین دو سرور FTP در حالت FXP درخواست اتصال SSL می‌کند. در این صورت از دستور CPSV یا SSCN استفاده خواهد شد. اگر اتصال SSL به هر دلیلی ناموفق باشد، lftp انتقال محافظت‌نشده FXP را امتحان می‌کند، مگر اینکه ftp:ssl-force برای هر یک از دو سرور تنظیم شده باشد. پیش‌فرض true است. .TP .BR ftp:ssl-protect-list \ (boolean) اگر true باشد، برای انتقال فهرست فایل‌ها درخواست اتصال SSL می‌کند. پیش‌فرض true است. .TP .BR ftp:ssl-use-ccc \ (boolean) اگر true باشد، lftp پس از ورود دستور CCC را صادر می‌کند، و بدین ترتیب لایه حفاظتی ssl را روی اتصال کنترل غیرفعال می‌سازد. .TP .BR ftp:stat-interval " (time interval)" فاصله زمانی بین دستورهای STAT. پیش‌فرض ۱ ثانیه است. .TP .BR ftp:strict-multiline \ (boolean) هنگامی که true باشد، lftp قالب پاسخ چندخطی را به دقت بررسی می‌کند (انتظار دارد با همان کدی که آغاز شده است پایان یابد). هنگامی که false باشد، این بررسی سهل‌گیرانه‌تر است. .TP .BR ftp:sync-mode \ (boolean) اگر true باشد، lftp در هر زمان یک دستور را ارسال می‌کند و منتظر پاسخ می‌ماند. این گزینه در صورتی که از یک سرور FTP یا مسیریاب دارای باگ استفاده می‌کنید می‌تواند مفید باشد. هنگامی که off باشد، lftp دسته‌ای از دستورها را ارسال کرده و منتظر پاسخ‌ها می‌ماند؛ این کار زمانی که زمان رفت‌وبرگشت (round trip time) قابل توجه باشد، به عملیات سرعت می‌بخشد. متأسفانه این قابلیت با همه سرورهای FTP کار نمی‌کند و برخی مسیریاب‌ها با آن مشکل دارند، از این رو به طور پیش‌فرض on است. .TP .BR ftp:timezone \ (string) این منطقه زمانی را برای زمان در فهرست‌های بازگردانده‌شده توسط دستور LIST در نظر می‌گیرد. این تنظیم می‌تواند اختلاف از GMT به صورت [+|-]HH[:MM[:SS]] یا هر مقدار معتبر TZ (مانند Europe/Moscow یا MSK-3MSD,M3.5.0,M10.5.0/3) باشد. پیش‌فرض GMT است. این مقدار را روی یک رشته خالی تنظیم کنید تا منطقه زمانی محلی مشخص‌شده توسط متغیر محیطی TZ فرض شود. .TP .BR ftp:too-many-re \ (regexp) کاهش محدودیت پویای اتصال هنگامی که خط پاسخ 421 با این عبارت باقاعده مطابقت داشته باشد. .TP .BR ftp:trust-feat \ (string) هنگامی که true باشد، فرض می‌کند که داده‌های بازگردانده‌شده توسط FEAT صحیح هستند و در صورتی که پسوندهای متداول پروتکل مانند SIZE، MDTM و REST فهرست نشده باشند، از آن‌ها استفاده نمی‌کند. پیش‌فرض false است. .TP .BR ftp:use-abor \ (boolean) اگر false باشد، lftp دستور ABOR را ارسال نمی‌کند بلکه فوراً اتصال داده را می‌بندد. .TP .BR ftp:use-allo \ (boolean) هنگامی که true باشد، lftp پیش از بارگذاری فایل، دستور ALLO را ارسال می‌کند..TP .BR ftp:use-feat \ (boolean) وقتی درست (پیش‌فرض) باشد، lftp از دستور FEAT برای تعیین ویژگی‌های گسترش‌یافتهٔ کارساز ftp استفاده می‌کند. .TP .BR ftp:use-fxp \ (boolean) اگر درست باشد، lftp سعی خواهد کرد اتصال مستقیمی بین دو کارساز ftp برقرار کند. .TP .BR ftp:use-hftp \ (boolean) وقتی ftp:proxy به یک پراکسی http اشاره دارد، این تنظیم در صورت درست بودن روش hftp‏ (GET، HEAD) و در صورت نادرست بودن روش CONNECT را انتخاب می‌کند. پیش‌فرض true است. .TP .BR ftp:use-ip-tos \ (boolean) وقتی درست باشد، lftp برای اتصال کنترلی از IPTOS_LOWDELAY و برای اتصالات داده از IPTOS_THROUGHPUT استفاده می‌کند. .TP .BR ftp:lang \ (boolean) زبانی که با دستور LANG انتخاب می‌شود، در صورت پشتیبانی بر اساس پاسخ FEAT. پیش‌فرض خالی است که به معنی پیش‌فرض کارساز می‌باشد. .TP .BR ftp:use-mdtm \ (boolean) وقتی درست (پیش‌فرض) باشد، lftp از دستور MDTM برای تعیین زمان تغییر فایل استفاده می‌کند. .TP .BR ftp:use-mdtm-overloaded \ (boolean) وقتی درست باشد، lftp از دستور دو آرگومانی MDTM برای تنظیم زمان تغییر فایل روی فایل‌های بارگذاری‌شده استفاده می‌کند. پیش‌فرض false است. .TP .BR ftp:use-mlsd \ (boolean) وقتی درست باشد، lftp در صورت پشتیبانی کارساز، از دستور MLSD برای فهرست کردن دایرکتوری استفاده خواهد کرد. .TP .BR ftp:use-mode-z \ (boolean) وقتی درست باشد، lftp در صورت پشتیبانی کارساز از «MODE Z» برای انجام انتقال‌های فشرده استفاده خواهد کرد. .TP .BR ftp:use-pret " (tri-boolean)" وقتی روی auto تنظیم شود، استفاده از دستور PRET به پاسخ کارساز به FEAT بستگی دارد. در غیر این صورت این تنظیم مشخص می‌کند که آیا از آن استفاده شود یا خیر. دستور PRET پیش از دستورهای PORT یا PASV، کارساز را از فایلی که باید منتقل شود آگاه می‌سازد تا کارساز بتواند پارامترهای اتصال داده را تنظیم کند. .TP .BR ftp:use-site-idle \ (boolean) وقتی درست باشد، lftp دستور `SITE IDLE' را با آرگومان net:idle ارسال می‌کند. پیش‌فرض false است. .TP .BR ftp:use-site-utime \ (boolean) وقتی درست باشد، lftp دستور ۵ آرگومانی `SITE UTIME' را برای تنظیم زمان تغییر فایل روی فایل‌های بارگذاری‌شده ارسال می‌کند. پیش‌فرض true است. .TP .BR ftp:use-site-utime2 \ (boolean) وقتی درست باشد، lftp دستور ۲ آرگومانی `SITE UTIME' را برای تنظیم زمان تغییر فایل روی فایل‌های بارگذاری‌شده ارسال می‌کند. پیش‌فرض true است. اگر `SITE UTIME' ۵ آرگومانی نیز فعال باشد، ابتدا دستور ۲ آرگومانی امتحان می‌شود. .TP .BR ftp:use-size \ (boolean) وقتی درست (پیش‌فرض) باشد، lftp از دستور SIZE برای تعیین اندازهٔ فایل استفاده می‌کند. .TP .BR ftp:use-stat \ (boolean) اگر درست باشد، lftp در انتقال حالت FXP دستور STAT را ارسال می‌کند تا بداند چه مقدار داده منتقل شده است. همچنین ftp:stat-interval را ببینید. پیش‌فرض true است. .TP .BR ftp:use-stat-for-list \ (boolean) وقتی درست باشد، lftp به جای دستور LIST از STAT استفاده می‌کند. به‌طور پیش‌فرض `.' به عنوان آرگومان STAT استفاده می‌شود. با استفاده از STAT، برنامهٔ lftp از ایجاد اتصال داده برای فهرست کردن دایرکتوری اجتناب می‌کند. برخی کارسازها به گزینه‌های خاصی برای STAT نیاز دارند، برای مشخص کردن آن‌ها از ftp:list-options استفاده کنید (برای مثال \fB\-la\fP). .TP .BR ftp:use-telnet-iac \ (boolean) وقتی درست (پیش‌فرض) باشد، lftp از دستور TELNET IAC استفاده می‌کند و پروتکل TELNET را همان‌طور که در RFC959 مشخص شده است دنبال می‌کند. وقتی نادرست باشد، پروتکل TELNET را دنبال نمی‌کند و در نتیجه نویسهٔ 255 (0xFF, 0377) را دو برابر نمی‌کند و دستورهای ABOR و STAT را با سیگنال TELNET IP+SYNCH پیشوندگذاری نمی‌کند. .TP .BR ftp:use-tvfs " (tri-boolean)" وقتی روی auto تنظیم شود، استفاده از ویژگی TVFS به پاسخ کارساز به FEAT بستگی دارد. در غیر این صورت این تنظیم مشخص می‌کند که آیا از آن استفاده شود یا خیر. به طور خلاصه، اگر یک کارساز از ویژگی TVFS پشتیبانی کند، از مسیرهای شبه‌یونیکس استفاده می‌کند. .TP .BR ftp:use-utf8 \ (boolean) اگر درست باشد، lftp دستور `OPTS UTF8 ON' را برای فعال کردن کدگذاری UTF-8 (در صورت پشتیبانی) به کارساز ارسال می‌کند. در صورتی که نام‌های فایل کدگذاری متفاوتی دارند و کارساز با آن مشکل دارد، آن را غیرفعال کنید. .TP .BR ftp:use-quit " (boolean)" اگر درست باشد، lftp پیش از قطع اتصال از کارساز ftp، دستور QUIT را ارسال می‌کند. پیش‌فرض true است. .TP .BR ftp:verify-address \ (boolean) بررسی می‌کند که اتصال داده از نشانی شبکهٔ همان همتای اتصال کنترلی آمده باشد. این می‌تواند احتمالاً از جعل اتصال داده که می‌تواند منجر به تخریب داده شود جلوگیری کند. متأسفانه این بررسی ممکن است در برخی کارسازهای ftp با چندین رابط شبکه، در صورتی که نشانی خروجی را روی سوکت داده تنظیم نکنند با شکست مواجه شود؛ بنابراین به‌طور پیش‌فرض غیرفعال است. .TP .BR ftp:verify-port \ (boolean) بررسی می‌کند که انتهای دوردست اتصال داده دارای پورت 20 (ftp-data) باشد. این می‌تواند احتمالاً از جعل اتصال داده توسط کاربران میزبان دوردست جلوگیری کند. متأسفانه، کارسازهای ویندوزی و حتی یونیکسی زیادی تنظیم پورت مناسب روی اتصال داده را فراموش می‌کنند، بنابراین این بررسی به‌طور پیش‌فرض خاموش است. .TP .BR ftp:web-mode \ (boolean) پس از بستن اتصال داده قطع ارتباط می‌کند. این می‌تواند برای کارسازهای ftp که کاملاً خراب هستند مفید باشد. پیش‌فرض false است. .TP .BR ftps:initial-prot \ (string) تنظیم اولیهٔ PROT را برای اتصالات FTPS مشخص می‌کند. باید یکی از موارد C، S، E، P یا خالی باشد. مقدار پیش‌فرض خالی است که به معنی ناشناخته است، به طوری که lftp بدون قید و شرط از دستور PROT استفاده خواهد کرد. اگر مشخص شود دستور PROT پشتیبانی نمی‌شود، حالت Clear در نظر گرفته می‌شود. .TP .BR hftp:cache \ (boolean) اجازهٔ کش کردن در سمت کارساز/پراکسی برای پروتکل ftp-over-http. .TP .BR hftp:cache-control \ (string) سرفصل متناظر در درخواست HTTP را مشخص می‌کند. .TP .BR hftp:decode \ (boolean) وقتی درست باشد، lftp در پروتکل hftp به‌طور خودکار موجودیت را هنگامی که مقدار سرفصل Content-Encoding با deflate، gzip، compress، x-gzip یا x-compress تطابق داشته باشد رمزگشایی می‌کند. .TP .BR hftp:proxy \ (URL) پراکسی HTTP را برای پروتکل FTP-over-HTTP‏ (hftp) مشخص می‌کند. مسلماً پروتکل hftp نمی‌تواند بدون پراکسی HTTP کار کند. مقدار پیش‌فرض از متغیر محیطی \fBftp_proxy\fP در صورتی که با «http://» شروع شود، و در غیر این صورت از متغیر محیطی \fBhttp_proxy\fP گرفته می‌شود. اگر پراکسی FTP شما نیاز به احراز هویت دارد، نام کاربری و گذرواژه را در URL مشخص کنید. .TP .BR hftp:use-allprop \ (boolean) اگر درست باشد، lftp بدنهٔ درخواست `' را در درخواست‌های `PROPFIND' ارسال می‌کند، در غیر این صورت یک بدنهٔ درخواست خالی ارسال خواهد کرد. .TP .BR hftp:use-authorization \ (boolean) اگر روی off تنظیم شود، lftp گذرواژه را به عنوان بخشی از URL به پراکسی ارسال می‌کند. این ممکن است برای برخی پراکسی‌ها (مانند M-soft) لازم باشد. پیش‌فرض on است و lftp گذرواژه را به عنوان بخشی از سرفصل Authorization ارسال خواهد کرد. .TP .BR hftp:use-head \ (boolean) اگر روی off تنظیم شود، lftp سعی خواهد کرد برای پروتکل hftp به جای `HEAD' از `GET' استفاده کند. در حالی که این کندتر است، ممکن است به lftp اجازه دهد با برخی پراکسی‌ها که درخواست‌های «HEAD ftp://» را متوجه نمی‌شوند یا به نادرستی پردازش می‌کنند، کار کند. .TP .BR hftp:use-mkcol \ (boolean) اگر روی off تنظیم شود، lftp سعی خواهد کرد برای ایجاد دایرکتوری‌ها با پروتکل hftp به جای `MKCOL' از `PUT' استفاده کند. پیش‌فرض off است. .TP .BR hftp:use-propfind \ (boolean) اگر روی off تنظیم شود، lftp سعی نخواهد کرد برای دریافت محتویات دایرکتوری با پروتکل hftp از `PROPFIND' استفاده کند و به جای آن از `GET' استفاده می‌کند. پیش‌فرض off است. در صورت فعال بودن، lftp پس از بارگذاری از PROPPATCH نیز برای تنظیم زمان تغییر فایل استفاده خواهد کرد. .TP .BR hftp:use-range \ (boolean) وقتی درست باشد، lftp از سرفصل Range برای ازسرگیری انتقال استفاده خواهد کرد. .TP .BR hftp:use-type \ (boolean) اگر روی off تنظیم شود، lftp سعی نخواهد کرد `;type=' را به URLهای ارسال‌شده به پراکسی اضافه کند. برخی پراکسی‌های معیوب آن را به درستی پردازش نمی‌کنند. پیش‌فرض on است. .TP .BR "http:accept, http:accept-charset, http:accept-encoding, http:accept-language" " (string)" سرفصل‌های متناظر درخواست HTTP را مشخص می‌کنند. .TP .BR http:authorization \ (string) احراز هویتی که در صورت عدم تعیین کاربر، به‌طور پیش‌فرض استفاده می‌شود. قالب آن «user:password» است. پیش‌فرض خالی است که به معنی بدون احراز هویت است. .TP .BR http:cache \ (boolean) اجازهٔ کش کردن در سمت کارساز/پراکسی. .TP .BR http:cache-control \ (string) سرفصل متناظر در درخواست HTTP را مشخص می‌کند. .TP .BR http:cookie \ (string) ارسال این کوکی به کارساز. در اینجا یک بستار (closure) مفید است: set cookie/www.somehost.com "param=value" .TP .BR http:decode \ (boolean) وقتی درست باشد، lftp به‌طور خودکار موجودیت را هنگامی که مقدار سرفصل Content-Encoding با deflate، gzip، compress، x-gzip یا x-compress تطابق دارد رمزگشایی می‌کند. .TP .BR http:post-content-type " (string)" مقدار سرفصل Content-Type در درخواست HTTP را برای روش POST مشخص می‌کند. پیش‌فرض «application/x-www-form-urlencoded» است..TP .BR http:proxy \ (URL) پروکسی HTTP را مشخص می‌کند. هنگامی که lftp بر روی پروتکل HTTP کار می‌کند، استفاده می‌شود. مقدار پیش‌فرض از متغیر محیطی \fBhttp_proxy\fP گرفته می‌شود. اگر پروکسی شما نیاز به احراز هویت دارد، نام کاربری و گذرواژه را در URL مشخص کنید. .TP .BR http:put-method " (PUT or POST)" مشخص می‌کند هنگام ارسال (put) از کدام متد HTTP استفاده شود. .TP .BR http:put-content-type " (string)" مقدار سرآیند درخواست HTTP با عنوان Content-Type را برای متد PUT مشخص می‌کند. .TP .BR http:referer " (string)" مقدار سرآیند درخواست HTTP با عنوان Referer را مشخص می‌کند. تک‌نقطه «.» به URL دایرکتوری جاری بسط می‌یابد. مقدار پیش‌فرض «.» است. برای غیرفعال کردن سرآیند Referer آن را روی یک رشته خالی تنظیم کنید. .TP .BR http:set-cookies " (boolean)" اگر درست (true) باشد، lftp هنگام دریافت سرآیند Set-Cookie متغیرهای http:cookie را تغییر می‌دهد. .TP .BR http:use-allprop \ (boolean) اگر درست باشد، lftp بدنه درخواست «» را در درخواست‌های «PROPFIND» ارسال می‌کند، در غیر این صورت یک بدنه درخواست خالی می‌فرستد. .TP .BR http:use-mkcol \ (boolean) اگر روی خاموش (off) تنظیم شود، lftp تلاش می‌کند به‌جای «MKCOL» از «PUT» برای ساخت دایرکتوری‌ها با پروتکل HTTP استفاده کند. پیش‌فرض روشن (on) است. .TP .BR http:use-propfind \ (boolean) اگر روی خاموش تنظیم شود، lftp تلاشی برای استفاده از «PROPFIND» جهت دریافت محتویات دایرکتوری با پروتکل HTTP نمی‌کند و در عوض از «GET» استفاده خواهد کرد. مقدار پیش‌فرض off است. هنگام فعال بودن، lftp پس از بارگذاری فایل، از PROPPATCH نیز برای تنظیم مشخصه «Last-Modified» استفاده می‌کند. .TP .BR http:use-range \ (boolean) هنگامی که درست باشد، lftp از سرآیند Range برای ازسرگیری انتقال استفاده خواهد کرد. .TP .BR http:user-agent " (string)" رشته‌ای که lftp در سرآیند User-Agent درخواست HTTP ارسال می‌کند. .TP .BR https:proxy " (string)" پروکسی https را مشخص می‌کند. مقدار پیش‌فرض از متغیر محیطی \fBhttps_proxy\fP گرفته می‌شود. .TP .BR log:enabled \ (boolean) هنگامی که درست باشد، پیام‌های گزارش خروجی داده می‌شوند. کلوژر (closure) برای این متغیر و دیگر متغیرهای «log:» یا «debug» برای پیام‌های اشکال‌زدایی است یا «xfer» برای گزارش انتقال‌ها. .TP .BR log:file " (string)" فایل خروجی مقصد برای گزارش‌گیری. هنگامی که خالی باشد، از \fBstderr\fP استفاده می‌شود. .TP .BR log:level " (number)" سطح پرگویی گزارش‌گیری. در حال حاضر فقط برای کلوژر «debug» تعریف شده است. .TP .BR log:max-size " (number)" حداکثر اندازه فایل گزارش. هنگامی که اندازه به این حد برسد، نام فایل تغییر کرده و از نو آغاز می‌شود. .TP .BR log:prefix-error " (string)" .TP .BR log:prefix-note " (string)" .TP .BR log:prefix-recv " (string)" .TP .BR log:prefix-send " (string)" پیشوندهای مربوط به انواع متناظر پیام‌های اشکال‌زدایی. .TP .BR log:show-ctx \ (boolean) .TP .BR log:show-pid \ (boolean) .TP .BR log:show-time \ (boolean) انتخاب اطلاعات تکمیلی در پیام‌های گزارش. .TP .BR mirror:dereference " (boolean)" هنگامی که درست باشد، mirror به‌طور پیش‌فرض پیوندهای نمادین را دنبال (dereference) می‌کند. می‌توانید آن را با گزینه \-\-no\-dereference لغو کنید. مقدار پیش‌فرض نادرست (false) است. .TP .BR mirror:exclude-regex " (regex)" الگوی پیش‌فرض برای مستثنی کردن را مشخص می‌کند. می‌توانید آن را با گزینه \-\-include بازنویسی کنید. .TP .BR mirror:include-regex " (regex)" الگوی پیش‌فرض برای گنجاندن را مشخص می‌کند. این الگو درست پس از اعمال mirror:exclude-regex استفاده می‌شود. اگر mirror:exclude-regex خالی باشد، هرگز به کار نخواهد رفت. .TP .BR mirror:no-empty-dirs " (boolean)" هنگامی که درست باشد، mirror دایرکتوری‌های خالی را نمی‌سازد (مشابه گزینه \-\-no\-empty\-dirs). .TP .BR mirror:sort-by " (string)" ترتیب انتقال فایل‌ها را مشخص می‌کند. مقادیر معتبر عبارتند از: name، name-desc، size، size-desc، date، date-desc. وقتی مقدار name یا name-desc باشد، تنظیم mirror:order نیز بر ترتیب انتقال‌ها اثر می‌گذارد. .TP .BR mirror:order " (list of patterns)" ترتیب انتقال فایل‌ها را هنگام مرتب‌سازی بر اساس نام مشخص می‌کند. برای نمونه، تنظیم این مقدار روی «*.sfv *.sum» باعث می‌شود mirror ابتدا فایل‌های منطبق با *.sfv، سپس منطبق با *.sum و پس از آن تمامی فایل‌های دیگر را انتقال دهد. برای پردازش دایرکتوری‌ها پس از سایر فایل‌ها، «*/» را به انتهای فهرست الگوها بیفزایید. .TP .BR mirror:overwrite " (boolean)" هنگامی که درست باشد، mirror به‌جای حذف و ایجاد مجدد فایل‌های عادی، بر روی آن‌ها رونویسی می‌کند. .TP .BR mirror:parallel-directories " (boolean)" اگر درست باشد، هنگامی که در حالت موازی قرار دارد، mirror پردازش چندین دایرکتوری را به‌صورت موازی آغاز خواهد کرد. در غیر این صورت، پیش از رفتن به دایرکتوری‌های دیگر، فایل‌ها را از یک دایرکتوری واحد منتقل می‌کند. .TP .BR mirror:parallel-transfer-count " (number)" تعداد انتقال‌های موازی مجاز برای آغاز توسط mirror را مشخص می‌کند. می‌توانید آن را با گزینه \-\-parallel بازنویسی کنید. یک کلوژر می‌تواند در برابر نام‌های میزبان مبدا یا مقصد تطبیق داده شود؛ کمترین عدد بزرگ‌تر از ۰ استفاده خواهد شد. .TP .BR mirror:require-source \ (boolean) هنگامی که درست باشد، mirror الزام می‌کند که دایرکتوری مبدا به‌طور صریح مشخص شود، در غیر این صورت فرض بر این خواهد بود که دایرکتوری جاری است. .TP .BR mirror:set-permissions \ (boolean) هنگامی که روی خاموش تنظیم شود، mirror تلاشی برای کپی مجوزهای فایل و دایرکتوری نخواهد کرد. می‌توانید آن را با گزینه \-\-perms بازنویسی کنید. مقدار پیش‌فرض روشن (on) است. .TP .BR mirror:skip-noaccess \ (boolean) هنگامی که درست باشد، mirror تلاشی برای بارگیری فایل‌هایی که بر اساس ماسک مجوزها آشکارا غیرقابل‌دسترس هستند انجام نمی‌دهد. مقدار پیش‌فرض نادرست (false) است. .TP .BR mirror:use-pget-n " (number)" گزینه \-n را برای دستور pget که جهت انتقال تک‌تک فایل‌ها تحت mirror استفاده می‌شود، مشخص می‌کند. یک کلوژر می‌تواند در برابر نام‌های میزبان مبدا یا مقصد تطبیق داده شود؛ کمترین عدد بزرگ‌تر از ۰ استفاده خواهد شد. هنگامی که مقدار کمتر از ۲ باشد، pget استفاده نمی‌شود. .TP .BR module:path \ (string) فهرستی از دایرکتوری‌ها جدا شده با دو‌نقطه (:) برای جستجوی ماژول‌ها. می‌تواند توسط متغیر محیطی LFTP_MODULE_PATH مقداردهی اولیه شود. مقدار پیش‌فرض «PKGLIBDIR/VERSION:PKGLIBDIR» است. .TP .BR net:connection-limit \ (number) حداکثر تعداد اتصال‌های هم‌زمان به یک سایت یکسان. ۰ به معنای نامحدود است. .TP .BR net:connection-limit-timer " (time interval)" محدودیت پویای اتصال پس از این بازه زمانی افزایش می‌یابد. .TP .BR net:connection-takeover \ (boolean) اگر درست باشد، اتصال‌های پیش‌زمینه بر اتصال‌های پس‌زمینه اولویت دارند و می‌توانند برای تکمیل یک عملیات پیش‌زمینه، انتقال‌های پس‌زمینه را قطع کنند. .TP .BR net:idle " (time interval)" قطع اتصال از سرور پس از این مدت زمان بی‌کاری. مقدار پیش‌فرض ۳ دقیقه است. .TP .BR net:limit-rate " (bytes per second)" محدود کردن نرخ انتقال روی اتصال داده. ۰ به معنی نامحدود است. می‌توانید دو عدد جدا شده با دو‌نقطه را برای محدود کردن جداگانه نرخ بارگیری و بارگذاری مشخص کنید. پسوندها پشتیبانی می‌شوند، برای نمونه 100K به معنی 102400 است. .TP .BR net:limit-max \ (bytes) محدود کردن انباشت limit-rate استفاده‌نشده. ۰ به معنی دو برابر limit-rate است. .TP .BR net:limit-total-rate " (bytes per second)" محدود کردن مجموع نرخ انتقال تمامی اتصالات. ۰ به معنای نامحدود است. می‌توانید دو عدد جدا شده با دو‌نقطه را برای محدود کردن جداگانه نرخ بارگیری و بارگذاری مشخص کنید. توجه داشته باشید که سوکت‌ها دارای بافرهای دریافت هستند؛ این امر می‌تواند درست پس از آغاز انتقال، منجر به بار پیوند شبکه بالاتر از این محدودیت نرخ شود. می‌توانید مقدار net:socket-buffer را روی مقداری نسبتاً کوچک تنظیم کنید تا از این مشکل جلوگیری شود. .PP اگر یک کلوژر مشخص کنید، محدودیت نرخ بر روی مجموع اتصالات به یک میزبان منطبق اعمال خواهد شد. .TP .BR net:limit-total-max \ (bytes) محدود کردن انباشت limit-total-rate استفاده‌نشده. ۰ به معنی دو برابر limit-total-rate است. .TP .BR net:max-retries \ (number) حداکثر تعداد تلاش‌های متوالی بدون موفقیت برای یک عملیات. ۰ به معنای نامحدود است. ۱ به معنای عدم تلاش مجدد است. .TP .BR net:no-proxy \ (string) شامل فهرستی از دامنه‌ها با جداکننده کاما که پروکسی نباید برای آن‌ها استفاده شود. مقدار پیش‌فرض از متغیر محیطی \fBno_proxy\fP گرفته می‌شود. .TP .BR net:persist-retries " (number)" نادیده گرفتن این تعداد از خطاهای سخت (hard errors). این ویژگی برای ورود به سرورهای FTP دارای اشکال که هنگام وجود کاربران بیش از حد، پاسخ 5xx می‌دهند کاربرد دارد. .TP .BR net:reconnect-interval-base \ (seconds) حداقل زمان پایه بین تلاش‌های اتصال مجدد را تعیین می‌کند. بازه زمانی واقعی به net:reconnect-interval-multiplier و تعداد تلاش‌ها برای انجام یک عملیات بستگی دارد..TP .BR net:reconnect-interval-max \ (ثانیه) بیشینه بازه زمانی اتصال مجدد را تنظیم می‌کند. هنگامی که بازه فعلی پس از ضرب در net:reconnect-interval-multiplier به این مقدار برسد (یا از آن فراتر رود)، دوباره به net:reconnect-interval-base بازنشانی می‌شود. .TP .BR net:reconnect-interval-multiplier \ (عدد\ حقیقی) ضریبی را مشخص می‌کند که با هر بار شکست در تلاش برای انجام عملیات، بازه پایه در آن ضرب می‌شود. هنگامی که بازه به بیشینه مقدار برسد، به مقدار پایه بازنشانی می‌شود. net:reconnect-interval-base و net:reconnect-interval-max را ببینید. .TP .BR net:socket-bind-ipv4 " (نشانی IPv4)" تمام سوکت‌های IPv4 را به نشانی مشخص‌شده مقید (bind) می‌کند. این گزینه می‌تواند برای انتخاب یک رابط شبکه خاص جهت استفاده، مفید باشد. پیش‌فرض خالی است که به معنای عدم مقیدسازی سوکت‌های IPv4 است؛ سیستم‌عامل به‌طور خودکار با استفاده از جدول مسیریابی یک نشانی را انتخاب خواهد کرد. .TP .BR net:socket-bind-ipv6 " (نشانی IPv6)" مشابه مورد قبل برای سوکت‌های IPv6. .TP .BR net:socket-buffer \ (بایت) اندازه داده‌شده را برای گزینه‌های سوکت SO_SNDBUF و SO_RCVBUF به کار می‌برد. مقدار 0 به معنای پیش‌فرض سیستم است. .TP .BR net:socket-maxseg \ (بایت) اندازه داده‌شده را برای گزینه سوکت TCP_MAXSEG به کار می‌برد. همه سیستم‌عامل‌ها از این گزینه پشتیبانی نمی‌کنند، اما لینوکس پشتیبانی می‌کند. .TP .BR net:timeout " (بازه زمانی)" مهلت زمانی (timeout) پروتکل شبکه را تعیین می‌کند. .TP .BR pget:default-n \ (عدد) تعداد پیش‌فرض قطعات برای تقسیم فایل در pget. .TP .BR pget:min-chunk-size \ (عدد) حداقل اندازه قطعه برای تقسیم فایل. .TP .BR pget:save-status " (بازه زمانی)" وضعیت انتقال pget را در این فواصل زمانی ذخیره می‌کند. برای غیرفعال کردن ذخیره فایل وضعیت، آن را روی \(lqnever\(rq تنظیم کنید. وضعیت در فایلی با پسوند \fI.lftp-pget-status\fP ذخیره می‌شود. .TP .BR sftp:auto-confirm \ (بولی) هنگامی که true باشد، lftp به تمام پرسش‌های ssh، به‌ویژه پرسش درباره کلید میزبان جدید، پاسخ \(lqyes\(rq می‌دهد. در غیر این صورت پاسخ \(lqno\(rq می‌دهد. .TP .BR sftp:charset \ (رشته) مجموعه نویسه‌های مورد استفاده توسط سرور SFTP در نام فایل‌ها و فهرست فایل‌ها. پیش‌فرض خالی است که به معنای همان کدبندی محلی است. این تنظیم تنها برای نسخه‌های پروتکل SFTP پیش از نسخه 4 استفاده می‌شود. نسخه 4 و بالاتر همواره از UTF-8 استفاده می‌کنند. .TP .BR sftp:connect-program \ (رشته) برنامه‌ای که برای اتصال به سرور دوردست استفاده می‌شود. این برنامه باید از گزینه \(lq\-l\(rq برای نام کاربری و \(lq\-p\(rq برای شماره پورت پشتیبانی کند. مقدار پیش‌فرض \(lqssh \-a \-x\(rq است. برای احراز هویت با کلید خصوصی، گزینه \(lq\-i\(rq را به همراه فایل کلید اضافه کنید. .TP .BR sftp:max-packets-in-flight \ (عدد) حداکثر تعداد بسته‌های بدون پاسخ در حال انتقال (in-flight). اگر زمان رفت و برگشت (round trip time) قابل توجه است، باید این مقدار و size-read/size-write را افزایش دهید. پیش‌فرض 16 است. .TP .BR sftp:protocol-version \ (عدد) شماره پروتکل برای مذاکره (negotiate). پیش‌فرض 6 است. نسخه پروتکل واقعیِ استفاده‌شده به سرور بستگی دارد. .TP .BR sftp:server-program \ (رشته) برنامه سرور که پروتکل SFTP را پیاده‌سازی می‌کند. اگر حاوی ممیز \(lq/\(rq نباشد، یک زیرسیستم ssh2 در نظر گرفته می‌شود و هنگام اجرای connect-program از گزینه \-s استفاده می‌گردد. پیش‌فرض \(lqsftp\(rq است. می‌توانید از rsh به عنوان پروتکل لایه انتقال به این صورت استفاده کنید: .Ds set sftp:connect-program rsh set sftp:server-program /usr/libexec/openssh/sftp-server .De به همین ترتیب می‌توانید SFTP را بر بستر SSH1 اجرا کنید. .TP .BR sftp:size-read \ (عدد) اندازه بلوک برای خواندن. پیش‌فرض 0x8000 است. .TP .BR sftp:size-write \ (عدد) اندازه بلوک برای نوشتن. پیش‌فرض 0x8000 است. .TP .BR ssl:ca-file " (مسیر فایل)" استفاده از فایل مشخص‌شده به عنوان گواهی مرجع صدور گواهی (CA). .TP .BR ssl:ca-path " (مسیر دایرکتوری)" استفاده از دایرکتوری مشخص‌شده به عنوان مخزن گواهی‌های مرجع صدور گواهی (فقط در OpenSSL). .TP .BR ssl:check-hostname " (بولی)" هنگامی که true باشد، lftp بررسی می‌کند که آیا نام میزبان استفاده‌شده برای اتصال به سرور با نام میزبان موجود در گواهی آن مطابقت دارد یا خیر. .TP .BR ssl:crl-file " (مسیر فایل)" استفاده از فایل مشخص‌شده به عنوان گواهی فهرست ابطال گواهی (CRL). .TP .BR ssl:crl-path " (مسیر دایرکتوری)" استفاده از دایرکتوری مشخص‌شده به عنوان مخزن گواهی‌های فهرست ابطال گواهی (فقط در OpenSSL). .TP .BR ssl:key-file " (مسیر فایل)" استفاده از فایل مشخص‌شده به عنوان کلید خصوصی شما. این تنظیم تنها برای پروتکل‌های ftps و https استفاده می‌شود. برای پروتکل‌های sftp و fish به ترتیب از sftp:connect-program و fish:connect-program استفاده کنید (گزینه \(lq\-i\(rq را به ssh اضافه نمایید). .TP .BR ssl:cert-file " (مسیر فایل)" استفاده از فایل مشخص‌شده به عنوان گواهی شما. .TP .BR ssl:use-sni \ (بولی) هنگامی که true باشد، از افزونه Server Name Indication (SNI) در TLS استفاده می‌شود. .TP .BR ssl:verify-certificate \ (بولی) اگر روی yes تنظیم شود، گواهی سرور بررسی می‌شود تا توسط یک مرجع صدور گواهی (CA) شناخته‌شده امضا شده باشد و در فهرست ابطال گواهی (CRL) قرار نداشته باشد. می‌توانید نام میزبان یا اثرانگشت (fingerprint) گواهی را در closure مشخص کنید. .TP .BR ssl:priority " (رشته)" رشته اولویت با قالب آزاد برای GnuTLS. مثال برای TLS 1.2: .Ds set ssl:priority "NORMAL:\-VERS\-SSL3.0:\-VERS\-TLS1.0:\-VERS\-TLS1.1:+VERS\-TLS1.2:\-VERS-TLS1.3" .De .RS اگر با OpenSSL ساخته شده باشد، یک نسخه شبیه‌سازی‌شده عبارت است از \fI\-\fP (\fI\+\fP هیچ تاثیری ندارد) به دنبال SSL3.0، TLS1.0، TLS1.1، TLS1.2 که با \fB:\fP از هم جدا شده‌اند. مثال برای TLS 1.3: .RE .Ds set ssl:priority "NORMAL:\-SSL3.0:\-TLS1.0:\-TLS1.1:-TLS1.2" .De .TP .BR torrent:ip " (نشانی IPv4)" نشانی IP برای ارسال به ترکر (tracker). اگر از یک پروکسی HTTP استفاده می‌کنید آن را مشخص نمایید. .TP .BR torrent:ipv6 " (نشانی IPv6)" نشانی IPv6 برای ارسال به ترکر. به‌طور پیش‌فرض، از نخستین نشانی unicast سراسریِ یافت‌شده استفاده می‌شود. .TP .BR torrent:max-peers \ (عدد) حداکثر تعداد همتاها (peers) برای یک تورنت. همتاهایی که کمتر استفاده شده‌اند برای حفظ این محدودیت حذف می‌شوند. .TP .BR torrent:port-range \ (از-تا) محدوده درگاه برای پذیرش اتصالات. هنگام شروع یک تورنت، یک درگاه منفرد انتخاب می‌شود. .TP .BR torrent:retracker " (نشانی URL)" نشانی صریح ردیاب مجدد (retracker)، مانند \(lqhttp://retracker.local/announce\(rq. .TP .BR torrent:save-metadata \ (بولی) هنگامی که true باشد، lftp فراداده‌های هر تورنتی را که با آن کار می‌کند در دایرکتوری \fI~/.local/share/lftp/torrent/md\fP یا \fI~/.lftp/torrent/md\fP ذخیره کرده و در صورت نیاز از آنجا بارگذاری می‌کند. .TP .BR torrent:seed-max-time " (بازه زمانی)" حداکثر زمان سید (seed). پس از این مدت زمان، تورنتِ کامل مستقل از نسبت (ratio) متوقف می‌شود. در صورت نیاز می‌توان آن را روی بی‌نهایت (infinity) تنظیم کرد. .TP .BR torrent:seed-min-peers \ (عدد) حداقل تعداد همتاها هنگامی که تورنت کامل شده است. اگر تعداد کمتر باشد، همتاهای جدید به‌طور فعال جستجو می‌شوند. .TP .BR torrent:stop-min-ppr " (عدد حقیقی)" حداقل نسبت به ازای هر قطعه (per-piece-ratio) برای توقف ارسال (seeding). از این مقدار برای جلوگیری از وضعیتی استفاده کنید که در آن یک قطعه محبوب باعث افزایش سریع نسبت کل می‌شود. .TP .BR torrent:stop-on-ratio " (عدد حقیقی)" تورنت هنگامی که کامل شود و نسبت (ratio) به این عدد برسد متوقف می‌شود. .TP .BR torrent:timeout " (بازه زمانی)" حداکثر زمان بدون هیچ‌گونه پیشرفت. با رسیدن به این زمان، تورنت متوقف می‌شود. .TP .BR torrent:use-dht \ (بولی) در صورت true بودن، از DHT استفاده می‌شود. .TP .BR xfer:auto-rename (بولی) اگر کاربر صریحاً این گزینه را روی \(lqon\(rq تنظیم کند، نام‌های فایل پیشنهادی ارائه‌شده توسط سرور استفاده می‌شوند. از آنجا که این امر می‌تواند یک ریسک امنیتی باشد، پیش‌فرض خاموش (off) است. .TP .BR xfer:backup-suffix \ (رشته) یک رشته قالب‌بندی زمان (نگاه کنید به strftime(3)) برای نام فایل پشتیبان هنگام جایگزینی یک فایل موجود. .TP .BR xfer:clobber \ (بولی) اگر این تنظیم خاموش (off) باشد، دستورهای get فایل‌های موجود را بازنویسی نکرده و در عوض خطا ایجاد می‌کنند. .TP .BR xfer:destination-directory " (مسیر یا نشانی URL به دایرکتوری)" این تنظیم به عنوان گزینه \-O پیش‌فرض برای دستورهای get و mget استفاده می‌شود. پیش‌فرض خالی است که به معنای دایرکتوری فعلی است (بدون گزینه \-O)..TP .BR xfer:disk-full-fatal \ (boolean) وقتی true باشد، اگر lftp نتواند به دلیل پر بودن دیسک یا سهمیه (quota) در فایل مقصد بنویسد، انتقال را لغو می‌کند؛ وقتی false باشد، lftp منتظر آزاد شدن فضای دیسک می‌ماند. .TP .BR xfer:eta-period \ (seconds) دوره‌ای که در طول آن، نرخ میانگین وزنی برای محاسبه ETA محاسبه می‌شود. .TP .BR xfer:eta-terse \ (boolean) نمایش خلاصه ETA (تنها بخش‌های با مرتبه بالاتر). مقدار پیش‌فرض true است. .TP .BR xfer:keep-backup \ (boolean) وقتی true باشد، فایل پشتیبان ایجادشده پیش از جایگزینی یک فایل موجود، پس از انتقال موفقیت‌آمیز حذف نمی‌شود. .TP .BR xfer:make-backup \ (boolean) وقتی true باشد، lftp به جای بازنویسی فایل از پیش موجود، نام آن را با افزودن xfer:backup-suffix تغییر می‌دهد. .TP .BR xfer:max-redirections " (number)" حداکثر تعداد تغییر مسیرها. این گزینه می‌تواند برای بارگیری از طریق HTTP مفید باشد. مقدار 0 تغییر مسیر را ناممکن می‌سازد. .TP .BR xfer:parallel \ (number) تعداد پیش‌فرض انتقال‌های موازی در یک دستور منفرد get/put/mget/mput. .TP .BR xfer:rate-period \ (seconds) دوره‌ای که در طول آن، نرخ میانگین وزنی جهت نمایش محاسبه می‌شود. .TP .BR xfer:temp-file-name \ (string) الگوی نام فایل موقت؛ نخستین علامت ستاره (*) با نام فایل اصلی جایگزین می‌شود. .TP .BR xfer:timeout " (time interval)" حداکثر زمان بدون هیچ‌گونه پیشرفت در انتقال. این مقدار می‌تواند برای محدود کردن حداکثر زمان تلاش مجدد جهت انتقال از سروری که از ازسرگیری انتقال پشتیبانی نمی‌کند، استفاده شود. .TP .BR xfer:use-temp-file \ (boolean) وقتی true باشد، فایل ابتدا به یک فایل موقت در همان پوشه منتقل شده و سپس تغییر نام می‌یابد. .TP .BR xfer:verify \ (boolean) وقتی true باشد، پس از انتقال موفق، verify-command برای ارزیابی یکپارچگی فایل اجرا می‌شود. کد خروج صفر آن دستور باید نشان‌دهنده درستی فایل باشد. .TP .BR xfer:verify-command \ (string) دستور مربوط به اعتبارسنجی یکپارچگی فایل. تنها آرگومان آن، مسیر فایل است. .PP نام یک متغیر را می‌توان خلاصه کرد مگر اینکه مبهم شود. پیشوند پیش از «:» نیز می‌تواند نادیده گرفته شود. شما می‌توانید یک متغیر را چندین بار برای بستارهای (closures) گوناگون مقداردهی کنید و بدین‌ترتیب برای وضعیت‌های خاص، تنظیمات خاصی داشته باشید. بستار باید پس از نام متغیر و با جداکننده خط مورب «/» مشخص شود. .PP بستار برای متغیرهای دامنه `dns:`، `net:`، `ftp:`، `http:` و `hftp:` در حال حاضر تنها همان نام میزبانی است که در دستور `open` مشخص می‌کنید (به‌جز برخی موارد استثنا که در آن‌ها بستار بی‌معنی است، مانند dns:cache-size). برای برخی متغیرهای دامنه `cmd:`، بستارْ نشانی وب (URL) جاری بدون مسیر است. برای متغیرهای دامنه `log:`، بستار یا `debug` است یا `xfer`. برای سایر متغیرها در حال حاضر استفاده نمی‌شود. مثال‌ها را در نمونه \fIlftp.conf\fR مشاهده کنید. .PP برخی دستورها و تنظیمات پارامتری از نوع بازه زمانی می‌پذیرند. قالب آن به صورت Nx[Nx...] است که در آن N مقدار زمان (ممیز شناور) و x یکای زمان است: d - روز، h - ساعت، m - دقیقه، s - ثانیه. یکای پیش‌فرض ثانیه است؛ مانند 5h30m یا 5.5h. همچنین این بازه می‌تواند `infinity`، `inf`، `never` یا `forever` باشد که نمایانگر بازه نامتناهی است؛ مانند `sleep forever` یا `set dns:cache-expire never`. .PP تنظیمات بولی (Boolean) می‌توانند برای مقدار True یکی از موارد (true, on, yes, 1, +) یا برای مقدار False یکی از موارد (false, off, no, 0, -) باشند. .PP تنظیمات سه‌حالته (Tri-boolean) دارای یک مقدار بولی یا `auto` هستند. .PP تنظیمات عدد صحیح (Integer) می‌توانند پسوند داشته باشند: k برای کیبی، m برای مبی، g برای گیبی و غیره. همچنین می‌توانند پیشوند داشته باشند: 0 برای هشت‌هشتی (octal)، 0x برای شانزده‌شانزدهی (hexadecimal). .SS حالت ناهمگام FTP (pipelining) .PP .B Lftp می‌تواند با ارسال هم‌زمان چندین دستور و سپس بررسی همه پاسخ‌ها، عملیات‌های FTP را سرعت ببخشد. متغیر ftp:sync-mode را ببینید. گاهی این روش کار نمی‌کند، بنابراین حالت همگام (synchronous) حالت پیش‌فرض است. می‌توانید حالت همگام را خاموش کنید و ببینید آیا برای شما کار می‌کند یا خیر. مشخص شده است که برخی نرم‌افزارهای شبکه که با ترجمه نشانی (NAT) سروکار دارند، در صورت قرارگیری چندین دستور FTP در یک بسته شبکه، به درستی کار نمی‌کنند. .PP در RFC959 آمده است: «ارسال دستوری دیگر توسط فرآیند کاربر پیش از دریافت پاسخ اتمام، نقض پروتکل خواهد بود؛ اما فرآیندهای FTP سرور باید هر دستوری را که در زمان اجرای دستور قبلی دریافت می‌شود، در صف قرار دهند». همچنین RFC1123 بیان می‌کند: «پیاده‌سازان نباید هیچ تطابقی میان مرزهای READ روی اتصال کنترل و دنباله‌های EOL تلنت (CR LF) متصور شوند» و «یک READ منفرد از اتصال کنترل ممکن است شامل بیش از یک دستور FTP باشد». بنابراین ارسال هم‌زمان چندین دستور باید ایمن باشد؛ این کار سرعت عملیات را بسیار افزایش می‌دهد و به نظر می‌رسد با تمام سرورهای ftp مبتنی بر Unix و VMS کار می‌کند. متأسفانه، سرورهای مبتنی بر ویندوز اغلب نمی‌توانند چندین دستور را در یک بسته پردازش کنند، و همین‌طور برخی از روترهای معیوب نیز توانایی این کار را ندارند..SH "گزینه‌ها (OPTIONS)" .TP .B \-d فعال کردن حالت اشکال‌زدایی. .TP .BI \-e " commands" اجرای دستورهای مشخص‌شده بدون خروج از برنامه. .TP .BI \-p " port" استفاده از درگاه (پورت) مشخص‌شده برای اتصال. .TP .BI \-u " user\fR[\fP\fB,\fPpass\fR]\fP" استفاده از نام کاربری و گذرواژهٔ مشخص‌شده برای اتصال. به یاد داشته باشید که گذرواژه را به درستی درون پوسته نقل‌قول (quote) کنید. همچنین توجه داشته باشید که مشخص کردن گذرواژه در خط فرمان امن نیست؛ از فایل \fI~/.netrc\fP یا متغیر محیطی \fBLFTP_PASSWORD\fP به همراه گزینهٔ \-\-env\-password استفاده کنید. به عنوان روش جایگزین می‌توانید از پروتکل‌های مبتنی بر ssh با کلیدهای مجاز (authorized keys) استفاده نمایید تا مجبور به وارد کردن گذرواژه نباشید. .PP .TP .B \-\-norc عدم اجرای فایل‌های rc از دایرکتوری خانگی (home). .TP .BI \-\-rcfile " file" اجرای دستورها از فایل مشخص‌شده. می‌تواند چندین بار مشخص شود. .TP .BI \-f " script_file" اجرای دستورهای درون فایل و سپس خروج. این گزینه باید به تنهایی و بدون آرگومان‌های دیگر (به جز \fB\-\-norc\fP) استفاده شود. .TP .BI \-c " commands" اجرای دستورهای داده‌شده و سپس خروج. دستورها می‌توانند با یک نقطه‌ویرگول (semicolon)، «&&» یا «||» از یکدیگر جدا شوند. به یاد داشته باشید که آرگومان دستورها را به درستی درون پوسته نقل‌قول کنید. این گزینه باید به تنهایی و بدون سایر آرگومان‌ها (به جز \fB\-\-norc\fP) استفاده شود. .TP سایر گزینه‌های \fBopen\fP نیز ممکن است در خط فرمان \fBlftp\fP داده شوند. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" متغیرهای محیطی زیر توسط \fBlftp\fR پردازش می‌شوند: .IP "\fBEDITOR\fP" به عنوان ویرایشگر محلی برای دستور \fBedit\fR استفاده می‌شود. .IP "\fBHOME\fP" برای بسط تیلدا («~») (محلی) استفاده می‌شود. .IP "\fBSHELL\fP" توسط دستور \fB!\fR برای تعیین پوسته‌ای که باید اجرا شود به کار می‌رود. .IP "\fBPAGER\fP" این متغیر باید نام صفحه‌بندی (pager) مورد استفاده باشد. این متغیر توسط دستورهای \fBmore\fR و \fBzmore\fR استفاده می‌شود. .IP "\fBhttp_proxy\fP, \fBhttps_proxy\fP" برای مقداردهی اولیه به متغیرهای http:proxy،‏ hftp:proxy و https:proxy استفاده می‌شود. .IP "\fBftp_proxy\fP" بسته به پروتکل URL استفاده‌شده در این متغیر محیطی، برای مقداردهی اولیه به متغیرهای ftp:proxy یا hftp:proxy استفاده می‌شود. .IP "\fBno_proxy\fP" برای مقداردهی اولیه به متغیر net:no-proxy استفاده می‌شود. .IP "\fBLFTP_MODULE_PATH\fP" برای مقداردهی اولیه به متغیر module:path استفاده می‌شود. .IP "\fBLFTP_HOME\fP" برای یافتن دایرکتوری ذخیره‌کنندهٔ فایل‌های پیکربندی ویژهٔ کاربر استفاده می‌شود. در صورت تنظیم نبودن، \fI~/.lftp\fR استفاده خواهد شد. لطفاً توجه داشته باشید در صورتی که این دایرکتوری وجود نداشته باشد، از دایرکتوری‌های XDG استفاده خواهد شد. .IP "\fBLFTP_PASSWORD\fP" برای گزینهٔ \-\-env\-password در دستور \fBopen\fP استفاده می‌شود. .IP "\fBLS_COLORS\fP" برای مقداردهی اولیه به متغیر color:dir-colors استفاده می‌شود. .IP "\fBXDG_CONFIG_HOME\fP, \fBXDG_DATA_HOME\fP, \fBXDG_CACHE_HOME\fP" زمانی که \fI~/.lftp\fR (یا دایرکتوری \fB$LFTP_HOME\fP) وجود نداشته باشد، برای یافتن دایرکتوری‌های مربوط به فایل‌های ویژهٔ کاربر استفاده می‌شوند. پیش‌فرض‌ها به ترتیب \fI~/.config\fR،‏ \fI~/.local/share\fR و \fI~/.cache\fR هستند. پسوند \fI/lftp\fR به منظور ایجاد مسیر کامل دایرکتوری‌ها به انتهای آن‌ها افزوده می‌شود. .SH "فایل‌ها (FILES)" .TP .I "/etc/lftp.conf" فایل راه‌اندازی سراسری سیستم. مکان واقعی آن به گزینهٔ پیکربندی \-\-sysconfdir بستگی دارد. زمانی که پیشوند \fI/usr\fR باشد، این مسیر \fI/etc\fR است و به طور پیش‌فرض \fI/usr/local/etc\fR می‌باشد. .TP .I "~/.config/lftp/rc \fPor\fI ~/.lftp/rc, ~/.lftprc" این فایل‌ها در زمان راه‌اندازی lftp پس از \fI/etc/lftp.conf\fR اجرا می‌شوند. .TP .I "~/.local/share/lftp/log \fPor\fI ~/.lftp/log" فایلی که با رفتن lftp به پس‌زمینه در حالت nohup، رویدادها در آن ثبت می‌شوند. .TP .I "~/.local/share/lftp/transfer_log \fPor\fI ~/.lftp/transfer_log" فایلی که وقتی تنظیم log:enabled/xfer روی «yes» باشد، گزارش انتقال‌ها در آن ثبت می‌شود. مکان این فایل را می‌توان با تنظیم log:file/xfer تغییر داد. .TP .I "~/.local/share/lftp/bookmarks \fPor\fI ~/.lftp/bookmarks" این فایل برای ذخیرهٔ نشانک‌های lftp استفاده می‌شود. به دستور \fBbookmark\fR مراجعه کنید. .TP .I "~/.local/share/lftp/cwd_history \fPor\fI ~/.lftp/cwd_history" این فایل برای ذخیرهٔ آخرین دایرکتوری‌های کاری برای هر سایت بازدیدشده استفاده می‌شود. .TP .I "~/.local/share/lftp/bg/ \fPor\fI ~/.lftp/bg/" این دایرکتوری برای ذخیرهٔ سوکت‌های نام‌گذاری‌شده برای فرایندهای به پس‌زمینه رفتهٔ lftp استفاده می‌شود. .TP .I "~/.cache/lftp/DHT/ \fPor\fI ~/.lftp/DHT/"" این دایرکتوری برای ذخیرهٔ شناسهٔ DHT و حافظهٔ موقت گره‌ها برای IPv4 و IPv6 استفاده می‌شود. پسوند نام فایل، همان نام میزبان (host name) است. .TP .I "~/.cache/lftp/edit/ \fPor\fI ~/.lftp/edit/"" این دایرکتوری برای ذخیرهٔ فایل‌های موقت دستور \fBedit\fR استفاده می‌شود. .TP .I "~/.local/share/lftp/torrent/md/ \fPor\fI ~/.lftp/torrent/md/"" این دایرکتوری برای ذخیرهٔ فراداده‌های تورنت (torrent metadata) استفاده می‌شود. این قابلیت به ویژه برای پیوندهای magnet مفید است و فراداده‌های ذخیره‌شده را می‌توان از این دایرکتوری بارگیری کرد. همچنین می‌تواند به عنوان تاریخچهٔ تورنت عمل کند که در آن نام فایل‌ها همان info_hash تورنت‌ها هستند. .TP .I "~/.netrc" هنگامی که سروری بدون پروتکل به دستور «open» داده می‌شود، از این فایل برای به‌دست آوردن نام ورود (login) و گذرواژهٔ پیش‌فرض استفاده می‌شود. همچنین اگر نشانی URL همراه با نام کاربری اما بدون گذرواژه استفاده شده باشد، گذرواژه‌ها در اینجا جستجو می‌شوند..SH "همچنین ببینید (SEE ALSO)" .BR ftpd (8),\ ftp (1) .br RFC854 (telnet)، RFC959 (ftp)، RFC1123، RFC1945 (http/1.0)، RFC2052 (SRV RR)، RFC2228 (افزونه‌های امنیتی ftp)، RFC2389 (ftp FEAT)، RFC2428 (ftp/ipv6)، RFC2518 (WebDAV)، RFC2616 (http/1.1)، RFC2617 (احراز هویت http/1.1)، RFC2640 (بین‌المللی‌سازی ftp)، RFC3659 (افزونه‌های ftp)، RFC4217 (ftp بر بستر ssl)، BEP0003 (پروتکل BitTorrent)، BEP0005 (پروتکل DHT)، BEP0006 (افزونهٔ Fast)، BEP0007 (افزونهٔ ترکر IPv6)، BEP0009 (افزونه برای ارسال فایل‌های فراداده توسط همتایان)، BEP0010 (پروتکل افزونه)، BEP0012 (افزونهٔ فراداده چندترکری)، BEP0023 (بازگرداندن فهرست فشرده همتایان توسط ترکر)، BEP0032 (افزونه‌های DHT برای IPv6). .br .na https://tools.ietf.org/html/draft-preston-ftpext-deflate-04 (حالت انتقال فشرده‌سازی deflate در ftp)، .br https://tools.ietf.org/html/draft-dd-pret-00 (دستور PRET)، .br https://tools.ietf.org/html/draft-ietf-secsh-filexfer-13 (sftp). .br http://wiki.theory.org/BitTorrentSpecification .br http://www.bittornado.com/docs/multitracker-spec.txt .br http://www.rasterbar.com/products/libtorrent/dht_sec.html (افزونهٔ امنیتی DHT) .br http://xbtt.sourceforge.net/udp_tracker_protocol.html (ترکر UDP) .ad .SH "نویسنده (AUTHOR)" .nf Alexander V. Lukyanov lav@yars.free.net .fi .SH "قدردانی‌ها (ACKNOWLEDGMENTS)" این صفحهٔ راهنما در ابتدا توسط Christoph Lameter برای سیستم Debian GNU/Linux نوشته شد. این صفحه بعدها توسط Nicolas Lichtmaier ،‏ James Troup و Alexander V. Lukyanov بهبود یافته و به‌روزرسانی شد.