NetworkManager-1.26.0

NetworkManager の概要

NetworkManager is a set of co-operative tools that make networking simple and straightforward. Whether you use WiFi, wired, 3G, or Bluetooth, NetworkManager allows you to quickly move from one network to another: Once a network has been configured and joined once, it can be detected and re-joined automatically the next time it's available.

本パッケージは LFS-10.0 において正しくビルドでき動作することが確認されています。

[注記]

注記

Make sure that you disable the systemd-networkd service or configure it not to manage the interfaces you want to manage with NetworkManager.

パッケージ情報

NetworkManager の依存パッケージ

必須

dbus-glib-0.110, libndp-1.7

推奨

任意

BlueZ-5.54, D-Bus Python-1.2.16 (for the test suite), GnuTLS-3.6.14 (used if NSS-3.55 is not found), GTK-Doc-1.32, libpsl-0.21.1, Qt-5.15.0 (for examples), ModemManager-1.14.0, Valgrind-3.16.1, dnsmasq, libaudit, libteam, mobile-broadband-provider-info, PPP, and RP-PPPoE

ユーザー情報: http://wiki.linuxfromscratch.org/blfs/wiki/NetworkManager

Kernel Configuration

If you wish to run the tests, enable the following options in the kernel configuration and recompile the kernel if necessary:

Device Drivers --->
  [*] Network device support         [CONFIG_NETDEVICES] --->
    [*] Bonding driver support       [CONFIG_BONDING]
    [*] Dummy net driver support     [CONFIG_DUMMY]
    [*] Ethernet team driver support [CONFIG_NET_TEAM]

NetworkManager のインストール

If Qt-5.15.0 is installed and the Qt based examples are desired, fix two meson.build files:

sed -e 's/-qt4/-qt5/'              \
    -e 's/moc_location/host_bins/' \
    -i examples/C/qt/meson.build   &&
sed -e 's/Qt/&5/'                  \
    -i meson.build

Fix a missing meson.build file for initrd hooks (not used in BLFS):

sed '/initrd/d' -i src/meson.build

Fix the python scripts so that they use Python 3:

grep -rl '^#!.*python$' | xargs sed -i '1s/python/&3/'

以下のコマンドを実行して NetworkManager をビルドします。

mkdir build &&
cd    build    &&

CXXFLAGS+="-O2 -fPIC"            \
meson --prefix /usr              \
      -Djson_validation=false    \
      -Dlibaudit=no              \
      -Dlibpsl=false             \
      -Dnmtui=true               \
      -Dovs=false                \
      -Dppp=false                \
      -Dselinux=false            \
      -Dqt=false                 \
      -Dudev_dir=/lib/udev       \
      -Dsession_tracking=systemd \
      -Dmodem_manager=false      \
      -Dsystemdsystemunitdir=/lib/systemd/system \
      .. &&
ninja

An already active graphical session with a bus address is necessary to run the tests. To test the results, as the root user, issue: ninja test. Five tests, devices/test-acd, platform/test-tc-linux, platform/test-route-linux, platform/test-link-linux, and platform/test-cleanup-linux, are known to fail.

root ユーザーになって以下を実行します。

ninja install &&
mv -v /usr/share/doc/NetworkManager{,-1.26.0}

コマンド説明

CXXFLAGS="-O2 -fPIC": These compiler options are necessary to build the Qt5 based examples.

-Ddocs=true: Use this switch to enable building man pages and documentation if GTK-Doc-1.32 is installed.

-Dnmtui=true: This parameter enables building nmtui.

-Djson_validation=false, -Dlibpsl=false, and -Dovs=false: These switches disable building with the respective libraries. Remove if you have the needed libraries installed.

-Dmodem_manager=false: This switch is requried if ModemManager is not installed. Omit if you have built ModemManager and mobile-broadband-provider-info.

-Dsession_tracking=systemd: This switch is used to set systemd-logind as the default program for session tracking.

-Dsystemdsystemunitdir=/lib/systemd/system: This switch is used to set the correct installation directory for systemd units.

-Dppp=false: This parameter disables PPP support in NetworkManager.

-Dlibaudit=no and -Dselinux=false: libaudit and SELinux are not used in BLFS.

-Dqt=false: disables the QT examples. Omit if you have QT available and wish to install the examples.

NetworkManager の設定

設定ファイル

/etc/NetworkManager/NetworkManager.conf

設定情報

For NetworkManager to work, at least a minimal configuration file must be present. Such file is not installed with make install. Issue the following command as the root user to create minimal NetworkManager.conf file:

cat >> /etc/NetworkManager/NetworkManager.conf << "EOF"
[main]
plugins=keyfile
EOF

This file should not be modified directly by users of the system. Instead, system specific changes should be made using configuration files in the /etc/NetworkManager/conf.d direcotry.

To allow polkit to manage authorizations, add the following configuration file:

cat > /etc/NetworkManager/conf.d/polkit.conf << "EOF"
[main]
auth-polkit=true
EOF

To use something other than the built-in dhcp client (recommended if using only nmcli), use the following configuration (valid values include either dhclient or internal):

cat > /etc/NetworkManager/conf.d/dhcp.conf << "EOF"
[main]
dhcp=dhclient
EOF

To prevent NetworkManager from updating the /etc/resolv.conf file, add the following configuration file:

cat > /etc/NetworkManager/conf.d/no-dns-update.conf << "EOF"
[main]
dns=none
EOF

For additional configuation options, see man 5 NetworkManager.conf.

To allow regular users permission to configure network connections, you should add them to the netdev group, and create a polkit rule that grants access. Run the following commands as the root user:

groupadd -fg 86 netdev &&
/usr/sbin/usermod -a -G netdev <username>

cat > /usr/share/polkit-1/rules.d/org.freedesktop.NetworkManager.rules << "EOF"
polkit.addRule(function(action, subject) {
    if (action.id.indexOf("org.freedesktop.NetworkManager.") == 0 && subject.isInGroup("netdev")) {
        return polkit.Result.YES;
    }
});
EOF

Systemd ユニット

To start the NetworkManager daemon at boot, enable the previously installed systemd unit by running the following command as the root user:

[注記]

注記

If using Network Manager to manage an interface, any previous configuration for that interface should be removed, and the interface brought down prior to starting Network Manager.

systemctl enable NetworkManager

Starting in version 1.11.2 of NetworkManager, a systemd unit named NetworkManager-wait-online.service is enabled, which is used to prevent services that require network connectivity from starting until NetworkManager establishes a connection. To disable this behavior, run the following command as the root user:

systemctl disable NetworkManager-wait-online

パッケージ構成

インストールプログラム: NetworkManager, nmcli, nm-online, nmtui, and, symlinked to nmtui: nmtui-connect, nmtui-edit, and nmtui-hostname
インストールライブラリ: libnm.so, /usr/lib/NetworkManager 配下の数種のモジュール
インストールディレクトリ: /etc/NetworkManager, /usr/include/libnm, /usr/lib/NetworkManager, /usr/share/doc/NetworkManager-1.26.0, /usr/share/gtk-doc/html/{libnm,NetworkManager} (if the documentation is built), /var/lib/NetworkManager

概略説明

nmcli

is a command-line tool for controlling NetworkManager and getting its status.

nm-online

is an utility to find out whether you are online.

nmtui

is an interactive ncurses based interface for nmcli.

nmtui-connect

is an interactive ncurses based interface connection to activate/deactivate connections.

nmtui-edit

is an interactive ncurses based interface connection editor.

nmtui-hostname

is an interactive ncurses based interface hostname editor.

NetworkManager

is the network management daemon.

libnm.so

contains functions used by NetworkManager.

最終更新日: 2020-08-27 03:16:17 +0900