Find a file
Thomas Haller e8824f6a52 policy: add manager for default routes and support multiple default routes
Up to now, NMPolicy would iterate over all devices to find the "best"
device and assign the default route to that device.

A better approach is to add a default route to *all* devices that
are never-default=no. The relative priority is choosen according to
the route metrics.

If two devices receive the same metric, we want to prefer the device
that activates first. That way, the default route sticks to the same
device until a better device activates or the device deactivates.
Hence, the order of activation is imporant in this case (as it is
already now).

Also, if several devices have identical metrics, increment their
metrics so that every metric is unique.
This makes the routing deterministic according to what we choose as best
device.

A special case is assumed devices. In this case we cannot adjust the metric
in face of equal metrics.

Add a new singleton class NMDefaultRouteManager that has a list of all
devices and their default routes. The manager will order the devices by
their priority and configure the routes using platform.

Also update the metric for VPN connections. Later we will track VPN
routes also via NMDefaultRouteManager. For now, fix the VPN metric because
otherwise VPNs would always get metric 1024 (which is usually much larger then the
device metrics).

https://bugzilla.gnome.org/show_bug.cgi?id=735512

Signed-off-by: Thomas Haller <thaller@redhat.com>
2014-11-07 15:23:12 +01:00
callouts all: allow route metrics to be "0" 2014-11-07 07:49:41 -05:00
clients cli: support new property NM_SETTING_IP_CONFIG_ROUTE_METRIC 2014-11-07 15:19:06 +01:00
contrib/fedora Merge branch 'lr/rpm-make-check' 2014-10-30 14:40:47 +01:00
data dispatcher: rename executable to 'nm-dispatcher' 2014-06-06 13:43:45 -05:00
docs libnm: create NMDhcpConfig as parent of NMDhcp4Config and NMDhcp6Config 2014-11-07 07:49:40 -05:00
examples libnm-core: extract NMSettingIPConfig superclass out of IP4, IP6 classes 2014-11-07 07:49:40 -05:00
include all: add macro NM_IN_SET 2014-11-07 15:19:05 +01:00
initscript remove paldo initscript 2013-05-06 16:33:14 +02:00
introspection libnm-core, libnm, core: add AddressData and RouteData properties 2014-11-07 07:49:40 -05:00
libnm libnm: add NMSettingIPConfig:route-metric 2014-11-07 15:19:06 +01:00
libnm-core libnm: add NMSettingIPConfig:route-metric 2014-11-07 15:19:06 +01:00
libnm-glib tests: Don't run session-long dbus daemons for tests 2014-10-24 19:16:33 +02:00
libnm-util libnm: add NMSettingIPConfig:route-metric 2014-11-07 15:19:06 +01:00
m4 dhcp: add systemd-based "internal" DHCP client 2014-11-06 22:42:43 -06:00
man cli: add 'nmcli agent' command (bgo #739568) 2014-11-07 11:58:25 +01:00
po libnm-core: extract NMSettingIPConfig superclass out of IP4, IP6 classes 2014-11-07 07:49:40 -05:00
policy policy: allow non-local admin sessions to control the network (rh #1145646) 2014-10-13 15:58:46 -05:00
src policy: add manager for default routes and support multiple default routes 2014-11-07 15:23:12 +01:00
tools test,examples: fix scripts to avoid 'has_key' for Python 3 2014-10-31 16:39:00 +01:00
vapi vapi: add bindings for new_async methods (bgo #732253) 2014-07-16 17:11:02 -05:00
.dir-locals.el misc: add toplevel .dir-locals file that tells Emacs to show trailing whitespace 2013-03-08 15:15:28 +01:00
.gitignore gitignore: ignore dhcp test binary 2014-11-07 12:25:33 +01:00
AUTHORS Update authors 2008-11-19 23:33:18 +00:00
autogen.sh build: remove setup of git-submodules in autogen.sh 2014-07-15 22:50:36 +02:00
ChangeLog fix typos in documentation and messages 2014-04-03 17:12:31 +02:00
configure.ac configure: check whether polkit-agent-1 is available 2014-11-07 11:37:42 +01:00
CONTRIBUTING doc: update code style docs 2009-10-07 12:28:10 -07:00
COPYING docs: create new master NM documentation module 2011-02-16 16:24:16 -06:00
MAINTAINERS Update MAINTAINERS 2007-09-02 23:57:41 +00:00
Makefile.am libnm: port to GDBus 2014-09-18 11:51:09 -04:00
Makefile.glib build: update Makefile.glib 2013-04-19 10:52:21 -04:00
NetworkManager.pc.in build: update NetworkManager.pc 2013-01-29 16:17:30 -05:00
NEWS trivial: typo in the NEWS 2014-06-09 09:15:40 +02:00
README trivial: typo fixes 2010-09-25 00:34:10 -05:00
TODO todo: remove item about finished VPN IPv6 support 2013-04-10 10:06:38 -05:00
valgrind.suppressions test: add valgrind suppressions 2014-02-18 20:33:10 +01:00

******************
2008-12-11: NetworkManager core daemon has moved to git.freedesktop.org!

git clone git://git.freedesktop.org/git/NetworkManager/NetworkManager.git
******************


Networking that Just Works
--------------------------

NetworkManager attempts to keep an active network connection available at all
times.  The point of NetworkManager is to make networking configuration and
setup as painless and automatic as possible.  NetworkManager is intended to
replace default route, replace other routes, set IP addresses, and in general
configure networking as NM sees fit (with the possibility of manual override as
necessary).  In effect, the goal of NetworkManager is to make networking Just
Work with a minimum of user hassle, but still allow customization and a high
level of manual network control.  If you have special needs, we'd like to hear
about them, but understand that NetworkManager is not intended for every
use-case.

NetworkManager will attempt to keep every network device in the system up and
active, as long as the device is available for use (has a cable plugged in,
the killswitch isn't turned on, etc).  Network connections can be set to
'autoconnect', meaning that NetworkManager will make that connection active
whenever it and the hardware is available.

"Settings services" store lists of user- or administrator-defined "connections",
which contain all the settings and parameters required to connect to a specific
network.  NetworkManager will _never_ activate a connection that is not in this
list, or that the user has not directed NetworkManager to connect to.


How it works:

The NetworkManager daemon runs as a privileged service (since it must access
and control hardware), but provides a D-Bus interface on the system bus to
allow for fine-grained control of networking.  NetworkManager does not store
connections or settings, it is only the mechanism by which those connections
are selected and activated.

To store pre-defined network connections, two separate services, the "system
settings service" and the "user settings service" store connection information
and provide these to NetworkManager, also via D-Bus.  Each settings service
can determine how and where it persistently stores the connection information;
for example, the GNOME applet stores its configuration in GConf, and the system
settings service stores it's config in distro-specific formats, or in a distro-
agnostic format, depending on user/administrator preference.

A variety of other system services are used by NetworkManager to provide
network functionality: wpa_supplicant for wireless connections and 802.1x
wired connections, pppd for PPP and mobile broadband connections, DHCP clients
for dynamic IP addressing, dnsmasq for proxy nameserver and DHCP server
functionality for internet connection sharing, and avahi-autoipd for IPv4
link-local addresses.  Most communication with these daemons occurs, again,
via D-Bus.


Why doesn't my network Just Work?

Driver problems are the #1 cause of why NetworkManager sometimes fails to
connect to wireless networks.  Often, the driver simply doesn't behave in a
consistent manner, or is just plain buggy.  NetworkManager supports _only_
those drivers that are shipped with the upstream Linux kernel, because only
those drivers can be easily fixed and debugged.  ndiswrapper, vendor binary
drivers, or other out-of-tree drivers may or may not work well with
NetworkManager, precisely because they have not been vetted and improved by the
open-source community, and because problems in these drivers usually cannot
be fixed.

Sometimes, command-line tools like 'iwconfig' will work, but NetworkManager will
fail.  This is again often due to buggy drivers, because these drivers simply
aren't expecting the dynamic requests that NetworkManager and wpa_supplicant
make.  Driver bugs should be filed in the bug tracker of the distribution being
run, since often distributions customize their kernel and drivers.

Sometimes, it really is NetworkManager's fault.  If you think that's the case,
please file a bug at http://bugzilla.gnome.org and choose the NetworkManager
component.  Attaching the output of /var/log/messages or /var/log/daemon.log
(wherever your distribution directs syslog's 'daemon' facility output) is often
very helpful, and (if you can get) a working wpa_supplicant config file helps
enormously.