| 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 |