.\" !!! IMPORTANT: This file is generated from s3cmd \-\-help output using format-manpage.pl
.\" !!!            Do your changes either in s3cmd file or in 'format\-manpage.pl' otherwise
.\" !!!            they will be overwritten!

.TH s3cmd 1
.SH "نام (NAME)"
s3cmd \- ابزاری برای مدیریت فضای ذخیره‌سازی Amazon S3 و شبکه توزیع محتوای Amazon CloudFront
.SH "خلاصه دستور (SYNOPSIS)"
.B s3cmd
[\fIOPTIONS\fR] \fICOMMAND\fR [\fIPARAMETERS\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
.B s3cmd
یک کلاینت خط فرمان برای رونوشت فایل‌ها به/از
Amazon S3 (سرویس ذخیره‌سازی ساده) و انجام دیگر
وظایف مرتبط است، برای نمونه ایجاد و حذف باکت‌ها،
فهرست‌کردن اشیاء و غیره.

.SH "دستورها (COMMANDS)"
.PP
.B s3cmd
می‌تواند چندین \fIعمل\fR را که با \fIدستورهای\fR زیر مشخص می‌شوند انجام دهد.
.TP
s3cmd \fBmb\fR \fIs3://BUCKET\fR
ایجاد باکت
.TP
s3cmd \fBrb\fR \fIs3://BUCKET\fR
حذف باکت
.TP
s3cmd \fBls\fR \fI[s3://BUCKET[/PREFIX]]\fR
فهرست‌کردن اشیاء یا باکت‌ها
.TP
s3cmd \fBla\fR \fI\fR
فهرست‌کردن تمام اشیاء در همهٔ باکت‌ها
.TP
s3cmd \fBput\fR \fIFILE [FILE...] s3://BUCKET[/PREFIX]\fR
قرار دادن فایل در باکت
.TP
s3cmd \fBget\fR \fIs3://BUCKET/OBJECT LOCAL_FILE\fR
دریافت فایل از باکت
.TP
s3cmd \fBdel\fR \fIs3://BUCKET/OBJECT\fR
حذف فایل از باکت
.TP
s3cmd \fBrm\fR \fIs3://BUCKET/OBJECT\fR
حذف فایل از باکت (نام مستعار برای del)
.TP
s3cmd \fBrestore\fR \fIs3://BUCKET/OBJECT\fR
بازیابی فایل از فضای ذخیره‌سازی Glacier
.TP
s3cmd \fBsync\fR \fILOCAL_DIR s3://BUCKET[/PREFIX] or s3://BUCKET[/PREFIX] LOCAL_DIR or s3://BUCKET[/PREFIX] s3://BUCKET[/PREFIX]\fR
همگام‌سازی یک درخت دایرکتوری با S3 (بررسی تازگی فایل‌ها با استفاده از اندازه و جمع‌آزمایی md5، مگر اینکه با گزینه‌ها لغو شود؛ به بخش زیر مراجعه کنید)
.TP
s3cmd \fBdu\fR \fI[s3://BUCKET[/PREFIX]]\fR
میزان مصرف دیسک توسط باکت‌ها
.TP
s3cmd \fBinfo\fR \fIs3://BUCKET[/OBJECT]\fR
دریافت اطلاعات گوناگون درباره باکت‌ها یا فایل‌ها
.TP
s3cmd \fBcp\fR \fIs3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]\fR
رونوشت شیء
.TP
s3cmd \fBmodify\fR \fIs3://BUCKET1/OBJECT\fR
تغییر متاداده شیء
.TP
s3cmd \fBmv\fR \fIs3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]\fR
انتقال شیء
.TP
s3cmd \fBsetacl\fR \fIs3://BUCKET[/OBJECT]\fR
تغییر فهرست کنترل دسترسی (ACL) برای باکت یا فایل‌ها
.TP
s3cmd \fBsetversioning\fR \fIs3://BUCKET enable|disable\fR
تغییر نسخه‌بندی باکت
.TP
s3cmd \fBsetownership\fR \fIs3://BUCKET BucketOwnerPreferred|BucketOwnerEnforced|ObjectWriter\fR
تغییر مالکیت شیء در باکت
.TP
s3cmd \fBsetblockpublicaccess\fR \fIs3://BUCKET BlockPublicAcls,IgnorePublicAcls,BlockPublicPolicy,RestrictPublicBuckets\fR
تغییر قواعد مسدودسازی دسترسی عمومی
.TP
s3cmd \fBsetobjectlegalhold\fR \fISTATUS s3://BUCKET/OBJECT\fR
تغییر وضعیت نگه‌داری قانونی شیء
.TP
s3cmd \fBsetobjectretention\fR \fIMODE RETAIN_UNTIL_DATE s3://BUCKET/OBJECT\fR
تغییر دوره نگه‌داری شیء
.TP
s3cmd \fBsetpolicy\fR \fIFILE s3://BUCKET\fR
تغییر خط‌مشی باکت
.TP
s3cmd \fBdelpolicy\fR \fIs3://BUCKET\fR
حذف خط‌مشی باکت
.TP
s3cmd \fBsetcors\fR \fIFILE s3://BUCKET\fR
تغییر CORS باکت
.TP
s3cmd \fBdelcors\fR \fIs3://BUCKET\fR
حذف CORS باکت
.TP
s3cmd \fBpayer\fR \fIs3://BUCKET\fR
تغییر خط‌مشی پرداخت توسط درخواست‌کننده باکت
.TP
s3cmd \fBmultipart\fR \fIs3://BUCKET [Id]\fR
نمایش بارگذاری‌های چندبخشی
.TP
s3cmd \fBabortmp\fR \fIs3://BUCKET/OBJECT Id\fR
لغو یک بارگذاری چندبخشی
.TP
s3cmd \fBlistmp\fR \fIs3://BUCKET/OBJECT Id\fR
فهرست‌کردن بخش‌های یک بارگذاری چندبخشی
.TP
s3cmd \fBaccesslog\fR \fIs3://BUCKET\fR
فعال/غیرفعال کردن ثبت گزارش دسترسی به باکت
.TP
s3cmd \fBsign\fR \fISTRING\-TO\-SIGN\fR
امضای رشته دلخواه با استفاده از کلید مخفی
.TP
s3cmd \fBsignurl\fR \fIs3://BUCKET/OBJECT <expiry_epoch|+expiry_offset>\fR
امضای نشانی اینترنتی S3 برای فراهم کردن دسترسی عمومی محدود با زمان انقضا
.TP
s3cmd \fBfixbucket\fR \fIs3://BUCKET[/PREFIX]\fR
تصحیح نام‌های نامعتبر فایل‌ها در باکت
.TP
s3cmd \fBsettagging\fR \fIs3://BUCKET[/OBJECT] "KEY=VALUE[&KEY=VALUE ...]"\fR
تغییر برچسب‌گذاری برای باکت یا فایل‌ها
.TP
s3cmd \fBgettagging\fR \fIs3://BUCKET[/OBJECT]\fR
دریافت برچسب‌های باکت یا فایل‌ها
.TP
s3cmd \fBdeltagging\fR \fIs3://BUCKET[/OBJECT]\fR
حذف برچسب‌های باکت یا فایل‌ها
.TP
s3cmd \fBexpire\fR \fIs3://BUCKET\fR
تنظیم یا حذف قاعده انقضا برای باکت
.TP
s3cmd \fBsetlifecycle\fR \fIFILE s3://BUCKET\fR
بارگذاری خط‌مشی چرخه حیات برای باکت
.TP
s3cmd \fBgetlifecycle\fR \fIs3://BUCKET\fR
دریافت خط‌مشی چرخه حیات برای باکت
.TP
s3cmd \fBdellifecycle\fR \fIs3://BUCKET\fR
حذف خط‌مشی چرخه حیات باکت
.TP
s3cmd \fBsetnotification\fR \fIFILE s3://BUCKET\fR
بارگذاری خط‌مشی اعلان برای باکت
.TP
s3cmd \fBgetnotification\fR \fIs3://BUCKET\fR
دریافت خط‌مشی اعلان برای باکت
.TP
s3cmd \fBdelnotification\fR \fIs3://BUCKET\fR
حذف خط‌مشی اعلان باکت


.PP
دستورهای پیکربندی وب‌سایت‌های ایستا
.TP
s3cmd \fBws\-create\fR \fIs3://BUCKET\fR
ایجاد وب‌سایت از باکت
.TP
s3cmd \fBws\-delete\fR \fIs3://BUCKET\fR
حذف وب‌سایت
.TP
s3cmd \fBws\-info\fR \fIs3://BUCKET\fR
اطلاعات درباره وب‌سایت


.PP
دستورهای مدیریت CloudFront
.TP
s3cmd \fBcflist\fR \fI\fR
فهرست‌کردن نقاط توزیع CloudFront
.TP
s3cmd \fBcfinfo\fR \fI[cf://DIST_ID]\fR
نمایش پارامترهای نقطه توزیع CloudFront
.TP
s3cmd \fBcfcreate\fR \fIs3://BUCKET\fR
ایجاد نقطه توزیع CloudFront
.TP
s3cmd \fBcfdelete\fR \fIcf://DIST_ID\fR
حذف نقطه توزیع CloudFront.TP
s3cmd \fBcfmodify\fR \fIcf://DIST_ID\fR
تغییر پارامترهای نقطه توزیع CloudFront
.TP
s3cmd \fBcfinval\fR \fIs3://BUCKET/OBJECT [s3://BUCKET/OBJECT ...]\fR
باطل‌سازی (Invalidate) اشیاء CloudFront
.TP
s3cmd \fBcfinvalinfo\fR \fIcf://DIST_ID[/INVAL_ID]\fR
نمایش وضعیت درخواست(های) باطل‌سازی CloudFront


.SH "گزینه‌ها (OPTIONS)"
.PP
مقادیر پیش‌فرض برخی از گزینه‌های مشخص‌شده در زیر را می‌توان در فایل پیکربندی
.B s3cmd
(به‌طور پیش‌فرض $HOME/.s3cmd) تعیین کرد. از آنجا که این فایل یک فایل متنی ساده است،
می‌توانید آن را با ویرایشگر متنی دلخواه خود باز کرده و تغییرات مورد نظر خود را
اعمال کنید.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما و خروج
.TP
\fB\-\-configure\fR
فراخوانی ابزار تعاملی پیکربندی (یا پیکربندی مجدد). همچنین می‌توانید به‌صورت
اختياری از '\fB\-\-configure\fR s3://some\-bucket' برای آزمایش دسترسی به یک باکت
خاص به‌جای تلاش برای فهرست کردن همه آن‌ها استفاده کنید.
.TP
\fB\-c\fR FILE, \fB\-\-config\fR=FILE
نام فایل پیکربندی. پیش‌فرض $HOME/.s3cfg است.
.TP
\fB\-\-dump\-config\fR
نمایش و تخلیه پیکربندی فعلی پس از تجزیه فایل‌های پیکربندی و گزینه‌های خط فرمان
و سپس خروج.
.TP
\fB\-\-access_key\fR=ACCESS_KEY
کلید دسترسی (Access Key) در AWS
.TP
\fB\-\-secret_key\fR=SECRET_KEY
کلید محرمانه (Secret Key) در AWS
.TP
\fB\-\-access_token\fR=ACCESS_TOKEN
توکن دسترسی (Access Token) در AWS
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
فقط نشان می‌دهد چه مواردی باید بارگذاری یا بارگیری شوند، اما در عمل کاری انجام
نمی‌دهد. با این حال ممکن است همچنان درخواست‌های S3 را برای دریافت فهرست باکت‌ها
و سایر اطلاعات انجام دهد (فقط برای دستورهای انتقال فایل).
.TP
\fB\-s\fR, \fB\-\-ssl\fR
استفاده از اتصال HTTPS هنگام برقراری ارتباط با S3.
(پیش‌فرض)
.TP
\fB\-\-no\-ssl\fR
عدم استفاده از HTTPS.
.TP
\fB\-e\fR, \fB\-\-encrypt\fR
رمزگذاری فایل‌ها پیش از بارگذاری در S3.
.TP
\fB\-\-no\-encrypt\fR
عدم رمزگذاری فایل‌ها.
.TP
\fB\-f\fR, \fB\-\-force\fR
اجبار در رونویسی و سایر عملیات‌های خطرناک.
.TP
\fB\-\-continue\fR
ادامه دریافت یک فایل نیمه‌بارگیری‌شده (فقط برای دستور [get]).
.TP
\fB\-\-continue\-put\fR
ادامه بارگذاری فایل‌های نیمه‌بارگذاری‌شده یا بخش‌های بارگذاری چندبخشی (multipart).
بخش‌ها یا فایل‌هایی را که اندازه و مقدار md5 یکسانی ندارند را مجدداً بارگذاری
می‌کند. فایل‌ها یا بخش‌های دارای اندازه و md5 یکسان را نادیده می‌گیرد.
نکته: بررسی‌های md5sum همیشه برای بررسی یکسانی (بخش‌های) فایل کافی نیستند.
این گزینه را با مسئولیت خود فعال کنید.
.TP
\fB\-\-upload\-id\fR=UPLOAD_ID
شناسه UploadId برای بارگذاری چندبخشی، در صورتی که بخواهید یک بارگذاری موجود
را ادامه دهید (معادل \fB\-\-continue\-put\fR) و چندین بارگذاری ناقص وجود داشته باشد.
از دستور s3cmd multipart [URI] استفاده کنید تا ببینید چه UploadIdهایی با URI داده‌شده
مرتبط هستند.
.TP
\fB\-\-skip\-existing\fR
نادیده گرفتن فایل‌هایی که در مقصد وجود دارند (فقط برای دستورهای [get] و [sync]).
.TP
\fB\-r\fR, \fB\-\-recursive\fR
بارگذاری، بارگیری یا حذف بازگشتی (recursive).
.TP
\fB\-\-check\-md5\fR
بررسی مقادیر مجموع کنترل MD5 هنگام مقایسه فایل‌ها برای [sync].
(پیش‌فرض)
.TP
\fB\-\-no\-check\-md5\fR
عدم بررسی مقادیر مجموع کنترل MD5 هنگام مقایسه فایل‌ها برای [sync].
تنها اندازه فایل مقایسه خواهد شد. ممکن است سرعت انتقال را به‌طور چشمگیری
افزایش دهد اما ممکن است برخی فایل‌های تغییریافته را نادیده بگیرد.
.TP
\fB\-P\fR, \fB\-\-acl\-public\fR
ذخیره اشیاء با ACL که به هر کسی اجازه خواندن می‌دهد.
.TP
\fB\-\-acl\-private\fR
ذخیره اشیاء با ACL پیش‌فرض که تنها به شما اجازه دسترسی می‌دهد.
.TP
\fB\-\-acl\-grant\fR=PERMISSION:EMAIL or USER_CANONICAL_ID
اعطای مجوز مشخص‌شده به کاربر داده‌شده در آمازون.
مجوز یکی از این موارد است: read، write، read_acp، write_acp، full_control، all
.TP
\fB\-\-acl\-revoke\fR=PERMISSION:USER_CANONICAL_ID
لغو مجوز مشخص‌شده برای کاربر داده‌شده در آمازون.
مجوز یکی از این موارد است: read، write، read_acp، write_acp، full_control، all
.TP
\fB\-D\fR NUM, \fB\-\-restore\-days\fR=NUM
تعداد روزهایی که فایل بازیابی‌شده در دسترس نگه داشته می‌شود (تنها برای
دستور 'restore'). پیش‌فرض ۱ روز است.
.TP
\fB\-\-restore\-priority\fR=RESTORE_PRIORITY
اولویت بازیابی فایل‌ها از S3 Glacier (تنها برای دستور 'restore').
گزینه‌های موجود: bulk، standard، expedited
.TP
\fB\-\-delete\-removed\fR
حذف اشیای مقصد در صورتی که فایل متناظری در مبدأ وجود نداشته باشد [sync]
.TP
\fB\-\-no\-delete\-removed\fR
عدم حذف اشیای مقصد [sync]
.TP
\fB\-\-delete\-after\fR
انجام حذف‌ها پس از بارگذاری‌های جدید هنگامی که delete-removed فعال است [sync]
.TP
\fB\-\-delay\-updates\fR
*منسوخ‌شده* قرار دادن تمام فایل‌های به‌روزرسانی‌شده در جای خود در پایان کار [sync]
.TP
\fB\-\-max\-delete\fR=NUM
عدم حذف بیش از NUM فایل. [del] و [sync]
.TP
\fB\-\-limit\fR=NUM
محدود کردن تعداد اشیای بازگردانده‌شده در بدنه پاسخ
(تنها برای دستورهای [ls] و [la])
.TP
\fB\-\-add\-destination\fR=ADDITIONAL_DESTINATIONS
مقصد اضافی برای بارگذاری‌های موازی، علاوه بر آخرین آرگومان.
می‌تواند تکرار شود.
.TP
\fB\-\-delete\-after\-fetch\fR
حذف اشیای دوردست پس از واکشی به فایل محلی
(تنها برای دستورهای [get] و [sync]).
.TP
\fB\-p\fR, \fB\-\-preserve\fR
حفظ ویژگی‌های فایل‌سیستم (دسترسی‌ها، مالکیت، برچسب‌های زمانی).
پیش‌فرض برای دستور [sync].
.TP
\fB\-\-no\-preserve\fR
عدم ذخیره ویژگی‌های فایل‌سیستم
.TP
\fB\-\-keep\-dirs\fR
حفظ تمام دایرکتوری‌های محلی به‌صورت اشیای دوردست از جمله دایرکتوری‌های خالی.
ویژگی آزمایشی.
.TP
\fB\-\-exclude\fR=GLOB
نام‌های فایل و مسیرهای منطبق با GLOB از همگام‌سازی (sync) مستثنی خواهند شد
.TP
\fB\-\-exclude\-from\fR=FILE
خواندن الگوهای GLOB مربوط به --exclude از FILE
.TP
\fB\-\-rexclude\fR=REGEXP
نام‌های فایل و مسیرهای منطبق با REGEXP (عبارت باقاعده) از همگام‌سازی
(sync) مستثنی خواهند شد
.TP
\fB\-\-rexclude\-from\fR=FILE
خواندن عبارات باقاعده REGEXP مربوط به --rexclude از FILE.TP
\fB\-\-include\fR=GLOB
نام‌های فایل و مسیرهای منطبق بر GLOB گنجانده خواهند شد، حتی اگر قبلاً توسط یکی از الگوهای
\fB\-\-(r)exclude(\-from)\fR مستثنی شده باشند.
.TP
\fB\-\-include\-from\fR=FILE
خواندن الگوهای GLOB گزینه \-\-include از FILE.
.TP
\fB\-\-rinclude\fR=REGEXP
مشابه \-\-include است اما به جای GLOB از REGEXP (عبارت باقاعده) استفاده می‌کند.
.TP
\fB\-\-rinclude\-from\fR=FILE
خواندن الگوهای باقاعده REGEXP برای \-\-rinclude از FILE.
.TP
\fB\-\-files\-from\fR=FILE
خواندن فهرست نام‌های فایل‌های مبدأ از FILE. برای خواندن از stdin از \- استفاده کنید.
.TP
\fB\-\-region\fR=REGION, \fB\-\-bucket\-location\fR=REGION
منطقه‌ای (Region) که باکت در آن ایجاد می‌شود. در حال حاضر منطقه‌ها عبارتند از:
us\-east\-1، us\-west\-1، us\-west\-2، eu\-west\-1، eu\-central\-1، ap\-northeast\-1، ap\-southeast\-1، ap\-southeast\-2، sa\-east\-1
.TP
\fB\-\-host\fR=HOSTNAME
مقدار HOSTNAME:PORT برای نقطه پایانی S3 (پیش‌فرض:
s3.amazonaws.com، یا گزینه‌های جایگزین مانند s3\-eu\-west\-1.amazonaws.com). همچنین باید \fB\-\-host\-bucket\fR را نیز تنظیم کنید.
.TP
\fB\-\-host\-bucket\fR=HOST_BUCKET
الگوی bucket+hostname:port به سبک DNS برای دسترسی به یک باکت (پیش‌فرض: %(bucket)s.s3.amazonaws.com)
.TP
\fB\-\-reduced\-redundancy\fR, \fB\-\-rr\fR
ذخیره شیء با «Reduced redundancy» (افزونگی کاهش‌یافته). هزینه کمتر به ازای هر گیگابایت. [دستورهای put، cp، mv]
.TP
\fB\-\-no\-reduced\-redundancy\fR, \fB\-\-no\-rr\fR
ذخیره شیء بدون «Reduced redundancy». هزینه بیشتر به ازای هر گیگابایت. [دستورهای put، cp، mv]
.TP
\fB\-\-storage\-class\fR=CLASS
ذخیره شیء با CLASS مشخص‌شده (STANDARD، STANDARD_IA، ONEZONE_IA، INTELLIGENT_TIERING، GLACIER یا DEEP_ARCHIVE). [دستورهای put، cp، mv]
.TP
\fB\-\-access\-logging\-target\-prefix\fR=LOG_TARGET_PREFIX
پیشوند مقصد برای گزارش‌های دسترسی (S3 URI) (برای دستورهای [cfmodify] و [accesslog])
.TP
\fB\-\-no\-access\-logging\fR
غیرفعال‌سازی ثبت گزارش‌های دسترسی (برای دستورهای [cfmodify] و [accesslog])
.TP
\fB\-\-default\-mime\-type\fR=DEFAULT_MIME_TYPE
نوع MIME پیش‌فرض برای اشیاء ذخیره‌شده. پیش‌فرض برنامه binary/octet\-stream است.
.TP
\fB\-M\fR, \fB\-\-guess\-mime\-type\fR
حدس زدن نوع MIME فایل‌ها از روی پسوند آن‌ها یا mime magic. در صورت عدم تشخیص، استفاده از MIME\-Type پیش‌فرضِ مشخص‌شده با گزینه
\fB\-\-default\-mime\-type\fR
.TP
\fB\-\-no\-guess\-mime\-type\fR
نوع MIME حدس زده نشود و در عوض از نوع پیش‌فرض استفاده شود.
.TP
\fB\-\-no\-mime\-magic\fR
عدم استفاده از mime magic هنگام حدس زدن نوع MIME.
.TP
\fB\-m\fR MIME/TYPE, \fB\-\-mime\-type\fR=MIME/TYPE
اجبار در تعیین نوع MIME. نادیده گرفتن هر دو گزینه \fB\-\-default\-mime\-type\fR و \fB\-\-guess\-mime\-type\fR.
.TP
\fB\-\-add\-header\fR=NAME:VALUE
افزودن یک سرآیند مشخص HTTP به درخواست بارگذاری. می‌تواند چندین بار استفاده شود. به عنوان مثال تنظیم سرآیندهای \(aqExpires\(aq یا
\&'Cache\-Control\(aq (یا هر دو) با استفاده از این گزینه.
.TP
\fB\-\-remove\-header\fR=NAME
حذف یک سرآیند مشخص HTTP. می‌تواند چندین بار استفاده شود. برای نمونه، حذف سرآیندهای \(aqExpires\(aq یا \(aqCache\-Control\(aq (یا هر دو) با استفاده از این گزینه. [دستور modify]
.TP
\fB\-\-server\-side\-encryption\fR
مشخص می‌کند که هنگام ارسال اشیاء از رمزگذاری سمت سرور استفاده شود. [دستورهای put، sync، cp، modify]
.TP
\fB\-\-server\-side\-encryption\-kms\-id\fR=KMS_KEY
شناسه کلید مورد استفاده برای رمزگذاری سمت سرور با کلیدهای مدیریت‌شده AWS KMS‏ (SSE\-KMS) هنگام ارسال اشیاء را مشخص می‌کند. [دستورهای put، sync، cp، modify]
.TP
\fB\-\-encoding\fR=ENCODING
نادیده‌گرفتن کدگذاری (مجموعه نویسه) شناسایی‌شده به طور خودکار برای ترمینال و سامانه فایل. شناسایی‌شده خودکار: UTF\-8
.TP
\fB\-\-add\-encoding\-exts\fR=EXTENSIONs
افزودن کدگذاری به این پسوندهای جداشده با کاما، مانند (css,js,html)، هنگام بارگذاری به S3.
.TP
\fB\-\-verbatim\fR
استفاده از نام S3 دقیقاً به همان صورت که در خط فرمان داده شده است. بدون پیش‌پردازش، کدگذاری و غیره. با احتیاط استفاده شود!
.TP
\fB\-\-disable\-multipart\fR
غیرفعال‌سازی بارگذاری چندبخشی برای فایل‌های بزرگ‌تر از
\fB\-\-multipart\-chunk\-size\-mb\fR
.TP
\fB\-\-multipart\-chunk\-size\-mb\fR=SIZE
اندازه هر تکه در بارگذاری چندبخشی. فایل‌های بزرگ‌تر از SIZE به طور خودکار به صورت چندبخشیِ چندنخی بارگذاری می‌شوند؛ فایل‌های کوچک‌تر با استفاده از روش سنتی بارگذاری خواهند شد. مقدار SIZE بر حسب مگابایت است، اندازه تکه پیش‌فرض 15MB، حداقل اندازه مجاز 5MB و حداکثر آن 5GB است.
.TP
\fB\-\-list\-md5\fR
گنجاندن مقادیر MD5 در فهرست‌بندی باکت (تنها برای دستور \(aqls\(aq).
.TP
\fB\-\-list\-allow\-unordered\fR
از استانداردهای AWS نیست. اجازه می‌دهد نتایج فهرست‌بندی به صورت نامرتب بازگردانده شوند. این قابلیت ممکن است هنگام فهرست کردن باکت‌های بسیار بزرگ سریع‌تر عمل کند.
.TP
\fB\-H\fR, \fB\-\-human\-readable\-sizes\fR
نمایش اندازه‌ها با قالبی خوانا برای انسان (مثلاً 1kB به جای 1234).
.TP
\fB\-\-ws\-index\fR=WEBSITE_INDEX
نام سند شاخص (index\-document) (تنها برای دستور [ws\-create])
.TP
\fB\-\-ws\-error\fR=WEBSITE_ERROR
نام سند خطا (error\-document) (تنها برای دستور [ws\-create])
.TP
\fB\-\-expiry\-date\fR=EXPIRY_DATE
مشخص می‌کند که قانون انقضا از چه زمانی اجرایی می‌شود (تنها برای دستور [expire]).
.TP
\fB\-\-expiry\-days\fR=EXPIRY_DAYS
تعداد روزهای پس از ایجاد شیء را مشخص می‌کند که قانون انقضا پس از آن اجرایی می‌شود (تنها برای دستور [expire]).
.TP
\fB\-\-expiry\-prefix\fR=EXPIRY_PREFIX
مشخص‌کننده یک یا چند شیء با پیشوندی که قانون انقضا بر آن‌ها اعمال می‌شود (تنها برای دستور [expire]).
.TP
\fB\-\-skip\-destination\-validation\fR
صرف‌نظر کردن از اعتبارسنجی مقصدهای Amazon SQS، Amazon SNS و AWS Lambda هنگام اعمال پیکربندی اعلان‌ها (تنها برای دستور [setnotification]).
.TP
\fB\-\-progress\fR
نمایش نشانگر پیشرفت (پیش‌فرض در TTY).
.TP
\fB\-\-no\-progress\fR
عدم نمایش نشانگر پیشرفت (پیش‌فرض در محیط‌های غیر TTY).
.TP
\fB\-\-stats\fR
نمایش برخی آمارهای مربوط به انتقال فایل.
.TP
\fB\-\-enable\fR
فعال‌سازی توزیع مشخص‌شده در CloudFront (تنها برای دستور [cfmodify]).
.TP
\fB\-\-disable\fR
غیرفعال‌سازی توزیع مشخص‌شده در CloudFront (تنها برای دستور [cfmodify]).
.TP
\fB\-\-cf\-invalidate\fR
نامعتبر کردن (Invalidate) فایل‌های بارگذاری‌شده در CloudFront. همچنین به دستور [cfinval] مراجعه کنید.
.TP
\fB\-\-cf\-invalidate\-default\-index\fR
هنگام استفاده از Custom Origin و وب‌گاه ایستای S3، فایل شاخص (index) پیش‌فرض را نامعتبر می‌کند..TP
\fB\-\-cf\-no\-invalidate\-default\-index\-root\fR
هنگام استفاده از Custom Origin و وب‌گاه ایستای S3، مسیر فایل شاخص پیش‌فرض را باطل نکن.
.TP
\fB\-\-cf\-add\-cname\fR=CNAME
افزودن CNAME داده‌شده به یک توزیع CloudFront (فقط برای دستورهای [cfcreate] و [cfmodify])
.TP
\fB\-\-cf\-remove\-cname\fR=CNAME
حذف CNAME داده‌شده از یک توزیع CloudFront (فقط برای دستور [cfmodify])
.TP
\fB\-\-cf\-comment\fR=COMMENT
تنظیم COMMENT برای یک توزیع CloudFront داده‌شده (فقط برای دستورهای [cfcreate] و [cfmodify])
.TP
\fB\-\-cf\-default\-root\-object\fR=DEFAULT_ROOT_OBJECT
تنظیم شیء ریشهٔ پیش‌فرض برای بازگرداندن هنگامی که هیچ شیئی در نشانی اینترنتی (URL) مشخص نشده است. از یک مسیر نسبی استفاده کنید، یعنی default/index.html به‌جای /default/index.html یا s3://bucket/default/index.html (فقط برای دستورهای [cfcreate] و [cfmodify])
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال‌سازی خروجی پرجزئیات.
.TP
\fB\-d\fR, \fB\-\-debug\fR
فعال‌سازی خروجی اشکال‌زدایی.
.TP
\fB\-\-version\fR
نمایش نسخهٔ s3cmd (2.4.0) و خروج.
.TP
\fB\-F\fR, \fB\-\-follow\-symlinks\fR
دنبال کردن پیوندهای نمادین مانند فایل‌های معمولی
.TP
\fB\-\-cache\-file\fR=FILE
فایل ذخیره‌گاه FILE حاوی مقادیر MD5 مبدأ محلی
.TP
\fB\-q\fR, \fB\-\-quiet\fR
بی‌صدا کردن خروجی در خروجی استاندارد (stdout)
.TP
\fB\-\-ca\-certs\fR=CA_CERTS_FILE
مسیر فایل گواهی SSL CA با نام CA_CERTS_FILE (به‌جای پیش‌فرض سیستم)
.TP
\fB\-\-ssl\-cert\fR=SSL_CLIENT_CERT_FILE
مسیر فایل گواهی SSL اختصاصی کارخواه CRT_FILE
.TP
\fB\-\-ssl\-key\fR=SSL_CLIENT_KEY_FILE
مسیر فایل کلید خصوصی گواهی SSL اختصاصی کارخواه KEY_FILE
.TP
\fB\-\-check\-certificate\fR
بررسی اعتبار گواهی SSL
.TP
\fB\-\-no\-check\-certificate\fR
عدم بررسی اعتبار گواهی SSL
.TP
\fB\-\-check\-hostname\fR
بررسی اعتبار نام میزبان در گواهی SSL
.TP
\fB\-\-no\-check\-hostname\fR
عدم بررسی اعتبار نام میزبان در گواهی SSL
.TP
\fB\-\-signature\-v2\fR
استفاده از نسخهٔ ۲ امضای AWS به‌جای روش‌های جدیدتر امضا. برای سامانه‌های مشابه S3 که هنوز نسخهٔ ۴ امضای AWS را ندارند مفید است.
.TP
\fB\-\-limit\-rate\fR=LIMITRATE
محدود کردن سرعت بارگذاری یا بارگیری به مقداری مشخص از بایت بر ثانیه. این مقدار می‌تواند برحسب بایت، کیلوبایت با پسوند k، یا مگابایت با پسوند m مشخص شود
.TP
\fB\-\-no\-connection\-pooling\fR
غیرفعال‌سازی استفادهٔ مجدد از اتصال
.TP
\fB\-\-requester\-pays\fR
تنظیم پرچم REQUESTER PAYS برای عملیات‌ها
.TP
\fB\-l\fR, \fB\-\-long\-listing\fR
تولید فهرست بلند [ls]
.TP
\fB\-\-stop\-on\-error\fR
توقف در صورت بروز خطا در انتقال
.TP
\fB\-\-max\-retries\fR=NUM
حداکثر دفعات تلاش مجدد برای یک درخواست ناموفق پیش از صرف‌نظر کردن. پیش‌فرض ۵ است
.TP
\fB\-\-content\-disposition\fR=CONTENT_DISPOSITION
ارائه یک Content\-Disposition برای نشانی‌های اینترنتی امضاشده، مانند:
"inline; filename=myvideo.mp4"
.TP
\fB\-\-content\-type\fR=CONTENT_TYPE
ارائه یک Content\-Type برای نشانی‌های اینترنتی امضاشده، مانند:
"video/mp4".SH "مثال‌ها (EXAMPLES)"
یکی از قدرتمندترین دستورهای \fIs3cmd\fR دستور \fBs3cmd sync\fR است که برای
همگام‌سازی کامل درخت دایرکتوری‌ها به یا از حافظهٔ دوردست S3 استفاده می‌شود. تا حدودی
\fBs3cmd put\fR و \fBs3cmd get\fR رفتار مشابهی با \fBsync\fR دارند.
.PP
کاربرد پایه‌ای که در سناریوهای پشتیبان‌گیری رایج است، به همین سادگی است:
.nf
	s3cmd sync /local/path/ s3://test\-bucket/backup/
.fi
.PP
این دستور همهٔ فایل‌های زیر دایرکتوری /local/path را پیدا کرده و آن‌ها را
در مسیرهای متناظر در s3://test\-bucket/backup در سمت دوردست کپی می‌کند.
برای مثال:
.nf
	/local/path/\fBfile1.ext\fR         \->  s3://bucket/backup/\fBfile1.ext\fR
	/local/path/\fBdir123/file2.bin\fR  \->  s3://bucket/backup/\fBdir123/file2.bin\fR
.fi
.PP
با این حال، اگر مسیر محلی با یک اسلش پایان نیابد، نام آخرین دایرکتوری
نیز در سمت دوردست استفاده می‌شود. این را با مثال قبلی مقایسه کنید:
.nf
	s3cmd sync /local/path s3://test\-bucket/backup/
.fi
موارد زیر را همگام خواهد کرد:
.nf
	/local/\fBpath/file1.ext\fR         \->  s3://bucket/backup/\fBpath/file1.ext\fR
	/local/\fBpath/dir123/file2.bin\fR  \->  s3://bucket/backup/\fBpath/dir123/file2.bin\fR
.fi
.PP
برای بازگردانی فایل‌ها از S3، از ساختار برعکس استفاده کنید:
.nf
	s3cmd sync s3://test\-bucket/backup/ ~/restore/
.fi
که این فایل‌ها را بارگیری خواهد کرد:
.nf
	s3://bucket/backup/\fBfile1.ext\fR         \->  ~/restore/\fBfile1.ext\fR
	s3://bucket/backup/\fBdir123/file2.bin\fR  \->  ~/restore/\fBdir123/file2.bin\fR
.fi
.PP
بدون اسلش پایانی در مبدأ، رفتار مشابه چیزی خواهد بود که
در بارگذاری نشان داده شد:
.nf
	s3cmd sync s3://test\-bucket/backup ~/restore/
.fi
فایل‌ها را بدین شکل بارگیری خواهد کرد:
.nf
	s3://bucket/\fBbackup/file1.ext\fR         \->  ~/restore/\fBbackup/file1.ext\fR
	s3://bucket/\fBbackup/dir123/file2.bin\fR  \->  ~/restore/\fBbackup/dir123/file2.bin\fR
.fi
.PP
همهٔ نام‌های فایل‌های مبدأ (موارد برجسته در بالا) با قواعد \fBexclude\fR
مطابقت داده می‌شوند و مواردی که مطابقت دارند، سپس دوباره با قواعد \fBinclude\fR بررسی می‌شوند
تا مشخص شود که آیا باید کنار گذاشته شوند یا در فهرست مبدأ نگه‌داشته شوند.
.PP
به منظور تطبیق \fB\-\-exclude\fR و \fB\-\-include\fR فقط نام فایل‌های
پررنگ شده در بالا به کار می‌روند. به عنوان مثال، فقط \fBpath/file1.ext\fR با الگوها
بررسی می‌شود، نه \fI/local/\fBpath/file1.ext\fR
.PP
هر دو گزینهٔ \fB\-\-exclude\fR و \fB\-\-include\fR با نویسه‌های عام سبک پوسته (معروف به GLOB) کار می‌کنند.
برای انعطاف‌پذیری بیشتر، s3cmd نسخه‌های عبارت باقاعده (Regular\-expression) از این دو گزینه را
با نام‌های \fB\-\-rexclude\fR و \fB\-\-rinclude\fR فراهم می‌کند.
گزینه‌های دارای پسوند ...\fB\-from\fR (مانند \-\-rinclude\-from) یک نام فایل را به عنوان
یک آرگومان می‌پذیرند. هر خط از چنین فایلی به عنوان یک الگو در نظر گرفته می‌شود.
.PP
تنها یک مجموعه الگو از تمام گزینه‌های \fB\-\-(r)exclude(\-from)\fR ساخته می‌شود
و به طور مشابه برای نوع include نیز چنین است. هر فایلی که برای مثال با \-\-exclude کنار گذاشته شده باشد،
می‌تواند با الگویی که در فهرست \-\-rinclude\-from یافت می‌شود، بازگردانده شود.
.PP
دستور s3cmd را با \fB\-\-dry\-run\fR اجرا کنید تا مطمئن شوید قواعد شما همان‌طور که انتظار می‌رود کار می‌کنند.
از آن به همراه \fB\-\-debug\fR استفاده کنید تا اطلاعات دقیقی
دربارهٔ تطبیق نام فایل‌ها با قواعد exclude و include به دست آورید.
.PP
برای مثال، جهت مستثنی کردن همهٔ فایل‌های دارای پسوند ".jpg" به جز آن‌هایی که با یک عدد آغاز می‌شوند، استفاده کنید از:
.PP
	\-\-exclude '*.jpg' \-\-rinclude '[0\-9].*\.jpg'
.PP
برای مستثنی کردن همهٔ فایل‌ها به جز مواردی با پسوند "*.jpg"، استفاده کنید از:
.PP
	\-\-exclude '*' \-\-include '*.jpg'
.PP
برای مستثنی کردن دایرکتوری محلی 'somedir'، حتماً از یک اسلش رو به جلو در انتها استفاده کنید، بدین صورت:
.PP
	\-\-exclude 'somedir/'
.PP.SH "همچنین ببینید (SEE ALSO)"
برای مشاهدهٔ به‌روزترین فهرست گزینه‌ها، این دستور را اجرا کنید:
.B s3cmd \-\-help
.br
برای کسب اطلاعات بیشتر درباره نحوه استفاده، مثال‌ها و دیگر اطلاعات مرتبط، به صفحه اصلی پروژه مراجعه کنید:
.B https://s3tools.org
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Michal Ludvig، Florent Viard و مشارکت‌کنندگان
.SH "تماس و پشتیبانی (CONTACT, SUPPORT)"
روش ترجیحی برای دریافت پشتیبانی، فهرست پستی ما است:
.br
.I s3tools\-general@lists.sourceforge.net
.br
یا به صفحه اصلی پروژه مراجعه کنید:
.br
.B https://s3tools.org
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها را به این نشانی ارسال کنید:
.I s3tools\-bugs@lists.sourceforge.net
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
کپی‌رایت \(co 2007\-2023 متعلق به TGRMN Software (https://www.tgrmn.com)، Sodria SAS (https://www.sodria.com) و مشارکت‌کنندگان است.
.br
.SH "مجوز (LICENSE)"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز همگانی عمومی گنو (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation)؛ چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بعدی، بازتوزیع کرده یا تغییر دهید.
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب با یک هدف خاص. برای جزئیات بیشتر به مجوز همگانی عمومی گنو مراجعه کنید.
.br