summaryrefslogtreecommitdiff
path: root/man/systemd-resolved.service.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: add description of org.freedesktop.LogControl1Zbigniew Jędrzejewski-Szmek2020-05-051-0/+2
| | | | | | I'm not sure if the LogTarget property is sufficiently general to be made into a property that can be generally implemented. It is very closely tied to the internal systemd logic. The other two seem fine thoough.
* man: add a description of handling of single-label namesZbigniew Jędrzejewski-Szmek2020-04-231-29/+54
| | | | | | | | | | | | | | | | It turns out that our man page didn't describe the handling of single-label names almost at all. This probably adds to the confusion regarding the subject. So let's first describe what our current implementation is doing. Quoting https://www.iab.org/documents/correspondence-reports-documents/2013-2/iab-statement-dotless-domains-considered-harmful/: > Applications and platforms that apply a suffix search list to a single-label > name are in conformance with IETF standards track RFCs. Furthermore, > applications and platforms that do not query DNS for a TLD are in conformance > with IETF standards track recommendations Current behaviour is in line with that recommendation. For #13763.
* tree-wide: use "hostname" spelling everywhereZbigniew Jędrzejewski-Szmek2020-04-211-3/+3
| | | | | | | | It's not that I think that "hostname" is vastly superior to "host name". Quite the opposite — the difference is small, and in some context the two-word version does fit better. But in the tree, there are ~200 occurrences of the first, and >1600 of the other, and consistent spelling is more important than any particular spelling choice.
* man: reindent nss-resolve(8)Zbigniew Jędrzejewski-Szmek2020-04-201-145/+154
|
* man: import org.freedesktop.resolve1(3) from the wikiZbigniew Jędrzejewski-Szmek2020-04-161-5/+6
|
* codespell: fix spelling errorsBen Boeckel2019-04-291-1/+1
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* man: flush-caches and reset-server-features are commands for resolvectl (#11877)Yu, Li-Yu2019-03-031-2/+2
|
* man: document new systemd-resolved.service(8) routing features in more detailLennart Poettering2018-12-211-7/+36
|
* man: split long section in systemd-resolved.service man page into threeLennart Poettering2018-12-211-4/+15
| | | | Also, do some minor updating.
* man: drop mode line in file headersZbigniew Jędrzejewski-Szmek2018-07-031-1/+1
| | | | | This is already included in .dir-locals, so we don't need it in the files themselves.
* tree-wide: drop copyright headers from frequent contributorsZbigniew Jędrzejewski-Szmek2018-06-201-2/+0
| | | | | | | | Fixes #9320. for p in Shapovalov Chevalier Rozhkov Sievers Mack Herrmann Schmidt Rudenberg Sahani Landden Andersen Watanabe; do git grep -e 'Copyright.*'$p -l|xargs perl -i -0pe 's|/([*][*])?[*]\s+([*#]\s+)?Copyright[^\n]*'$p'[^\n]*\s*[*]([*][*])?/\n*|\n|gms; s|\s+([*#]\s+)?Copyright[^\n]*'$p'[^\n]*\n*|\n|gms' done
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: beautify remaining copyright statementsLennart Poettering2018-06-141-1/+1
| | | | | | Let's unify an beautify our remaining copyright statements, with a unicode ©. This means our copyright statements are now always formatted the same way. Yay.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* resolved: use Oxford comma at once placeLennart Poettering2018-06-081-1/+1
| | | | As suggested by @keszybz in https://github.com/systemd/systemd/pull/9235#pullrequestreview-127150950
* resolved: document .local domain routing a bit more in detailLennart Poettering2018-06-081-23/+29
| | | | | Inspired by the discussions in #8851, even though the issue appears to be entirely unrelated to the .local domain in the end.
* man: create man page for resolvectlYu Watanabe2018-04-191-3/+3
|
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: fix reference to gateway hostname (#7258)Alessandro Ghedini2017-11-071-2/+2
| | | | Follow-up to commit 1dc92a06e210a978e54c72168aaaa7487bf2fd2a which didn't catch all cases.
* resolved: create private stub resolve file for /etc/resolv.conf integration ↵Dimitri John Ledkov2017-10-241-3/+15
| | | | | | | | | | | (#7014) This creates a second private resolve.conf file which lists the stub resolver and the resolved acquired search domains. This runtime file should be used as a symlink target for /etc/resolv.conf such that non-nss based applications can resolve search domains. Fixes: #7009
* resolved: include DNS server feature level info in SIGUSR1 status dumpLennart Poettering2017-10-051-2/+3
| | | | let's make the status dump more useful for tracking down server issues.
* resolved: add support for explicitly forgetting everything we learnt about ↵Lennart Poettering2017-10-051-6/+24
| | | | | | | | | DNS server feature levels This adds "systemd-resolve --reset-server-features" for explicitly forgetting what we learnt. This might be useful for debugging purposes, and to force systemd-resolved to restart its learning logic for all DNS servers.
* build-sys: s/ENABLE_RESOLVED/ENABLE_RESOLVE/Zbigniew Jędrzejewski-Szmek2017-10-041-1/+1
| | | | | | The configuration option was called -Dresolve, but the internal define was …RESOLVED. This options governs more than just resolved itself, so let's settle on the version without "d".
* doc/systemd-resolved.service: fix typo (#6422)Lion Yang2017-07-211-1/+1
| | | DNS sever => DNS server
* man: use https:// in URLsAsciiWolf2017-02-211-2/+2
|
* resolved: correctly handle non-address RR types with /etc/hosts lookups (#4808)Martin Pitt2016-12-221-2/+3
| | | | | | | | | | | | | | | Fix wrong condition test in manager_etc_hosts_lookup(), which caused it to return an IPv4 answer when an IPv6 question was asked, and vice versa. Also only return success if we actually found any A or AAAA record. In systemd-resolved.service(8), point out that /etc/hosts mappings only affect address-type lookups, not other types. The test case currently disables DNSSEC in resolved, as there is a bug where "-t MX" fails due to "DNSSEC validation failed" even after "downgrading to non-DNSSEC mode". This should be dropped once that bug gets fixed. Fixes #4801
* man: provide html links to a bunch of external man pagesZbigniew Jędrzejewski-Szmek2016-08-061-4/+4
|
* man: minor man page fixLennart Poettering2016-07-251-4/+4
| | | | | | Addressing: https://github.com/systemd/systemd/commit/b541146bf8c34aaaa9efcf58325f18da9253c4ec#commitcomment-17997074
* Drop parentheses in two placesZbigniew Jędrzejewski-Szmek2016-07-171-2/+2
|
* man: beef up resolved man pageLennart Poettering2016-06-211-23/+72
| | | | Let's explain the various APIs and various ways to handle /etc/resolv.conf.
* man: document what SIGUSR1 and SIGUSR2 do to resolvedLennart Poettering2016-06-101-0/+22
|
* *.localdomain != localhostDavid R. Hedges2016-04-041-3/+4
| | | | | | | | | | | | | | | | | | | ".localdomain" is not a reserved suffix (or prefix). I'm not aware of any product expecting *.localdomain to resolve to localhost, however I am aware of at least one product that defaults to ".localdomain" as its DNS suffix provided via DHCP (pfSense). This leads to unexpected results when attempting to access a host that's offline (or a host that's online, when nsswitch.conf is [mis-]configured to have myhostname ahead of DNS). Operate on: localhost (and localhost.) *.localhost (and *.localhost.) localhost.localdomain (and localhost.localdomain.) *.localhost.localdomain (and *.localhost.localdomain.) We should not cover: *.localdomain (nor *.localdomain.) localdomain (nor localdomain.)
* man: document that resolved cares about /etc/hostsLennart Poettering2016-02-111-0/+4
|
* man: document that nss-myhostname handles *.localhost and *.localdomain tooLennart Poettering2016-02-101-3/+3
| | | | | | (And similar for resolved) Fixes: #1630
* man: link resolved bus API documentation from its man pageLennart Poettering2016-02-091-0/+4
| | | | This is similar how we already do it for logind or machined.
* man: fix references to a few external man pagesZbigniew Jędrzejewski-Szmek2016-01-271-1/+1
| | | | Noticed in pull request #2067.
* man: document systemd-resolve(8)Lennart Poettering2016-01-251-14/+13
| | | | This also links up the new manpage from systemd-resolved.service(8), and makes a couple of unrelated additions.
* man: add documentation for dnssec-trust-anchors.d(5)Lennart Poettering2016-01-051-0/+2
|
* man: fix typosJakub Wilk2015-12-261-1/+1
|
* doc: correct orthography, word forms and missing/extraneous wordsJan Engelhardt2015-11-061-1/+1
|
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-3/+3
|
* man: Document that resolved requires nss-resolve to work with libcLennart Poettering2015-08-281-6/+14
| | | | Closes #884.
* man: document resolved's RR synthesizing and query routingLennart Poettering2015-08-261-1/+56
|
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-5/+2
| | | | | | | | | | | | | | | | | | | | | | | 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: generate configured paths in manpagesFilipe Brandenburger2015-05-281-2/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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.
* Reindent man pages to 2chZbigniew Jędrzejewski-Szmek2015-02-031-65/+64
|
* man: minimal updates to resolved.conf man pageLennart Poettering2014-08-121-3/+5
|