avahi.service(5) File Formats Manual avahi.service(5)

avahi.service - پرونده سرویس ایستا برای avahi-daemon

/etc/avahi/services/*.service

پرونده‌های /etc/avahi/services/*.service قطعه‌های XML حاوی داده‌های سرویس ایستای DNS-SD هستند. هر پرونده سرویس می‌تواند شامل چندین تعریف سرویس باشد که نام یکسانی دارند. این قابلیت برای انتشار داده‌های سرویس برای سرویس‌هایی که چندین پروتکل را پیاده‌سازی می‌کنند مفید است (برای نمونه، چاپگری که هر دو _ipp._tcp و _printer._tcp را پیاده‌سازی می‌کند).

<service-group> برچسب سند پرونده‌های سرویس avahi. باید شامل یک عنصر <name> و یک یا چند عنصر <service> باشد.
<name replace-wildcards="yes|no"> نام سرویس. اگر replace-wildcards برابر "yes" باشد، هر رخداد از رشتهٔ "%h" با نام هاست محلی جایگزین خواهد شد. این قابلیت می‌تواند برای نام‌های سرویس مانند "Remote Terminal on %h" استفاده شود. اگر replace-wildcards مشخص نشده باشد، مقدار پیش‌فرض "no" است.
<service protocol="ipv4|ipv6|any"> شامل اطلاعات سرویس برای دقیقاً یک نوع سرویس است. باید شامل یک عنصر <type> و یک عنصر <port> باشد. به‌صورت اختیاری ممکن است شامل یک عنصر <domain-name>، یک عنصر <host-name>، هر تعداد عنصر <subtype> و هر تعداد عنصر <txt-record> باشد. صفت protocol پروتکل مورد استفاده برای آگهی سرویس را مشخص می‌کند. اگر از any استفاده شود (که پیش‌فرض است)، سرویس روی هر دو پروتکل IPv4 و IPv6 آگهی خواهد شد.
<type> شامل نوع سرویس DNS-SD برای این سرویس است، مانند "_http._tcp".
<subtype> شامل یک زیرنوع سرویس تکمیلی DNS-SD برای این سرویس است، مانند "_anon._sub._ftp._tcp".
<domain-name> نام دامنه‌ای که این سرویس باید در آن ثبت شود. در صورت حذف، پیش‌فرض روی دامنهٔ پیش‌فرض دیمن avahi تنظیم می‌شود (احتمالاً .local).
<host-name> نام هاستِ میزبانی که این سرویس را ارائه می‌دهد. این باید هاستی باشد که توسط DNS چندپخشی (multicast) یا تک‌پخشی (unicast) قابل تفکیک و آدرس‌یابی باشد. توجه داشته باشید که باید یک نام دامنه کاملاً واجد شرایط (FQDN) را در اینجا مشخص کنید، یعنی .local به‌طور ضمنی افزوده نمی‌شود! نیازی نیست نام هاست بخشی از دامنهٔ مشخص‌شده در <domain-name> باشد. برای اطلاعات بیشتر در مورد نحوه انتشار نگاشت‌های نام هاست اضافی، avahi.hosts(5) را ببینید.
<port> شماره پورت IP که سرویس روی آن گوش می‌دهد.
<txt-record value-format="text|binary-hex|binary-base64"> داده‌های رکورد TXT در DNS-SD. اگر value-format برابر "text" باشد، مقدار رکورد TXT بدون تغییر (عینی) دریافت می‌شود. اگر value-format برابر "binary-hex" باشد، مقدار رکورد TXT با دریافت جفت‌نویسه‌های پس از نویسهٔ "=" و تفسیر آن‌ها به‌عنوان نمایش متنیِ عدد مبنای ۱۶ (هگزادسیمال) دونقمی رمزگشایی می‌شود. هر دو نویسه‌های هگزادسیمال بزرگ و کوچک مجاز هستند. پیشوند 0x یا 0X مجاز نیست. این حالت نیازمند زوج بودن طول مقدار است. اگر value-format برابر "binary-base64" باشد، مقدار رکورد TXT با رمزگشای base64 رمزگشایی می‌شود. مجموعه نویسه‌های مورد استفاده A-Za-z0-9+/ است. این حالت نیازمند مضرب ۴ بودن طول مقدار است، همراه با "=" به‌عنوان نویسه پرکننده (padding) در انتها. اگر value-format مشخص نشده باشد، مقدار پیش‌فرض "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>

توسعه‌دهندگان Avahi <avahi (at) lists (dot) freedesktop (dot) org>؛ دیمن Avahi در http://avahi.org در دسترس است.

avahi-daemon(8), avahi.hosts(5)

این صفحهٔ راهنما با استفاده از xml2man(1) توسط Oliver Kurth نوشته شده است.

User Manuals