'\" t
.\"     Title: rename
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: User Commands
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "RENAME" "1" "2026-06-16" "util\-linux 2.41.5" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
rename \- تغییر نام دسته‌جمعی پرونده‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBrename\fP [options] \fIexpression replacement file\fP.\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBrename\fP با جایگزین کردن نخستین رخداد \fIexpression\fP در نام پرونده‌های مشخص‌شده با \fIreplacement\fP، نام آن‌ها را تغییر می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-s\fP, \fB\-\-symlink\fP
.RS 4
پیوند نمادین را تغییر نام نده، بلکه مقصدی را که به آن اشاره می‌کند تغییر بده.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
نمایش پرونده‌هایی که تغییر نام یافته‌اند، در صورت وجود.
.RE
.sp
\fB\-n\fP, \fB\-\-no\-act\fP
.RS 4
هیچ تغییری اعمال نکن؛ برای مشاهده تغییراتی که انجام می‌شد \fB\-\-verbose\fP را اضافه کنید.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
جایگزین کردن تمام رخدادهای \fIexpression\fP به جای فقط نخستین رخداد.
.RE
.sp
\fB\-l\fP, \fB\-\-last\fP
.RS 4
جایگزین کردن آخرین رخداد \fIexpression\fP به جای نخستین رخداد.
.RE
.sp
\fB\-o\fP, \fB\-\-no\-overwrite\fP
.RS 4
پرونده‌های موجود بازنویسی نشوند. هنگامی که \fB\-\-symlink\fP فعال است، پیوندهای نمادینی که به مقصدهای موجود اشاره دارند بازنویسی نشوند.
.RE
.sp
\fB\-i\fP, \fB\-\-interactive\fP
.RS 4
پرسش قبل از بازنویسی پرونده‌های موجود.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "هشدار (WARNING)"
.sp
عملیات تغییر نام به‌طور پیش‌فرض یا بدون یکی از گزینه‌های \fB\-\-no\-overwrite\fP، \fB\-\-interactive\fP یا \fB\-\-no\-act\fP فاقد تدابیر حفاظتی است. اگر کاربر مجوز بازنویسی نام پرونده‌ها را داشته باشد، دستور عملیات را بدون هیچ پرسشی انجام خواهد داد. به عنوان مثال، هنگامی که دستور به عنوان کاربر root در پوشه \fI/lib\fP اجرا شود، نتیجه می‌تواند بسیار مخرب باشد. همیشه قبل از اجرای دستور یک نسخه پشتیبان تهیه کنید، مگر اینکه واقعاً بدانید چه کاری انجام می‌دهید.
.SH "حالت‌های خاص (EDGE CASES)"
.sp
اگر \fIexpression\fP خالی باشد، به‌طور پیش‌فرض \fIreplacement\fP به ابتدای نام پرونده افزوده خواهد شد. با گزینه \fB\-\-all\fP، مقدار \fIreplacement\fP بین هر دو نویسه از نام پرونده و همچنین در ابتدا و انتهای آن درج خواهد شد.
.sp
به‌طور معمول، تنها آخرین مؤلفه مسیر یک نام پرونده به‌روزرسانی می‌شود. (یا با \fB\-\-symlink\fP، تنها آخرین مؤلفه مسیر پیوند.) اما اگر \fIexpression\fP یا \fIreplacement\fP حاوی \fI/\fP باشد، کل مسیر به‌روزرسانی می‌شود. این کار می‌تواند سبب انتقال پرونده بین پوشه‌ها شود. ایجاد پوشه‌ها و انتقال پرونده‌ها بین سیستم‌های پرونده پشتیبانی نمی‌شود.
.SH "حالت تعاملی (INTERACTIVE MODE)"
.sp
همانند بیشتر ابزارهای استاندارد، rename می‌تواند با یک دستگاه ترمینال (به اختصار tty) در حالت متعارف (canonical mode) استفاده شود، جایی که خط توسط tty بافر شده و برای اعتبارسنجی ورودی کاربر کلید ENTER فشرده می‌شود. با این حال اگر tty خود را در حالت cbreak قرار دهید، rename برای پاسخ به اعلان فقط به فشردن یک کلید نیاز دارد. برای تنظیم حالت cbreak، برای نمونه دستور زیر را اجرا کنید:
.sp
.if n .RS 4
.nf
.fam C
sh \-c \*(Aqstty \-icanon min 1; "$0" "$@"; stty icanon\*(Aq rename \-i from to files
.fam
.fi
.if n .RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
تمام عملیات‌های تغییر نام درخواست‌شده موفقیت‌آمیز بودند
.RE
.sp
\fB1\fP
.RS 4
تمام عملیات‌های تغییر نام شکست خوردند
.RE
.sp
\fB2\fP
.RS 4
برخی از عملیات‌های تغییر نام شکست خوردند
.RE
.sp
\fB4\fP
.RS 4
هیچ موردی تغییر نام نیافت
.RE
.sp
\fB64\fP
.RS 4
خطای پیش‌بینی‌نشده رخ داد
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
با فرض وجود پرونده‌های \fIfoo1\fP، .\|.\|.، \fIfoo9\fP، \fIfoo10\fP، .\|.\|.، \fIfoo278\fP، دستورهای
.sp
.if n .RS 4
.nf
.fam C
rename foo foo00 foo?
rename foo foo0 foo??
.fam
.fi
.if n .RE
.sp
آن‌ها را به \fIfoo001\fP، .\|.\|.، \fIfoo009\fP، \fIfoo010\fP، .\|.\|.، \fIfoo278\fP تبدیل خواهند کرد. و دستور
.sp
.if n .RS 4
.nf
.fam C
rename .htm .html *.htm
.fam
.fi
.if n .RE
.sp
پسوند پرونده‌های html شما را اصلاح خواهد کرد. برای کوتاه‌سازی، یک رشته خالی ارائه دهید:
.sp
.if n .RS 4
.nf
.fam C
rename \*(Aq_with_long_name\*(Aq \*(Aq\*(Aq file_with_long_name.*
.fam
.fi
.if n .RE
.sp
زیررشته موجود در نام پرونده‌ها را حذف خواهد کرد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBmv\fP(1)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "دسترسی (AVAILABILITY)"
.sp
دستور \fBrename\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
.sp
دریافت کرد.