.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-VSI-SYNC" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vsi-sync \- همگام‌سازی فایل یا دایرکتوری مبدأ و مقصد در واسط سیستم مجازی GDAL (VSI)
.sp
در نسخه 3.11 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal vsi sync [OPTIONS] <SOURCE> <DESTINATION>

همگام‌سازی فایل یا دایرکتوری مبدأ و مقصد در واسط سیستم مجازی GDAL (VSI).

آرگومان‌های موقعیتی:
  \-\-source <SOURCE>                نام فایل یا دایرکتوری مبدأ [الزامی]
  \-\-destination <DESTINATION>      نام فایل یا دایرکتوری مقصد [الزامی]

گزینه‌های عمومی:
  \-h, \-\-help                       نمایش پیام راهنما و خروج
  \-\-json\-usage                     نمایش نحوه استفاده به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>           گزینه پیکربندی [قابل تکرار]
  \-q, \-\-quiet                      حالت ساکت (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]

گزینه‌ها:
  \-r, \-\-recursive                  همگام‌سازی به صورت بازگشتی
  \-\-strategy <STRATEGY>            راهبرد همگام‌سازی. STRATEGY=timestamp|ETag|overwrite (پیش‌فرض: timestamp)
  \-j, \-\-num\-threads <NUM\-THREADS>  تعداد وظایف همزمان (یا ALL_CPUS)
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vsi sync\fP فایل‌ها و دایرکتوری‌های واقع در \fI\%سیستم‌های فایل مجازی GDAL (فشرده‌شده، میزبانی‌شده در شبکه و غیره: /vsimem، /vsizip، /vsitar، /vsicurl و...)\fP را همگام‌سازی می‌کند.
.sp
این ابزار مشابه دستور \fBrsync\fP در یونیکس است. در پیاده‌سازی فعلی، \fBrsync\fP برای کپی محلی فایل‌ها کارآمدتر است، اما مزیت اصلی \fBgdal vsi sync\fP زمانی است که مبدأ یا مقصد یک سیستم فایل راه دور مانند /vsis3/ یا /vsigs/ باشد؛ در این حالت می‌تواند زمان ثبت فایل‌ها (یا به صورت اختیاری ETag/MD5Sum) را در نظر بگیرد تا از عملیات کپی غیرضروری جلوگیری شود.
.sp
این عملکرد به صورت بهینه برای موارد زیر پیاده‌سازی شده است:
.INDENT 0.0
.IP \(bu 2
سیستم فایل محلی <\-\-> سیستم فایل راه دور.
.IP \(bu 2
سیستم فایل راه دور <\-\-> سیستم فایل راه دور، جایی که سیستم‌های فایل مبدأ و مقصد یکسان و یکی از /vsis3/، /vsigs/ یا /vsiaz/ باشند؛ یا وقتی مقصد /vsiaz/ و مبدأ یکی از /vsis3/، /vsigs/، /vsiadls/ یا /vsicurl/ باشد.
.UNINDENT
.sp
مشابه با رفتار \fBrsync\fP، اگر نام فایل مبدأ با یک اسلش به پایان برسد، به این معناست که محتوای دایرکتوری باید کپی شود، نه خود نام دایرکتوری. برای مثال، با فرض اینکه \fB/home/even/foo\fP حاوی فایل \fBbar\fP باشد، اجرای \fBgdal vsi sync \-r /home/even/foo/ /mnt/media\fP فایل \fB/mnt/media/bar\fP را ایجاد می‌کند. در حالی که اجرای \fBgdal vsi sync \-r /home/even/foo /mnt/media\fP دایرکتوری \fB/mnt/media/foo\fP را ایجاد می‌کند که حاوی فایل \fBbar\fP است.
.sp
این ویژگی توسط \fI\%VSISync()\fP پیاده‌سازی شده است.
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-r, \-\-recursive
همگام‌سازی به صورت بازگشتی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strategy timestamp|ETag|overwrite
تعیین می‌کند که در صورت وجود فایل مقصد با اندازه یکسان با فایل مبدأ، از چه معیاری برای تصمیم‌گیری درباره جایگزینی آن استفاده شود. تنها برای حالتی اعمال می‌شود که مبدأ یا مقصد یک سیستم فایل تحت شبکه باشد.
.sp
مقدار پیش‌فرض \fBtimestamp\fP است (مشابه نحوه عملکرد \fBaws s3 sync\fP).
برای عملیات بارگذاری (upload)، فایل راه دور در صورتی که اندازه متفاوتی داشته باشد یا قدیمی‌تر از فایل مبدأ باشد، جایگزین می‌شود.
برای عملیات بارگیری (download)، فایل محلی در صورتی که اندازه متفاوتی داشته باشد یا جدیدتر از فایل راه دور باشد، جایگزین می‌شود.
.sp
راهبرد \fBETag\fP فرض می‌کند که متادیتای ETag فایل راه دور، همان MD5Sum محتوای فایل است که این فرض تنها در مورد /vsis3/ برای فایل‌هایی که از رمزنگاری سمت سرور KMS استفاده نمی‌کنند و در یک عملیات تک‌مرحله‌ای PUT بارگذاری شده‌اند (بنابراین با توجه به مقدار پیش‌فرض GDAL، کوچکتر از ۵۰ مگابایت هستند) صادق است. این گزینه تنها باید برای /vsis3/، /vsigs/ یا سایر سیستم‌های فایلی که از MD5Sum به عنوان ETag استفاده می‌کنند به کار رود.
.sp
راهبرد \fBoverwrite\fP همواره فایل مقصد را با فایل مبدأ بازنویسی می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-j, \-\-num\-threads <value>
تعداد وظایف همزمان برای اجرا
.UNINDENT
.SH "کد وضعیت خروج (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: همگام‌سازی یک دایرکتوری محلی روی یک باکت S3"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi sync \-r my_directory/ /vsis3/bucket/my_directory
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.