'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "iwd.ap" "5" "20 October 2020" "iwd" "Linux Connectivity"
.SH "نام (NAME)"
iwd.ap \- پیکربندی نقطه دسترسی برای iwd
.SH "خلاصه (SYNOPSIS)"
.sp
توصیف فایل‌های پیکربندی نقطه دسترسی (access point).
.SH "توضیحات (DESCRIPTION)"
.sp
یک فایل پیکربندی نقطه دسترسی، تنظیمات نقطه دسترسی IWD را تعیین می‌کند. این فایل‌ها در
\fI$STATE_DIRECTORY\fP/ap
(به‌طور پیش‌فرض در /var/lib/iwd/ap) قرار دارند.
آن‌ها هنگام فراخوانی متد D-Bus
\fInet.connman.iwd.AccessPoint.StartProfile(ssid)\fP
خوانده می‌شوند.
.SH "قالب فایل (FILE FORMAT)"
.sp
برای جزئیات بیشتر درباره نحو و ساختار فایل تنظیمات، به \fIiwd.network\fP مراجعه کنید.
.SH "تنظیمات (SETTINGS)"
.sp
تنظیمات به چندین دسته‌بندی تقسیم شده‌اند. هر دسته‌بندی یک گروه مرتبط با خود دارد و در جدول متناظر در زیر شرح داده شده است.
.SS "تنظیمات عمومی (General Settings)"
.sp
گروه \fB[General]\fP شامل پیکربندی عمومی نقطه دسترسی (AP) است.
.TS
box center;
l|l.
T{
Channel
T}	T{
شماره کانال
.sp
شماره کانال اختیاری برای فعالیت نقطه دسترسی. در صورت عدم ذکر، کانال به‌طور خودکار انتخاب خواهد شد. کانال‌های بزرگ‌تر یا مساوی ۳۶، باند 5GHz را برای فعالیت نقطه دسترسی انتخاب می‌کنند.
.sp
نکته: با توجه به الزامات مقرراتی، هسته لینوکس استفاده از 5GHz را در حالت AP هنگام رومینگ جهانی (world roaming) مجاز ندانسته یا به‌شدت محدود می‌کند. این فرکانس‌ها زمانی در دسترس قرار می‌گیرند که کشور تنظیم شود، چه از طریق گزینه
\fB[General].Country\fP
در فایل main.conf مربوط به IWD (به \fBman iwd.config\fP مراجعه کنید) یا به‌صورت خارجی (مانند iw reg set <CC>). اگر در استفاده از 5GHz با مشکل مواجه شدید، مطمئن شوید که کشور تنظیم شده و فرکانس/کانال مورد نظر بدون محدودیت است.
T}
_
T{
RekeyTimeout
T}	T{
مهلت زمانی برای کلیدگذاری مجدد PTK (به ثانیه)
.sp
بازه زمانی که در آن AP کلیدگذاری مجدد را برای یک ایستگاه (station) مشخص آغاز می‌کند. در صورت عدم ارائه، مقدار پیش‌فرض 0 استفاده می‌شود (کلیدگذاری مجدد غیرفعال است).
T}
_
T{
DisableHT
T}	T{
مقدار بولی (Boolean)
.sp
به‌طور صریح قابلیت‌های HT را برای این AP غیرفعال می‌کند.
T}
.TE
.SS "تنظیمات احراز هویت شبکه (Network Authentication Settings)"
.sp
گروه \fB[Security]\fP شامل تنظیمات امنیت و پیکربندی احراز هویت Wi\-Fi است.
.TS
box center;
l|l.
T{
Passphrase
T}	T{
رشته‌ای با طول ۸ تا ۶۳ نویسه
.sp
عبارت عبور WPA\-PSK که با این نقطه دسترسی استفاده می‌شود. حداقل یکی از موارد
\fIPassphrase\fP
یا
\fIPreSharedKey\fP
باید وجود داشته باشد.
T}
_
T{
PreSharedKey
T}	T{
رشته هگزادسیمال ۶۴ نویسه‌ای
.sp
عبارت عبور پردازش‌شده برای این شبکه در قالب یک کلید اشتراکی (pre-shared key) هگزادسیمال ۳۲ بایتی. باید این مورد یا
\fIPassphrase\fP
حضور داشته باشد.
T}
_
T{
PairwiseCiphers
T}	T{
فهرست جداشده با کاما از رمزهای زوجی (pairwise ciphers) که AP پشتیبانی می‌کند.
.sp
مقادیر می‌توانند شامل موارد زیر باشند: TKIP، CCMP، GCMP، GCMP\-256، CCMP\-256
.sp
سخت‌افزار زیرین و پیاده‌سازی AP در IWD نیز باید از رمزهای فهرست‌شده پشتیبانی کنند
T}
_
T{
GroupCipher
T}	T{
رمز گروهی (Group cipher) مورد استفاده AP
.sp
یک مقدار رمزگذاری واحد که AP می‌تواند به‌عنوان رمز گروهی استفاده کند. مقادیر مشابه با رمزهای زوجی هستند و همان محدودیت‌ها اعمال می‌شوند (سخت‌افزار و پیاده‌سازی IWD باید از این رمز پشتیبانی کنند)
T}
.TE
.SS "پیکربندی شبکه IPv4 (IPv4 Network Configuration)"
.sp
گروه \fB[IPv4]\fP شامل تنظیمات کارساز داخلی DHCP در IWD است. تمامی تنظیمات اختیاری هستند. این تنظیمات در صورتی استفاده می‌شوند که پیکربندی شبکه مطابق شرح داده شده در
\fBiwd.config(5)\fP
فعال شده باشد. حذف گروه
\fB[IPv4]\fP
پیکربندی شبکه را برای این نقطه دسترسی غیرفعال می‌کند، بنابراین اگر راه‌اندازی تماماً پیش‌فرض DHCP مد نظر باشد، خط عنوان گروه همچنان باید وجود داشته باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Enable network configuration
[IPv4]

[other groups follow]
.EE
.UNINDENT
.UNINDENT
.TS
box center;
l|l.
T{
Address
T}	T{
نشانی IP محلی یا فهرستی جداشده با کاما از نشانی‌ها با نشانه‌گذاری پیشوند (prefix-notation)
.sp
استخر نشانی‌های محلی اختیاری برای نقطه دسترسی و کارساز DHCP. اگر یک نشانی واحد ارائه شود، این نشانی روی رابط AP تنظیم خواهد شد و سایر گزینه‌های کارساز DHCP در صورت عدم بازنویسی توسط سایر تنظیمات زیر، از آن مشتق می‌شوند.
.sp
اگر فهرستی از نشانی‌ها و طول پیشوند مشخص شود (در قالب
\fI<IP>/<prefix\-len>\fP)،
هر بار که این نمایه اجرا می‌شود، یک نشانی زیرشبکه واحد از فضای موجود انتخاب خواهد شد. اندازه زیرشبکه بر اساس تنظیم
\fB[IPv4].Netmask\fP
تعیین می‌شود.
.sp
اگر \fIAddress\fP ارائه نشود و هیچ نشانی IP پیش از فراخوانی \fIStartProfile\fP روی رابط تنظیم نشده باشد، مقدار تنظیم
\fB[IPv4].APAddressPool\fP
در main.conf به ارث برده می‌شود که به نوبه خود پیش‌فرض 192.168.0.0/16 دارد.
.sp
برای مثال، اگر \fB[IPv4].Netmask\fP روی 255.255.255.0 تنظیم شود و این تنظیم، یا مقدار پیش‌فرض عمومی \fIAPAddressPool\fP، روی
\fB192.168.0.0/16, 10.0.0.0/22\fP
تنظیم گردد، IWD یکی از ۲۵۶ زیرشبکه با نشانی‌ها در محدوده 192.168.<0\-255>.0/24 یا یکی از ۴ زیرشبکه با نشانی‌ها در محدوده 10.0.<0\-3>.0/24 را انتخاب می‌کند که امکان ۲۷۰ زیرشبکه احتمالی را فراهم می‌سازد. تعریف یک استخر نشانی بزرگ‌تر از زیرشبکه مورد نظر به IWD این شانس را می‌دهد تا از تداخل در صورتی که سایر رابط‌های سیستم از نشانی‌های اختصاص‌یافته پویا استفاده کنند، جلوگیری نماید.
T}
_
T{
Gateway
T}	T{
نشانی IP دروازه (gateway)
.sp
نشانی IP دروازه که باید توسط DHCP اعلان شود. در صورت عدم ارائه، به نشانی IP محلی بازمی‌گردد.
T}
_
T{
Netmask
T}	T{
ماسک زیرشبکه محلی نقطه دسترسی (AP)
.sp
در صورت عدم ارائه، پیش‌فرض روی ماسک زیرشبکه ۲۸ بیتی قرار می‌گیرد.
T}
_
T{
DNSList
T}	T{
فهرست کارسازهای DNS به‌صورت نشانی‌های IP جداشده با کاما
.sp
فهرستی از کارسازهای DNS که توسط کارساز DHCP اعلان خواهند شد. در صورت عدم ارائه، هیچ کارساز DNS توسط کارساز DHCP ارسال نخواهد شد.
T}
_
T{
LeaseTime
T}	T{
محدودیت زمانی اجاره‌های DHCP به ثانیه
.sp
زمان اجاره پیش‌فرض را لغو و بازنویسی می‌کند.
T}
_
T{
IPRange
T}	T{
محدوده‌ای از IPها که به‌صورت دو نشانی جداشده با کاما مشخص می‌شود
.sp
نشانی‌های مبدا و مقصد محدوده‌ای که از طریق DHCP به کلاینت‌ها اختصاص می‌یابد. در صورت عدم ارائه، محدوده از نشانی محلی + ۱ تا ‎.254 استفاده خواهد شد.
T}
.TE
.SS "پیکربندی ساده وای‌فای (Wi\-Fi Simple Configuration)"
.sp
گروه \fB[WSC]\fP برخی پارامترهای محلی پیکربندی ساده Wi\-Fi (که قبلاً با نام WPS یا Wi\-Fi Protected Setup شناخته می‌شد) را تنظیم دقیق می‌کند.
.TS
box center;
l|l.
T{
DeviceName
T}	T{
رشته ۱ تا ۳۲ نویسه‌ای
.sp
نام اختیاری دستگاه (Device Name) که AP برای آن اعلان انجام می‌دهد. پیش‌فرض روی SSID است.
T}
_
T{
PrimaryDeviceType
T}	T{
رشته زیردسته یا یک عدد صحیح ۶۴ بیتی
.sp
نوع اصلی دستگاه اختیاری که AP برای آن اعلان انجام می‌دهد. پیش‌فرض روی رایانه PC است. می‌تواند به‌صورت یک رشته زیردسته حروف کوچک WSC v2.0.5 یا یک کدگذاری عدد صحیح ۶۴ بیتی مشخص شود، از باارزش‌ترین بیت (MSB) به کم‌ارزش‌ترین بیت (LSB): شناسه دسته ۱۶ بیتی، OUI ۲۴ بیتی، نوع OUI ۸ بیتی و شناسه زیردسته ۱۶ بیتی.
T}
_
T{
AuthorizedMACs
T}	T{
فهرستی از نشانی‌های MAC جداشده با کاما
.sp
فهرست اختیاری از نشانی‌های MAC مجاز برای بررسی توسط ثبت‌کننده WSC هنگام برقراری ارتباط (association). هر نشانی در قالب نشانه‌گذاری هگزادسیمال با دونقطه (colon\-hexadecimal) مشخص می‌شود. پیش‌فرض بدون بررسی‌های مبتنی بر MAC است.
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.sp
iwd(8), iwd.network(5)
.SH "نویسندگان (AUTHORS)"
James Prestwood <prestwoj@gmail.com>
.SH "حق نشر (COPYRIGHT)"
2020 Intel Corporation
.\" End of generated man page.