GDAL-VSI-MOVE(1) GDAL GDAL-VSI-MOVE(1)

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

در نسخه ۳.۱۱ اضافه شد.

کاربرد: gdal vsi move [OPTIONS] <SOURCE> <DESTINATION>
جابه‌جایی یا تغییر نام فایل/دایرکتوری مستقر روی رابط سامانه مجازی (VSI) گدال.
آرگومان‌های موقعیتی:
  --source <SOURCE>            نام فایل یا دایرکتوری مبدا [الزامی]
  --destination <DESTINATION>  نام فایل یا دایرکتوری مقصد [الزامی]
گزینه‌های عمومی:
  -h, --help                   نمایش پیام راهنما و خروج
  --json-usage                 نمایش نحوه کاربرد در قالب سند JSON و خروج
  --config <KEY>=<VALUE>       گزینه پیکربندی [تکرارپذیر]
  -q, --quiet                  حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست]

دستور gdal vsi move فایل‌ها و دایرکتوری‌های مستقر بر سامانه‌های فایل مجازی GDAL (فشرده‌سازی‌شده، میزبانی‌شده روی شبکه و غیره): /vsimem، /vsizip، /vsitar، /vsicurl، ... را جابه‌جا می‌کند.

اگر مسیر مقصد یک دایرکتوری موجود باشد، فایل به درون آن منتقل خواهد شد.

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

توجه داشته باشید که در ذخیره‌سازهای شیء ابری، جابه‌جایی یا تغییر نام یک دایرکتوری ممکن است شامل تغییر نام بازگشتی تمام فایل‌های درون آن باشد؛ بنابراین یک عملیات اتمیک محسوب نمی‌شود (و ممکن است برای دایرکتوری‌هایی با فایل‌های پرتعداد، کند و پرهزینه باشد!)

این قابلیت توسط VSIMove() پیاده‌سازی شده است.

این دستور مشابه دستور mv در یونیکس است و gdal vsi mv یک نام مستعار (alias) برای gdal vsi move می‌باشد.

برنامه در صورت موفقیت کد وضعیت ۰، و در صورت بروز خطا مقداری غیر از صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/new_name.tif

$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/existing_subdir

$ gdal vsi move /vsis3/bucket/my_directory /vsigs/bucket/

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026