.\" Copyright 1997, Martin Schulze <joey@debian.org>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.TH host.conf 5 2026-02-08 "Linux man-pages 6.19"
.SH "نام (NAME)"
host.conf \- پرونده پیکربندی کتابخانه تفکیککننده نام (Resolver)
.SH "توضیحات (DESCRIPTION)"
پرونده
.I /etc/host.conf
شامل اطلاعات پیکربندی مختص کتابخانه تفکیک‌کننده نام (resolver) است.
این پرونده باید در هر خط شامل یک کلیدواژه پیکربندی باشد که به دنبال آن
اطلاعات پیکربندی مناسب قرار می‌گیرد.
کلیدواژه‌های زیر پشتیبانی می‌شوند:
.TP
.I trim
این کلیدواژه ممکن است بیش از یک‌بار فهرست شود.
هر بار باید پس از آن فهرستی از دامنه‌ها قرار گیرد که با دونقطه (\[aq]:\[aq])، نقطه‌ویرگول
(\[aq];\[aq]) یا ویرگول (\[aq],\[aq]) و با نقطه آغازین از یکدیگر جدا شده‌اند.
در صورت تنظیم،
کتابخانه تفکیک‌کننده به طور خودکار نام دامنه مشخص‌شده را از انتهای هر نام میزبانی که از طریق DNS تفکیک شده باشد، حذف می‌کند.
این ویژگی برای استفاده با میزبان‌ها و دامنه‌های محلی در نظر گرفته شده است.
(یادداشت مرتبط:
.I trim
بر نام‌های میزبانی که از طریق NIS یا پرونده
.BR hosts (5)
به دست می‌آیند، تأثیری نخواهد گذاشت.
باید دقت شود تا اطمینان حاصل گردد که نخستین نام میزبان برای هر مدخل در پرونده hosts، بسته به
نصب محلی، به طور کامل واجد شرایط (fully qualified) یا بدون پسوند دامنه (unqualified) باشد.)
.TP
.I multi
مقادیر معتبر عبارتند از
.IR on " و " off .
اگر روی
.I on
تنظیم شود، کتابخانه تفکیک‌کننده تمام نشانی‌های معتبر میزبانی را که در پرونده
.I /etc/hosts
ظاهر می‌شود، به جای فقط اولین نشانی بازمی‌گرداند.
این گزینه به صورت پیش‌فرض
.I off
است، زیرا ممکن است در سامانه‌هایی با پرونده‌های hosts بزرگ باعث افت محسوس کارایی شود.
.TP
.I reorder
مقادیر معتبر عبارتند از
.IR on " و " off .
اگر روی
.I on
تنظیم شود، کتابخانه تفکیک‌کننده تلاش خواهد کرد تا نشانی‌های میزبان را به گونه‌ای مرتب‌سازی مجدد کند که هنگام اجرای
.BR gethostbyname (3)
نشانی‌های محلی (یعنی آن‌هایی که در همان زیرشبکه هستند) در ابتدای فهرست قرار گیرند.
مرتب‌سازی مجدد برای تمامی روش‌های جستجو انجام می‌شود.
مقدار پیش‌فرض
.I off
است.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر می‌توانند توسط کاربران برای بازنویسی رفتاری که در
.I /etc/host.conf
پیکربندی شده است، استفاده شوند:
.TP
.B RESOLV_HOST_CONF
در صورت تنظیم، این متغیر به پرونده‌ای اشاره می‌کند که باید به جای
.I /etc/host.conf
خوانده شود.
.TP
.B RESOLV_MULTI
دستور
.I multi
را بازنویسی می‌کند.
.TP
.B RESOLV_REORDER
دستور
.I reorder
را بازنویسی می‌کند.
.TP
.B RESOLV_ADD_TRIM_DOMAINS
فهرستی از دامنه‌ها که با
دونقطه (\[aq]:\[aq])، نقطه‌ویرگول (\[aq];\[aq]) یا ویرگول (\[aq],\[aq])،
همراه با نقطه در ابتدا جدا شده‌اند،
که به فهرست دامنه‌هایی که باید پیراسته (trim) شوند، اضافه خواهد شد.
.TP
.B RESOLV_OVERRIDE_TRIM_DOMAINS
فهرستی از دامنه‌ها که با
دونقطه (\[aq]:\[aq])، نقطه‌ویرگول (\[aq];\[aq]) یا ویرگول (\[aq],\[aq])،
همراه با نقطه در ابتدا جدا شده‌اند،
که جایگزین فهرست دامنه‌هایی می‌شود که باید پیراسته (trim) شوند.
دستور
.I trim
را بازنویسی می‌کند.
.SH "فایلها (FILES)"
.TP
.I /etc/host.conf
پرونده پیکربندی تفکیک‌کننده
.TP
.I /etc/resolv.conf
پرونده پیکربندی تفکیک‌کننده
.TP
.I /etc/hosts
پایگاه‌داده میزبان‌های محلی
.SH "یادداشتها (NOTES)"
تفاوت‌های زیر در مقایسه با پیاده‌سازی اصلی وجود دارد.
یک دستور جدید
.I spoof
و یک متغیر محیطی جدید
.B RESOLV_SPOOF_CHECK
می‌توانند آرگومان‌هایی مانند
.IR off "، " nowarn " و " warn
را بپذیرند.
توضیحات درون خطی می‌توانند در هر کجای خط ظاهر شوند و نه صرفاً در ابتدای یک خط.
.SS "تاریخی (Historical)"
پرونده
.BR nsswitch.conf (5)
روش نوین برای کنترل ترتیب جستجوی میزبان‌ها است.
.P
در glibc 2.4 و نسخه‌های پیشین، کلیدواژه زیر شناخته شده است:
.TP
.I order
این کلیدواژه چگونگی انجام جستجوی میزبان را مشخص می‌کند.
پس از آن باید یک یا چند روش جستجو که با ویرگول از یکدیگر جدا شده‌اند، قرار گیرد.
روش‌های معتبر عبارتند از
.IR bind "، " hosts " و " nis .
.TP
.B RESOLV_SERV_ORDER
دستور
.I order
را بازنویسی می‌کند.
.P
.\" commit 7d68cdaa4f748e87ee921f587ee2d483db624b3d
از glibc 2.0.7 تا glibc 2.24،
کلیدواژه‌ها و متغیر محیطی زیر
شناخته شده بودند اما هرگز پیاده‌سازی نشدند:
.TP
.I nospoof
مقادیر معتبر عبارتند از
.IR on " و " off .
اگر روی
.I on
تنظیم شود، کتابخانه تفکیک‌کننده به منظور افزایش امنیت
.BR rlogin " و " rsh
تلاش خواهد کرد تا از جعل نام میزبان (hostname spoofing) جلوگیری کند.
این سازوکار به شرح زیر کار می‌کند: پس از انجام جستجوی نشانی میزبان،
کتابخانه تفکیک‌کننده یک جستجوی نام میزبان برای آن نشانی انجام می‌دهد.
اگر این دو نام میزبان
با یکدیگر تطابق نداشته باشند، پرس‌وجو با شکست مواجه می‌شود.
مقدار پیش‌فرض
.I off
است.
.TP
.I spoofalert
مقادیر معتبر عبارتند از
.IR on " و " off .
اگر این گزینه روی
.I on
تنظیم شده باشد و گزینه
.I nospoof
نیز فعال باشد،
کتابخانه تفکیک‌کننده هشداری در مورد این خطا را از طریق سازوکار syslog ثبت می‌کند.
مقدار پیش‌فرض
.I off
است.
.TP
.I spoof
مقادیر معتبر عبارتند از
.IR off "، " nowarn " و " warn .
اگر این گزینه روی
.I off
تنظیم شود، نشانی‌های جعلی مجاز شمرده می‌شوند و هیچ هشداری از طریق سازوکار syslog ارسال نخواهد شد.
اگر این گزینه روی
.I warn
تنظیم شود، کتابخانه تفکیک‌کننده به منظور افزایش امنیت تلاش خواهد کرد تا از جعل نام میزبان جلوگیری کرده و هشداری درباره خطا را از طریق سازوکار syslog ثبت کند.
اگر این گزینه روی
.I nowarn
تنظیم شود، کتابخانه تفکیک‌کننده به منظور افزایش امنیت تلاش خواهد کرد تا از جعل نام میزبان جلوگیری کند، اما هشداری را از طریق سازوکار syslog ارسال نخواهد کرد.
تنظیم این گزینه روی هر مقدار دیگری معادل تنظیم آن روی
.I nowarn
است.
.TP
.B RESOLV_SPOOF_CHECK
دستورهای
.IR nospoof "، " spoofalert " و " spoof
را به همان روشی که دستور
.I spoof
تجزیه می‌شود، بازنویسی می‌کند.
مقادیر معتبر عبارتند از
.IR off "، " nowarn " و " warn .
.SH "همچنین ببینید (SEE ALSO)"
.BR gethostbyname (3),
.BR hosts (5),
.BR nsswitch.conf (5),
.BR resolv.conf (5),
.BR hostname (7),
.BR named (8)