units: introduce new Documentation= field and make use of it everywhere

This should help making the boot process a bit easier to explore and
understand for the administrator. The simple idea is that "systemctl
status" now shows a link to documentation alongside the other status and
decriptionary information of a service.

This patch adds the necessary fields to all our shipped units if we have
proper documentation for them.

systemctl: drop useless DBus calls from 'systemctl show foo.service'

systemctl called LoadUnit, GetUnit, GetAll in this order to get the properties.

It is useless to load units explicitly, because it won't ensure anything. The
unit may be freed immediately by the garbage collector.

It is unnecessary to call GetUnit, because systemctl can easily translate the
unit name to DBus path by itself.

GetAll will load the unit if necessary.

dbus-unit: always load the unit before handling a message for it

We need to be able to show the properties even of inactive units.
systemctl loads the unit before getting its properties, but this is racy
as the garbage collector may kick in right after the loading.

Fix it by always loading the unit before handling a message for it.

https://bugzilla.redhat.com/show_bug.cgi?id=814966#c6

delta: drop PHP'ism

delta: don't highlight unchanged files

update TODO

delta: introduce arg_flags field, to follow our usual scheme

delta: use same nomenclature for equivalent and redirected everywhere

delta: enums are much cooler than defines

delta: Support filtering what type of deltas to show

Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.

The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.

As a side effect, in case of overriden files, the diff output was made
optional.

By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.

Signed-off-by: Gergely Nagy <algernon@balabit.hu>

delta: add preset dirs

delta: add missing files

switch-root: check for absolute paths

delta: add systemd-delta tool to find overriden configuration and unit files

udev: update docs, NEWS

udev: libudev - bump soname, remove deprecated functions, introduce symbol versions

build-sys: support build-from-git without gobject-introspection

build-sys: fix distcheck

tmpfiles: if we are supposed to write a string to a file, it's OK if we can't write the trailing newline

build-sys: fix build

build-sys: fix build for folks without gtk-doc installed

git: update gitignore

build-sys: move gtk-doc stuff into its own subdir and reindent autogen.sh

We moved most other build noise files into their own subdirs, so let's
do this for gtk-doc too

man: overwrite vs. override

'overwrite' conveys the idea of the old text being destroyed.
'override' does not. It is more similar to 'overrule'.

install: fix inverted meaning of '--force' in systemctl enable

missing: Fix broken syscall(__NR_fanotify_mark... on ppc32

The same situation as on o32 mips.

sd-login: update header docs a bit

namespace: make PrivateTmp= apply to both /tmp and /var/tmp

update TODO

systemctl: add switch-root verb

core: add extra safety check before switching root

job: info message if JOB_VERIFY_ACTIVE detects an inactive unit

job: report the status of first half of JOB_RESTART the same as JOB_STOP

unit: unit type dependent status messages

Instead of generic "Starting..." and "Started" messages for all unit use
type-dependent messages. For example, mounts will announce "Mounting..."
and "Mounted".

Add status messages to units of types that used to be entirely silent
(automounts, sockets, targets, devices). For unit types whose jobs are
instantaneous, report only the job completion, not the starting event.
Socket units with non-instantaneous jobs are rare (Exec*= is not used
often in socket units), so I chose not to print the starting messages
for them either.

This will hopefully give people better understanding of the boot.

unit: print the color status marks on the left

The alignment of the "[  OK  ]" and "[FAILED]" status marks to the right
side of the terminal makes it difficult to link them with the messages
on the left if your console is wide.

I considered the options:
 1. Align them to the 80th column regardless of the console width.
    Disadvantage - either:
    - truncating messages needlessly, not using available space; or
    - If the message is long, write the mark over it. => ugly
 2. Write them to the 80th column for short messages,
    and further to the right for longer ones.
    Disadvantage:
    - jagged look
 3. Write the marks on the left, before the message.
    Disadvantage:
    - Breaks tradition from RHL.
    Advantages:
    + slightly simpler code
    + Will annoy holy-traditionalists.

I chose option 3.
BTW, Debian now uses similar marks on the left with its makefile-style
boot.

Special values of the "status" argument to status_vprintf are:
  NULL - no status mark, no message indentation
  ""   - no status mark, message indented as if the mark was there

job: change red [ABORT] status to yellow [DEPEND]

The red "[ABORT]" for a dependency failure is too scary.
It suggests a crash. And it suggests a problem with the unit itself.
Change it to a yellow "[DEPEND]" message. The color communicates the
level of seriousness better.

job: only jobs on the runqueue can be run

units: do not quit plymouth too early

keymap: Add Mio N890

https://launchpad.net/bugs/998621

update mailmap for Martin Pitt

udev: path_id - cciss - set "we have a bus" flag

udev: path_id - add cciss support

dbus-manager: fix tainted string

The pointer to the end of the string was not advanced after adding
the "cgroups-missing" taint. If "local-hwclock" was detected too,
it would overwrite the previous string.

With 'e' always pointing to the end of the string, removing the last
delimiter is easier.

main: fix uninitialized variable

main: fix assertion failure due to use of ELEMENTSOF on a non-array

bash-completion: use printf instead of echo

If the expanded argument begins with '-', echo would try to interpret
it as options.
printf does not have this problem. Use it everywhere.

bash-completion: avoid losing backslashes in unit names

Use 'read -r' everywhere to consider backslashes as parts of the input line.
Single-quote the arguments to 'compgen -W' to avoid immediate expansion.
compgen itself will expand the argument.

Fixes a possible reason for "Failed to issue method call: Unknown unit"
after requesting completion.

https://bugzilla.redhat.com/show_bug.cgi?id=814966

update TODO

util: a few updates for rm_rf()

manager: introduce SwitchRoot bus call for initrd/main transition

path-util: there is no function path_parent()

main: simplify+unify logic for parsing runtime booleans

logind: implement suspend/hibernate calls with inhibition logic

sleep: implement suspend/hibernate as first class targets

logind: use "sleep" as generic term for "suspend", "hibernate", and later on "hybrid suspend"

logind: fix test-inhibit

autogen.sh: undef _FORTIFY_SOURCE, which now logs warnings when used with -O0

util: split-out path-util.[ch]

util: split-out hwclock.[ch]

logind: fix memory leak

update TODO

Update TODO

util: split-out conf-file.[ch]

udev: path_id - skip PCI-only-parents for block devices

udev: use conf_files_list() to search rules files

conf_files_list(): split out conf_files_list_strv()

conf_files_list(): files-add() - do not canonicalize file names

File names in /etc, /run, /usr/lib are sorted/overridden by basename.
Sorting things like "/dev/null" with the basename "null" in the hash
of config files breaks the ordering and the overriding logic.

logind: implement delay inhibitor locks in addition to block inhibitor locks

This is useful to allow applications to synchronously save data before
the system is suspended or shut down.

update TODO

udev: fix the ENV{} blacklist logic

systemctl: fix typo

as Sergey Ptashnick pointed out we should write "poweroff" once instead
of "reboot" twice.

systemd-analyze: add a --user option to support user instances

man: clarify _TRANSPORT

"resp." where it was confuses reader that stdout and stderr might go to differn't places

update TODO

readahead: store inode numbers in pack file

If the inode nr for each file is available in the pack file we can
easily detect replaced files (like they result from package upgrades)
which we can then skip to readahead.

units: use OOMScoreAdjust= in the unit files to set OOM score adjust

readhead: temporarily lower the kernel's read_ahead_kb setting while collecting

While collecting readahead data we want to know exactly what userspace
accesses unblurred by the kernel's read_ahead_kb. Hence lower this
during collection, and raise it afterwards.

This is mostly based on ideas and code by Auke Kok.

cgroup: fix alloca() misuse in cg_shorten_controllers()

dbus: handle invalid enum values better

dbus: include unit name in JobNew/JobRemoved signals

This breaks D-Bus interface slightly, but since the D-Bus API isn't
covered by the interface stability promise this should be OK.

service: explicitly remove control/ subcgroup after each control command

The kernel will only notify us of cgroups running empty if no subcgroups
exist anymore. Hence make sure we don't leave our own control/ subcgroup
around longer than necessary.

https://bugzilla.redhat.com/show_bug.cgi?id=818381

systemctl: allow 'systemctl reboot -ff' to succeed even without D-Bus

systemctl: print a nice error message if an unprivileged user calls systemctl reboot -ff

systemctl: get rid of arg_immediate and fold it into arg_force

rc-local-generator: hook halt-local in based on generator too

hwclock: add taint flag for non-local hwclock

vconsole: fix some error messages

units: explicit Type=dbus is now redundant

service: default to Type=dbus if BusName= is specified

service: warn if a dbus name is specified but the service type is not dbus

vconsole: fix error messages

https://bugs.freedesktop.org/show_bug.cgi?id=49192

update TODO

man: fix typo

units: make sure /var is writable before initializing random seed

TODO

unit: add new dependency type RequiresMountsFor=

RequiresMountsFor= is a shortcut for adding requires and after
dependencies to all mount units neeed for the specified paths.

This solves a couple of issues regarding dep loop cycles for encrypted
swap.

service: document new Type=idle

update TODO

update TODO

udev: use container_of() macro