.TH afpcmd 1 "13 Nov 2007" 0.5 afpfs-ng
.SH "نام (NAME)"
afpcmd \- انتقال فایل‌ها از طریق شبکه با استفاده از پروتکل پرونده اپل (AFP)
.SH "خلاصه دستور (SYNOPSIS)"
\fIafpcmd\fR [\fB-r\fR] [\fBafp url\fR]

.SH "توضیحات (DESCRIPTION)"
ابزار \fIafpcmd\fR یک ابزار خط فرمانی برای تسهیل انتقال فایل‌ها به و از یک سرور با استفاده از پروتکل AFP است. این سرور معمولاً Netatalk یا Mac OS یا Mac OS X است.

این کار می‌تواند توسط یک کاربر غیرریشه انجام شود. این ابزار هم یک خط فرمان تعاملی (مانند کلاینت‌های سنتی FTP) و هم امکان دریافت دسته‌ای فایل‌ها را فراهم می‌سازد.

این ابزار را با ابزارهای اتصال FUSE (مانند mount_afp، afpfsd، afp_client) که امکان مانت کردن یک سیستم‌فایل کامل را فراهم می‌کنند، اشتباه نگیرید.

.SH "گزینه‌ها (OPTIONS)"

گزینه \fB-r\fR فلگ بازگشتی (recursive) را فعال می‌کند.

عبارت \fBafp url\fR از قالب استاندارد نشانی‌های اینترنتی AFP استفاده می‌کند.

.SH "پشتیبانی از نسخه‌های AFP (AFP version support)"
برای کسب اطلاعات بیشتر در رابطه با سازگاری نسخه‌های مشخص پروتکل AFP به مستندات afpfs-ng مراجعه نمایید.

.SH "حالت دسته‌ای (Batch mode)"

انتقال دسته‌ای فایل‌ها به یکی از دو روش زیر قابل انجام است:

\fIafpcmd -r [\fBafp url to directory\fR]

این دستور یک انتقال بازگشتی از تمام زیرپوشه‌ها و فایل‌ها به صورت محلی انجام می‌دهد.

\fIafpcmd [\fBafp url to file\fR]

این دستور تنها همان فایل مشخص را به صورت محلی منتقل می‌کند.

پس از پایان هر یک از این دو عملیات، دستور خاتمه می‌یابد.

.SH "حالت تعاملی (Interactive mode)"

اگر در خط فرمان یک نشانی وب مشخص شود، afpcmd متصل شده و وارد حجم دیسک (volume) و پوشه مشخص‌شده می‌شود.

کلیدهای میانبر استاندارد readline فعال هستند. تکمیل خودکار خط فرمان (با کلید tab) و تاریخچه دستورات (با کلیدهای جهت‌نما بالا و پایین) پشتیبانی می‌شود. تکمیل خودکار نام فایل‌های محلی فعال است.

\fBرایج‌ترین دستورات\fR

\fIconnect\fR <afp URL>: اتصال به سرور، ورود به حجم دیسک و پوشه

\fIcd\fR: تغییر پوشه در سرور

\fIget\fR <filename>: دریافت فایل

\fIget\fR -r <directory>: دریافت بازگشتی کل پوشه

\fIput\fR <filename>: بارگذاری فایل

\fIquit\fR: خروج

\fBدستورات اتصال/قطع اتصال\fR

\fIdisconnect\fR: قطع اتصال از سرور فعلی

\fIpasswd\fR: درخواست رمز عبور جدید بدون نمایش در صفحه

\fIuser\fR <user>: تعیین نام کاربری

\fIpasswd\fR: تغییر رمز عبور در سرور. کار نمی‌کند.

\fBدستورات دایرکتوری از راه دور\fR

\fIpwd\fR: نمایش پوشه جاری در سرور

\fImkdir\fR <directory>: ایجاد پوشه جدید

\fIrmdir\fR <directory>: حذف پوشه

\fIls\fR یا \fIdir\fR: نمایش فایل‌های پوشه جاری

\fBدستورات فایل از راه دور\fR

\fImv\fR یا \fIrename\fR old_file new_file: تغییر نام <old file> به <new file>

\fItouch\fR <filename>: ایجاد یک فایل خالی

\fIview\fR <filename>: نمایش محتوای فایل

\fIchmod\fR: <file> <mode>: تغییر مجوز دسترسی یک فایل در سرور

\fIdelete\fR یا \fIrm\fR: <file>: حذف فایل از سرور

\fBدستورات وضعیت\fR

\fIstatus\fR: نمایش وضعیت اتصال و جزئیات. جهت اشکال‌زدایی.

\fIdf\fR: نمایش اندازه دیسک و بلوک‌های در دسترس.

\fBدستورات محلی\fR

\fIlpwd\fR: نمایش مسیر محلی جاری

\fIlcd\fR: تغییر پوشه محلی

\fBسایر دستورات\fR

\fIhelp\fR یا \fI?\fR: نمایش راهنما

\fItestafp\fR: آزمون‌های گوناگون برای توسعه‌دهندگان

.SH "نشانی‌های اینترنتی AFP (AFP URLs)"

یک نمونه کاربرد متداول afpcmd عبارت است از:

\fIafpcmd\fR afp://username:password@servername/volume

سینتکس کامل یک نشانی اینترنتی به شکل زیر است:

afp://username;AUTH=authtype:password@server:port/volume/path

اگر به جای رمز عبور "-" درج شود، برنامه رمز عبور را از کاربر درخواست می‌کند.

.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به فهرست پستی afpfs-ng-devel@sf.net ارسال فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
\fBafpgetstatus\fR(1)