.\" 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-DATASET-RENAME" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-dataset-rename \- تغییر نام فایل‌های یک مجموعه‌داده
.sp
افزوده شده در نسخهٔ 3.12.

.sp
دستور \fBgdal dataset rename\fP فایل(های) مجموعه‌داده، از جمله
فایل‌های جانبی (side\-car) یا وابستهٔ احتمالی را تغییر نام می‌دهد.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal dataset rename [OPTIONS] <SOURCE> <DESTINATION>

Rename files of a dataset.

Positional arguments:
  \-\-source <SOURCE>            Source dataset name [required]
  \-\-destination <DESTINATION>  Destination dataset name [required]

Common Options:
  \-h, \-\-help                   Display help message and exit
  \-\-json\-usage                 Display usage as JSON document and exit
  \-\-config <KEY>=<VALUE>       Configuration option [may be repeated]

Options:
  \-\-overwrite                  Whether overwriting existing output dataset is allowed

Advanced Options:
  \-f, \-\-format <FORMAT>        Dataset format
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-source <FILENAME>
نام فایل یا دایرکتوری مبدأ. الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-destination <FILENAME>
نام فایل یا دایرکتوری مقصد. الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-\-format <FORMAT>
قالب مجموعه‌داده. بر تشخیص خودکار قالب اولویت دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه به برنامه برای بازنویسی فایل یا مجموعه‌دادهٔ هدف موجود.
در غیر این صورت، به‌طور پیش‌فرض، چنانچه فایل یا مجموعه‌دادهٔ هدف از قبل
وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند
(خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق
در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: تغییر نام یک مجموعه‌داده"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset rename old_name.tif new_name.tif
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.