.TH connmanctl 1 "2015-10-15" ""
.SH "نام (NAME)"
connmanctl \- رابط خط فرمان Connman
.SH "خلاصه دستور (SYNOPSIS)"
.BR connmanctl \ [\|\c
.BI state\fR\ |
.BI technologies\fR\ |
.BI enable \ technology\fR|offline\ |
.BI disable \ technology\fR|offline\ |
.BI tether \ technology\ \fRon|off\ |
.BI tether\fR\ wifi\ on|off\  ssid\ passphrase\ freq\fR\ |
.BR services \ [\fIservice\fR]\ |
.BI peers \ peer\fR\ |
.BI scan \ technology\fR\ |
.RI \fBconnect \ service | peer \ |
.RI \fBdisconnect \ service | peer \ |
.B config \ \fIservice\ option\ arg\fR...\ |
.BR vpnconnections \ [\fIconnection\fR]\ |
.BI help \fR\|]
.PP
.SH "توضیحات (DESCRIPTION)"
برنامه connmanctl یک رابط خط فرمان برای Connman است که می‌تواند در دو حالت اجرا شود:
ورودی دستور همگام ساده، و یک پوسته تعاملی ناهمگام.
برای اجرای یک دستور خاص، کاربر می‌تواند
.RI \fBconnmanctl\  command\  [ options ] \fR
را وارد کند، یا صرفاً \fBconnmanctl\fR را تایپ کند که در حالت دوم، یک پوسته تعاملی آغاز به کار خواهد کرد.
.PP
برنامه connmanctl می‌تواند بیشتر اتصالات شبکه را مدیریت کند. از این ابزار می‌توان برای
فعال/غیرفعال کردن هر فناوری موجود در سیستم، نمایش فهرست سرویس‌های در دسترس،
اتصال/قطع اتصال شبکه‌ها، نمایش ویژگی‌های سیستم، فناوری‌ها و هر سرویس مجزا،
و همچنین پیکربندی تمامی ویژگی‌ها استفاده کرد. این ابزار همچنین قادر است تغییرات
ویژگی‌های سرویس‌ها، فناوری‌ها و سیستم را پایش کند.
.PP
در پوسته تعاملی، می‌توان از تمامی همین دستورها استفاده کرد. این حالت استفاده سریع‌تری
را در زمان نیاز به کار گسترده‌تر با connmanctl فراهم می‌کند. علاوه بر این،
اتصال به اکسس‌پوینت‌های بی‌سیم محافظت‌شده برای بار اول نیازمند پوسته تعاملی است.
.SH "دستورها و گزینه‌ها (COMMANDS AND OPTIONS)"
.TP
.B help
منوی راهنمای خلاصه را در پایانه نمایش می‌دهد.
.PP
.TP
.B state
ویژگی‌های سیستم را نمایش می‌دهد. شامل وضعیت آنلاین (برخط) سیستم، حالت آفلاین، و حالت نشست (session).
.PP
.TP
.B technologies
فهرستی از تمام انواع فناوری‌های موجود در سیستم و ویژگی‌های آن‌ها را نمایش می‌دهد.
برای توضیحات مربوط به هر ویژگی، بخش ویژگی‌ها در Technology API را ببینید.
.PP
.TP
.BI enable \ technology
نوع فناوری داده‌شده (مانند ethernet، wifi، 3g و غیره) را فعال می‌کند.
برق فناوری را روشن می‌کند، اما متصل نمی‌شود مگر اینکه سرویسی وجود داشته باشد
که مقدار autoconnect آن روی True تنظیم شده باشد.
.PP
.TP
.BI disable \ technology
نوع فناوری داده‌شده را غیرفعال می‌کند. برق فناوری را خاموش کرده
و در صورتی که متصل باشد، اتصال آن را قطع می‌کند.
.PP
.TP
.B enable offline
حالت آفلاین را فعال می‌کند. تمام فناوری‌ها را در سراسر سیستم قطع کرده و برق آن‌ها را خاموش می‌کند،
اگرچه هر فناوری می‌تواند به‌صورت جداگانه دوباره روشن شود.
.PP
.TP
.B disable offline
حالت آفلاین را غیرفعال می‌کند. فناوری‌ها مطابق با خط‌مشی‌های فردی خود دوباره روشن می‌شوند.
.PP
.TP
.BI tether \ technology \ on \ \fR|\  off
فعال یا غیرفعال کردن اشتراک اینترنت (tethering) روی \fItechnology\fR. به‌طور پیش‌فرض امکان اشتراک اینترنت
از طریق ethernet وجود ندارد، زیرا معمولاً شبکه‌های محلی را مختل می‌کند. برای فعال‌سازی به
.BR connman.conf (5)
مراجعه کنید.
.PP
.TP
.BR tether\ wifi\ on \ |\  off \ \fIssid\ passphrase\ [freq]
فعال یا غیرفعال کردن اشتراک اینترنت بی‌سیم، و همچنین تنظیم SSID و عبارت عبور (passphrase).
.PP
.TP
.B services
فهرستی از تمام سرویس‌های در دسترس را نمایش می‌دهد. این فهرست شامل شبکه‌های wifi مجاور،
اتصالات کابلی ethernet، دستگاه‌های بلوتوث و غیره است.
وجود یک علامت ستاره در جلوی سرویس نشان‌دهنده آن است که قبلاً به این سرویس متصل شده است.
.PP
.TP
.BI services \ service
فهرستی از تمام ویژگی‌های آن سرویس را نمایش می‌دهد.
تنها مسیر سرویس (مانند wifi_6834534139723_managed_none)
به عنوان پارامتر پذیرفته می‌شود.
.PP
.TP
.BI scan \ technology
سرویس‌های جدید روی فناوری داده‌شده را پویش (اسکن) می‌کند.
.PP
.TP
.BI connect \ service
به سرویس داده‌شده متصل می‌شود. برخی سرویس‌ها برای اتصال نیازمند به‌اصطلاح
یک \fBفایل تدارک (provisioning file)\fR هستند؛ به
\fBconnman-service.config\fR(5)
مراجعه کنید.
.PP
.TP
.BI disconnect \ service
اتصال از سرویس داده‌شده را قطع می‌کند.
.PP
.TP
.BI move-before \ service\ target-service
اتصال به \fIservice\fR را نسبت به \fItarget-service\fR در اولویت قرار می‌دهد.
.PP
.TP
.BI move-after \ service\ target-service
اتصال به \fItarget-service\fR را نسبت به \fIservice\fR در اولویت قرار می‌دهد.
.PP
.TP
.BI config \ service\ option\ arg\fR...
یک ویژگی قابل‌نوشتن از سرویس داده‌شده را به مقدار(های) وارد شده پس از \fIoption\fR تنظیم می‌کند.
برای جزئیات، زیربخش \fBگزینه‌های پیکربندی (Config Options)\fR را ببینید.
.PP
.TP
.BI monitor \ target
سیگنال‌های DBus ارسال‌شده توسط Connman را شنود کرده و نمایش می‌دهد. اگر ویژگی‌ای که
در حال حاضر پایش می‌شود تغییر کند، تغییرات نشان داده خواهند شد. اگر هیچ \fItarget\fR مشخص نشده باشد،
تمام تغییرات نشان داده می‌شوند. برای خلاصه‌ای از پارامترها، زیربخش \fBگزینه‌های پایش (Monitor Options)\fR را ببینید.
.PP
.TP
.BI vpnconnections
فهرستی از تمام اتصالات vpn دردسترس را نمایش می‌دهد.
.PP
.TP
.BI vpnconnections \ connection
ویژگی‌های فعلی \fIconnection\fR را نمایش می‌دهد.
.PP
.SS "دستورهای فقط در دسترس در حالت تعاملی (Commands only available in interactive mode):"
.PP
.TP
.BR agent\ on \ |\  off
فعال یا غیرفعال کردن عامل بی‌سیم (wireless agent)، که برای وارد کردن عبارت‌های عبور
شبکه بی‌سیم استفاده می‌شود. برای نمونه‌ای از اتصال به یک اکسس‌پوینت بی‌سیم، بخش \fBمثال‌ها (EXAMPLES)\fR
این صفحه راهنما را ببینید.
.PP
.TP
.BR vpnagent\ on \ |\  off
فعال یا غیرفعال کردن عامل vpn (vpn agent)، که برای وارد کردن اطلاعات احراز هویت vpn استفاده می‌شود.
.SS "گزینه‌های پیکربندی (Config Options):"
.PP
.TP
.BR \fBautoconnect\ on \ |\  off
ویژگی اتصال خودکار (autoconnect) سرویس را تنظیم می‌کند.
.PP
.TP
.BR ipv4\ off \ |\  dhcp \ |\  manual\ \fIaddress\ netmask\ gateway
تنظیمات IPv4 را برای سرویس پیکربندی می‌کند. آرگومان
\fBoff\fR یعنی از IPv4 استفاده نخواهد شد، \fBdhcp\fR یعنی
از dhcp برای دریافت تنظیمات استفاده می‌شود و \fBmanual\fR یعنی
از آرگومان‌های داده‌شده به عنوان تنظیمات IPv4 استفاده خواهد شد.
.IR address "،\ " netmask " و " gateway
باید آدرس‌های معتبر IPv4 باشند. برای جزئیات، بخش \fBمثال‌ها (EXAMPLES)\fR
این صفحه راهنما را ببینید.
.PP
.TP
.BR ipv6\ off \ |\  auto \ |\  manual\ \fIaddress\ prefixlength\ gateway
تنظیمات IPv6 را برای سرویس پیکربندی می‌کند. آرگومان
\fBoff\fR یعنی از IPv6 استفاده نخواهد شد، \fBauto\fR یعنی
تنظیمات از شبکه درخواست می‌شود و \fBmanual\fR یعنی
از آرگومان‌های داده‌شده به عنوان تنظیمات IPv6 استفاده خواهد شد.
.IR address " و " gateway
باید آدرس‌های معتبر IPv6 باشند. \fIprefixlength\fR طول پیشوند
بر حسب بیت است. برای جزئیات، بخش \fBمثال‌ها (EXAMPLES)\fR این صفحه
راهنما را ببینید.
.PP
.TP
.BI nameservers\  dns\fR\ [...]
تنظیم فهرست کارگزارهای نام (nameservers)، که با فاصله از هم جدا می‌شوند.
.PP
.TP
.BI timeservers\  server\fR\ [...]
تنظیم فهرست کارگزارهای زمان (timeservers)، که با فاصله از هم جدا می‌شوند.
.PP
.TP
.BI domains\  domain\fR\ [...]
تنظیم فهرست دامنه‌های جستجو (search domains)، که با فاصله از هم جدا می‌شوند.
.PP
.TP
.BR proxy\ direct \ |\  auto\fI\ URL \ |\  manual\ \fIserver [...]\ [--excludes\  \fIserver [...]]
تنظیمات پروکسی را برای سرویس پیکربندی می‌کند. \fBdirect\fR یعنی از هیچ
پروکسی استفاده نخواهد شد. در صورت استفاده از \fBauto\fR بدون پارامتر، تنظیمات پروکسی
از شبکه درخواست خواهد شد. در غیر این صورت، از \fIURL\fR به عنوان نشانی وب
پیکربندی خودکار پروکسی استفاده می‌شود. هنگامی که روی \fBmanual\fR تنظیم شود، فهرست نخست کارگزارها
به عنوان کارگزارهای پروکسی استفاده شده و ترافیک ارسالی به فهرست دوم کارگزارها از
پروکسی مستثنی می‌شود. فهرست کارگزارهای مستثنی اختیاری است. برای جزئیات،
بخش \fBمثال‌ها (EXAMPLES)\fR این صفحه راهنما را ببینید.
.PP
.SS "گزینه‌های پایش (Monitor Options):"
.PP
.TP
.BR services\  [ off ]
تغییرات سرویس‌ها را پایش می‌کند، برای مثال دریافت یک نشانی IP توسط یک سرویس.
.PP
.TP
.BR tech\  [ off ]
تغییرات فناوری‌ها را پایش می‌کند، برای مثال فعال شدن یک فناوری.
.PP
.TP
.BR manager\  [ off ]
تغییرات ویژگی‌های سراسری، فناوری‌های دردسترس،
سرویس‌ها، و همتایان (peers) را پایش می‌کند.
.PP
.TP
.BR vpnmanager\  [ off ]
اتصالات vpn اضافه‌شده یا حذف‌شده را پایش می‌کند.
.PP
.TP
.BR vpnconnection\  [ off ]
تغییرات اتصالات vpn را پایش می‌کند، برای مثال اتصال به یک VPN.
.PP
.SH "مثال‌ها (EXAMPLES)"
فهرست کردن فناوری‌های در دسترس:
.PP
      $ connmanctl technologies
.PP
فهرست کردن سرویس‌های در دسترس:
.PP
      $ connmanctl services
.PP
پویش برای شبکه‌های بی‌سیم:
.PP
      $ connmanctl scan wifi
.PP
استفاده از حالت تعاملی برای دسترسی به یک اکسس‌پوینت بی‌سیم:
.PP
      $ connmanctl
      connmanctl> agent on
      Agent registered
      connmanctl> connect wifi_100ba9d170fc_666f6f626172_managed_psk
      Agent RequestInput wifi_100ba9d170fc_666f6f626172_managed_psk
        Passphrase = [ Type=psk, Requirement=mandatory ]
      Passphrase? password
      Connected wifi_100ba9d170fc_666f6f626172_managed_psk
      connmanctl>
.PP
پیکربندی IP ایستا (static) از طریق خط فرمان:
.PP
      $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk ipv4 manual 192.168.1.101 255.255.255.0 192.168.1.1
.PP
بازگرداندن IP به حالت dhcp:
.PP
      $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk ipv4 dhcp
.PP
تنظیم یک کارگزار پروکسی:
.PP
      $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk proxy manual proxy.example.com
.PP
تنظیم چندین کارگزار پروکسی:
.PP
      $ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk proxy manual proxy.example.com http://httpproxy.example.com --excludes internal.example.com
.PP
اشتراک‌گذاری اتصال بی‌سیم (ssid برابر با "SSID"، عبارت عبور برابر با "password"):
.PP
      $ connmanctl tether wifi on SSID password
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR connman.conf (5), \ connman-service.config (5), \c
.BR \ connman-vpn-provider.config (5), \ connman (8), \ connman-vpn (8)