GDAL-VSI-LIST(1) GDAL GDAL-VSI-LIST(1)

gdal-vsi-list - فهرست کردن فایل‌های یکی از سیستم‌های فایل مجازی GDAL (VSI)

در نسخه 3.11 اضافه شد.

Usage: gdal vsi list [OPTIONS] <FILENAME>
فهرست کردن فایل‌های یکی از واسط‌های سیستم مجازی GDAL (VSI).
آرگومان‌های موقعیتی:
  --filename <FILENAME>                                نام فایل یا دایرکتوری [الزامی]
گزینه‌های عمومی:
  -h, --help                                           نمایش پیام راهنما و خروج
  --json-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                               گزینه پیکربندی [قابل تکرار]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی. OUTPUT-FORMAT=json|text
  -l, --long, --long-listing                           استفاده از قالب فهرست‌بندی طولانی
  -R, --recursive                                      فهرست کردن بازگشتی زیردایرکتوری‌ها
  --depth <DEPTH>                                      حداکثر عمق در حالت بازگشتی
  --abs, --absolute-path                               نمایش مسیر مطلق
  --tree                                               استفاده از نمایش سلسله‌مراتبی برای خروجی JSON

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

این دستور معادل دستور ls در یونیکس است و gdal vsi ls یک نام مستعار (alias) برای gdal vsi list محسوب می‌شود.

به‌طور پیش‌فرض، نام فایل‌ها را در سطح جاری، بدون جزئیات و در قالب JSON در خروجی نمایش می‌دهد.

هر نام فایل یا نام دایرکتوری از یکی از سیستم‌های فایل مجازی GDAL. الزامی است.
قالب خروجی مورد استفاده. پیش‌فرض JSON است و از GDAL 3.12 به بعد، در صورت اجرا از خط فرمان، پیش‌فرض text خواهد بود.
استفاده از قالب فهرست‌بندی طولانی، همراه با دسترسی‌ها، اندازه فایل و تاریخ آخرین تغییر.
فهرست کردن بازگشتی زیردایرکتوری‌ها. به‌طور پیش‌فرض عمق نامحدود است، اما می‌توان آن را با --depth کاهش داد.
حداکثر عمق در حالت بازگشتی. مقدار ۱ معادل عدم بازگشت، ۲ معادل زیردایرکتوری‌های بی‌واسطه و غیره است.
نمایش نام فایل‌ها به صورت مسیر مطلق. به‌طور پیش‌فرض، مسیرها نسبت به نام فایل ورودی هستند.
استفاده از نمایش درختی سلسله‌مراتبی برای خروجی JSON، به جای فهرست مسطح. تنها زمانی معتبر است که --output-format روی json تنظیم شده باشد (یا در مقدار پیش‌فرض خود باقی مانده باشد).

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

$ gdal vsi list -lR /vsis3/bucket

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026