.TH curlftpfs 1 "۲۵ مه ۲۰۰۷" "CurlFtpFS 0.9.2" "راهنمای CurlFtpFS"
.SH "نام (NAME)"
curlftpfs \- سوار کردن یک میزبان FTP به عنوان یک دایرکتوری محلی
.SH "خلاصه دستور (SYNOPSIS)"
.B curlftpfs [گزینه‌ها]
.I میزبان مسیر
.SH "توضیحات (DESCRIPTION)"
برنامه
.B curlftpfs
ابزاری برای سوار کردن (mount) میزبان‌های راه دور FTP به عنوان دایرکتوری‌های محلی است. این برنامه به سرور FTP
.I میزبان
متصل شده و ساختار دایرکتوری آن را بر روی دایرکتوری
.I مسیر
می‌نگارد.

.PP
ابزار curlftpfs برای تمام ویژگی‌های مربوط به انتقال از کتابخانه libcurl بهره می‌برد. برای جزئیات
.BR libcurl (3)
را ببینید. بخش سامانه پرونده بر روی FUSE پیاده‌سازی شده است. برای جزئیات
.BR http://fuse.sourceforge.net
را ببینید.
.SH "گزینه‌های FTP (FTP OPTIONS)"
.TP
.B "-h/--help"
چاپ گزینه‌های راهنما.
.TP
.B "-v/--verbose"
چاپ خروجی اشکال‌زدایی پرگو توسط libcurl.
.TP
.B "-V/--version"
چاپ نسخه‌های curlftpfs، libcurl و fuse.
.TP
.B \-o
گزینه‌ها با فلگ
.B \-o
مشخص شده و پس از آن رشته‌ای از گزینه‌ها با کاما جدا می‌شوند.
.RS
.TP
.B cacert=<file>
(SSL) ارسال یک رشته شامل نام فایلی که حاوی یک یا چند گواهی برای تأیید همتا است.
.PP
توجه داشته باشید که این گزینه به طور پیش‌فرض روی مسیر سیستمی تنظیم شده است که انتظار می‌رود بسته cacert مربوط به libcurl طبق زمان ساخت در آنجا ذخیره شده باشد.
.TP
.B capath=<directory>
(SSL) به curlftpfs می‌گوید از دایرکتوری گواهی‌های مشخص‌شده برای تأیید همتا استفاده کند. گواهی‌ها باید در قالب PEM باشند و دایرکتوری باید با استفاده از ابزار c_rehash ارائه‌شده همراه با openssl پردازش شده باشد. اگر فایل cacert شامل گواهی‌های مرجع صدور گواهی (CA) زیادی باشد، استفاده از \fBcapath\fP به curlftpfs اجازه می‌دهد اتصالات را بسیار کارآمدتر از حالت استفاده از \fBcacert\fP برقرار کند.
.TP
.B cert=<certificate>
(SSL) تعیین فایل گواهی مورد استفاده برای curlftpfs. قالب پیش‌فرض "PEM" است و با \fBcert_type\fP قابل تغییر است.
.TP
.B cert_type=<type>
(SSL) تعیین نوع قالبی که گواهی ارائه‌شده در آن قالب قرار دارد. انواع شناخته‌شده PEM، DER و ENG هستند.
.TP
.B ciphers=<list of ciphers>
(SSL) تعیین الگوریتم‌های رمزگذاری (ciphers) مورد استفاده در اتصال. فهرست باید از نظر نحوی صحیح باشد و شامل یک یا چند رشته الگوریتم رمزگذاری جداشده با دونقطه باشد. کاما یا فاصله نیز جداکننده‌های قابل قبولی هستند اما معمولاً از دونقطه استفاده می‌شود. همچنین - و + می‌توانند به عنوان عملگر استفاده شوند. نمونه‌های معتبر فهرست رمزها عبارتند از 'RC4-SHA'، 'SHA1+DES'، 'TLSv1' و 'DEFAULT'. فهرست پیش‌فرض معمولاً هنگام کامپایل OpenSSL تعیین می‌شود.
.PP
جزئیات فهرست رمزهای SSL را در این نشانی بخوانید:
\fIhttp://www.openssl.org/docs/apps/ciphers.html\fP
.TP
.B codepage=<name>
تنظیم کدگذاری (encoding) مورد استفاده سرور FTP برای کدگذاری نام فایل‌ها.
.TP
.B connect_timeout=<seconds>
حداکثر زمان مجاز به ثانیه برای برقراری اتصال به سرور. این فقط مرحله اتصال را محدود می‌کند؛ پس از اتصال curlftpfs، این گزینه دیگر کاربردی ندارد.
.TP
.B custom_list=<command>
دستور مورد استفاده توسط curlftpfs برای فهرست کردن فایل‌ها. پیش‌فرض "LIST -a" است، اما برخی سرورها ممکن است به گزینه‌های اضافی نیاز داشته باشند، مانند "LIST -la".
.TP
.B disable_eprt
غیرفعال کردن استفاده از دستورات EPRT و LPRT هنگام انتقال فعال FTP. ابزار Curlftpfs معمولاً همیشه ابتدا سعی می‌کند از EPRT و سپس از LPRT پیش از استفاده از PORT استفاده کند، اما با این گزینه، بلافاصله از PORT استفاده خواهد کرد. دستورات EPRT و LPRT افزونه‌هایی برای پروتکل اصلی FTP هستند که ممکن است روی همه سرورها کار نکنند اما قابلیت‌های بیشتری را بهتر از دستور سنتی PORT فراهم می‌کنند.
.TP
.B disable_epsv
غیرفعال کردن استفاده از دستور EPSV هنگام انتقال غیرفعال (passive) در FTP. این حالت پیش‌فرض است.
.TP
.B enable_epsv
فعال کردن استفاده از دستور EPSV هنگام انتقال غیرفعال در FTP. ابزار curlftpfs ابتدا پیش از PASV برای استفاده از EPSV تلاش خواهد کرد.
.TP
.B engine=<name>
انتخاب موتور رمزنگاری OpenSSL برای عملیات رمزگذاری. از:
.br
.B "curl \-\-engine list"
.br
برای چاپ فهرستی از موتورهای پشتیبانی‌شده در زمان ساخت استفاده کنید. توجه داشته باشید که ممکن است همه (یا هیچ‌یک از) موتورها در زمان اجرا در دسترس نباشند.
.TP
.B ftpfs_debug
چاپ حجم زیادی از اطلاعات اشکال‌زدایی توسط curlftpfs. تنها همراه با گزینه
.B \-d
مفید است.
.TP
.B ftp_method=<method>
کنترل روشی که curlftpfs برای دسترسی به فایل روی سرور استفاده می‌کند. آرگومان متد باید یکی از گزینه‌های زیر باشد:
.RS
.IP multicwd
ابزار curlftpfs برای هر بخش مسیر در نشانی اینترنتی یک عملیات CWD جداگانه انجام می‌دهد. برای سلسله‌مراتب‌های عمیق این به معنای دستورات بسیار زیادی است. این نحوه عملکرد طبق RFC1738 است و حالت پیش‌فرض ولی کندترین رفتار است.
.IP singlecwd
ابزار curlftpfs یک بار CWD را با کل دایرکتوری مقصد انجام می‌دهد و سپس بر روی فایل به‌صورت «معمولی» عمل می‌کند (مانند حالت multicwd).
.RE
.TP
.B ftp_port=<address>
معکوس کردن نقش‌های آغازگر/شنونده هنگام اتصال با FTP. این سوییچ باعث می‌شود curlftpfs به جای PASV از دستور PORT استفاده کند. در عمل، دستور PORT به سرور می‌گوید به آدرس و پورت مشخص‌شده کلاینت متصل شود، در حالی که PASV از سرور یک آدرس IP و پورت برای اتصال درخواست می‌کند. مقدار <address> باید یکی از موارد زیر باشد:
.RS
.IP interface
مثلاً "eth0" برای تعیین اینکه آدرس IP کدام رابط شبکه استفاده شود
.IP "IP address"
مثلاً "192.168.10.1" برای تعیین دقیق شماره IP
.IP "host name"
مثلاً "my.host.domain" برای تعیین نام ماشین
.IP "-"
انتخاب همان آدرس IP که قبلاً برای اتصال کنترلی استفاده شده است
.RE
.RS
.PP
غیرفعال کردن تلاش برای استفاده از دستور EPRT به جای PORT با استفاده از \fIdisable_eprt\fP انجام می‌شود. EPRT در واقع نگارش ارتقایافته PORT است.
.RE
.TP
.B httpproxy
تنظیم نوع پراکسی روی HTTP. این نوع پیش‌فرض است.
.TP
.B interface=<name>
ارسال یک رشته به عنوان پارامتر. این گزینه نام رابط شبکه خروجی را مشخص می‌کند. این نام می‌تواند یک رابط شبکه، نشانی IP یا نام میزبان باشد.
.TP
.B iocharset=<name>
مجموعه نویسه (charset) مورد استفاده در سمت کلاینت برای ترجمه codepage به مجموعه نویسه را مشخص می‌کند. پیش‌فرض: UTF8.
.TP
.B ipv4
اگر libcurl قادر به تحلیل یک نشانی به چندین نسخه IP باشد (که در صورت پشتیبانی از ipv6 هست)، این گزینه به libcurl می‌گوید نام‌ها را تنها به نشانی‌های IPv4 تحلیل کند.
.TP
.B ipv6
اگر libcurl قادر به تحلیل یک نشانی به چندین نسخه IP باشد (که در صورت پشتیبانی از ipv6 هست)، این گزینه به libcurl می‌گوید نام‌ها را تنها به نشانی‌های IPv6 تحلیل کند.
.TP
.B key=<key>
(SSL) نام فایل کلید خصوصی. به شما اجازه می‌دهد کلید خصوصی خود را در این فایل مجزا ارائه دهید. قالب پیش‌فرض "PEM" است و با \fBkey_type\fP قابل تغییر است.
.TP
.B key_type=<type>
(SSL) ارسال یک رشته در قالب کلید خصوصی شما. قالب‌های پشتیبانی‌شده "PEM"، "DER" و "ENG" هستند.
.PP
قالب "ENG" شما را قادر می‌سازد کلید خصوصی را از یک موتور رمزنگاری بارگذاری کنید. در این حالت \fBkey\fP به عنوان شناسه‌ای که به موتور فرستاده می‌شود به کار می‌رود. شما باید موتور رمزنگاری را با گزینه \fBengine\fP تنظیم کنید. فایل کلید با قالب "DER" در حال حاضر به دلیل وجود یک باگ در OpenSSL کار نمی‌کند.
.TP
.B krb4=<level>
فعال‌سازی و استفاده از احراز هویت kerberos4. سطح باید مشخص شود و یکی از 'clear'، 'safe'، 'confidential' یا 'private' باشد. اگر سطحی غیر از این موارد تعیین شود، به جای آن از 'private' استفاده خواهد شد.
.PP
این گزینه نیازمند این است که کتابخانه libcurl با پشتیبانی از kerberos4 ساخته شده باشد. این مورد چندان رایج نیست.
.TP
.B no_verify_hostname
(SSL) ابزار Curlftpfs هنگام اتصال به سرور دارای SSL، نام میزبان را تأیید نخواهد کرد.
.TP
.B no_verify_peer
(SSL) ابزار Curlftpfs هنگام اتصال به سرور دارای SSL، گواهی را تأیید نخواهد کرد.
.TP
.B pass=<password>
(SSL) عبارت عبور (Passphrase) برای کلید خصوصی.
.TP
.B proxy=<host[:port]>
استفاده از پراکسی HTTP مشخص‌شده. اگر شماره پورت مشخص نشده باشد، پورت ۱۰۸۰ در نظر گرفته می‌شود.
.PP
این گزینه بر متغیرهای محیطی موجود که پراکسی را مشخص می‌کنند اولویت دارد. اگر متغیر محیطی برای تنظیم پراکسی وجود دارد، می‌توانید مقدار پراکسی را روی "" قرار دهید تا آن را نادیده بگیرد.
.PP
این گزینه متضمن گزینه \fBproxytunnel\fP نیز هست.
.PP
از نسخه ۷.۱۴.۱ کتابخانه libcurl، میزبان پراکسی می‌تواند دقیقاً به همان شیوه متغیرهای محیطی پراکسی، از جمله پیشوند پروتکل (//:http) و نام کاربری + گذرواژه تعبیه‌شده مشخص شود.
.TP
.B proxytunnel
به curlftpfs می‌گوید از یک تونل پراکسی استفاده کند. این گزینه به صورت ضمنی توسط گزینه \fBproxy\fP اعمال می‌شود اما اگر از متغیر محیطی \fIproxy\fP استفاده می‌کنید، باید آن را به صورت دستی تنظیم کنید.
.TP
.B proxy_anyauth
به curl می‌گوید هنگام ارتباط با پراکسی داده‌شده یک روش احراز هویت مناسب را انتخاب کند. این کار باعث یک رفت‌وبرگشت (round-trip) اضافی برای درخواست/پاسخ خواهد شد.
.TP
.B proxy_basic
به curlftpfs می‌گوید هنگام ارتباط با پراکسی داده‌شده از احراز هویت پایه‌ای HTTP Basic استفاده کند. احراز هویت Basic روش پیش‌فرض curlftpfs در کار با پراکسی‌ها است.
.TP
.B proxy_digest
به curlftpfs می‌گوید هنگام ارتباط با پراکسی داده‌شده از احراز هویت HTTP Digest استفاده کند.
.TP
.B proxy_ntlm
به curlftpfs می‌گوید هنگام ارتباط با پراکسی داده‌شده از احراز هویت HTTP NTLM استفاده کند.
.TP
.B proxy_user=<user:password>
تعیین نام کاربری و گذرواژه برای استفاده در احراز هویت پراکسی.
.TP
.B skip_pasv_ip
به curlftpfs می‌گوید از نشانی IP پیشنهادی سرور در پاسخ به دستور PASV هنگام اتصال داده curlftpfs استفاده نکند. در عوض curlftpfs همان نشانی IP را که قبلاً برای اتصال کنترلی استفاده می‌کرد، مجدداً استفاده خواهد کرد.
.TP
.B socks4
تنظیم نوع پراکسی روی SOCKS4.
.TP
.B socks5
تنظیم نوع پراکسی روی SOCKS5.
.TP
.B ssl
استفاده از SSL/TLS برای هر دو اتصال کنترلی و داده در curlftpfs.
.TP
.B sslv3
اجبار curlftpfs به استفاده از SSL نسخه ۳ هنگام مذاکره با یک سرور راه دور SSL.
.TP
.B ssl_control
استفاده از SSL/TLS تنها برای اتصال کنترلی در curlftpfs.
.TP
.B ssl_try
تلاش curlftpfs برای استفاده از SSL/TLS برای هر دو اتصال داده و کنترل، اما اگر سرور از آن پشتیبانی نکند، اتصال همچنان بدون رمزنگاری برقرار خواهد شد.
.TP
.B tcp_nodelay
روشن کردن گزینه TCP_NODELAY. برای جزئیات مربوط به این گزینه به صفحه راهنمای \fIcurl_easy_setopt(3)\fP مراجعه فرمایید.
.TP
.B tlsv1
(SSL) اجبار curlftpfs به استفاده از TLS نسخه ۱ هنگام مذاکره با سرور دارای TLS راه دور.
.TP
.B transform_symlinks
الحاق
.I مسیر
به پیوندهای نمادین مطلق تا همچنان به درون ساختار دایرکتوری FTP اشاره کنند. در غیر این صورت آن پیوندها به احتمال زیاد خراب خواهند شد.
.TP
.B user=<user:password>
مشخص کردن نام کاربری و گذرواژه برای احراز هویت در سرور. بر پیکربندی netrc اولویت دارد.
.TP
.B utf8
تلاش برای انتقال فهرست فایل‌ها با کدگذاری UTF-8. ارسال دستور OPTS UTF8 ON در ابتدای انتقال فهرست فایل.
.RE
.SH "گزینه‌های FUSE (FUSE OPTIONS)"
.TP
.B "-d"
فعال کردن خروجی اشکال‌زدایی FUSE. متضمن گزینه \fB-f\fP است.
.TP
.B "-f"
اجرای curlftpfs در حالت پیش‌زمینه (foreground).
.TP
.B "-r"
سوار کردن به صورت فقط‌خواندنی.
.TP
.B "-s"
غیرفعال کردن عملکرد چندریسمانی (multi-threaded).
.TP
.B \-o
گزینه‌ها با فلگ
.B \-o
همراه با یک رشته جداشده با کاما از گزینه‌ها مشخص می‌شوند.
.RS
.TP
.B allow_other
اجازه دسترسی به سایر کاربران. به طور پیش‌فرض نقطه سوار کردن فقط برای کاربری که آن را سوار کرده قابل دسترسی است و حتی کاربر ریشه نیز دسترسی ندارد.
.TP
.B allow_root
اجازه دسترسی به کاربر ریشه (root). به طور پیش‌فرض نقطه سوار کردن فقط برای کاربری که آن را سوار کرده در دسترس است و حتی به کاربر ریشه هم در دسترس نیست.
.TP
.B debug
فعال کردن خروجی اشکال‌زدایی
.TP
.B direct_io
استفاده از ورودی/خروجی مستقیم (Direct I/O)
.TP
.B fsname=NAME
تنظیم نام سامانه پرونده در mtab
.TP
.B gid=N
تنظیم گروه فایل
.TP
.B hard_remove
حذف فوری (فایل‌ها پنهان نشوند)
.TP
.B kernel_cache
اجازه دادن به لایه VFS هسته برای ذخیره‌سازی موقت (cache) فایل‌ها.
.TP
.B large_read
صدور درخواست‌های خواندن بزرگ (فقط نگارش 2.4)
.TP
.B max_read=N
تنظیم حداکثر اندازه درخواست‌های خواندن
.TP
.B nonempty
اجازه سوار کردن روی فایل/دایرکتوری غیرخالی
.TP
.B readdir_ino
تلاش برای پر کردن d_ino در readdir
.TP
.B uid=N
تنظیم مالک فایل
.TP
.B umask=M
تنظیم مجوزهای فایل (هشت‌هشتی / octal)
.TP
.B use_ino
اجازه دادن به سامانه پرونده برای تعیین شماره‌های inode
.RE
.SH "نویسندگان (AUTHORS)"
Robson Braga Araujo نویسنده و نگهدارنده CurlFtpFS است.
.SH "وبگاه (WWW)"
http://curlftpfs.sourceforge.net
.SH "همچنین ببینید (SEE ALSO)"
.BR mount (8)