'\" t
.\"     Title: netctl.profile
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 10/09/2023
.\"    Manual: \ \&
.\"    Source: \ \& 1.29
.\"  Language: Persian
.\"
.TH "NETCTL\&.PROFILE" "5" "10/09/2023" "\ \& 1\&.29" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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)"
netctl.profile \- گزینه‌های پروفایل netctl
.SH "خلاصه دستور (SYNOPSIS)"
.sp
netctl\&.profile
.SH "توضیحات (DESCRIPTION)"
.sp
پروفایل‌های netctl در مسیر \fI/etc/netctl/\fR قرار دارند و فایل‌های متنی ساده هستند\&. این فایل‌ها شامل تعریف متغیرها بر اساس قواعد نحو شل bash می‌باشند و انتظار نمی‌رود که کدی را اجرا کنند\&. بهتر است تا حد امکان از نقل‌قول (کوتیشن) استفاده نشود\&. برای چند متغیر مربوط به WPA، قواعد نقل‌قول ویژه‌ای (به زیر مراجعه کنید) اعمال می‌شود\&.
.sp
نام پروفایل همان نام فایل است\&. نام پروفایل‌ها نباید شامل خط جدید (newline) باشد و نباید به \fI\&.action\fR، \fI\&.conf\fR یا \fI\&.service\fR ختم شود\&. هر زمان که یک پروفایل خوانده می‌شود، تمام اسکریپت‌های اجرایی در \fI/etc/netctl/hooks/\fR و هر اسکریپت اجرایی در \fI/etc/netctl/interfaces/\fR با نام رابط مربوط به آن پروفایل فراخوانی (source) می‌شوند\&. نام پروفایل جاری از طریق متغیر \fIProfile\fR در محیط اسکریپت‌های فراخوانی‌شده در دسترس است\&. هنگام شروع یا توقف یک پروفایل، دستور مربوطه از طریق متغیر \fICommand\fR قابل دسترسی است\&. تعاریف درون اسکریپت یک رابط، تعاریف درون پروفایل را بازنویسی (override) می‌کنند و تعاریف درون پروفایل نیز تعاریف درون قلاب‌ها (hooks) را بازنویسی می‌نمایند\&. برای هر نوع اتصال، فایل‌های نمونه پروفایل در مسیر \fI/etc/netctl/examples/\fR موجود است\&.
.SH "انواع اتصال موجود (AVAILABLE CONNECTION TYPES)"
.PP
ethernet
.RS 4
برای اتصالات سیمی (wired)\&.
.RE
.PP
wireless
.RS 4
برای اتصالات بی‌سیم\&. این نوع اتصال به وجود و در دسترس بودن
\fBwpa_supplicant\fR
نیاز دارد\&.
.RE
.PP
bond
.RS 4
برای رابط‌های پیوند داده‌شده (bonded)\&.
.RE
.PP
bridge
.RS 4
برای رابط‌های پل (bridge)\&.
.RE
.PP
dummy
.RS 4
برای رابط‌های ساختگی (dummy)\&.
.RE
.PP
ppp
.RS 4
برای اتصالات PPP (در حال حاضر فقط PPPoE)\&.
.RE
.PP
pppoe
.RS 4
برای اتصالات PPPoE\&.
.RE
.PP
mobile_ppp
.RS 4
برای اتصالات پهن‌باند تلفن همراه PPP که از مودم USB استفاده می‌کنند\&.
.RE
.PP
openvswitch
.RS 4
برای رابط‌های پل Open vSwitch\&.
.RE
.PP
tunnel
.RS 4
برای رابط‌های تونل\&.
.RE
.PP
tuntap
.RS 4
برای رابط‌های TUN/TAP\&.
.RE
.PP
vlan
.RS 4
برای VLANها روی اتصالات مشابه اترنت\&.
.RE
.PP
macvlan
.RS 4
برای MACVLANها روی اتصالات مشابه اترنت\&.
.RE
.PP
wireguard
.RS 4
برای رابط‌های WireGuard\&.
.RE
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.PP
\fIDescription=\fR
.RS 4
توضیحی درباره پروفایل\&.
.RE
.PP
\fIConnection=\fR [اجباری برای تمام پروفایل‌ها]
.RS 4
نوع اتصال مورد استفاده توسط پروفایل\&.
.RE
.PP
\fIInterface=\fR [اجباری برای تمام پروفایل‌ها]
.RS 4
نام رابط شبکه مرتبط\&. نام رابط نباید داخل نقل‌قول قرار گیرد\&.
.RE
.PP
\fIBindsToInterfaces=()\fR
.RS 4
آرایه‌ای از رابط‌های فیزیکی شبکه که این پروفایل برای شروع به آن‌ها نیاز دارد\&. برای پروفایل‌های فعال‌شده (enabled)،
\fBsystemd\fR
قبل از شروع پروفایل، منتظر حضور رابط‌های مشخص‌شده خواهد ماند\&. اگر این متغیر مشخص نشود، مقدار پیش‌فرض آن همان مقدار
\fIInterface=\fR
خواهد بود\&.
.RE
.PP
\fIMACAddress=\fR
.RS 4
آدرس MAC اختیاری برای رابط‌های تازه ایجاد شده\&. وقتی روی نام یک رابط موجود تنظیم شود، آدرس آن رابط استفاده می‌شود\&. انواع اتصالاتی که یک رابط ایجاد می‌کنند و قادر به تنظیم آدرس MAC هستند عبارتند از:
bond،
bridge،
dummy،
vlan، و
macvlan\&.
.RE
.PP
\fIAfter=()\fR
.RS 4
آرایه‌ای از نام‌های پروفایل‌ها که باید قبل از شروع این پروفایل، شروع شوند\&. این صرفاً یک وابستگی ترتیبی است و به معنای فهرستی از پروفایل‌های مورد نیاز این پروفایل نیست\&. معنای آن مشابه
\fIAfter=\fR
در
\fBsystemd\&.unit\fR(5)
است\&.
.RE
.PP
\fIWaitOnline=\fR
.RS 4
برای اینکه پروفایل تنها زمانی فعال در نظر گرفته شود که آنلاین است، روی \(oqyes\(cq تنظیم شود\&. پیش‌فرض \(oqno\(cq است\&.
.RE
.PP
\fIExecUpPost=\fR
.RS 4
دستوری که پس از برقراری اتصال اجرا می‌شود\&. اگر دستور مشخص‌شده هر مقداری غیر از 0 (موفقیت) برگرداند،
\fBnetctl\fR
عملیات را متوقف کرده و پروفایل را غیرفعال می‌کند\&. اگر می‌خواهید شکست دستور نادیده گرفته شود، عبارت \(oq|| true\(cq را به انتهای آن اضافه کنید\&.
.RE
.PP
\fIExecDownPre=\fR
.RS 4
دستوری که قبل از قطع اتصال اجرا می‌شود\&. احتیاط‌های مشابه با
\fIExecUpPost=\fR
باید رعایت شوند\&.
.RE
.PP
\fITimeoutUp\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت بالا آمدن رابط\&. مقدار پیش‌فرض \(oq5\(cq است\&.
.RE
.PP
\fIForceConnect=\fR
.RS 4
تنظیم روی \(oqyes\(cq برای اجبار به اتصال حتی اگر رابط از قبل بالا باشد\&. از این گزینه استفاده نکنید مگر اینکه بدانید دقیقاً چه کاری انجام می‌دهید\&.
.RE
.PP
\fIExcludeAuto=\fR
.RS 4
آیا این پروفایل از انتخاب خودکار پروفایل مستثنی شود یا خیر\&. پیش‌فرض برای اتصالات بی‌سیم و اتصالات با DHCP فعال برابر با \(oqno\(cq و در غیر این صورت برابر با \(oqyes\(cq است\&.
.RE
.PP
\fINETCTL_DEBUG=\fR
.RS 4
برای تولید خروجی رفع اشکال (debug) روی \(oqyes\(cq تنظیم شود\&.
.RE
.SH "گزینه‌های آی‌پی (IP OPTIONS)"
.sp
این گزینه‌ها برای تمام اتصالاتی که یک شبکه مبتنی بر IP را راه‌اندازی می‌کنند اعمال می‌شوند\&. به‌طور خاص، این انواع اتصال عبارتند از: ethernet، wireless، bond، bridge، tunnel، tuntap و vlan\&.
.PP
\fIIP=\fR [اجباری برای IPv4]
.RS 4
یکی از مقادیر \(oqstatic\(cq، \(oqdhcp\(cq یا \(oqno\(cq، بسته به روش مورد نظر برای دریافت آدرس\&.
.RE
.PP
\fIIP6=\fR [اجباری برای IPv6]
.RS 4
یکی از مقادیر \(oqstatic\(cq، \(oqstateless\(cq، \(oqdhcp\-noaddr\(cq، \(oqdhcp\(cq، \(oqno\(cq یا کاملاً خالی (بدون مقدار)\&. تفاوت بین مشخص نکردن و تنظیم روی \(oqno\(cq در نحوه مدیریت بسته‌های
\fIrouter advertisement\fR
است که توسط \(oqno\(cq مسدود می‌شود\&.
.RE
.PP
\fIAddress=()\fR [نیازمند \fIIP=static\fR]
.RS 4
آرایه‌ای از آدرس‌های IP با پسوند \(oq/<netmask>\(cq\&. حذف براکت‌ها برای آرایه‌های شامل یک عنصر در نحو Bash مجاز است\&.
.RE
.PP
\fIGateway=\fR [نیازمند \fIIP=static\fR]
.RS 4
آدرس درگاه (gateway) مسیریابی IP\&.
.RE
.PP
\fIRoutes=()\fR
.RS 4
آرایه‌ای از مسیرهای سفارشی به فرم

\(oq\fB<address range>\fR
via
\fB<gateway>\fR\(cq\&.
.RE
.PP
\fIAddress6=()\fR [نیازمند \fIIP6=static\fR یا \fIIP6=stateless\fR]
.RS 4
آرایه‌ای از آدرس‌های IPv6\&. طول پیشوند می‌تواند با نحو \(oq1234:bcd::11/64\(cq مشخص شود\&. امکان تعیین اصلاح‌کننده‌ها (modifiers) وجود دارد، به‌ویژه \(oq1234:bcd::11/64 nodad\(cq که تشخیص آدرس تکراری (Duplicate Address Detection) را برای آن آدرس غیرفعال می‌کند\&.
.RE
.PP
\fIGateway6=\fR [نیازمند \fIIP6=static\fR یا \fIIP6=stateless\fR]
.RS 4
آدرس درگاه (gateway) مسیریابی IPv6\&.
.RE
.PP
\fIRoutes6=()\fR
.RS 4
آرایه‌ای از مسیرهای سفارشی به فرم

\(oq\fB<address range>\fR
via
\fB<gateway>\fR\(cq\&.
.RE
.PP
\fIDHCPClient=\fR [نیازمند \fIIP=dhcp\fR]
.RS 4
نام کلاینت DHCP مورد استفاده\&. به‌طور پیش‌فرض،
\fBnetctl\fR
با پشتیبانی از \(oqdhcpcd\(cq و \(oqdhclient\(cq عرضه می‌شود\&. کلاینت‌ها ممکن است گزینه‌های اضافی را از طریق متغیرهای خاص خود بپذیرند\&. گزینه‌های خط فرمان برای
\fBdhcpcd\fR(8)
از
\fIDhcpcdOptions=\fR
خوانده می‌شوند (پیش‌فرض \(oq\-L\(cq است)\&. گزینه‌های خط فرمان برای
\fBdhclient\fR(8)
از
\fIDhclientOptions=\fR
خوانده می‌شوند\&. مقدار پیش‌فرض \(oqdhcpcd\(cq است\&.
.RE
.PP
\fIDHCP6Client=\fR [نیازمند \fIIP6=dhcp\fR یا \fIIP6=dhcp\-noaddr\fR]
.RS 4
نام کلاینت DHCPv6 مورد استفاده\&. به‌طور پیش‌فرض، \(oqdhcpcd\(cq و \(oqdhclient\(cq پشتیبانی می‌شوند\&. گزینه‌های خط فرمان برای نمونه IPv6 نرم‌افزار
\fBdhcpcd\fR(8)
از
\fIDhcpcdOptions6=\fR
خوانده می‌شوند\&. گزینه‌های خط فرمان برای نمونه IPv6 نرم‌افزار
\fBdhclient\fR(8)
از
\fIDhclientOptions6=\fR
خوانده می‌شوند\&. مقدار پیش‌فرض \(oqdhclient\(cq است\&.
.RE
.PP
\fIDHCPReleaseOnStop=\fR
.RS 4
برای آزادسازی اجاره (lease) DHCP هنگام توقف پروفایل، روی \(oqyes\(cq تنظیم شود\&.
.RE
.PP
\fIIPCustom=()\fR
.RS 4
آرایه‌ای از خطوط آرگومان برای ارسال به
ip\&. این گزینه می‌تواند برای دستیابی به پیکربندی‌های پیچیده در چارچوب
\fBnetctl\fR
استفاده شود\&.
.RE
.PP
\fIHostname=\fR
.RS 4
یک نام میزبان موقت (transient) برای سیستم\&.
.RE
.PP
\fIDNS=()\fR
.RS 4
آرایه‌ای از کارگزارهای نام DNS\&. کافی است آدرس‌های IP هر یک از کارگزارهای DNS را مشخص کنید\&.
.RE
.PP
\fIDNSDomain=\fR
.RS 4
یک خط \(oqdomain\(cq برای
\fI/etc/resolv\&.conf\fR،
که به
\fBresolvconf\fR(5)
ارسال می‌شود\&.
.RE
.PP
\fIDNSSearch=\fR
.RS 4
یک خط \(oqsearch\(cq برای
\fI/etc/resolv\&.conf\fR،
که به
\fBresolvconf\fR(5)
ارسال می‌شود\&.
.RE
.PP
\fIDNSOptions=()\fR
.RS 4
آرایه‌ای از خطوط \(oqoptions\(cq برای
\fI/etc/resolv\&.conf\fR،
که به
\fBresolvconf\fR(5)
ارسال می‌شود\&.
.RE
.PP
\fITimeoutDHCP=\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت موفقیت DHCP\&. پیش‌فرض \(oq30\(cq است\&.
.RE
.PP
\fITimeoutDAD=\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت موفقیت تشخیص آدرس تکراری (DAD) در IPv6\&. پیش‌فرض \(oq3\(cq است\&.
.RE
.PP
\fISkipDAD=\fR
.RS 4
آیا تشخیص آدرس تکراری به‌طور کلی نادیده گرفته شود یا خیر\&. پیش‌فرض \(oqno\(cq است\&.
.RE
.SH "گزینه‌های اتصالات ‘ETHERNET’ (OPTIONS FOR ‘ETHERNET’ CONNECTIONS)"
.sp
علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqethernet\(cq شناخته شده‌اند:
.PP
\fIAuth8021X=\fR
.RS 4
برای استفاده از احراز هویت 802\&.1x روی \(oqyes\(cq تنظیم شود\&.
.RE
.PP
\fIWPAConfigFile=\fR
.RS 4
مسیر فایل پیکربندی
\fBwpa_supplicant\fR\&.
پیش‌فرض
\fI/etc/wpa_supplicant\&.conf\fR
است\&.
.RE
.PP
\fIWPADriver=\fR
.RS 4
درایور
\fBwpa_supplicant\fR
مورد استفاده برای احراز هویت 802\&.1x\&. پیش‌فرض \(oqwired\(cq است\&.
.RE
.PP
\fITimeoutCarrier=\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار دریافت سیگنال حامل (carrier)\&. پیش‌فرض \(oq5\(cq است\&.
.RE
.PP
\fITimeoutWPA=\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت موفقیت احراز هویت 802\&.1x\&. پیش‌فرض \(oq15\(cq است\&.
.RE
.PP
\fISkipNoCarrier=\fR
.RS 4
آیا عدم وجود حامل (کابل متصل‌شده) قابل قبول است یا خیر\&. پیش‌فرض \(oqno\(cq است\&.
.RE
.PP
\fIPriority=\fR
.RS 4
سطح اولویت پروفایل\&. در صورت انتخاب خودکار پروفایل، پروفایل‌ها به ترتیب اولویت نزولی آزمایش می‌شوند\&. مقدار پیش‌فرض در پروفایل‌های با DHCP فعال \(oq1\(cq و در غیر این صورت \(oq0\(cq است\&.
.RE
.SH "گزینه‌های اتصالات ‘WIRELESS’ (OPTIONS FOR ‘WIRELESS’ CONNECTIONS)"
.sp
علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqwireless\(cq شناخته شده‌اند:
.PP
\fISecurity=\fR
.RS 4
یکی از مقادیر \(oqnone\(cq، \(oqwep\(cq، \(oqwpa\(cq، \(oqwpa\-configsection\(cq، یا \(oqwpa\-config\(cq\&. پیش‌فرض \(oqnone\(cq است\&.
.RE
.PP
\fIESSID=\fR [اجباری]
.RS 4
نام شبکه‌ای که قرار است به آن متصل شوید\&. قواعد نقل‌قول ویژه (به زیر مراجعه کنید) اعمال می‌شود\&.
.RE
.PP
\fIAP=\fR
.RS 4
شناسه BSSID (آدرس MAC) نقطه دسترسی (Access Point) برای اتصال\&.
.RE
.PP
\fIKey=\fR
.RS 4
کلید مخفی برای شبکه رمزگذاری‌شده WEP یا WPA\&. قواعد نقل‌قول ویژه (به زیر مراجعه کنید) اعمال می‌شود\&.
.RE
.PP
\fIHidden=\fR
.RS 4
آیا شبکه مشخص‌شده یک شبکه مخفی است یا خیر\&. پیش‌فرض \(oqno\(cq است\&.
.RE
.PP
\fIAdHoc=\fR
.RS 4
آیا از حالت Ad-Hoc استفاده شود یا خیر\&. پیش‌فرض \(oqno\(cq است\&.
.RE
.PP
\fIScanFrequencies=\fR
.RS 4
فهرستی از فرکانس‌ها بر حسب مگاهرتز (جداشده با فاصله) برای پویش هنگام جستجوی شبکه\&. پیش‌فرض همه فرکانس‌های موجود است\&.
.RE
.PP
\fIFrequency=\fR
.RS 4
فرکانسی بر حسب مگاهرتز برای استفاده در حالت Ad-Hoc هنگامی که یک IBSS جدید ایجاد می‌شود (یعنی شبکه از قبل وجود ندارد)\&.
.RE
.PP
\fIPriority=\fR
.RS 4
گروه اولویت برای شبکه\&. در صورت انتخاب خودکار پروفایل، شبکه منطبق با بالاترین اولویت انتخاب خواهد شد\&. پیش‌فرض \(oq0\(cq است\&.
.RE
.PP
\fIWPAConfigSection=()\fR [اجباری برای \fISecurity=wpa\-configsection\fR]
.RS 4
آرایه‌ای از خطوط که یک بلوک شبکه را برای
\fBwpa_supplicant\fR
تشکیل می‌دهند\&. تمام گزینه‌های بالا نادیده گرفته خواهند شد\&.
.RE
.PP
\fIWPAConfigFile=\fR
.RS 4
مسیر فایل پیکربندی
\fBwpa_supplicant\fR\&.
تنها برای
\fISecurity=wpa\-config\fR
استفاده می‌شود\&. تمام گزینه‌ها به جز
\fIWPADriver=\fR،
\fITimeoutWPA=\fR و
\fIRFKill=\fR
نادیده گرفته خواهند شد\&. این پروفایل از انتخاب خودکار پروفایل مستثنی است\&. پیش‌فرض
\fI/etc/wpa_supplicant\&.conf\fR
است\&.
.RE
.PP
\fICountry=\fR
.RS 4
کشوری که مقررات فرکانسی آن اعمال خواهد شد\&.
.RE
.PP
\fIWPAGroup=\fR
.RS 4
گروهی که اجازه پیکربندی
\fBwpa_supplicant\fR
از طریق رابط کنترلی آن را دارد\&. پیش‌فرض \(oqwheel\(cq است\&.
.RE
.PP
\fIWPADriver=\fR
.RS 4
درایور
\fBwpa_supplicant\fR
مورد استفاده\&. پیش‌فرض \(oqnl80211,wext\(cq است\&.
.RE
.PP
\fITimeoutWPA=\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت موفقیت مراحل اتصال (association) و احراز هویت\&. پیش‌فرض \(oq15\(cq است\&.
.RE
.PP
\fIRFKill=\fR
.RS 4
نام یک دستگاه
\fBrfkill\fR\&.
در صورت مشخص شدن، این دستگاه برای مسدود/باز کردن رابط در زمان مناسب استفاده می‌شود\&. نام‌ها را می‌توان در
\fI/sys/class/rfkill/rfkillX/name\fR
یافت\&. همچنین می‌توان این متغیر را روی \(oqauto\(cq تنظیم کرد\&. در این حالت دستگاه
\fBrfkill\fR
مرتبط با رابط شبکه استفاده می‌شود\&.
.RE
.SH "گزینه‌های اتصالات ‘BOND’ (OPTIONS FOR ‘BOND’ CONNECTIONS)"
.sp
رابط‌های مشخص‌شده در \fIBindsToInterfaces=\fR در رابطی با نام \fIInterface=\fR با هم پیوند داده می‌شوند (bound)\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqbond\(cq شناخته شده‌اند:
.PP
\fIMode=\fR
.RS 4
سیاست پیوند (bonding policy)\&. برای جزئیات به مستندات هسته درباره پیوند (bonding) مراجعه کنید\&.
.RE
.PP
\fILinkOptions=\fR
.RS 4
گزینه‌های اضافی برای ارسال به
\fBip link\fR\&.
برای مشاهده گزینه‌های موجود، دستور
\fBip link add type bond help\fR
را اجرا کنید\&.
.RE
.SH "گزینه‌های اتصالات ‘BRIDGE’ (OPTIONS FOR ‘BRIDGE’ CONNECTIONS)"
.sp
رابط‌های مشخص‌شده در \fIBindsToInterfaces=\fR در پلی با نام \fIInterface=\fR شرکت می‌کنند\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqbridge\(cq شناخته شده‌اند:
.PP
\fISkipForwardingDelay=\fR
.RS 4
صرف‌نظر کردن از (R)STP و فعال‌سازی فوری تمام اعضای پل\&. این گزینه زمانی که DHCP روی پل استفاده می‌شود می‌تواند مفید باشد\&.
.RE
.PP
\fILinkOptions=\fR
.RS 4
گزینه‌های اضافی برای ارسال به
\fBip link\fR\&.
برای مشاهده گزینه‌های موجود، دستور
\fBip link add type bridge help\fR
را اجرا کنید\&.
.RE
.SH "گزینه‌های اتصالات ‘DUMMY’ (OPTIONS FOR ‘DUMMY’ CONNECTIONS)"
.sp
نام رابط ساختگی در \fIInterface=\fR مشخص می‌شود\&. برای اتصالات از نوع \(oqdummy\(cq فقط \fBگزینه‌های آی‌پی\fR شناخته شده‌اند\&.
.SH "گزینه‌های اتصالات ‘PPP’ (OPTIONS FOR ‘PPP’ CONNECTIONS)"
.sp
این نوع اتصال با نوع \(oqpppoe\(cq در زیر یکسان است، با این تفاوت که رابط اترنت در \fIBindsToInterfaces=\fR مشخص می‌شود\&. مقدار \fIInterface=\fR باید به صورت \(oqppp<n>\(cq باشد که در آن n به \fIPPPUnit=\fR منتقل می‌شود\&.
.SH "گزینه‌های اتصالات ‘PPPOE’ (OPTIONS FOR ‘PPPOE’ CONNECTIONS)"
.sp
رابط برای برقراری اتصال نقطه به نقطه روی اترنت (PPPoE) در \fIInterface=\fR مشخص می‌شود\&. گزینه‌های زیر برای اتصالات از نوع \(oqpppoe\(cq شناخته شده‌اند:
.PP
\fIUser=\fR و \fIPassword=\fR
.RS 4
نام کاربری و گذرواژه برای برقراری اتصال\&.
.RE
.PP
\fIConnectionMode=\fR
.RS 4
یکی از مقادیر \(oqpersist\(cq یا \(oqdemand\(cq، بسته به نحوه برقراری اتصال\&. پیش‌فرض \(oqpersist\(cq است\&.
.RE
.PP
\fIIdleTimeout=\fR [نیازمند \fIConnectionMode=demand\fR]
.RS 4
مدت زمان بیکاری (به ثانیه) که پس از آن دیمن PPP باید اتصال را قطع کند\&.
.RE
.PP
\fIMaxFail=\fR
.RS 4
تعداد تلاش‌های ناموفق متوالی برای اتصال که مجاز است\&. مقدار 0 به معنای نامحدود است\&. پیش‌فرض \(oq5\(cq است\&.
.RE
.PP
\fIDefaultRoute=\fR
.RS 4
آیا از مسیر پیش‌فرض ارائه‌شده توسط همتا (peer) استفاده شود یا خیر\&. پیش‌فرض \(oqyes\(cq است\&.
.RE
.PP
\fIUsePeerDNS=\fR
.RS 4
آیا از کارگزارهای DNS ارائه‌شده توسط همتا استفاده شود یا خیر\&. پیش‌فرض \(oqyes\(cq است\&.
.RE
.PP
\fIPPPUnit=\fR
.RS 4
شماره واحد PPP در نام رابط (\(oqppp0\(cq، \(oqppp1\(cq، غیره)\&.
.RE
.PP
\fILCPEchoInterval=\fR و \fILCPEchoFailure=\fR
.RS 4
این گزینه‌ها پارامترهای پیش‌فرض LCP را از \(oq/etc/ppp/options\(cq بازنویسی می‌کنند\&.
.RE
.PP
\fIOptionsFile=\fR
.RS 4
فایلی برای خواندن گزینه‌های اضافی
\fBpppd\fR(8)\&.
.RE
.sp
گزینه‌های پیشرفته زیر نیز شناخته شده‌اند:
.PP
\fIPPPoEService=\fR
.RS 4
نام سرویس PPPoE\&.
.RE
.PP
\fIPPPoEAC=\fR
.RS 4
نام متمرکزکننده دسترسی (Access Concentrator) در PPPoE\&.
.RE
.PP
\fIPPPoESession=\fR
.RS 4
یک نشست موجود برای اتصال به آن\&. این گزینه به صورت \(oqsessid:macaddr\(cq است\&.
.RE
.PP
\fIPPPoEMAC=\fR
.RS 4
یک آدرس MAC برای محدود کردن اتصال به آن\&.
.RE
.PP
\fIPPPoEIP6=\fR
.RS 4
آیا پروتکل‌های IPv6CP و IPv6 فعال شوند یا خیر\&. وقتی روی \(oqno\(cq تنظیم شود، مذاکره IPv6CP و ارتباط IPv6 به صراحت غیرفعال می‌شود\&.
.RE
.SH "گزینه‌های اتصالات ‘MOBILE_PPP’ (OPTIONS FOR ‘MOBILE_PPP’ CONNECTIONS)"
.sp
نام دستگاه سریال USB در \fIInterface=\fR مشخص می‌شود\&. گزینه‌های زیر برای اتصالات از نوع \(oqmobile_ppp\(cq شناخته شده‌اند:
.PP
\fIUser=\fR و \fIPassword=\fR
.RS 4
نام کاربری و گذرواژه برای برقراری اتصال\&. این‌ها به طور پیش‌فرض تنظیم نشده‌اند، زیرا اغلب مورد نیاز نیستند\&.
.RE
.PP
\fIAccessPointName=\fR
.RS 4
نام نقطه دسترسی (APN) برای ارائه به ارائه‌دهنده خدمات\&. این مورد مختص به ISP شما است\&.
.RE
.PP
\fIPin=\fR
.RS 4
اگر مودم شما برای باز شدن به PIN نیاز دارد، آن را اینجا تنظیم کنید\&.
.RE
.PP
\fIPhoneNumber\fR
.RS 4
شماره‌ای که باید گرفته شود\&. پیش‌فرض \(oq*99#\(cq است\&.
.RE
.PP
\fIMode=\fR
.RS 4
حالت اتصال\&. می‌تواند یکی از موارد \(oq3Gpref\(cq، \(oq3Gonly\(cq، \(oqGPRSpref\(cq، \(oqGPRSonly\(cq، \(oqNone\(cq، یا یک خط سفارشی
AT^SYSCFG=\&...
باشد که به صورت \(oqSYSCFG=\&...\(cq مشخص می‌شود\&. این گزینه دستورات
AT
مخصوص به برخی مودم‌های Huawei را تولید می‌کند؛ تمام دستگاه‌های دیگر باید این گزینه را خالی بگذارند یا روی \(oqNone\(cq تنظیم کنند\&.
.RE
.PP
\fIInit=\fR
.RS 4
رشته مقداردهی اولیه که قبل از شماره‌گیری به مودم ارسال می‌شود\&. این رشته پس از ارسال \(lqATZ\(rq ارسال می‌شود\&. مقدار پیش‌فرض \(oqATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0\(cq است\&.
.RE
.PP
\fIChatScript=\fR
.RS 4
مسیر به یک فایل chat\&. در صورت مشخص شدن، هیچ اسکریپت chat تولید نخواهد شد و تمام گزینه‌های بالا به جز
\fIUser=\fR
و
\fIPassword=\fR
نادیده گرفته می‌شوند\&.
.RE
.PP
\fIMaxFail=\fR
.RS 4
تعداد تلاش‌های ناموفق متوالی برای اتصال که مجاز است\&. مقدار 0 به معنای نامحدود است\&. پیش‌فرض \(oq5\(cq است\&.
.RE
.PP
\fIDefaultRoute=\fR
.RS 4
آیا از مسیر پیش‌فرض ارائه‌شده توسط همتا (peer) استفاده شود یا خیر\&. پیش‌فرض \(oqyes\(cq است\&.
.RE
.PP
\fIUsePeerDNS=\fR
.RS 4
آیا از کارگزارهای DNS ارائه‌شده توسط همتا استفاده شود یا خیر\&. پیش‌فرض \(oqyes\(cq است\&.
.RE
.PP
\fIPPPUnit=\fR
.RS 4
شماره واحد PPP در نام رابط (\(oqppp0\(cq، \(oqppp1\(cq، غیره)\&.
.RE
.PP
\fIOptionsFile=\fR
.RS 4
فایلی برای خواندن گزینه‌های اضافی
\fBpppd\fR(8)\&.
.RE
.PP
\fIRFKill=\fR
.RS 4
نام یک دستگاه
\fBrfkill\fR\&.
در صورت مشخص شدن، این دستگاه برای مسدود/باز کردن رابط در زمان مناسب استفاده می‌شود\&. نام‌ها را می‌توان در
\fI/sys/class/rfkill/rfkillX/name\fR
یافت\&.
.RE
.SH "گزینه‌های اتصالات ‘OPENVSWITCH’ (OPTIONS FOR ‘OPENVSWITCH’ CONNECTIONS)"
.sp
رابط‌های مشخص‌شده در \fIBindsToInterfaces=\fR در پلی با نام \fIInterface=\fR شرکت می‌کنند\&. برای اتصالات از نوع \(oqopenvswitch\(cq فقط \fBگزینه‌های آی‌پی\fR شناخته شده‌اند\&.
.SH "گزینه‌های اتصالات ‘TUNNEL’ (OPTIONS FOR ‘TUNNEL’ CONNECTIONS)"
.sp
نام رابط تونل در \fIInterface=\fR مشخص می‌شود\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqtunnel\(cq شناخته شده‌اند:
.PP
\fIMode=\fR
.RS 4
نوع تونل (مثلاً \(oqsit\(cq)\&. برای حالت‌های موجود به
\fBip\-tunnel\fR(8)
مراجعه کنید\&.
.RE
.PP
\fILocal=\fR
.RS 4
آدرس انتهای محلی تونل\&.
.RE
.PP
\fIRemote=\fR
.RS 4
آدرس انتهای راه دور تونل\&.
.RE
.PP
\fIKey=\fR [نیازمند \fIMode=gre\fR]
.RS 4
کلیدی که یک جریان ترافیک خاص را درون یک تونل شناسایی می‌کند\&.
.RE
.SH "گزینه‌های اتصالات ‘TUNTAP’ (OPTIONS FOR ‘TUNTAP’ CONNECTIONS)"
.sp
نام رابط tuntap در \fIInterface=\fR مشخص می‌شود\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqtuntap\(cq شناخته شده‌اند:
.PP
\fIMode=\fR
.RS 4
یکی از مقادیر \(oqtun\(cq یا \(oqtap\(cq\&.
.RE
.PP
\fIUser=\fR
.RS 4
کاربر مالک رابط tun/tap\&.
.RE
.PP
\fIGroup=\fR
.RS 4
گروه مالک رابط tun/tap\&.
.RE
.SH "گزینه‌های اتصالات ‘VLAN’ (OPTIONS FOR ‘VLAN’ CONNECTIONS)"
.sp
نام رابط vlan در \fIInterface=\fR مشخص می‌شود\&. رابط فیزیکی زیربنایی در \fIBindsToInterfaces=\fR مشخص می‌گردد\&. بنابراین، برای پروفایل‌های vlan، متغیر \fIBindsToInterfaces=\fR شامل نام یک رابط شبکه واحد است\&.
.sp
تمام گزینه‌های اتصالات از نوع \(oqethernet\(cq برای اتصالات از نوع \(oqvlan\(cq نیز شناخته شده‌اند\&. علاوه بر این، اتصالات از نوع \(oqvlan\(cq باید یک شناسه vlan را با استفاده از \fIVLANID=\fR تعیین کنند\&. برای جزئیات به \fBip\fR(8) مراجعه کنید\&.
.SH "گزینه‌های اتصالات ‘MACVLAN’ (OPTIONS FOR ‘MACVLAN’ CONNECTIONS)"
.sp
نام رابط macvlan در \fIInterface=\fR مشخص می‌شود\&. رابط فیزیکی زیربنایی در \fIBindsToInterfaces=\fR مشخص می‌گردد\&. بنابراین، برای پروفایل‌های macvlan، متغیر \fIBindsToInterfaces=\fR شامل نام یک رابط شبکه واحد است\&.
.sp
تمام گزینه‌های اتصالات از نوع \(oqethernet\(cq برای اتصالات از نوع \(oqmacvlan\(cq نیز شناخته شده‌اند\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqmacvlan\(cq شناخته شده‌اند:
.PP
\fIMode=\fR
.RS 4
یکی از مقادیر \(oqbridge\(cq، \(oqvepa\(cq، \(oqprivate\(cq یا \(oqpassthru\(cq\&. برای جزئیات به
\fBip\fR(8)
مراجعه کنید\&.
.RE
.SH "گزینه‌های اتصالات ‘WIREGUARD’ (OPTIONS FOR ‘WIREGUARD’ CONNECTIONS)"
.sp
نام رابط WireGuard در \fIInterface=\fR مشخص می‌شود\&. علاوه بر \fBگزینه‌های آی‌پی\fR، موارد زیر برای اتصالات از نوع \(oqwireguard\(cq شناخته شده‌اند:
.PP
\fIWGConfigFile=\fR
.RS 4
مسیر فایل پیکربندی
\fBWireGuard\fR\&.
پیش‌فرض
\fI/etc/wireguard/$Interface\&.conf\fR
است\&.
.RE
.SH "قواعد نقل‌قول ویژه (SPECIAL QUOTING RULES)"
.sp
فایل‌های پیکربندی \fBwpa_supplicant\fR از قواعد نقل‌قول (کوتیشن) غیرمعمول استفاده می‌کنند\&. بنابراین، قواعد نقل‌قول غیرمعمولی برای برخی متغیرها در اتصالات از نوع \(oqwireless\(cq وجود دارد\&. به‌ویژه، این متغیرها شامل \fIESSID=\fR و \fIKey=\fR هستند\&.
.sp
یک متغیر توسط \fBwpa_supplicant\fR در صورتی \fBنقل‌قول‌شده (quoted)\fR در نظر گرفته می‌شود که در جفت‌گیومه (") محصور شده باشد\&. متغیری توسط \fBwpa_supplicant\fR به صورت \fBبدون‌نقل‌قول (non\-quoted)\fR در نظر گرفته می‌شود که با جفت‌گیومه شروع نشود\&. مقادیر هگزادسیمال در فایل‌های پیکربندی \fBwpa_supplicant\fR به صورت \fBبدون‌نقل‌قول\fR مشخص می‌شوند\&. در \fBnetctl\fR، متغیرها به صورت پیش‌فرض به شکل \fBنقل‌قول‌شده\fR در فایل‌های پیکربندی \fBwpa_supplicant\fR نوشته می‌شوند\&. هنگامی که قواعد نقل‌قول ویژه اعمال می‌شوند، می‌توان با استفاده از یک نحو خاص یک مقدار بدون نقل‌قول (هگزادسیمال) را مشخص کرد\&.
.sp
قواعد نقل‌قول ویژه \fBnetctl\fR به شرح زیر است: رشته‌ای که با یک گیومه دوگانه صریح شروع شود، \fBبدون‌نقل‌قول\fR در نظر گرفته می‌شود\&. هر رشته دیگری \fBنقل‌قول‌شده\fR در نظر گرفته می‌شود\&. می‌توان رشته‌های نقل‌قول‌شده‌ای که با گیومه دوگانه شروع می‌شوند را با نقل‌قول دستی مشخص کرد\&. یک مثال مفرط، تعیین یک گیومه دوگانه \fBنقل‌قول‌شده\fR است: \fIX=\*(Aq""""\*(Aq\fR\&. در سوی دیگر طیف، بک‌اسلش \fBبدون‌نقل‌قول\fR قرار دارد: \fIX=\e"\e\e\fR\&.
.sp
مثال‌های بیشتر از رشته‌های \fBنقل‌قول‌شده (quoted)\fR (همگی معادل هستند):
.sp
.if n \{\
.RS 4
.\}
.nf
X=string
X="string"
X=\*(Aq""string"\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
مثال‌های بیشتر از رشته‌های \fBبدون‌نقل‌قول (non\-quoted)\fR (همگی معادل هستند):
.sp
.if n \{\
.RS 4
.\}
.nf
X=\e"string
X="\e"string"
X=\*(Aq"string\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
یک شیوه برای به خاطر سپردن این است که پیشوند \(oq\e"\(cq را معادل «بدون»\-«نقل‌قول» (non-quote) در نظر بگیرید\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnetctl\fR(1), \fBresolvconf\&.conf\fR(5)