.\" 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-LIST" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vsi-list \- فهرست کردن فایل‌های یکی از سیستم‌های فایل مجازی GDAL (VSI)
.sp
در نسخه 3.11 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vsi list\fP فایل‌های \fI\%سیستم‌های فایل مجازی GDAL (فشرده‌شده، میزبانی‌شده در شبکه و غیره: /vsimem، /vsizip، /vsitar، /vsicurl و...)\fP را فهرست می‌کند.
.sp
این دستور معادل دستور \fBls\fP در یونیکس است و \fBgdal vsi ls\fP یک نام مستعار (alias) برای \fBgdal vsi list\fP محسوب می‌شود.
.sp
به‌طور پیش‌فرض، نام فایل‌ها را در سطح جاری، بدون جزئیات و در قالب JSON در خروجی نمایش می‌دهد.
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-filename <FILENAME>
هر نام فایل یا نام دایرکتوری از یکی از سیستم‌های فایل مجازی GDAL.
الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format json|text
قالب خروجی مورد استفاده. پیش‌فرض JSON است و از GDAL 3.12 به بعد، در صورت اجرا از خط فرمان، پیش‌فرض text خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-long, \-\-long\-listing
استفاده از قالب فهرست‌بندی طولانی، همراه با دسترسی‌ها، اندازه فایل و تاریخ آخرین تغییر.
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-recursive
فهرست کردن بازگشتی زیردایرکتوری‌ها. به‌طور پیش‌فرض عمق نامحدود است، اما می‌توان آن را با \fI\%\-\-depth\fP کاهش داد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-depth <DEPTH>
حداکثر عمق در حالت بازگشتی. مقدار ۱ معادل عدم بازگشت، ۲ معادل زیردایرکتوری‌های بی‌واسطه و غیره است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-abs, \-\-absolute\-path
نمایش نام فایل‌ها به صورت مسیر مطلق. به‌طور پیش‌فرض، مسیرها نسبت به نام فایل ورودی هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tree
استفاده از نمایش درختی سلسله‌مراتبی برای خروجی JSON، به جای فهرست مسطح.
تنها زمانی معتبر است که \fI\%\-\-output\-format\fP روی \fBjson\fP تنظیم شده باشد (یا در مقدار پیش‌فرض خود باقی مانده باشد).
.UNINDENT
.SH "کد وضعیت خروج (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: فهرست کردن بازگشتی فایل‌ها در /vsis3/bucket همراه با جزئیات"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi list \-lR /vsis3/bucket
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.