.\" Jean II - HPL - 2004-2007
.\" ifrename.8
.\"
.TH IFRENAME 8 "26 February 2007" "wireless-tools" "Linux Programmer's Manual"
.\"
.\" NAME part
.\"
.SH "نام (NAME)"
ifrename \- تغییر نام رابط‌های شبکه بر اساس معیارهای ثابت گوناگون
.\"
.\" SYNOPSIS part
.\"
.SH "خلاصه دستور (SYNOPSIS)"
.B "ifrename [-c configfile] [-p] [-d] [-u] [-v] [-V] [-D] [-C]"
.br
.B "ifrename [-c configfile] [-i interface] [-n newname]"
.\"
.\" DESCRIPTION part
.\"
.SH "توضیحات (DESCRIPTION)"
دستور
.B Ifrename
ابزاری است که به شما امکان می‌دهد یک نام پایدار و یکپارچه به هر یک از رابط‌های شبکه خود اختصاص دهید.
.PP
به‌طور پیش‌فرض، نام‌های رابط شبکه پویا هستند و به هر رابط شبکه نخستین نام موجود اختصاص می‌یابد
.RI ( eth0 "، " eth1 "...)."
ترتیب ایجاد رابط‌های شبکه ممکن است متغیر باشد. برای رابط‌های داخلی (built-in)، نحوه شناسایی و شماره‌گذاری هسته در زمان بوت ممکن است تغییر کند. برای رابط‌های جداشدنی (removable)، کاربر ممکن است آن‌ها را با هر ترتیبی متصل کند.
.PP
دستور
.B Ifrename
به کاربر اجازه می‌دهد تا مشخص کند یک رابط شبکه چه نامی داشته باشد.
.B Ifrename
می‌تواند از انواع مختلفی از
.I انتخاب‌گرها (selectors)
برای تعیین نحوه تطبیق نام‌ها با رابط‌های شبکه موجود در سیستم استفاده کند؛ متداول‌ترین انتخاب‌گر،
.IR "آدرس MAC"
رابط است.
.PP
دستور
.B Ifrename
باید پیش از بالا آمدن و فعال شدن رابط‌ها اجرا شود، به همین دلیل بیشتر در اسکریپت‌های گوناگون (init، hotplug) کاربرد دارد و به‌ندرت مستقیماً توسط کاربر اجرا می‌شود. به‌طور پیش‌فرض،
.B ifrename
تمام رابط‌های موجود در سیستم را بر اساس نگاشت‌های تعریف‌شده در
.I /etc/iftab
تغییر نام می‌دهد.
.\"
.\" PARAMETER part
.\"
.SH "پارامترها (PARAMETERS)"
.TP
.BI "-c " configfile
تعیین فایل پیکربندی مورد استفاده (به‌طور پیش‌فرض
.IR /etc/iftab ).
فایل پیکربندی، نگاشت بین انتخاب‌گرها و نام‌های رابط را تعیین می‌کند و در
.BR iftab (5)
شرح داده شده است.
.br
اگر
.I configfile
برابر با "-" باشد، پیکربندی از ورودی استاندارد (stdin) خوانده می‌شود.
.TP
.B -p
پیش از تغییر نام رابط‌ها، ماژول‌های هسته را کاوش (بارگذاری) می‌کند. به‌طور پیش‌فرض
.B ifrename
تنها رابط‌هایی را که قبلاً بارگذاری شده‌اند بررسی می‌کند و ماژول‌های هسته لازم را به‌طور خودکار بارگذاری نمی‌نماید. این گزینه امکان هماهنگی روان با سیستم‌هایی را فراهم می‌کند که ماژول‌ها را پیش از فراخوانی
.B ifrename
بارگذاری نمی‌کنند.
.TP
.B -d
برخی ترفندها و سازوکارهای ویژه
.B دبیان (Debian)
را فعال می‌کند. در ترکیب با
.BR -p ،
تنها ماژول‌های مربوط به رابط‌های مشخص‌شده در
.I /etc/network/interface
بارگذاری می‌شوند.
.TP
.BI "-i " interface
تنها رابط مشخص‌شده در
.I interface
را به جای تمام رابط‌های سیستم تغییر نام می‌دهد. نام جدید رابط چاپ خواهد شد.
.TP
.BI "-n " newname
هنگامی که همراه با
.B -i
استفاده شود، نام جدید رابط را مشخص می‌کند. در این حالت فهرست نگاشت‌های فایل پیکربندی نادیده گرفته شده و رابط مشخص‌شده با
.B -i
مستقیماً به
.I newname
تغییر نام می‌یابد. نام جدید می‌تواند شامل یک نویسه عام (wildcard) مانند '*' باشد.
.br
هنگامی که بدون
.B -i
استفاده شود، تغییر نام رابط‌ها تنها با استفاده از نگاشت‌هایی انجام می‌گیرد که نام آن‌ها را به
.I newname
تغییر می‌دهند. در این حالت نام جدید نمی‌تواند حاوی نویسه عام باشد. این شیوه استفاده از ifrename توصیه نمی‌شود، زیرا ناکارآمد است
.RI ( -n " بدون " -i ).
در این حالت تمام رابط‌های سیستم باید در هر بار فراخوانی بررسی شوند، بنابراین در بیشتر موارد سریع‌تر از این نیست که اجازه دهید ifrename تمام آن‌ها را تغییر نام دهد (بدون هر دو گزینه
.BR -n " و " -i ).
.TP
.B -t
پشتیبانی از تصاحب نام (takeover) را فعال می‌کند. این قابلیت امکان جابه‌جایی و تبادل نام را بین دو یا چند رابط فراهم می‌سازد.
.br
تصاحب نام به یک رابط اجازه می‌دهد نام رابط دیگری را «تصاحب» کند. این ویژگی تنها در نسخه 2.6.X هسته لینوکس و در صورتی که رابط دیگر غیرفعال (down) باشد کار می‌کند؛ در نتیجه با Hotplug سازگار نیست. به رابط دیگر یک نام تصادفی اختصاص داده می‌شود، اما می‌توان بعداً با 'ifrename' نام آن را تغییر داد.
.br
تعداد دفعات تصاحب نام محدود است تا از ایجاد حلقه‌های بی‌پایان (circular loops) جلوگیری شود، بنابراین برخی سناریوهای پیچیده تبادل نام چندطرفه ممکن است به‌طور کامل پردازش نشوند.
.br
در هر صورت، جابه‌جایی نام و استفاده از این ویژگی توصیه نمی‌شود و بهتر است نام‌های یکتا و بدون ابهام برای رابط‌های خود برگزینید...
.TP
.B -u
حالت خروجی
.I udev
را فعال می‌کند. این گزینه امکان یکپارچه‌سازی مناسب
.B ifrename
را در ساختار
.I udev
فراهم می‌سازد، به‌طوری که
.BR udevd (8)
از
.B ifrename
برای اختصاص نام رابط‌های موجود در
.I /etc/iftab
استفاده می‌کند. در این حالت خروجی ifrename می‌تواند مستقیماً توسط
.BR udevd (8)
به عنوان یک کنش IMPORT تجزیه شود. این ویژگی نیازمند نسخه ۱۰۷ یا بالاتر
.I udev
است.
.TP
.B -D
حالت اجرای آزمایشی (Dry-run). دستور ifrename هیچ رابطی را تغییر نمی‌دهد، بلکه تنها نام جدید رابط را (در صورت وجود) چاپ کرده و خارج می‌شود.
.br
در حالت اجرای آزمایشی، نویسه‌های عام نام رابط بازگشایی نمی‌شوند. نام جدید رابط حتی اگر با نام قبلی یکسان باشد چاپ می‌شود.
.br
همچنین توجه داشته باشید که برخی انتخاب‌گرها تنها توسط کاربر ریشه (root) قابل خواندن هستند (برای نمونه مواردی که بر پایه
.BR ethtool
هستند) و در صورت اجرا توسط کاربر عادی بدون هیچ خطایی ناموفق خواهند بود. به عبارت دیگر، حالت آزمایشی با دسترسی کاربر معمولی ممکن است نتیجه مورد انتظار را ندهد.
.TP
.B -V
حالت پرگو (Verbose). دستور ifrename نتایج داخلی تجزیه فایل پیکربندی و وضعیت انتخاب‌گرهای رابط‌ها را نمایش می‌دهد. این گزینه در ترکیب با گزینه
.I dry-run
یک روش مناسب برای اشکال‌زدایی پیکربندی‌های پیچیده یا مشکلات جزئی است.
.TP
.B -C
شمارش رابط‌های منطبق. تعداد رابط‌های منطبق‌شده را نمایش می‌دهد و آن را به عنوان وضعیت خروج (exit status) ifrename برمی‌گرداند.
.br
تعداد رابط‌های منطبق، تعداد رابط‌هایی در سیستم است که برای آن‌ها نگاشتی در فایل پیکربندی یافت شده است (که با تعداد رابط‌های تغییر نام‌یافته متفاوت است).
.\"
.\" AUTHOR part
.\"
.SH "نویسنده (AUTHOR)"
Jean Tourrilhes \- jt@hpl.hp.com
.\"
.\" FILES part
.\"
.SH "فایل‌ها (FILES)"
.I /etc/iftab
.\"
.\" SEE ALSO part
.\"
.SH "همچنین ببینید (SEE ALSO)"
.BR ifconfig (8),
.BR ip (8),
.BR iftab (5).