.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DOMAIN 8"
.TH DOMAIN 8 2023-03-07 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
domain \- تحلیل‌گر نام دامنه برای nnrpd
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdomain\fR \fIdomain\-name\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
از این برنامه می‌توان در
\fIreaders.conf\fR
برای اعطای دسترسی بر اساس بخش زیردامنه نام میزبان دوردست استفاده کرد. به‌ویژه، این برنامه تنها زمانی موفقیت را بازمی‌گرداند که نام میزبان دوردست به
\fIdomain\-name\fR
ختم شود. (قرار دادن نقطه در ابتدای
\&\fIdomain\-name\fR
اختیاری است؛ حتی بدون آن نیز آرگومان باید در مرزهای جداشده با نقطه مطابقت داشته باشد). نام کاربری
(\f(CW\*(C`username\*(C'\fR)
بازگردانده‌شده، همان بخش ابتدایی نام میزبان دوردست است که پس از حذف
\fIdomain\-name\fR
باقی می‌ماند. اگر هیچ بخش ابتدایی وجود نداشته باشد (یعنی اگر نام میزبان دوردست
\fIدقیقاً\fR
برابر با
\fIdomain\-name\fR
مشخص‌شده باشد) خطا رخ می‌دهد.
.SH "مثال (EXAMPLE)"
.IX Header "EXAMPLE"
قطعه کد زیر از readers.conf(5) دسترسی به میزبان‌هایی با نام‌های دامنه داخلی را اعطا می‌کند:
.PP
.Vb 4
\&    auth internal {
\&        res: "domain .internal"
\&        default\-domain: "example.com"
\&    }
\&
\&    access internal {
\&        users: "*@example.com"
\&        newsgroups: example.*
\&    }
.Ve
.PP
دسترسی به گروه‌های *example برای تمام اتصالات از سوی میزبان‌هایی اعطا می‌شود که نام میزبان آن‌ها به
\f(CW\*(C`.internal\*(C'\fR
ختم شود؛ اتصالی از سوی
\&\f(CW\*(C`foo.internal\*(C'\fR
با شناسه
\f(CW\*(C`foo@example.com\*(C'\fR
با گروه‌های دسترسی مطابقت خواهد داشت.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
به نظر می‌رسد کد این موضوع را تایید نمی‌کند که بخش تطبیق‌یافته واقعاً در انتهای نام میزبان دوردست قرار داشته باشد (برای نمونه،
\f(CW\*(C`domain: example.com\*(C'\fR
با میزبان دوردست
\f(CW\*(C`foo.example.com.org\*(C'\fR
از طریق نادیده گرفتن بخش پایانی
\f(CW\*(C`.org\*(C'\fR
تطبیق می‌یابد).
.PP
آیا این تحلیل‌گر واقعاً قابلیت مفیدی ارائه می‌دهد که با استفاده از الگوها (wildcards) در پارامتر
\fIhosts\fR
در readers.conf(5) در دسترس نباشد؟ اگر چنین است، مثال بالا باید این قابلیت را منعکس کند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
این مستندات توسط Jeffrey M.\ Vinocur <jeff@litech.org> نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\fBnnrpd\fR(8), \fBreaders.conf\fR(5)