.TH avahi.service 5 User Manuals
.SH "نام (NAME)"
avahi.service \- پرونده سرویس ایستا برای avahi-daemon
.SH "خلاصه دستور (SYNOPSIS)"
\fB/etc/avahi/services/*.service
\f1
.SH "توضیحات (DESCRIPTION)"
پرونده‌های \fI/etc/avahi/services/*.service\f1 قطعه‌های XML حاوی داده‌های سرویس ایستای DNS-SD هستند. هر پرونده سرویس می‌تواند شامل چندین تعریف سرویس باشد که نام یکسانی دارند. این قابلیت برای انتشار داده‌های سرویس برای سرویس‌هایی که چندین پروتکل را پیاده‌سازی می‌کنند مفید است (برای نمونه، چاپگری که هر دو \fI_ipp._tcp\f1 و \fI_printer._tcp\f1 را پیاده‌سازی می‌کند).
.SH "برچسب‌های XML (XML TAGS)"
.TP
\fB<service-group>\f1 برچسب سند پرونده‌های سرویس avahi. باید شامل یک عنصر \fB<name>\f1 و یک یا چند عنصر \fB<service>\f1 باشد.
.TP
\fB<name replace-wildcards="yes|no">\f1 نام سرویس. اگر \fBreplace-wildcards\f1 برابر "yes" باشد، هر رخداد از رشتهٔ "%h" با نام هاست محلی جایگزین خواهد شد. این قابلیت می‌تواند برای نام‌های سرویس مانند "Remote Terminal on %h" استفاده شود. اگر \fBreplace-wildcards\f1 مشخص نشده باشد، مقدار پیش‌فرض "no" است.
.TP
\fB<service protocol="ipv4|ipv6|any">\f1 شامل اطلاعات سرویس برای دقیقاً یک نوع سرویس است. باید شامل یک عنصر \fB<type>\f1 و یک عنصر \fB<port>\f1 باشد. به‌صورت اختیاری ممکن است شامل یک عنصر \fB<domain-name>\f1، یک عنصر \fB<host-name>\f1، هر تعداد عنصر \fB<subtype>\f1 و هر تعداد عنصر \fB<txt-record>\f1 باشد. صفت \fBprotocol\f1 پروتکل مورد استفاده برای آگهی سرویس را مشخص می‌کند. اگر از \fBany\f1 استفاده شود (که پیش‌فرض است)، سرویس روی هر دو پروتکل IPv4 و IPv6 آگهی خواهد شد.
.TP
\fB<type>\f1 شامل نوع سرویس DNS-SD برای این سرویس است، مانند "_http._tcp".
.TP
\fB<subtype>\f1 شامل یک زیرنوع سرویس تکمیلی DNS-SD برای این سرویس است، مانند "_anon._sub._ftp._tcp".
.TP
\fB<domain-name>\f1 نام دامنه‌ای که این سرویس باید در آن ثبت شود. در صورت حذف، پیش‌فرض روی دامنهٔ پیش‌فرض دیمن avahi تنظیم می‌شود (احتمالاً .local).
.TP
\fB<host-name>\f1 نام هاستِ میزبانی که این سرویس را ارائه می‌دهد. این باید هاستی باشد که توسط DNS چندپخشی (multicast) یا تک‌پخشی (unicast) قابل تفکیک و آدرس‌یابی باشد. توجه داشته باشید که باید یک نام دامنه کاملاً واجد شرایط (FQDN) را در اینجا مشخص کنید، یعنی .local به‌طور ضمنی افزوده نمی‌شود! نیازی نیست نام هاست بخشی از دامنهٔ مشخص‌شده در \fB<domain-name>\f1 باشد. برای اطلاعات بیشتر در مورد نحوه انتشار نگاشت‌های نام هاست اضافی، \fBavahi.hosts(5)\f1 را ببینید.
.TP
\fB<port>\f1 شماره پورت IP که سرویس روی آن گوش می‌دهد.
.TP
\fB<txt-record value-format="text|binary-hex|binary-base64">\f1 داده‌های رکورد TXT در DNS-SD. اگر \fBvalue-format\f1 برابر "text" باشد، مقدار رکورد TXT بدون تغییر (عینی) دریافت می‌شود. اگر \fBvalue-format\f1 برابر "binary-hex" باشد، مقدار رکورد TXT با دریافت جفت‌نویسه‌های پس از نویسهٔ "=" و تفسیر آن‌ها به‌عنوان نمایش متنیِ عدد مبنای ۱۶ (هگزادسیمال) دونقمی رمزگشایی می‌شود. هر دو نویسه‌های هگزادسیمال بزرگ و کوچک مجاز هستند. پیشوند 0x یا 0X مجاز نیست. این حالت نیازمند زوج بودن طول مقدار است. اگر \fBvalue-format\f1 برابر "binary-base64" باشد، مقدار رکورد TXT با رمزگشای base64 رمزگشایی می‌شود. مجموعه نویسه‌های مورد استفاده A-Za-z0-9+/ است. این حالت نیازمند مضرب ۴ بودن طول مقدار است، همراه با "=" به‌عنوان نویسه پرکننده (padding) در انتها. اگر \fBvalue-format\f1 مشخص نشده باشد، مقدار پیش‌فرض "text" است. نمونه‌ها (تمام مقادیر به رشتهٔ "value" بدون علامت نقل‌قول رمزگشایی می‌شوند):

<txt-record>key=value</txt-record>

<txt-record value-format="text">key=value</txt-record>

<txt-record value-format="binary-hex">key=76616c7565</txt-record>

<txt-record value-format="binary-base64">key=dmFsdWU=</txt-record>
.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان Avahi <avahi (at) lists (dot) freedesktop (dot) org>؛ دیمن Avahi در \fBhttp://avahi.org\f1 در دسترس است.
.SH "همچنین ببینید (SEE ALSO)"
\fBavahi-daemon(8)\f1, \fBavahi.hosts(5)\f1
.SH "توضیحات (COMMENTS)"
این صفحهٔ راهنما با استفاده از \fBxml2man(1)\f1 توسط Oliver Kurth نوشته شده است.