.\"	dhclient-script.8
.\"
.\" Copyright (C) 2004-2022 Internet Systems Consortium, Inc. ("ISC")
.\" Copyright (c) 1996-2003 by Internet Software Consortium
.\"
.\" This Source Code Form is subject to the terms of the Mozilla Public
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
.\" file, You can obtain one at http://mozilla.org/MPL/2.0
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\"   Internet Systems Consortium, Inc.
.\"   PO Box 360
.\"   Newmarket, NH 03857 USA
.\"   <info@isc.org>
.\"   https://www.isc.org
.\"
.\" Support and other services are available for ISC products - see
.\" https://www.isc.org for more information or to learn more about ISC.
.\"
.\" $Id: dhclient-script.8,v 1.14 2010/07/02 23:09:14 sar Exp $
.\"
.TH dhclient-script 8
.SH "نام (NAME)"
dhclient-script \- اسکریپت پیکربندی شبکه برای کلاینت DHCP
.SH "توضیحات (DESCRIPTION)"
اسکریپت پیکربندی شبکه کلاینت DHCP هرازگاهی توسط
.BR dhclient (8)
فراخوانی می‌شود. این اسکریپت توسط کلاینت DHCP برای تنظیم پیکربندی اولیه هر رابط شبکه پیش از درخواست آدرس، بررسی و آزمایش آدرس پس از پیشنهاد شدن آن، و اعمال پیکربندی نهایی رابط پس از دریافت اجاره‌نامه (lease) به کار می‌رود. اگر هیچ اجاره‌نامه‌ای به دست نیاید، از این اسکریپت برای آزمایش اجاره‌نامه‌های از پیش تعریف‌شده (در صورت وجود) استفاده می‌شود و همچنین اگر هیچ اجاره‌نامه معتبری شناسایی نشود، یک بار فراخوانی می‌گردد.
.PP
این اسکریپت برای سفارشی‌سازی توسط کاربر نهایی در نظر گرفته نشده است. در صورت نیاز به سفارشی‌سازی‌های محلی، این کار باید از طریق قلاب‌های (hooks) ورود و خروج ارائه‌شده انجام گیرد (برای جزئیات به بخش
.B HOOKS
مراجعه کنید). این قلاب‌ها به کاربر اجازه می‌دهند تا رفتار پیش‌فرض کلاینت را در ایجاد فایل
.B /etc/resolv.conf
بازنویسی کنند.
.PP
برای برخی سیستم‌عامل‌ها اسکریپت کلاینت استانداردی وجود ندارد، حتی اگر خود کلاینت به درستی کار کند؛ بنابراین ممکن است یک کاربر پیشرو نیاز به ایجاد یک اسکریپت جدید یا تغییر اسکریپت موجود داشته باشد. به طور کلی، سفارشی‌سازی‌های مختص به یک رایانه خاص باید در فایل
.B ETCDIR/dhclient.conf
انجام شوند. اگر متوجه شدید که نمی‌توانید چنین سفارشی‌سازی را بدون ویرایش
.B ETCDIR/dhclient.conf
یا استفاده از قلاب‌های ورود و خروج انجام دهید، لطفاً یک گزارش اشکال ارسال کنید.
.SH "قلاب‌ها (HOOKS)"
هنگام آغاز به کار، اسکریپت کلاینت ابتدا یک تابع شل به نام
.B make_resolv_conf
تعریف می‌کند که بعداً برای ایجاد فایل
.B /etc/resolv.conf
استفاده می‌شود. برای لغو رفتار پیش‌فرض، این تابع را در اسکریپت قلاب ورود (enter hook) مجدداً تعریف کنید.
.PP
پس از تعریف تابع
.BR make_resolv_conf ،
اسکریپت کلاینت وجود یک اسکریپت اجرایی به نام
.B ETCDIR/dhclient-enter-hooks
را بررسی می‌کند و در صورت وجود، آن را به صورت درون‌خطی و با استفاده از دستور نقطه (\'.\') در شل Bourne اجرا می‌نماید. تمام متغیرهای محیطی مستندشده در بخش
.B OPERATION
در دسترس این اسکریپت قرار دارند و در صورت نیاز، این اسکریپت می‌تواند محیط را برای تغییر رفتار اسکریپت ویرایش کند. اگر خطایی در حین اجرای اسکریپت رخ دهد، می‌تواند متغیر
.B exit_status
را روی یک مقدار غیرصفر تنظیم کند و
.B CLIENTBINDIR/dhclient-script
بلافاصله پس از خروج اسکریپت کلاینت، با همان کد خطا خارج خواهد شد.
.PP
پس از اتمام تمام پردازش‌ها،
.B CLIENTBINDIR/dhclient-script
وجود یک اسکریپت اجرایی به نام
.B ETCDIR/dhclient-exit-hooks
را بررسی می‌کند که در صورت وجود، با استفاده از دستور نقطه (\'.\') اجرا می‌شود. وضعیت خروج
.B dhclient-script
از طریق متغیر شل
.B exit_status
به
.B dhclient-exit-hooks
منتقل خواهد شد و اگر اسکریپت در انجام وظیفه‌ای که برای آن فراخوانی شده بود موفق شود، همیشه برابر صفر خواهد بود. مابقی متغیرهای محیطی که پیش‌تر برای
.B dhclient-enter-hooks
شرح داده شدند نیز در دسترس هستند. اسکریپت
.B ETCDIR/dhclient-exit-hooks
می‌تواند مقدار
.B exit_status
را تغییر دهد تا وضعیت خروج
.B dhclient-script
عوض شود.
.SH "عملیات (OPERATION)"
هنگامی که
.B dhclient
نیاز به اجرای اسکریپت پیکربندی کلاینت دارد، مجموعه‌ای از متغیرها را در محیط تعریف کرده و سپس
.B CLIENTBINDIR/dhclient-script
را اجرا می‌کند. در تمام موارد، متغیر
.B $reason
روی نام دلیلی که اسکریپت به خاطر آن فراخوانی شده است تنظیم می‌شود. دلایل زیر در حال حاضر تعریف شده‌اند:
.BR MEDIUM ،
.BR PREINIT ،
.BR BOUND ،
.BR RENEW ،
.BR REBIND ،
.BR REBOOT ،
.BR EXPIRE ،
.BR FAIL ،
.BR STOP ،
.BR RELEASE ،
.B NBI
و
.BR TIMEOUT .
.SH MEDIUM
کلاینت DHCP درخواست می‌کند نوع رسانه (media type) یک رابط شبکه تنظیم شود. نام رابط در
.B $interface
و نوع رسانه در
.B $medium
ارسال می‌شود.
.SH PREINIT
کلاینت DHCP درخواست می‌کند که یک رابط شبکه بر اساس نیازها پیکربندی شود تا پیش از دریافت آدرس واقعی، توانایی ارسال بسته‌ها را داشته باشد. برای کلاینت‌هایی که از کتابخانه سوکت BSD استفاده می‌کنند، این به معنای پیکربندی رابط با آدرس آی‌پی 0.0.0.0 و آدرس پخش (broadcast) برابر با 255.255.255.255 است. برای کلاینت‌های دیگر ممکن است بالا آوردن ساده رابط (up) بدون تخصیص هیچ آدرس آی‌پی به آن کفایت کند. نام رابط در
.B $interface
و نوع رسانه در
.B $medium
ارسال می‌شود.
.PP
اگر یک نام مستعار آی‌پی (IP alias) در
.B dhclient.conf
تعریف شده باشد، آدرس آن در
.B $alias_ip_address
ارسال می‌شود و آن نام مستعار باید به همراه تمام مسیرهای منتهی به آن از رابط شبکه حذف شود.
.SH BOUND
کلاینت DHCP اتصال اولیه (binding) به یک آدرس جدید را برقرار کرده است. آدرس آی‌پی جدید در
.B $new_ip_address
و نام رابط در
.B $interface
ارسال می‌شود. نوع رسانه در
.B $medium
قرار می‌گیرد. هر گزینه‌ای که از سرور به دست آمده باشد، با استفاده از نام گزینه شرح‌داده‌شده در
.B dhcp-options
ارسال می‌شود؛ با این تفاوت که خط تیره‌ها (\'-\') برای تبدیل به متغیرهای معتبر شل با زیرخط (\'_\') جایگزین شده‌اند و نام متغیرها با
.B new_
شروع می‌شود. بنابراین برای مثال، ماسک زیرشبکه جدید در
.B $new_subnet_mask
ارسال خواهد شد. گزینه‌های مربوط به یک حوزه (universe) غیرپیش‌فرض، نام آن حوزه را در ابتدای نام گزینه خواهند داشت؛ به عنوان مثال
.BR $new_dhcp6_server_id .
گزینه‌هایی که کلاینت صریحاً از طریق گزینه PRL یا ORO درخواست کرده باشد، با همان نام گزینه پیشین اما با پیشوند
.B requested_
و با مقدار 1 ارسال می‌شوند، مانند
.BR requested_subnet_mask=1 .
چنین متغیری برای گزینه‌هایی که توسط کلاینت درخواست نشده‌اند یا گزینه‌هایی که به گزینه درخواستی نیاز ندارند، مانند آدرس آی‌پی
.RB ( *_ip_address )
یا زمان انقضا
.RB ( *_expiry )
تعریف نمی‌شود.
.PP
پیش از پیکربندی واقعی آدرس،
.B dhclient-script
باید به نحوی برای آن ARP انجام دهد و در صورت دریافت پاسخ، با وضعیتی غیرصفر خارج شود. در این حالت، کلاینت یک پیام DHCPDECLINE به سرور ارسال می‌کند و آدرس متفاوتی به دست می‌آورد. این کار ممکن است در وضعیت‌های RENEW، REBIND یا REBOOT نیز انجام شود، اما اجباری نیست و در واقع شاید مطلوب هم نباشد.
.PP
هنگامی که یک اتصال برقرار شد، احتمالاً پارامترهای شبکه متعددی باید تنظیم شوند. یک فایل
.B /etc/resolv.conf
جدید باید با استفاده از مقادیر
.B $new_domain_name
و
.B $new_domain_name_servers
(که ممکن است بیش از یک سرور را با فاصله از هم فهرست کند) ایجاد شود. یک مسیر پیش‌فرض باید با استفاده از
.B $new_routers
تنظیم گردد، و ممکن است لازم باشد مسیرهای ایستا با استفاده از
.B $new_static_routes
تعیین شوند.
.PP
اگر یک نام مستعار آی‌پی (IP alias) تعریف شده باشد، باید در اینجا تنظیم شود. آدرس آی‌پی مستعار در
.B $alias_ip_address
نوشته خواهد شد و سایر گزینه‌های DHCP که برای نام مستعار تنظیم شده‌اند (مانند ماسک زیرشبکه) در متغیرهایی با نام‌گذاری مشابه‌ آنچه پیش‌تر شرح داده شد ارسال می‌شوند؛ به جز اینکه به جای
.B $new_
با
.B $alias_
آغاز می‌شوند. باید دقت شود که در صورت یکسان بودن آدرس آی‌پی مستعار با آدرس آی‌پی متصل‌شده
.RB ( $new_ip_address )
نباید از آدرس مستعار استفاده گردد، زیرا در این حالت ممکن است سایر پارامترهای مستعار نادرست باشند.
.SH RENEW
هنگامی که یک اتصال تجدید (renew) می‌شود، اسکریپت مانند BOUND فراخوانی می‌گردد؛ با این تفاوت که علاوه بر تمام متغیرهایی که با
.B $new_
و
.B $requested_
آغاز می‌شوند، مجموعه دیگری از متغیرها وجود دارند که با
.B $old_
شروع می‌شوند. تنظیمات پایداری که ممکن است تغییر کرده باشند باید حذف شوند؛ برای مثال، اگر یک مسیر محلی به آدرس متصل‌شده در حال پیکربندی است، مسیر محلی قدیمی باید حذف شود. اگر مسیر پیش‌فرض تغییر کرده باشد، مسیر پیش‌فرض قدیمی باید حذف شود. اگر مسیرهای ایستا تغییر کرده باشند، مسیرهای قدیمی باید حذف گردند. در غیر این صورت، پردازش می‌تواند مانند BOUND انجام شود.
.SH REBIND
کلاینت DHCP اتصال مجدد به یک سرور DHCP جدید برقرار کرده است. این وضعیت را می‌توان مانند RENEW مدیریت کرد، با این تفاوت که اگر آدرس آی‌پی تغییر کرده باشد، جدول ARP باید پاکسازی شود.
.SH REBOOT
کلاینت DHCP پس از راه‌اندازی مجدد، آدرس قدیمی خود را با موفقیت مجدداً به دست آورده است. این وضعیت می‌تواند مانند BOUND پردازش شود.
.SH EXPIRE
کلاینت DHCP در تجدید اجاره‌نامه خود یا دریافت یک اجاره‌نامه جدید ناموفق بوده و مهلت اجاره‌نامه منقضی شده است. آدرس آی‌پی باید واگذار شود و تمام پارامترهای مرتبط با آن نیز مانند RENEW و REBIND حذف گردند.
.SH FAIL
کلاینت DHCP قادر به برقراری ارتباط با هیچ سرور DHCP نبوده است و هیچ‌یک از اجاره‌نامه‌های آزمایش‌شده نیز معتبر شناخته نشده‌اند. پارامترهای مربوط به آخرین اجاره‌نامه آزمایش‌شده باید از پیکربندی خارج شوند. این وضعیت را می‌توان به همان شیوه EXPIRE مدیریت کرد.
.SH STOP
به
.B dhclient
اطلاع داده شده است که به صورت آرام متوقف شود؛
.B dhclient-script
باید بر حسب مورد، رابط شبکه را از پیکربندی خارج کرده یا غیرفعال کند.
.SH RELEASE
برنامه
.B dhclient
با استفاده از پرچم
.B \-r
اجرا شده است که نشان می‌دهد مدیر سیستم مایل است اجاره‌نامه(ها) آزاد شوند.
.B dhclient-script
باید رابط شبکه را از پیکربندی خارج کرده یا غیرفعال کند.
.SH NBI
بدون رابط‌های پخش (No-Broadcast-Interfaces)... برنامه
.B dhclient
قادر به یافتن رابطی نبوده است که معتقد باشد باید DHCP را روی آن آغاز کند. اینکه
.B dhclient-script
در این شرایط چه کاری باید انجام دهد، کاملاً بر عهده پیاده‌ساز است.
.SH TIMEOUT
کلاینت DHCP موفق به برقراری ارتباط با هیچ سرور DHCP نشده است. با این حال، یک اجاره‌نامه قدیمی شناسایی شده و پارامترهای آن مانند BOUND ارسال شده‌اند. اسکریپت پیکربندی کلاینت باید این پارامترها را آزمایش کند و اگر دلیلی دارد که آن‌ها معتبر هستند، باید با مقدار صفر خارج شود. در غیر این صورت، باید با یک مقدار غیرصفر خارج گردد.
.SH V6ONLY
کلاینت DHCPv4 گزینه درخواستی و معتبر v6-only-preferred را دریافت کرده است. سیستم باید IPv4 را روی رابط شبکه غیرفعال کند. از طرف خود،
.B dhclient
به مدت زمان V6ONLY_WAIT ثانیه (زمان‌سنجی که توسط این گزینه منتقل می‌شود و حداقل آن برابر با MIN_V6ONLY_WAIT است) پیش از بازگشت به وضعیت INIT منتظر می‌ماند.
.PP
روش معمول برای آزمایش یک اجاره‌نامه این است که شبکه همانند وضعیت REBIND راه‌اندازی شود (چرا که این ممکن است برای آزمایش بیش از یک اجاره‌نامه فراخوانی شود) و سپس به اولین مسیریاب تعریف‌شده در
.B $routers
پیام پینگ ارسال گردد. اگر پاسخی دریافت شود، اجاره‌نامه باید برای شبکه‌ای که رابط در حال حاضر به آن متصل است معتبر باشد. کامل‌تر خواهد بود اگر پینگ کردن تمام مسیریاب‌های فهرست‌شده در
.B $new_routers
و همچنین موارد فهرست‌شده در
.B $new_static_routes
امتحان شود، اما اسکریپت‌های فعلی چنین کاری را انجام نمی‌دهند.
.SH "فایل‌ها (FILES)"
هر سیستم‌عامل عموماً باید فایل اسکریپت مخصوص به خود را داشته باشد، اگرچه فایل‌های اسکریپت سیستم‌عامل‌های مشابه ممکن است شبیه یا حتی یکسان باشند. فایل‌های اسکریپت موجود در توزیع DHCP کنسرسیوم سامانه‌های اینترنتی در درخت توزیع زیر مسیر
.B client/scripts
قرار دارند و نام سیستم‌عامل‌هایی را دارند که برای کار روی آن‌ها در نظر گرفته شده‌اند.
.SH "اشکالات (BUGS)"
اگر بیش از یک رابط شبکه استفاده شود، هیچ راه مشخصی برای جلوگیری از تداخل بین پارامترهای پیکربندی ارائه‌شده از سوی سرور وجود ندارد؛ برای مثال، اسکریپت اصلی
.B dhclient-script
فایل
.B /etc/resolv.conf
را بازنویسی می‌کند. اگر بیش از یک رابط پیکربندی شود،
.B /etc/resolv.conf
به طور مکرر با مقادیر ارائه‌شده توسط یک سرور و سپس سرور دیگر بازنشانی خواهد شد. با فرض اینکه اطلاعات ارائه‌شده توسط هر دو سرور معتبر است، این نباید مشکل واقعی ایجاد کند، اما می‌تواند گیج‌کننده باشد.
.SH "همچنین ببینید (SEE ALSO)"
.BR dhclient (8)،
.BR dhcpd (8)،
.BR dhcrelay (8)،
.BR dhclient.conf (5)
و
.BR dhclient.leases (5).
.SH "نویسندگان (AUTHORS)"
.B dhclient-script(8)
توسط کنسرسیوم سامانه‌های اینترنتی (ISC) نگارش یافته است.
برای کسب اطلاعات بیشتر در مورد Internet Systems Consortium، نشانی زیر را ببینید:
.B https://www.isc.org