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

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

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


خلاصه دستور (SYNOPSIS)

          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

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

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

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

   گزینه‌ها (OPTIONS)

       --filename <FILENAME>
              هر نام فایل یا نام دایرکتوری از یکی از سیستم‌های فایل مجازی GDAL.
              الزامی است.

       -f, --of, --format, --output-format json|text
              قالب خروجی مورد استفاده. پیش‌فرض JSON است و از GDAL 3.12 به بعد،
              در صورت اجرا از خط فرمان، پیش‌فرض text خواهد بود.

       -l, --long, --long-listing
              استفاده از قالب فهرست‌بندی طولانی، همراه با دسترسی‌ها، اندازه فایل
              و تاریخ آخرین تغییر.

       -R, --recursive
              فهرست کردن بازگشتی زیردایرکتوری‌ها. به‌طور پیش‌فرض عمق نامحدود است،
              اما می‌توان آن را با --depth کاهش داد.

       --depth <DEPTH>
              حداکثر عمق در حالت بازگشتی. مقدار ۱ معادل عدم بازگشت، ۲ معادل
              زیردایرکتوری‌های بی‌واسطه و غیره است.

       --abs, --absolute-path
              نمایش نام فایل‌ها به صورت مسیر مطلق. به‌طور پیش‌فرض، مسیرها نسبت به
              نام فایل ورودی هستند.

       --tree استفاده از نمایش درختی سلسله‌مراتبی برای خروجی JSON، به جای فهرست
              مسطح.  تنها زمانی معتبر است که --output-format روی json تنظیم
              شده باشد (یا در مقدار پیش‌فرض خود باقی مانده باشد).

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

مثال‌ها (EXAMPLES)
   مثال ۱: فهرست کردن بازگشتی فایل‌ها در /vsis3/bucket همراه با جزئیات

          $ gdal vsi list -lR /vsis3/bucket

نویسندگان (AUTHORS)
       Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)
       1998-2026

                                August 18, 2026               GDAL-VSI-LIST(1)