'\" t
.\"     Title: firewalld.service
.\"    Author: Thomas Woerner <twoerner@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 
.\"    Manual: firewalld.service
.\"    Source: firewalld 2.5.1
.\"  Language: Persian
.\"
.TH "FIREWALLD\&.SERVICE" "5" "" "firewalld 2.5.1" "firewalld.service"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
firewalld.service \- فایل‌های پیکربندی سرویس firewalld
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.nf
\fI/etc/firewalld/services/service\&.xml\fR
\fI/usr/lib/firewalld/services/service\&.xml\fR
      
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل پیکربندی سرویس firewalld، اطلاعات مربوط به یک ورودی سرویس را برای firewalld فراهم می‌کند\&. مهم‌ترین گزینه‌های پیکربندی شامل پورت‌ها، ماژول‌ها و آدرس‌های مقصد هستند\&.
.PP
این فایل پیکربندی نمونه، ساختار یک فایل پیکربندی سرویس را نشان می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
<?xml version="1\&.0" encoding="utf\-8"?>
<service>
  <short>\fIMy Service\fR</short>
  <description>\fIdescription\fR</description>
  <port port="\fI137\fR" protocol="\fItcp\fR"/>
  <protocol value="\fIigmp\fR"/>
  <module name="\fInf_conntrack_netbios_ns\fR"/>
  <destination ipv4="\fI224\&.0\&.0\&.251\fR" ipv6="\fIff02::fb\fR"/>
  <include service="\fIssdp\fR"/>
  <helper name="\fIftp\fR"/>
</service>
      
.fi
.if n \{\
.RE
.\}
.sp
.SH "گزینه‌ها (OPTIONS)"
.PP
پیکربندی می‌تواند شامل این برچسب‌ها و مشخصه‌ها باشد\&. برخی از آن‌ها اجباری و برخی دیگر اختیاری هستند\&.
.SS "service"
.PP
برچسب آغازین و پایانی اجباری service، سرویس را تعریف می‌کند\&. این برچسب تنها یک‌بار می‌تواند در یک فایل پیکربندی سرویس استفاده شود\&. مشخصه‌های اختیاری برای سرویس‌ها وجود دارد:
.PP
version="\fIstring\fR"
.RS 4
برای اختصاص دادن یک نسخه به سرویس\&.
.RE
.SS "short"
.PP
یک برچسب آغازین و پایانی اختیاری است و برای دادن نامی خواناتر به سرویس استفاده می‌شود\&.
.SS "description"
.PP
یک برچسب آغازین و پایانی اختیاری برای ارائه توضیحات درباره سرویس است\&.
.SS "port"
.PP
یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پورت استفاده شود\&. تمام مشخصه‌های یک ورودی پورت اجباری هستند:
.PP
port="\fIstring\fR"
.RS 4
رشته‌ی پورت
\fIstring\fR
می‌تواند یک شماره پورت تکی یا یک محدوده پورت به‌صورت
\fIportid\fR\-\fIportid\fR
باشد یا همچنین برای تطبیق تنها یک پروتکل، خالی گذاشته شود\&.
.RE
.PP
protocol="\fIstring\fR"
.RS 4
مقدار پروتکل می‌تواند یکی از مقادیر
\fItcp\fR،
\fIudp\fR،
\fIsctp\fR
یا
\fIdccp\fR
باشد\&.
.RE
.PP
جهت سازگاری با نسخه‌های قدیمی‌تر firewalld، امکان افزودن پروتکل‌ها با گزینه پورت در حالتی که پورت خالی است وجود دارد\&. با اضافه شدن پشتیبانی بومی از پروتکل در سرویس، دیگر نیازی به این کار نیست\&. این ورودی‌ها به‌طور خودکار به پروتکل‌ها تبدیل می‌شوند\&. با ویرایش بعدی فایل سرویس، این ورودی‌ها به‌صورت پروتکل فهرست خواهند شد\&.
.SS "protocol"
.PP
یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پروتکل استفاده شود\&. یک ورودی پروتکل دقیقاً دارای یک مشخصه است:
.PP
value="\fIstring\fR"
.RS 4
پروتکل می‌تواند هر پروتکلی باشد که توسط سیستم پشتیبانی می‌شود\&. لطفاً برای مشاهده پروتکل‌های پشتیبانی‌شده به
\fI/etc/protocols\fR
نگاهی بیندازید\&.
.RE
.SS "source\-port"
.PP
یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پورت مبدأ استفاده شود\&. تمام مشخصه‌های یک ورودی پورت مبدأ اجباری هستند:
.PP
port="\fIstring\fR"
.RS 4
رشته پورت
\fIstring\fR
می‌تواند یک شماره پورت تکی یا یک محدوده پورت به‌صورت
\fIportid\fR\-\fIportid\fR
باشد\&.
.RE
.PP
protocol="\fIstring\fR"
.RS 4
مقدار پروتکل می‌تواند یکی از مقادیر
\fItcp\fR،
\fIudp\fR،
\fIsctp\fR
یا
\fIdccp\fR
باشد\&.
.RE
.SS "module"
.PP
این عنصر منسوخ شده است\&. لطفاً از helper که در ادامه در
بخش \(lqhelper\(rq
توضیح داده شده استفاده کنید\&.
.SS "destination"
.PP
یک برچسب عنصر خالی اختیاری است و تنها یک‌بار می‌تواند استفاده شود\&. مقصد، شبکه مقصد را به عنوان یک آدرس IP شبکه (اختیاری همراه با mask/) یا یک آدرس IP ساده مشخص می‌کند\&. استفاده از نام‌های میزبان (hostnames) توصیه نمی‌شود، زیرا این نام‌ها تنها در زمان فعال‌سازی سرویس تحلیل شده و به هسته ارسال می‌شوند\&. برای اطلاعات بیشتر درباره این عنصر، لطفاً به
\fB\-\-destination\fR
در
\fBiptables\fR(8)
و
\fBip6tables\fR(8)
مراجعه کنید\&.
.PP
ipv4="\fIaddress\fR[/\fImask\fR]"
.RS 4
آدرس مقصد IPv4 به همراه ماسک اختیاری\&.
.RE
.PP
ipv6="\fIaddress\fR[/\fImask\fR]"
.RS 4
آدرس مقصد IPv6 به همراه ماسک اختیاری\&.
.RE
.SS "include"
.PP
یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی include استفاده شود\&. یک ورودی include دقیقاً دارای یک مشخصه است:
.PP
service="\fIstring\fR"
.RS 4
مقدار include می‌تواند هر سرویسی باشد که توسط firewalld پشتیبانی می‌شود\&.
.sp
\fBهشدار:\fR firewalld تنها در صورتی بررسی می‌کند که
\fIservice\fR
گنجانده‌شده معتبر باشد که روی یک منطقه (zone) اعمال شده باشد\&.
.RE
.SS "helper"
.PP
یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی helper استفاده شود\&. یک ورودی helper دقیقاً دارای یک مشخصه است:
.PP
name="\fIstring\fR"
.RS 4
کمک‌کننده (helper) می‌تواند هر helper پشتیبانی‌شده توسط firewalld باشد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBfirewall-applet\fR(1), \fBfirewalld\fR(1), \fBfirewall-cmd\fR(1), \fBfirewall-config\fR(1), \fBfirewalld.conf\fR(5), \fBfirewalld.direct\fR(5), \fBfirewalld.dbus\fR(5), \fBfirewalld.icmptype\fR(5), \fBfirewall-offline-cmd\fR(1), \fBfirewalld.richlanguage\fR(5), \fBfirewalld.service\fR(5), \fBfirewalld.zone\fR(5), \fBfirewalld.zones\fR(5), \fBfirewalld.policy\fR(5), \fBfirewalld.policies\fR(5), \fBfirewalld.ipset\fR(5), \fBfirewalld.helper\fR(5)
.SH "یادداشت‌ها (NOTES)"
.PP
صفحه خانگی firewalld:
.RS 4
\m[blue]\fB\%http://firewalld.org\fR\m[]
.RE
.SH "نویسندگان (AUTHORS)"
.PP
\fBThomas Woerner\fR <\&twoerner@redhat\&.com\&>
.RS 4
توسعه‌دهنده
.RE
.PP
\fBJiri Popelka\fR <\&jpopelka@redhat\&.com\&>
.RS 4
توسعه‌دهنده
.RE
.PP
\fBEric Garver\fR <\&eric@garver\&.life\&>
.RS 4
توسعه‌دهنده
.RE