arcanis.me/ru/projects/_posts/2014-01-30-netctl-gui.md

11 KiB
Raw Blame History

permalink category hastr layout title short tags hasgui hasdocs developers license links
ru/projects/netctl-gui ru true project Netctl GUI netctl-gui archlinux, c++, qt, сеть, kde, netctl, система, dbus, библиотека true true
Evgeniy Alekseev
nosada (перевод на японский)
GPLv3
Страница на <a href="//linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
Страница на <a href="//kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
<a href="//aur.archlinux.org/pkgbase/netctl-gui/" title="AUR">Пакет в AUR</a>
<a href="/devs/netctl-gui-dbus-api.html" title="DBus API">Описание DBus API</a>
<a href="/devs/netctl-gui-security-notes.html" title="Security">Примечания о безопасности</a>

Графическая оболочка для netctl (набор скриптов для поднятия сети в Arch'е). Написана на C++ с использованием библиотеки Qt. На текущим момент умеет работать с профилями, в том числе создавать новые, а также умеет подключаться к WiFi. Также предоставляет библиотеку для взаимодействия с netctl и виджет и DataEngine для KDE.

ВНИМАНИЕ: НУЖНЫ ПЕРЕВОДЧИКИ!

$ netctl-gui --help
Использование:
netctl-gui [ options ]
Опции:
 Открыть окно:
       --detached        - запустить открепленным от консоли
       --maximized       - запустить развернутым
       --minimized       - запустить свернутым в трей
       --about           - показать окно "О программе"
       --netctl-auto     - показать окно netctl-auto
       --settings        - показать окно настроек
 Функции:
   -e, --essid <arg>     - выбрать данный ESSID
   -o, --open <arg>      - открыть данный профиль
   -s, --select <arg>    - выбрать данный профиль
 Дополнительные флаги:
   -c, --config <arg>    - прочитать настройки из данного файла
   -d, --debug           - показать отладочную информацию
       --default         - запустить со стандартными настройками
       --set-opts <arg>  - установить опции для данного запуска, разделенные запятыми
   -t, --tab <arg>       - открыть вкладку с этим номером
 Показать сообщения:
   -v, --version         - показать версию и выход
   -i, --info            - показать информацию о сборке и выход
   -h, --help            - показать справку и выход
$ netctlgui-helper --help
Использование:
netctlgui-helper [ options ]
Опции:
   -c, --config <arg>    - прочитать настройки из данного файла
   -d, --debug           - показать отладочную информацию
       --nodaemon        - не запускать как демон
       --replace         - принудительно заменить существующую сессию
       --restore         - принудительно восстановить существующую сессию
       --system          - не считывать пользовательские настройки, только системные
 Показать сообщения:
   -v, --version         - показать версию и выход
   -i, --info            - показать информацию о сборке и выход
   -h, --help            - показать справку и выход

Разработчики

{% for devel in page.developers %}

  • {{ devel }}{% endfor %}

Лицензия

  • {{ page.license }}

Changelog

CHANGELOG

Установка

Инструкция

  • Скачайте архив с актуальной версией исходных файлов.

  • Извлеките из него файлы и установите приложение. Если Вы хотите установить в /, Вы должны запустить как root:

    cd /путь/к/распакованному/архиву
    mkdir build && cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
    make
    sudo make install
    

    Доступные флаги cmake:

    • компоненты:
      • -DBUILD_DATAENGINE:BOOL=0 - не собирать DataEngine
      • -DBUILD_GUI:BOOL=0 - не собирать GUI
      • -DBUILD_HELPER:BOOL=0 - не собирать хелпер
      • -DBUILD_LIBRARY:BOOL=0 - не собирать библиотеку
      • -DBUILD_PLASMOID:BOOL=0 - не собирать плазмоид
    • дополнительные компоненты:
      • -DBUILD_DOCS:BOOL=0 - не собирать документацию разработчика
      • -DBUILD_TEST:BOOL=1 - собирать авто тесты для библиотеки и хелпера
    • свойства проекта:
      • -DDBUS_SYSTEMCONF_PATH=/etc/dbus-1/system.d/ - путь к системный файлам конфигурации DBus
      • -DSYSTEMD_SERVICE_PATH=lib/systemd/system - путь к сервису systemd
      • -DUSE_CAPABILITIES:BOOL=0 - не использовать setcap, чтобы дать необходимые привилегии хелперу
      • -DBUILD_KDE4:BOOL=1 - собирать виджет под KDE4 вместо KF5
      • -DUSE_QT5:BOOL=0 - использовать Qt4 вместо Qt5

Зависимости

Все было протестировано на последних версиях зависимостей.

  • netctl
  • qt5-base (если используется Qt5) или qt4 (если используется Qt4)
  • automoc4 (make)
  • cmake (make)
  • qt5-tools (make, если используется Qt5)
  • kdebase-workspace (опционально, KDE4 виджет)
  • plasma-frameworks (опционально, KF5 виджет)
  • sudo (опционально, поддержка sudo)
  • wpa_supplicant (опционально, поддержка WiFi)

Использование

Просто запустите приложение netctl-gui. Если потребуется (и если Вы используете KDE), можете добавить виджет netctl, предоставляемый приложением.

Настройка

Рекомендуется использовать графический интерфейс для настройки. Конфигурационные файлы:

  • Графический интерфейс и хелпер
    • $HOME/.config/netctl-gui.conf - пользовательские настройки GUI/хелпера
    • /etc/netctl-gui.conf - системные настройки хелпера
  • DataEngine (KDE4 версия)
    • $KDEHOME/share/config/plasma-dataengine-netctl.conf - пользовательские настройки DataEngine
    • $KDESYSTEM/share/config/plasma-dataengine-netctl.conf - системные настройки DataEngine
  • DataEngine (KF5 версия)
    • $HOME/.config/plasma-dataengine-netctl.conf - пользовательские настройки DataEngine
    • /etc/xdg/plasma-dataengine-netctl.conf - системные настройки DataEngine

Для настройки виджета и DataEngine рекомендуется использовать графический интерфейс. Все настройки графического интерфейса хранятся в $HOME/.config/netctl-gui.conf. Для редактирования настоятельно рекомендуется использовать графический интерфейс.

Графический интерфейс

Графический интерфейс предоставляется приложением netctl-gui.

Скриншоты

{% assign scrdesc = "DataEngine" %} {% assign scrname = "netctl-gui_dataengine" %} {% include prj_scr.html %} {% assign scrdesc = "Виджет" %} {% assign scrname = "netctl-gui_plasmoid" %} {% include prj_scr.html %} {% assign scrdesc = "Настройки виджета" %} {% assign scrname = "netctl-gui_plasmoid_conf_01" %} {% include prj_scr.html %} {% assign scrdesc = "Настройки виджета" %} {% assign scrname = "netctl-gui_plasmoid_conf_02" %} {% include prj_scr.html %} {% assign scrdesc = "Настройки виджета" %} {% assign scrname = "netctl-gui_plasmoid_conf_03" %} {% include prj_scr.html %} {% assign scrdesc = "Главное окно" %} {% assign scrname = "netctl-gui_main" %} {% include prj_scr.html %} {% assign scrdesc = "Окно создания профиля" %} {% assign scrname = "netctl-gui_profile" %} {% include prj_scr.html %} {% assign scrdesc = "WiFi меню" %} {% assign scrname = "netctl-gui_wifi" %} {% include prj_scr.html %} {% assign scrdesc = "Окно 'О программе'" %} {% assign scrname = "netctl-gui_about" %} {% include prj_scr.html %} {% assign scrdesc = "Окно netctl-auto" %} {% assign scrname = "netctl-gui_netctl-auto" %} {% include prj_scr.html %} {% assign scrdesc = "Окно настроек" %} {% assign scrname = "netctl-gui_settings" %} {% include prj_scr.html %}