FIREWALLD.SERVICE(5)           firewalld.service          FIREWALLD.SERVICE(5)

نام (NAME)
       firewalld.service - فایل‌های پیکربندی سرویس firewalld

خلاصه دستور (SYNOPSIS)
       /etc/firewalld/services/service.xml
       /usr/lib/firewalld/services/service.xml



توضیحات (DESCRIPTION)
       یک فایل پیکربندی سرویس firewalld، اطلاعات مربوط به یک ورودی سرویس را
       برای firewalld فراهم می‌کند. مهم‌ترین گزینه‌های پیکربندی شامل پورت‌ها،
       ماژول‌ها و آدرس‌های مقصد هستند.

       این فایل پیکربندی نمونه، ساختار یک فایل پیکربندی سرویس را نشان می‌دهد:

           <?xml version="1.0" encoding="utf-8"?>
           <service>
             <short>My Service</short>
             <description>description</description>
             <port port="137" protocol="tcp"/>
             <protocol value="igmp"/>
             <module name="nf_conntrack_netbios_ns"/>
             <destination ipv4="224.0.0.251" ipv6="ff02::fb"/>
             <include service="ssdp"/>
             <helper name="ftp"/>
           </service>



گزینه‌ها (OPTIONS)
       پیکربندی می‌تواند شامل این برچسب‌ها و مشخصه‌ها باشد. برخی از آن‌ها اجباری و
       برخی دیگر اختیاری هستند.

   service
       برچسب آغازین و پایانی اجباری service، سرویس را تعریف می‌کند. این برچسب
       تنها یک‌بار می‌تواند در یک فایل پیکربندی سرویس استفاده شود. مشخصه‌های
       اختیاری برای سرویس‌ها وجود دارد:

       version="string"
           برای اختصاص دادن یک نسخه به سرویس.

   short
       یک برچسب آغازین و پایانی اختیاری است و برای دادن نامی خواناتر به سرویس
       استفاده می‌شود.

   description
       یک برچسب آغازین و پایانی اختیاری برای ارائه توضیحات درباره سرویس است.

   port
       یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک
       ورودی پورت استفاده شود. تمام مشخصه‌های یک ورودی پورت اجباری هستند:

       port="string"
           رشته‌ی پورت string می‌تواند یک شماره پورت تکی یا یک محدوده پورت
           به‌صورت portid-portid باشد یا همچنین برای تطبیق تنها یک پروتکل، خالی
           گذاشته شود.

       protocol="string"
           مقدار پروتکل می‌تواند یکی از مقادیر tcp، udp، sctp یا dccp باشد.

       جهت سازگاری با نسخه‌های قدیمی‌تر firewalld، امکان افزودن پروتکل‌ها با
       گزینه پورت در حالتی که پورت خالی است وجود دارد. با اضافه شدن پشتیبانی
       بومی از پروتکل در سرویس، دیگر نیازی به این کار نیست. این ورودی‌ها به‌طور
       خودکار به پروتکل‌ها تبدیل می‌شوند. با ویرایش بعدی فایل سرویس، این ورودی‌ها
       به‌صورت پروتکل فهرست خواهند شد.

   protocol
       یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک
       ورودی پروتکل استفاده شود. یک ورودی پروتکل دقیقاً دارای یک مشخصه است:

       value="string"
           پروتکل می‌تواند هر پروتکلی باشد که توسط سیستم پشتیبانی می‌شود. لطفاً
           برای مشاهده پروتکل‌های پشتیبانی‌شده به /etc/protocols نگاهی بیندازید.

   source-port
       یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک
       ورودی پورت مبدأ استفاده شود. تمام مشخصه‌های یک ورودی پورت مبدأ اجباری
       هستند:

       port="string"
           رشته پورت string می‌تواند یک شماره پورت تکی یا یک محدوده پورت به‌صورت
           portid-portid باشد.

       protocol="string"
           مقدار پروتکل می‌تواند یکی از مقادیر tcp، udp، sctp یا dccp باشد.

   module
       این عنصر منسوخ شده است. لطفاً از helper که در ادامه در بخش “helper”
       توضیح داده شده استفاده کنید.

   destination
       یک برچسب عنصر خالی اختیاری است و تنها یک‌بار می‌تواند استفاده شود. مقصد،
       شبکه مقصد را به عنوان یک آدرس IP شبکه (اختیاری همراه با mask/) یا یک
       آدرس IP ساده مشخص می‌کند. استفاده از نام‌های میزبان (hostnames) توصیه
       نمی‌شود، زیرا این نام‌ها تنها در زمان فعال‌سازی سرویس تحلیل شده و به هسته
       ارسال می‌شوند. برای اطلاعات بیشتر درباره این عنصر، لطفاً به --destination
       در iptables(8) و ip6tables(8) مراجعه کنید.

       ipv4="address[/mask]"
           آدرس مقصد IPv4 به همراه ماسک اختیاری.

       ipv6="address[/mask]"
           آدرس مقصد IPv6 به همراه ماسک اختیاری.

   include
       یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک
       ورودی include استفاده شود. یک ورودی include دقیقاً دارای یک مشخصه است:

       service="string"
           مقدار include می‌تواند هر سرویسی باشد که توسط firewalld پشتیبانی
           می‌شود.

           هشدار: firewalld تنها در صورتی بررسی می‌کند که service گنجانده‌شده
           معتبر باشد که روی یک منطقه (zone) اعمال شده باشد.

   helper
       یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک
       ورودی helper استفاده شود. یک ورودی helper دقیقاً دارای یک مشخصه است:

       name="string"
           کمک‌کننده (helper) می‌تواند هر helper پشتیبانی‌شده توسط firewalld
           باشد.

همچنین ببینید (SEE ALSO)
       firewall-applet(1), firewalld(1), firewall-cmd(1), firewall-config(1),
       firewalld.conf(5), firewalld.direct(5), firewalld.dbus(5),
       firewalld.icmptype(5), firewall-offline-cmd(1),
       firewalld.richlanguage(5), firewalld.service(5), firewalld.zone(5),
       firewalld.zones(5), firewalld.policy(5), firewalld.policies(5),
       firewalld.ipset(5), firewalld.helper(5)

یادداشت‌ها (NOTES)
       صفحه خانگی firewalld:
           http://firewalld.org

نویسندگان (AUTHORS)
       Thomas Woerner <twoerner@redhat.com>
           توسعه‌دهنده

       Jiri Popelka <jpopelka@redhat.com>
           توسعه‌دهنده

       Eric Garver <eric@garver.life>
           توسعه‌دهنده

firewalld 2.5.1                                           FIREWALLD.SERVICE(5)