.\" connman-service.config(5) manual page
.\"
.\" Copyright (C) 2015 Intel Corporation
.\"
.TH "service\-name.config" "5" "2015-10-15" ""
.SH "نام (NAME)"
service\-name.config \- پرونده تدارک سرویس ConnMan
.SH "خلاصه دستور (SYNOPSIS)"
.B /var/lib/connman/\fIservice\-name\fB.config
.SH "توضیحات (DESCRIPTION)"
.P
سرویس‌های \fIConnMan\fP با پرونده‌هایی موسوم به
«\fBپرونده‌های تدارک\fP» (provisioning files) که در مسیر \fI/var/lib/connman/\fP قرار دارند، پیکربندی می‌شوند.
نام‌گذاری این فایل‌ها می‌تواند هر چیزی باشد، به شرط آنکه به پسوند \fB.config\fP ختم شوند.
از پرونده‌های تدارک می‌توان برای پیکربندی نقاط دسترسی بی‌سیم امن که به احراز هویت پیچیده نیاز دارند (مانند eduroam)، یا برای نشانی‌های IP ایستا و موارد دیگر استفاده کرد. هر پرونده تدارک می‌تواند به طور همزمان برای چندین سرویس استفاده شود.
.SH "قالب فایل (FILE FORMAT)"
.P
فایل پیکربندی از بخش‌ها (گروه‌ها)یی متشکل از جفت‌های کلید\-مقدار تشکیل شده است.
خطوطی که با «#» آغاز می‌شوند و خطوط خالی به عنوان یادداشت (کامنت) در نظر گرفته می‌شوند.
بخش‌ها با یک خط عنوان شامل نام بخش درون «[» و «]» آغاز می‌شوند و به صورت ضمنی با شروع بخش بعدی یا پایان فایل خاتمه می‌یابند. هر جفت کلید\-مقدار باید درون یک بخش قرار گیرد.
.P
توضیحات بخش‌ها و کلیدهای دردسترس در ادامه آمده است:
.SS [global]
این بخش اختیاری است و می‌تواند برای توصیف خود فایل به کار رود. دو فیلد مجاز برای این بخش عبارتند از:
.TP
.BI Name= name
نام شبکه.
.TP
.BI Description= description
توضیحات شبکه.
.SS [service_*]
هر سرویس تدارک‌دیده‌شده باید با برچسب [service_*] آغاز شود که در آن * با یک نام یکتا در درون فایل جایگزین می‌شود.
فیلدهای مجاز عبارتند از:
.TP
.B Type=ethernet \fR|\fB wifi
اجباری. انواعی غیر از ethernet یا wifi پشتیبانی نمی‌شوند.
.TP
.BI IPv4=off \ \fR|\  dhcp\ \fR|\  network / netmask / gateway
تنظیمات IPv4 برای سرویس. اگر روی \fBoff\fP تنظیم شود، از IPv4 استفاده نخواهد شد.
اگر روی \fBdhcp\fP تنظیم شود، از dhcp برای دریافت تنظیمات شبکه استفاده می‌شود.
\fInetmask\fP را می‌توان به جای خود ماسک، به عنوان طول ماسک مشخص کرد. هنگام استفاده از IP ایستا، می‌توان از تعیین درگاه (gateway) صرف‌نظر کرد.
.TP
.BI IPv6=off \ \fR|\  auto\ \fR|\  network / prefixlength / gateway
تنظیمات IPv6 برای سرویس. اگر روی \fBoff\fP تنظیم شود، از IPv6 استفاده نخواهد شد.
اگر روی \fBauto\fP تنظیم شود، تنظیمات از شبکه دریافت خواهند شد.
.TP
.B IPv6.Privacy=disabled \fR|\fB enabled \fR|\fB preferred
تنظیمات حریم خصوصی IPv6 مطابق با استاندارد RFC3041.
.TP
.BI MAC= address
نشانی MAC رابط مورد استفاده. اگر مشخص نشود، نخستین رابط یافت‌شده استفاده خواهد شد. باید در قالب ab:cd:ef:01:23:45 باشد.
.TP
.BI DeviceName= ifname
نام دستگاه رابط مورد استفاده، مانند eth0. نشانی MAC نسبت به DeviceName اولویت دارد.
.TP
.BI Nameservers= servers
فهرستی از کارسازهای نام (DNS) که با کاما از هم جدا شده‌اند.
.TP
.BI SearchDomains= domains
فهرستی از دامنه‌های جستجوی DNS که با کاما از هم جدا شده‌اند.
.TP
.BI Timeservers= servers
فهرستی از کارسازهای زمان (NTP) که با کاما از هم جدا شده‌اند.
.TP
.BI Domain= domain
نام دامنه مورد استفاده.
.TP
کلیدهای زیر تنها برای شبکه‌های بی‌سیم قابل استفاده هستند:
.TP
.BI Name= name
نمایش رشته‌ای از SSID شبکه. اگر فیلد SSID وجود داشته باشد، مقدار فیلد Name نادیده گرفته می‌شود. در صورت عدم وجود فیلد SSID، این فیلد اجباری است.
.TP
.BI SSID= ssid
شناسه SSID: نمایش هگزادسیمال از یک 802.11 SSID. از این قالب برای کدگذاری نویسه‌های ویژه شامل فاصله‌های ابتدا یا انتها استفاده کنید.
.TP
.BI Passphrase= passphrase
عبارت عبور RSN/WPA/WPA2.
.TP
.BI Security= type
نوع امنیت شبکه. مقادیر ممکن عبارتند از: \fBpsk\fP (برای WPA/WPA2 PSK)، \fBieee8021x\fP (برای WPA EAP)، \fBnone\fP و \fBwep\fP.
در صورت عدم تنظیم، اگر یک نوع EAP پیکربندی شده باشد مقدار پیش‌فرض \fBieee8021x\fP خواهد بود، اگر عبارت عبور وجود داشته باشد مقدار \fBpsk\fP خواهد بود و در غیر این صورت \fBnone\fP در نظر گرفته می‌شود.
.TP
.B Hidden=true \fR|\fB false
اگر روی \fBtrue\fP تنظیم شود، این نقطه دسترسی (AP) مخفی است. در صورت عدم درج یا اگر روی \fBfalse\fP تنظیم گردد، نقطه دسترسی مخفی نخواهد بود.
.TP
کلیدهای زیر برای WPA EAP (زمانی که \fBSecurity=ieee8021x\fP باشد) استفاده می‌شوند:
.TP
.B EAP=tls \fR|\fB ttls \fR|\fB peap
نوع EAP مورد استفاده. تنها مقادیر \fBtls\fP، \fBttls\fP و \fBpeap\fP پشتیبانی می‌شوند.
.TP
.BI CACertFile= file
مسیر فایل گواهی مرجع صدور گواهی (CA). تنها قالب‌های PEM و DER پشتیبانی می‌شوند.
.TP
.BI PrivateKeyFile= file
مسیر فایل کلید خصوصی. تنها قالب‌های PEM، DER و PFX پشتیبانی می‌شوند.
.TP
.BI PrivateKeyPassphrase= passphrase
عبارت عبور کلید خصوصی.
.TP
.B PrivateKeyPassphraseType=fsid
در صورت تعیین، از fsid کلید خصوصی به عنوان عبارت عبور استفاده می‌شود و مقدار فیلد PrivateKeyPassphrase نادیده گرفته خواهد شد.
.TP
.BI Identity= identity
رشته شناسه (هویت) برای EAP.
.TP
.BI AnonymousIdentity= identity
رشته شناسه ناشناس برای EAP.
.TP
.BI SubjectMatch= substring
زیررشته‌ای که باید با موضوع (subject) گواهی کارساز احراز هویت برای EAP مطابقت داده شود.
.TP
.BI AltSubjectMatch= substring
رشته‌ای از مقادیر جداشده با نقطه‌ویرگول که باید با نام موضوع جایگزین (alternative subject name) گواهی کارساز احراز هویت برای EAP مطابقت داشته باشد.
.TP
.BI DomainSuffixMatch= domain
محدودیت برای نام دامنه کارساز. در صورت تنظیم، این FQDN به عنوان شرط تطابق پسوند برای گواهی کارساز احراز هویت EAP استفاده می‌شود.
.TP
.BI DomainMatch= domain
این FQDN به عنوان شرط تطابق کامل برای گواهی کارساز احراز هویت EAP استفاده می‌شود.
.TP
.BI Phase2= type
نوع احراز هویت درونی برای \fBEAP=tls\fP یا \fBEAP=ttls\fP. پیشوند \fBEAP\-\fP را قبل از مقدار قرار دهید تا استفاده از روش احراز هویت مبتنی بر EAP مشخص شود (تنها باید با \fBEAP=ttls\fP به کار رود).
.SH "مثال‌ها (EXAMPLES)"
.SS Eduroam
این یک فایل پیکربندی برای شبکه‌های eduroam است. این فایل می‌تواند به عنوان نمونه در مسیر /var/lib/connman/eduroam.config قرار گیرد. تنظیمات دقیق دانشگاه شما ممکن است متفاوت باشد.
.PP
.nf
[service_eduroam]
Type = wifi
Name = eduroam
EAP = peap
Phase2 = MSCHAPV2
CACertFile = /etc/ssl/certs/UNIV_CA.crt
.fi
.SS "شبکه‌بندی پیچیده (Complex networking)"
این یک فایل پیکربندی برای شبکه‌ای است که سرویس‌های EAP-TLS، EAP-TTLS و EAP-PEAP را فراهم می‌کند. شناسه‌های SSID مربوطه به ترتیب tls_ssid، ttls_ssid و peap_ssid هستند و نام فایل می‌تواند /var/lib/connman/complex.config باشد.
.PP
لطفاً توجه داشته باشید که مدخل SSID برای SSID با کدگذاری هگزادسیمال است (مانند «"SSID = 746c735f73736964"»). اگر شناسه SSID شما نویسه نامتعارفی ندارد، باید به جای آن از مدخل Name استفاده کنید (مانند «"Name = tls_ssid"»).
.PP
.nf
[global]
Name = Example
Description = Example network configuration

[service_tls]
Type = wifi
SSID = 746c735f73736964
EAP = tls
CACertFile = /home/user/.certs/ca.pem
ClientCertFile = /home/user/devlp/.certs/client.pem
PrivateKeyFile = /home/user/.certs/client.fsid.pem
PrivateKeyPassphraseType = fsid
Identity = user

[service_ttls]
Type = wifi
Name = ttls_ssid
EAP = ttls
CACertFile = /home/user/.cert/ca.pem
Phase2 = MSCHAPV2
Identity = user

[service_peap]
Type = wifi
Name = peap_ssid
EAP = peap
CACertFile = /home/user/.cert/ca.pem
Phase2 = MSCHAPV2
Identity = user

[service_home_ethernet]
Type = ethernet
IPv4 = 192.168.1.42/255.255.255.0/192.168.1.1
IPv6 = 2001:db8::42/64/2001:db8::1
MAC = 01:02:03:04:05:06
Nameservers = 10.2.3.4,192.168.1.99
SearchDomains = my.home,isp.net
Timeservers = 10.172.2.1,ntp.my.isp.net
Domain = my.home

[service_home_wifi]
Type = wifi
Name = my_home_wifi
Passphrase = password
IPv4 = 192.168.2.2/255.255.255.0/192.168.2.1
MAC = 06:05:04:03:02:01

[service_vlan]
Type = ethernet
DeviceName = enp4s0.1
IPv4 = 192.168.1.42/255.255.255.0/192.168.1.1
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR connman (8)