man: add more (and simpler examples) to network.link(5)

doc: correct orthography, word forms and missing/extraneous words

doc: correct punctuation and improve typography in documentation

document ability to disable MACAddressPolicy While it is currently possible to either not set MACAddressPolicy or set it to a value different from "persistent" or "random", it is not obvious that a user can do so. Add a policy, "none", which simply retains kernel MAC addresses (same as not filling in the policy at all) and document it so that users are aware of this setting. Signed-off-by: Jacob Keller <jacob.keller@gmail.com>

man: include numeric prefixes in example file names for .link, .netdev, .network files In order to avoid confusion with the default files we ship, let's use a low prefix number for all examples. Fixes #1409.

man: describe masking of .network files better This should clear up some confusion in https://github.com/systemd/systemd/issues/717. This basically copies the description from systemd.unit to this man page. Masking can happen also in /run, so strike the part about /etc, and also add the magic work "mask".

man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.

man: systemd.link - explain random MAC addresses Two of the bits in the MAC address are set unconditioanlly, and the rest is randomized, make this clear in the documentation (as it currently read as if it was all random).

man: replace hard-coded /usr/lib Replace some /usr/lib occurences in man/ with &rootprefix;/lib.

man: generate configured paths in manpages In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.

man: boilerplate unification

net: support globbing and disjunction in Match logic Match{Name,OrginalName,Type,Driver,Path} can now take a space-separated glob of matches.

treewide: correct typos and use consistent "MAC" spelling

udev: net_setup - clarify reason for failure of persistent mac address policy

Reindent man pages to 2ch

man: mention that 99-default.link is shipped by default, and users hence need to install a lexically earlier .link file for it to be honoured

doc: add cross-references between systemd.{link, netdev, network}

tree-wide: spelling fixes https://github.com/vlajos/misspell_fixer https://github.com/torstehu/systemd/commit/b6fdeb618cf2f3ce1645b3315f15f482710c7ffa Thanks to Torstein Husebo <torstein@huseboe.net>.

udev: net_setup - allow matching on OriginalName= This has been requested repeatedly, so let's give it a go. We explicitly do not allow matching on names that have already been changed (from a previous udev run, or otherwise), and matching on unpredictable names (ethX) is discouraged (but not currently disallowed). We also currently allow: [Match] Name=veth0 [Link] Name=my-name0 SomeOtherSetting=true Which means that the link file will be applied the first time it is invoked, but not on subsequent invocations, which may be surprising.

s/commandline/command line/g

udev: link_setup - respect kernel name assign policy Newer kernels export meta-information about the origin of an ifname. Respect this from the ifname rename logic. We do not rename any interfaces that was originally named by userspace, nor once which have already been renamed from userspace. Moreover, we optionally do not (the default) rename interfaces which the kernel claims to have named in a predictable way.

man: split systemd.network(5) and related into various sections for better readability

doc: comma placement corrections and word order Set commas where there should be some. Some improvements to word order.

doc: corrections to words and forms This patch exchange words which are inappropriate for a situation, deletes duplicated words, and adds particles where needed.

doc: typographical fine tuning

man: fix example in systemd.link 'man/systemd.link.xml' recovery from: commit eac684ef1c29684b1bcd27a89c38c202e568e469 Author: Tom Gundersen <teg@jklm.no> Date: Tue Feb 25 19:30:40 2014 +0100 man: split out systemd.net{work,dev}(5) from systemd-networkd(8)

build-sys: update intructions for Makefile-man.am regeneration

man: split out systemd.net{work,dev}(5) from systemd-networkd(8)

man: split out systemd.link(5) from udev(7)