connmanctl(1) General Commands Manual connmanctl(1)

connmanctl - رابط خط فرمان Connman

connmanctl [state | technologies | enable technology|offline | disable technology|offline | tether technology on|off | tether wifi on|off ssid passphrase freq | services [service] | peers peer | scan technology | connect service|peer | disconnect service|peer | config  service option arg... | vpnconnections [connection] | help]

برنامه connmanctl یک رابط خط فرمان برای Connman است که می‌تواند در دو حالت اجرا شود: ورودی دستور همگام ساده، و یک پوسته تعاملی ناهمگام. برای اجرای یک دستور خاص، کاربر می‌تواند connmanctl command [options] را وارد کند، یا صرفاً connmanctl را تایپ کند که در حالت دوم، یک پوسته تعاملی آغاز به کار خواهد کرد.

برنامه connmanctl می‌تواند بیشتر اتصالات شبکه را مدیریت کند. از این ابزار می‌توان برای فعال/غیرفعال کردن هر فناوری موجود در سیستم، نمایش فهرست سرویس‌های در دسترس، اتصال/قطع اتصال شبکه‌ها، نمایش ویژگی‌های سیستم، فناوری‌ها و هر سرویس مجزا، و همچنین پیکربندی تمامی ویژگی‌ها استفاده کرد. این ابزار همچنین قادر است تغییرات ویژگی‌های سرویس‌ها، فناوری‌ها و سیستم را پایش کند.

در پوسته تعاملی، می‌توان از تمامی همین دستورها استفاده کرد. این حالت استفاده سریع‌تری را در زمان نیاز به کار گسترده‌تر با connmanctl فراهم می‌کند. علاوه بر این، اتصال به اکسس‌پوینت‌های بی‌سیم محافظت‌شده برای بار اول نیازمند پوسته تعاملی است.

منوی راهنمای خلاصه را در پایانه نمایش می‌دهد.
ویژگی‌های سیستم را نمایش می‌دهد. شامل وضعیت آنلاین (برخط) سیستم، حالت آفلاین، و حالت نشست (session).
فهرستی از تمام انواع فناوری‌های موجود در سیستم و ویژگی‌های آن‌ها را نمایش می‌دهد. برای توضیحات مربوط به هر ویژگی، بخش ویژگی‌ها در Technology API را ببینید.
نوع فناوری داده‌شده (مانند ethernet، wifi، 3g و غیره) را فعال می‌کند. برق فناوری را روشن می‌کند، اما متصل نمی‌شود مگر اینکه سرویسی وجود داشته باشد که مقدار autoconnect آن روی True تنظیم شده باشد.
نوع فناوری داده‌شده را غیرفعال می‌کند. برق فناوری را خاموش کرده و در صورتی که متصل باشد، اتصال آن را قطع می‌کند.
enable offline
حالت آفلاین را فعال می‌کند. تمام فناوری‌ها را در سراسر سیستم قطع کرده و برق آن‌ها را خاموش می‌کند، اگرچه هر فناوری می‌تواند به‌صورت جداگانه دوباره روشن شود.
disable offline
حالت آفلاین را غیرفعال می‌کند. فناوری‌ها مطابق با خط‌مشی‌های فردی خود دوباره روشن می‌شوند.
فعال یا غیرفعال کردن اشتراک اینترنت (tethering) روی technology. به‌طور پیش‌فرض امکان اشتراک اینترنت از طریق ethernet وجود ندارد، زیرا معمولاً شبکه‌های محلی را مختل می‌کند. برای فعال‌سازی به connman.conf(5) مراجعه کنید.
tether wifi on | off ssid passphrase [freq]
فعال یا غیرفعال کردن اشتراک اینترنت بی‌سیم، و همچنین تنظیم SSID و عبارت عبور (passphrase).
فهرستی از تمام سرویس‌های در دسترس را نمایش می‌دهد. این فهرست شامل شبکه‌های wifi مجاور، اتصالات کابلی ethernet، دستگاه‌های بلوتوث و غیره است. وجود یک علامت ستاره در جلوی سرویس نشان‌دهنده آن است که قبلاً به این سرویس متصل شده است.
فهرستی از تمام ویژگی‌های آن سرویس را نمایش می‌دهد. تنها مسیر سرویس (مانند wifi_6834534139723_managed_none) به عنوان پارامتر پذیرفته می‌شود.
سرویس‌های جدید روی فناوری داده‌شده را پویش (اسکن) می‌کند.
به سرویس داده‌شده متصل می‌شود. برخی سرویس‌ها برای اتصال نیازمند به‌اصطلاح یک فایل تدارک (provisioning file) هستند؛ به connman-service.config(5) مراجعه کنید.
اتصال از سرویس داده‌شده را قطع می‌کند.
اتصال به service را نسبت به target-service در اولویت قرار می‌دهد.
اتصال به target-service را نسبت به service در اولویت قرار می‌دهد.
یک ویژگی قابل‌نوشتن از سرویس داده‌شده را به مقدار(های) وارد شده پس از option تنظیم می‌کند. برای جزئیات، زیربخش گزینه‌های پیکربندی (Config Options) را ببینید.
سیگنال‌های DBus ارسال‌شده توسط Connman را شنود کرده و نمایش می‌دهد. اگر ویژگی‌ای که در حال حاضر پایش می‌شود تغییر کند، تغییرات نشان داده خواهند شد. اگر هیچ target مشخص نشده باشد، تمام تغییرات نشان داده می‌شوند. برای خلاصه‌ای از پارامترها، زیربخش گزینه‌های پایش (Monitor Options) را ببینید.
فهرستی از تمام اتصالات vpn دردسترس را نمایش می‌دهد.
ویژگی‌های فعلی connection را نمایش می‌دهد.

فعال یا غیرفعال کردن عامل بی‌سیم (wireless agent)، که برای وارد کردن عبارت‌های عبور شبکه بی‌سیم استفاده می‌شود. برای نمونه‌ای از اتصال به یک اکسس‌پوینت بی‌سیم، بخش مثال‌ها (EXAMPLES) این صفحه راهنما را ببینید.
فعال یا غیرفعال کردن عامل vpn (vpn agent)، که برای وارد کردن اطلاعات احراز هویت vpn استفاده می‌شود.

ویژگی اتصال خودکار (autoconnect) سرویس را تنظیم می‌کند.
تنظیمات IPv4 را برای سرویس پیکربندی می‌کند. آرگومان off یعنی از IPv4 استفاده نخواهد شد، dhcp یعنی از dhcp برای دریافت تنظیمات استفاده می‌شود و manual یعنی از آرگومان‌های داده‌شده به عنوان تنظیمات IPv4 استفاده خواهد شد. address، netmask و gateway باید آدرس‌های معتبر IPv4 باشند. برای جزئیات، بخش مثال‌ها (EXAMPLES) این صفحه راهنما را ببینید.
تنظیمات IPv6 را برای سرویس پیکربندی می‌کند. آرگومان off یعنی از IPv6 استفاده نخواهد شد، auto یعنی تنظیمات از شبکه درخواست می‌شود و manual یعنی از آرگومان‌های داده‌شده به عنوان تنظیمات IPv6 استفاده خواهد شد. address و gateway باید آدرس‌های معتبر IPv6 باشند. prefixlength طول پیشوند بر حسب بیت است. برای جزئیات، بخش مثال‌ها (EXAMPLES) این صفحه راهنما را ببینید.
تنظیم فهرست کارگزارهای نام (nameservers)، که با فاصله از هم جدا می‌شوند.
تنظیم فهرست کارگزارهای زمان (timeservers)، که با فاصله از هم جدا می‌شوند.
تنظیم فهرست دامنه‌های جستجو (search domains)، که با فاصله از هم جدا می‌شوند.
تنظیمات پروکسی را برای سرویس پیکربندی می‌کند. direct یعنی از هیچ پروکسی استفاده نخواهد شد. در صورت استفاده از auto بدون پارامتر، تنظیمات پروکسی از شبکه درخواست خواهد شد. در غیر این صورت، از URL به عنوان نشانی وب پیکربندی خودکار پروکسی استفاده می‌شود. هنگامی که روی manual تنظیم شود، فهرست نخست کارگزارها به عنوان کارگزارهای پروکسی استفاده شده و ترافیک ارسالی به فهرست دوم کارگزارها از پروکسی مستثنی می‌شود. فهرست کارگزارهای مستثنی اختیاری است. برای جزئیات، بخش مثال‌ها (EXAMPLES) این صفحه راهنما را ببینید.

services [off]
تغییرات سرویس‌ها را پایش می‌کند، برای مثال دریافت یک نشانی IP توسط یک سرویس.
تغییرات فناوری‌ها را پایش می‌کند، برای مثال فعال شدن یک فناوری.
تغییرات ویژگی‌های سراسری، فناوری‌های دردسترس، سرویس‌ها، و همتایان (peers) را پایش می‌کند.
اتصالات vpn اضافه‌شده یا حذف‌شده را پایش می‌کند.
تغییرات اتصالات vpn را پایش می‌کند، برای مثال اتصال به یک VPN.

فهرست کردن فناوری‌های در دسترس:


$ connmanctl technologies

فهرست کردن سرویس‌های در دسترس:


$ connmanctl services

پویش برای شبکه‌های بی‌سیم:


$ connmanctl scan wifi

استفاده از حالت تعاملی برای دسترسی به یک اکسس‌پوینت بی‌سیم:


$ 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>

پیکربندی IP ایستا (static) از طریق خط فرمان:


$ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk ipv4 manual 192.168.1.101 255.255.255.0 192.168.1.1

بازگرداندن IP به حالت dhcp:


$ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk ipv4 dhcp

تنظیم یک کارگزار پروکسی:


$ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk proxy manual proxy.example.com

تنظیم چندین کارگزار پروکسی:


$ connmanctl config wifi_100ba9d170fc_666f6f626172_managed_psk proxy manual proxy.example.com http://httpproxy.example.com --excludes internal.example.com

اشتراک‌گذاری اتصال بی‌سیم (ssid برابر با "SSID"، عبارت عبور برابر با "password"):


$ connmanctl tether wifi on SSID password

connman.conf(5), connman-service.config(5), connman-vpn-provider.config(5), connman(8), connman-vpn(8)

2015-10-15