.TH cadaver 1 "October 2022" Unix "User Manuals"
.SH "نام (NAME)"
cadaver \- یک کلاینت خط فرمانی WebDAV برای یونیکس
.SH "خلاصه دستور (SYNOPSIS)"
.B cadaver
[\-trp[\-r \fIfile\fR][\-p \fIhost\fR[:\fIport\fR]]][\-V][\-h] \fIURL\fR
.SH "توضیحات (DESCRIPTION)"
دستور
.B cadaver
از بارگذاری فایل (upload)، بارگیری (download)، نمایش روی صفحه، عملیات فضای نام (انتقال و رونوشت)، ایجاد و حذف مجموعه‌ها و عملیات قفل‌گذاری پشتیبانی می‌کند.
.PP
نحوه عملکرد آن مشابه کلاینت استاندارد BSD
.BR ftp (1)
و پروژه سامبا
.BR smbclient (1)
است. کاربری که با این ابزارها آشنایی داشته باشد، به سادگی می‌تواند با cadaver کار کند.
.PP
دستور
.B cadaver
از ورود خودکار به سرورهایی که نیازمند احراز هویت هستند از طریق فایل netrc. (مشابه
.BR ftp (1)
\- به بخش «فایل .netrc» در ادامه مراجعه کنید) پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
نشانی
.B URL
داده‌شده باید یک URI مطلق با استفاده از طرحواره‌های URL مانند http: یا https باشد.
.TP
.BR \-t ", " \-\-tolerant
اجازه ورود/باز کردن مجموعه‌های فاقد قابلیت WebDAV را می‌دهد؛ در صورتی استفاده می‌شود که سرور یا سرور پروکسی با استانداردهای WebDAV ناسازگاری داشته باشد.
.TP
.BR \-r ", " \-\-rcfile=\fIfile\fR
استفاده از این فایل پیکربندی به جای مسیر پیش‌فرض
.I ~/.cadaverrc
.TP
.BR \-p ", " \-\-proxy=\fIhost\fR[:\fIport\fR]
اتصال با استفاده از میزبان پروکسی "host" و پورت اختیاری "port".
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه و خروج.
.TP
.BR \-h ", " \-\-help
نمایش پیام راهنما و خروج.
.SH "مرجع دستورات (COMMAND REFERENCE)"
.IP "ls [path]"
فهرست کردن محتویات مجموعه فعلی [یا دیگر]
.IP "cd path"
تغییر مسیر به مجموعه مشخص‌شده
.IP "pwd"
نمایش نام مجموعه فعلی
.IP "put local [remote]"
بارگذاری فایل محلی
.IP "get remote [local]"
بارگیری منبع دوردست
.IP "mget remote..."
بارگیری چندین منبع دوردست
.IP "mput local..."
بارگذاری چندین فایل محلی
.IP "edit resource"
ویرایش منبع مشخص‌شده
.IP "less remote..."
نمایش منبع دوردست از طریق صفحه‌بند (pager)
.IP "mkcol remote..."
ایجاد مجموعه(های) دوردست
.IP "cat remote..."
نمایش محتوای منبع (یا منابع) دوردست
.IP "delete remote..."
حذف منبع (یا منابع) غیرمجموعه‌ای
.IP "rmcol remote..."
حذف مجموعه‌های دوردست و تمامی محتویات آن‌ها
.IP "copy source... dest"
رونوشت از منبع (یا منابع) به مقصد
.IP "move source... dest"
انتقال منبع (یا منابع) از مبدأ به مقصد
.IP "lock resource"
قفل کردن منبع مشخص‌شده
.IP "unlock resource"
آزادسازی قفل منبع مشخص‌شده
.IP "discover resource"
نمایش اطلاعات قفل منبع
.IP "steal resource"
ربودن نشان قفل (lock token) برای منبع
.IP "showlocks"
نمایش فهرست قفل‌های متعلق به کاربر
.IP "propnames res"
نام ویژگی‌های تعریف‌شده روی منبع
.IP "chexec [+|-] remote"
تغییر ویژگی قابلیت اجرا (isexecutable) منبع
.IP "propget res [propname]"
دریافت ویژگی‌های منبع
.IP "propset res propname value"
تنظیم ویژگی روی منبع
.IP "set [option] [value]"
تنظیم یک گزینه یا نمایش گزینه‌ها
.IP "open URL"
باز کردن اتصال به نشانی مشخص‌شده
.IP "close"
بستن اتصال فعلی
.IP "quit"
خروج از برنامه
.IP "unset [option] [value]"
لغو تنظیم یا پاک کردن مقدار گزینه
.IP "lcd [directory]"
تغییر پوشه کاری محلی
.IP "lls [options]"
نمایش فهرست پوشه محلی
.IP "lpwd"
چاپ مسیر پوشه کاری محلی
.IP "logout"
خروج از نشست احراز هویت
.IP "help [command]"
نمایش پیام راهنما
.SH "فایل .netrc (THE .netrc FILE)"
فایل
.I ~/.netrc
می‌تواند برای ورود خودکار به سرورهایی که نیاز به احراز هویت دارند استفاده شود. شناسه‌های زیر (که با فاصله، تب یا خط جدید از هم جدا می‌شوند) قابل استفاده هستند:
.PP
.B machine
.I host
.RS
مشخص‌کننده یک ماشین دوردست
.I host
که با نام میزبان ارائه‌شده در خط فرمان یا به عنوان آرگومان دستور
.B open
مقایسه می‌شود. تمامی شناسه‌های بعدی تا پایان فایل یا شناسه بعدی
.B machine
یا
.B default
به این مدخل اختصاص داده می‌شوند.
.RE
.PP
.B default
.RS
این شناسه معادل
.B machine
است اما با هر نام میزبانی مطابقت دارد. تنها یک شناسه
.B default
می‌تواند استفاده شود و باید پس از تمامی شناسه‌های
.B machine
قرار گیرد.
.RE
.PP
.B login
.I username
.RS
نام کاربری مورد استفاده برای ورود به ماشین دوردست را مشخص می‌کند.
.RE
.PP
.B password
.I string
.br
.B passwd
.I string
.RS
رمز عبور مورد استفاده برای ورود به ماشین دوردست را مشخص می‌کند.
.RE
.PP
سایر شناسه‌ها (مطابق توضیحات
.BR ftp (1))
نادیده گرفته می‌شوند.
.SH "مثال‌ها (EXAMPLES)"
.IP "cadaver http://myserver.example.com"
اتصال به سرور myserver.example.com و باز کردن مجموعه ریشه.
.IP "cadaver http://zope.example.com:8022/Users/fred"
اتصال به سرور zope.example.com با استفاده از پورت ۸۰۲۲ و باز کردن مجموعه "/Users/fred/".
.IP "cadaver https://secure.example.com"
اتصال به سروری به نام secure.example.com با استفاده از SSL.
.SH "فایل‌ها (FILES)"
.IP "~/.cadaverrc"
تنظیمات اختصاصی کاربر برای لغو پیش‌فرض‌های cadaver و اسکریپت‌نویسی با cadaver. این فایل می‌تواند با گزینه "\-\-rcfile" تغییر یابد.
.IP "~/.netrc"
اطلاعات ورود و مقداردهی اولیه مورد استفاده در فرآیند ورود خودکار. برای جزئیات بیشتر به بخش «فایل .netrc» مراجعه کنید.
.SH "نویسنده (AUTHOR)"
Joe Orton <https://github.com/notroj/cadaver>
.SH "همچنین ببینید (SEE ALSO)"
.BR ftp (1),
.BR smbclient (1)