This file is indexed.

/usr/share/doc/network-manager/README.Debian is in network-manager 0.9.4.0-0ubuntu3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
NetworkManager consists of two parts: one is on the system level daemon that
manages the connections and gathers information about new networks. The other
is a systray applet that users can use to interact with the NetworkManager
daemon.

Managed vs. Unmanaged mode and /etc/network/interfaces
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Devices listed in /etc/network/interfaces _will_ be managed by NetworkManager
unless the ifupdown system-config-setting is enabled and is setup to run
in "Unmanaged mode".

The config to select unmanaged/managed mode is in
/etc/NetworkManager/NetworkManager.conf:

  [ifupdown]
  managed=true/false

Unmanaged mode will make NetworkManager not touch any wired/wireless device
matching an interface name configured in /etc/network/interfaces.

Managed mode will make NetworkManager manage all devices and will make
NetworkManager honour all dhcp and static configurations for wired and
wireless devices.

After modifying /etc/NetworkManager/NetworkManager.conf _or_
/etc/network/interfaces you may want to tell NetworkManager about the changes
by running "service network-manager restart".

System settings
~~~~~~~~~~~~~~~

System settings allow to setup network connections which are available at
boot time, before login and to all users of the machine. The settings are
stored in a system-wide location.
There are plugins for different configuration sources.
By default the ifupdown and keyfile plugin are enabled, see
/etc/NetworkManager/NetworkManager.conf:

  [main]
  plugins=ifupdown,keyfile

The ifupdown plugin is read-only and reads the native ifupdown configuration
file /etc/network/interfaces.

The keyfile plugin is read-write. The configuration files for network
connections are stored in /etc/NetworkManager/system-connections/.

For more information see NetworkManager.conf(5) or
http://live.gnome.org/NetworkManager/SystemSettings

The keyfile specification is available at
http://projects.gnome.org/NetworkManager/developers/settings-spec-08.html


Dial-up configuration
~~~~~~~~~~~~~~~~~~~~~

Your dialup configurations can now be done in nm-connection-editor.
Because of that /etc/network/interfaces configurations are considered "legacy"
from a network manager point of view.

However, if you want to use your /etc/network/interfaces configuration make
sure that you have the ifupdown plugin in "Unmanaged mode" and take care that
the used wired/wireless device is also configured in /etc/network/interfaces.

Note that NetworkManager 0.7 will not provide UI hooks to up and down ppp
connections managed outside of NetworkManager itself (not that it ever worked
nicely before).