.TH LN 1 "September 2022" "GNU coreutils 9.1" "دستورات کاربر"
.SH "نام (NAME)"
ln \- ایجاد پیوند بین فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B ln
[\fIگزینه\fR]... [\fB\-T\fR] \fIهدف پیوند_جدید\fR
.br
.B ln
[\fIگزینه\fR]... \fIهدف\fR
.br
.B ln
[\fIگزینه\fR]... \fIهدف\fR... \fIدایرکتوری\fR
.br
.B ln
[\fIگزینه\fR]... \fB\-t\fR \fIدایرکتوری هدف\fR...
.SH "توضیحات (DESCRIPTION)"
در حالت نخست، پیوندی به \fIهدف\fR با نام \fIپیوند_جدید\fR ایجاد می‌کند.
در حالت دوم، پیوندی به \fIهدف\fR در دایرکتوری جاری می‌سازد.
در حالت سوم و چهارم، پیوندهایی به هر یک از مقادیر \fIهدف\fR در \fIدایرکتوری\fR مشخص‌شده ایجاد می‌کند.
به‌طور پیش‌فرض پیوندهای سخت (Hard Links) ایجاد می‌شوند؛ برای ساخت پیوندهای نمادین (Symbolic Links) از گزینه
.B \-\-symbolic
استفاده کنید.
به‌صورت پیش‌فرض، نام هر مقصد (نام پیوند جدید) نباید از قبل وجود داشته باشد.
هنگام ساخت پیوند سخت، هر \fIهدف\fR باید از قبل موجود باشد.
پیوندهای نمادین می‌توانند شامل هر متن دلخواهی باشند؛ در صورت ارجاع بعدی، یک پیوند نسبی بر مبنای دایرکتوری والد آن تفسیر می‌شود.
.PP
آرگومان‌های اجباری برای گزینه‌های بلند، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-\-backup\fR[=\fIروش\fR]
تهیه نسخه پشتیبان از هر فایل مقصد موجود
.TP
\fB\-b\fR
مشابه \fB\-\-backup\fR ولی آرگومانی نمی‌پذیرد
.TP
\fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR
اجازه به کاربر ارشد (superuser) برای تلاش جهت ایجاد پیوند سخت به دایرکتوری‌ها (نکته: به دلیل محدودیت‌های سیستم، احتمالاً حتی برای کاربر ارشد با شکست مواجه می‌شود)
.TP
\fB\-f\fR, \fB\-\-force\fR
حذف فایل‌های مقصد موجود
.TP
\fB\-i\fR, \fB\-\-interactive\fR
پرسش پیش از حذف هر فایل مقصد
.TP
\fB\-L\fR, \fB\-\-logical\fR
دنبال‌کردن مقاصد در صورتی که خود پیوند نمادین باشند (Dereference)
.TP
\fB\-n\fR, \fB\-\-no\-dereference\fR
رفتار با \fIپیوند_جدید\fR مانند فایل عادی در صورتی که پیوند نمادینی به یک دایرکتوری باشد
.TP
\fB\-P\fR, \fB\-\-physical\fR
ساخت پیوند سخت مستقیماً به خود پیوندهای نمادین
.TP
\fB\-r\fR, \fB\-\-relative\fR
همراه با \fB\-s\fR، ایجاد پیوندهای نسبی نسبت به موقعیت پیوند
.TP
\fB\-s\fR, \fB\-\-symbolic\fR
ایجاد پیوند نمادین به جای پیوند سخت
.TP
\fB\-S\fR, \fB\-\-suffix\fR=\fIپسوند\fR
جایگزینی پسوند معمول پشتیبان‌گیری
.TP
\fB\-t\fR, \fB\-\-target\-directory\fR=\fIدایرکتوری\fR
مشخص‌کردن \fIدایرکتوری\fR که پیوندها باید در آن ساخته شوند
.TP
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
همواره رفتار با \fIپیوند_جدید\fR به عنوان یک فایل معمولی
.TP
\fB\-v\fR, \fB\-\-verbose\fR
چاپ نام هر فایل پیوند داده‌شده
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
پسوند فایل پشتیبان برابر با '~' است، مگر اینکه با
.B \-\-suffix
یا متغیر SIMPLE_BACKUP_SUFFIX تنظیم شود.
روش کنترل نسخه پشتیبان می‌تواند از طریق گزینه
.B \-\-backup
یا متغیر محیطی VERSION_CONTROL انتخاب شود.
مقادیر مجاز عبارتند از:
.TP
\fBnone\fR, \fBoff\fR
هرگز نسخه پشتیبان تهیه نشود (حتی در صورت ارسال گزینه \fB\-\-backup\fR)
.TP
\fBnumbered\fR, \fBt\fR
تهیه نسخه‌های پشتیبان شماره‌گذاری‌شده
.TP
\fBexisting\fR, \fBnil\fR
در صورت وجود نسخه پشتیبان شماره‌گذاری‌شده، به صورت شماره‌گذاری‌شده وگرنه به شکل ساده پشتیبان گرفته شود
.TP
\fBsimple\fR, \fBnever\fR
همواره نسخه پشتیبان ساده تهیه شود
.PP
استفاده از گزینه
.B \-s
گزینه‌های
.B \-L
و
.B \-P
را نادیده می‌گیرد.
در غیر این صورت، آخرین گزینه مشخص‌شده رفتار هنگام مواجهه با
\fIهدف\fR
از نوع پیوند نمادین را کنترل می‌کند و مقدار پیش‌فرض آن
.B \-P
است.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Mike Parker و David MacKenzie.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
راهنمای برخط GNU coreutils: <https://www.gnu.org/software/coreutils/>
.br
گزارش هرگونه خطای ترجمه به: <https://translationproject.org/team/>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2022 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.).
مجوز GPLv3+: مجوز عمومی همگانی گنو نگارش ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این یک نرم‌افزار آزاد است: شما می‌توانید آزادانه آن را تغییر دهید و توزیع کنید.
هیچ ضمانتی برای آن وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
\fBlink\fP(2), \fBsymlink\fP(2)
.PP
مستندات کامل در: <https://www.gnu.org/software/coreutils/ln>
.br
یا به صورت محلی از طریق دستور: info \(aq(coreutils) ln invocation\(aq