connmanctl(1)               General Commands Manual              connmanctl(1)

نام (NAME)
       connmanctl - رابط خط فرمان Connman

خلاصه دستور (SYNOPSIS)
       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]

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

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

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

دستورها و گزینه‌ها (COMMANDS AND OPTIONS)
       help   منوی راهنمای خلاصه را در پایانه نمایش می‌دهد.

       state  ویژگی‌های سیستم را نمایش می‌دهد. شامل وضعیت آنلاین (برخط) سیستم،
              حالت آفلاین، و حالت نشست (session).

       technologies
              فهرستی از تمام انواع فناوری‌های موجود در سیستم و ویژگی‌های آن‌ها را
              نمایش می‌دهد.  برای توضیحات مربوط به هر ویژگی، بخش ویژگی‌ها در
              Technology API را ببینید.

       enable technology
              نوع فناوری داده‌شده (مانند ethernet، wifi، 3g و غیره) را فعال
              می‌کند.  برق فناوری را روشن می‌کند، اما متصل نمی‌شود مگر اینکه
              سرویسی وجود داشته باشد که مقدار autoconnect آن روی True تنظیم
              شده باشد.

       disable technology
              نوع فناوری داده‌شده را غیرفعال می‌کند. برق فناوری را خاموش کرده و
              در صورتی که متصل باشد، اتصال آن را قطع می‌کند.

       enable offline
              حالت آفلاین را فعال می‌کند. تمام فناوری‌ها را در سراسر سیستم قطع
              کرده و برق آن‌ها را خاموش می‌کند، اگرچه هر فناوری می‌تواند به‌صورت
              جداگانه دوباره روشن شود.

       disable offline
              حالت آفلاین را غیرفعال می‌کند. فناوری‌ها مطابق با خط‌مشی‌های فردی
              خود دوباره روشن می‌شوند.

       tether technology on | off
              فعال یا غیرفعال کردن اشتراک اینترنت (tethering) روی technology.
              به‌طور پیش‌فرض امکان اشتراک اینترنت از طریق ethernet وجود ندارد،
              زیرا معمولاً شبکه‌های محلی را مختل می‌کند. برای فعال‌سازی به
              connman.conf(5) مراجعه کنید.

       tether wifi on | off ssid passphrase [freq]
              فعال یا غیرفعال کردن اشتراک اینترنت بی‌سیم، و همچنین تنظیم SSID و
              عبارت عبور (passphrase).

       services
              فهرستی از تمام سرویس‌های در دسترس را نمایش می‌دهد. این فهرست شامل
              شبکه‌های wifi مجاور، اتصالات کابلی ethernet، دستگاه‌های بلوتوث و
              غیره است.  وجود یک علامت ستاره در جلوی سرویس نشان‌دهنده آن است که
              قبلاً به این سرویس متصل شده است.

       services service
              فهرستی از تمام ویژگی‌های آن سرویس را نمایش می‌دهد.  تنها مسیر
              سرویس (مانند wifi_6834534139723_managed_none) به عنوان پارامتر
              پذیرفته می‌شود.

       scan technology
              سرویس‌های جدید روی فناوری داده‌شده را پویش (اسکن) می‌کند.

       connect service
              به سرویس داده‌شده متصل می‌شود. برخی سرویس‌ها برای اتصال نیازمند
              به‌اصطلاح یک فایل تدارک (provisioning file) هستند؛ به connman-
              service.config(5) مراجعه کنید.

       disconnect service
              اتصال از سرویس داده‌شده را قطع می‌کند.

       move-before service target-service
              اتصال به service را نسبت به target-service در اولویت قرار می‌دهد.

       move-after service target-service
              اتصال به target-service را نسبت به service در اولویت قرار می‌دهد.

       config service option arg...
              یک ویژگی قابل‌نوشتن از سرویس داده‌شده را به مقدار(های) وارد شده پس
              از option تنظیم می‌کند.  برای جزئیات، زیربخش گزینه‌های پیکربندی
              (Config Options) را ببینید.

       monitor target
              سیگنال‌های DBus ارسال‌شده توسط Connman را شنود کرده و نمایش می‌دهد.
              اگر ویژگی‌ای که در حال حاضر پایش می‌شود تغییر کند، تغییرات نشان
              داده خواهند شد. اگر هیچ target مشخص نشده باشد، تمام تغییرات نشان
              داده می‌شوند. برای خلاصه‌ای از پارامترها، زیربخش گزینه‌های پایش
              (Monitor Options) را ببینید.

       vpnconnections
              فهرستی از تمام اتصالات vpn دردسترس را نمایش می‌دهد.

       vpnconnections connection
              ویژگی‌های فعلی connection را نمایش می‌دهد.

   دستورهای فقط در دسترس در حالت تعاملی (Commands only available in
       interactive mode):
       agent on | off
              فعال یا غیرفعال کردن عامل بی‌سیم (wireless agent)، که برای وارد
              کردن عبارت‌های عبور شبکه بی‌سیم استفاده می‌شود. برای نمونه‌ای از
              اتصال به یک اکسس‌پوینت بی‌سیم، بخش مثال‌ها (EXAMPLES) این صفحه
              راهنما را ببینید.

       vpnagent on | off
              فعال یا غیرفعال کردن عامل vpn (vpn agent)، که برای وارد کردن
              اطلاعات احراز هویت vpn استفاده می‌شود.

   گزینه‌های پیکربندی (Config Options):
       autoconnect on | off
              ویژگی اتصال خودکار (autoconnect) سرویس را تنظیم می‌کند.

       ipv4 off | dhcp | manual address netmask gateway
              تنظیمات IPv4 را برای سرویس پیکربندی می‌کند. آرگومان off یعنی از
              IPv4 استفاده نخواهد شد، dhcp یعنی از dhcp برای دریافت تنظیمات
              استفاده می‌شود و manual یعنی از آرگومان‌های داده‌شده به عنوان
              تنظیمات IPv4 استفاده خواهد شد.  address، netmask و gateway باید
              آدرس‌های معتبر IPv4 باشند. برای جزئیات، بخش مثال‌ها (EXAMPLES) این
              صفحه راهنما را ببینید.

       ipv6 off | auto | manual address prefixlength gateway
              تنظیمات IPv6 را برای سرویس پیکربندی می‌کند. آرگومان off یعنی از
              IPv6 استفاده نخواهد شد، auto یعنی تنظیمات از شبکه درخواست می‌شود
              و manual یعنی از آرگومان‌های داده‌شده به عنوان تنظیمات IPv6
              استفاده خواهد شد.  address و gateway باید آدرس‌های معتبر IPv6
              باشند. prefixlength طول پیشوند بر حسب بیت است. برای جزئیات، بخش
              مثال‌ها (EXAMPLES) این صفحه راهنما را ببینید.

       nameservers dns [...]
              تنظیم فهرست کارگزارهای نام (nameservers)، که با فاصله از هم جدا
              می‌شوند.

       timeservers server [...]
              تنظیم فهرست کارگزارهای زمان (timeservers)، که با فاصله از هم جدا
              می‌شوند.

       domains domain [...]
              تنظیم فهرست دامنه‌های جستجو (search domains)، که با فاصله از هم
              جدا می‌شوند.

       proxy direct | auto URL | manual server[...] [--excludes server[...]]
              تنظیمات پروکسی را برای سرویس پیکربندی می‌کند. direct یعنی از هیچ
              پروکسی استفاده نخواهد شد. در صورت استفاده از auto بدون پارامتر،
              تنظیمات پروکسی از شبکه درخواست خواهد شد. در غیر این صورت، از URL
              به عنوان نشانی وب پیکربندی خودکار پروکسی استفاده می‌شود. هنگامی
              که روی manual تنظیم شود، فهرست نخست کارگزارها به عنوان
              کارگزارهای پروکسی استفاده شده و ترافیک ارسالی به فهرست دوم
              کارگزارها از پروکسی مستثنی می‌شود. فهرست کارگزارهای مستثنی
              اختیاری است. برای جزئیات، بخش مثال‌ها (EXAMPLES) این صفحه راهنما
              را ببینید.

   گزینه‌های پایش (Monitor Options):
       services [off]
              تغییرات سرویس‌ها را پایش می‌کند، برای مثال دریافت یک نشانی IP توسط
              یک سرویس.

       tech [off]
              تغییرات فناوری‌ها را پایش می‌کند، برای مثال فعال شدن یک فناوری.

       manager [off]
              تغییرات ویژگی‌های سراسری، فناوری‌های دردسترس، سرویس‌ها، و همتایان
              (peers) را پایش می‌کند.

       vpnmanager [off]
              اتصالات vpn اضافه‌شده یا حذف‌شده را پایش می‌کند.

       vpnconnection [off]
              تغییرات اتصالات vpn را پایش می‌کند، برای مثال اتصال به یک VPN.

مثال‌ها (EXAMPLES)
       فهرست کردن فناوری‌های در دسترس:

             $ 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

همچنین ببینید (SEE ALSO)
       connman.conf(5), connman-service.config(5), connman-vpn-provider.config(5), connman(8), connman-vpn(8)

                                  2015-10-15                     connmanctl(1)