.\" 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-MOVE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vsi-move \- جابه‌جایی یا تغییر نام فایل/دایرکتوری مستقر روی رابط سامانه مجازی گدال (GDAL VSI)
.sp
در نسخه ۳.۱۱ اضافه شد.

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

جابه‌جایی یا تغییر نام فایل/دایرکتوری مستقر روی رابط سامانه مجازی (VSI) گدال.

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

گزینه‌های عمومی:
  \-h, \-\-help                   نمایش پیام راهنما و خروج
  \-\-json\-usage                 نمایش نحوه کاربرد در قالب سند JSON و خروج
  \-\-config <KEY>=<VALUE>       گزینه پیکربندی [تکرارپذیر]
  \-q, \-\-quiet                  حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vsi move\fP فایل‌ها و دایرکتوری‌های مستقر بر \fI\%سامانه‌های فایل مجازی GDAL (فشرده‌سازی‌شده، میزبانی‌شده روی شبکه و غیره): /vsimem، /vsizip، /vsitar، /vsicurl، ...\fP را جابه‌جا می‌کند\&.
.sp
اگر مسیر مقصد یک دایرکتوری موجود باشد، فایل به درون آن منتقل خواهد شد.
.sp
این دستور می‌تواند فایل‌ها و دایرکتوری‌ها را بین سامانه‌های فایل مجازی مختلف جابه‌جا کند، اما این عمل شامل کپی و سپس حذف خواهد بود.
.sp
توجه داشته باشید که در ذخیره‌سازهای شیء ابری، جابه‌جایی یا تغییر نام یک دایرکتوری ممکن است شامل تغییر نام بازگشتی تمام فایل‌های درون آن باشد؛ بنابراین یک عملیات اتمیک محسوب نمی‌شود (و ممکن است برای دایرکتوری‌هایی با فایل‌های پرتعداد، کند و پرهزینه باشد!)
.sp
این قابلیت توسط \fI\%VSIMove()\fP پیاده‌سازی شده است\&.
.sp
این دستور مشابه دستور \fBmv\fP در یونیکس است و \fBgdal vsi mv\fP یک نام مستعار (alias) برای \fBgdal vsi move\fP می‌باشد\&.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
برنامه در صورت موفقیت کد وضعیت ۰، و در صورت بروز خطا مقداری غیر از صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: تغییر نام یک فایل در همان سامانه فایل مجازی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/new_name.tif
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: جابه‌جایی یک فایل به دایرکتوری دیگر در همان سامانه فایل مجازی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/existing_subdir
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: جابه‌جایی یک دایرکتوری میان دو سامانه فایل مجازی مختلف
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my_directory /vsigs/bucket/
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.