summaryrefslogtreecommitdiffstats
path: root/man/resolvectl.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* resolvconf: disable default route when -p is specifiedYu Watanabe2024-08-261-2/+11
| | | | | | Internally, the switch triggers 'resolvectl default-route INTERFACE no'. Closes #34112.
* man: use standard-options for --no-ask-password everywhereMike Yuan2024-08-211-10/+1
|
* resolvectl: introduce --no-ask-password optionYu Watanabe2024-08-191-0/+10
|
* man: fix incorrect XML in man pageSam Leonard2024-04-151-17/+17
|
* resolvectl: expose new SD_RESOLVED_RELAX_SINGLE_LABEL flag in resolvectlLennart Poettering2024-03-051-0/+15
|
* resolvectl: add JSON output support for "resolvectl query"Lennart Poettering2024-01-311-9/+4
| | | | | | | | | | | | | | | It's easy to add. Let's do so. This only covers record lookups, i.e. with the --type= switch. The higher level lookups are not covered, I opted instead to print a message there to use --type= instead. I am a bit reluctant to defining a new JSON format for the high-level lookups, hence I figured for now a helpful error is good enough, that points people to the right use. Fixes: #29755
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: use <simplelist> for 'See also' sectionsDavid Tardon2023-12-231-7/+7
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* man: use meaningful titles for <ulink>sZbigniew Jędrzejewski-Szmek2023-11-061-11/+11
| | | | | | | | | | | | | | | | | | | | | | | | As pointed out in https://github.com/systemd/systemd/issues/29814, we need to use phrases are are meaningful on their own, because the man page formatter creates a list at the bottom. With <ulink>see docs</ulink>, we end up with: NOTES: 1. see docs https://some.url/page 2. see docs https://some.url/page2 which is not very useful :( Also, the text inside the tag should not include punctuation. Python helper: from xml_helper import xml_parse for p in glob.glob('../man/*.xml'): t = xml_parse(p) ulinks = t.iterfind('.//ulink') for ulink in ulinks: if ulink.text is None: continue text = ' '.join(ulink.text.split()) print(f'{p}: {text}')
* man: update version informationAbderrahim Kitouni2023-09-191-0/+2
| | | | | | | | As I noticed a lot of missing information when trying to implement checking for missing info. I reimplemented the version information script to be more robust, and here is the result. Follow up to ec07c3c80b2b1bfa6788500202006ff85f5ae4f4
* man: add version infoAbderrahim Kitouni2023-08-291-36/+110
| | | | | | | | This tries to add information about when each option was added. It goes back to version 183. The version info is included from a separate file to allow generating it, which would allow more control on the formatting of the final output.
* resolved: added show-server-state verb and DumpStatistics varlink methodKiran Vemula2023-07-301-0/+7
| | | | | Added show-server-state verb to resolvectl Added DumpStatistics and ResetStatistics methods to varlink
* resolved: added serve stale feature implementation of RFC 8767Kiran Vemula2023-06-161-0/+8
| | | | | | | serve stale feature to keep the DNS resource records beyond TTL to return them as stale records in case of upstream server is not reachable or returns negative response. SD_RESOLVED_NO_STALE flag has been added to disable serving stale records via dbus. added serve stale test cases to TEST-75-RESOLVED Fixes: #21815
* resolvectl: add resolvectl command for dumping cache contentsLennart Poettering2023-06-121-0/+7
| | | | | A wrapper around the new varlink call, showing the data either in its native JSON or in a more human readable textual form.
* resolved: introduce the _localdnsstub and _localdnsproxy special hostnames ↵Lennart Poettering2022-11-251-5/+6
| | | | | | | | | for 127.0.0.54 + 127.0.0.53 Let's give these special IP addresses names. After all name resolution is our job here. Fixes: #23623
* resolve: fix typoYu Watanabe2022-10-031-1/+1
|
* resolvectl: add new "monitor" verbLennart Poettering2022-09-301-1/+22
|
* resolvectl man page: Word correctionFrank Dana2022-07-071-1/+1
|
* Revert "Add systemd-resolve backwards compatibility section to resolvectl docs"Lennart Poettering2021-07-071-13/+0
| | | | This reverts commit 9fcfc0470df856c870dcfc6df78bfbc714da6bd2.
* man: fix typoYu Watanabe2021-06-301-1/+1
|
* Add systemd-resolve backwards compatibility section to resolvectl docsDan Streetman2021-06-291-0/+13
|
* man: add markup to dns resource record labelsZbigniew Jędrzejewski-Szmek2021-06-291-31/+45
|
* man: document _outboundLennart Poettering2021-04-231-5/+5
|
* Update resolvectl.xmlulf-f2021-03-111-1/+1
| | | fixed typo of filename
* tree-wide: fix typoYu Watanabe2021-02-191-1/+1
|
* resolvectl: clarify IDNA and search path logic in combination with ↵Lennart Poettering2021-02-161-9/+31
| | | | | | | | | | | | | | | | | "resolvectl query --type=" When low-level RR resolution is requested from "resolvectl query" via "--type=" or "--class=" no search domain logic is applied and no IDNA translation. Explain this in detail in the documentation, and also mentions this when users attempt to resolve single-label names or names with international characters in the output. I believe the current behaviour is correct, but it is indeed surprising. Hence the documentation and output improvement. Fixes: #11325 #10737
* resolvectl: add support for various new flagsLennart Poettering2021-02-151-0/+59
|
* Revert "resolvectl: Add show-multicast verb to show discovered LLMNR/mDNS hosts"Lennart Poettering2021-02-051-7/+0
|
* resolve: Add show-multicast verbDaan De Meyer2021-01-311-0/+7
| | | | | The show-multicast verb calls the GetMulticastHosts() D-Bus method and displays all its results formatted into a table.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: update explanation about the format to specify DNS serversYu Watanabe2020-07-201-9/+14
|
* man: fix links to various external man pagesZbigniew Jędrzejewski-Szmek2020-06-251-4/+4
| | | | | In cases where we used both die-net and man-pages for the same reference, I switched to use man-pages everywhere.
* tree-wide: use "hostname" spelling everywhereZbigniew Jędrzejewski-Szmek2020-04-211-1/+1
| | | | | | | | 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.
* Merge pull request #15495 from keszybz/resolve-debugging-and-stub-handlingLennart Poettering2020-04-211-0/+1
|\ | | | | Resolve debugging and stub handling
| * resolve: allow setting the log level dynamically as in pid1Zbigniew Jędrzejewski-Szmek2020-04-201-0/+1
| | | | | | | | | | | | | | This is useful to raise the log level for a single transaction or a few, without affecting other state of the resolved as a restart would. The log level can only be set, I didn't bother with having the ability to restore the original as in pid1.
* | man: use manpages.ubuntu.com for resolvconf(8) linkZbigniew Jędrzejewski-Szmek2020-04-201-3/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add manpages.debian.org as a man citeref "project", so we can refer to man pages hosted there. resolvconf(8) doesn't seem to appear on any of the ones we currently have defined. We are doing a trick, where our man page is installed as resolvconf(1), and we refer the reader to resolvconf(8). This can be pretty confusing, so the least we can do is to provide a non-broken symlink ;) v2: - link to manpages.d.o instead of manpages.ubuntu.com, because debian is the upstream here, and because with debian we can use /unstable/ as the version, and ubuntu doesn't seem to have any such shortcut, so the version would need to be periodically updated.
* | man: add a note that resolvconf updates /etc/resolv.conf in specific ↵Zbigniew Jędrzejewski-Szmek2020-04-191-2/+10
|/ | | | | | | | | | circumstances When someone knows how the whole ecosystem works, this is understandable. But for someone coming from a system where resolvconf updates /etc/resolv.conf directly, this can be rather surprising. For https://bugzilla.redhat.com/show_bug.cgi?id=1815605.
* man: use <command> not <option> for commands in resolvectl(1)Zbigniew Jędrzejewski-Szmek2019-11-211-39/+45
|
* Move the Commands section above Options sectionZbigniew Jędrzejewski-Szmek2019-10-081-109/+109
| | | | | | | For executables which take a verb, we should list the verbs first, and then options which modify those verbs second. The general layout of the man page is from general description to specific details, usually Overview, Commands, Options, Return Value, Examples, References.
* man: fix typo in resolvectl(1) man pageRonan Pigott2019-08-061-1/+1
|
* resolvectl: support networkd managed interfacesYu Watanabe2019-07-161-5/+2
| | | | Closes #9808.
* codespell: fix spelling errorsBen Boeckel2019-04-291-1/+1
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-2/+2
| | | | | | | 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
* resolvectl: add support for reading/writing per-link 'default-route' booleanLennart Poettering2018-12-211-9/+14
|
* doc: fix resolvectl(1) per-interface DNS configuration documentationDaniel Kahn Gillmor2018-08-231-18/+19
| | | | | | | | You can only have one listitem in each varlistentry. xmllint says: resolvectl.xml:269: element varlistentry: validity error : Element varlistentry content does not follow the DTD, expecting (term+ , listitem), got (term term term term term term term listitem listitem listitem )
* resolvectl: Take empty string argument to clear lists in "dns", "domain" and ↵Filipe Brandenburger2018-07-171-2/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | "nta" options The current CLI does not support a way to clear these lists, since without any additional arguments, the command will list the current values. Introduce a new way to clear the lists by passing a single '' argument to these subcommands. Update the man page to document this. Tested: $ build/resolvectl domain eth1 Link 3 (eth1): ~. $ build/resolvectl domain eth1 '' $ build/resolvectl domain eth1 Link 3 (eth1): $ build/resolvectl domain eth1 '~.' '~example.com' $ build/resolvectl domain eth1 Link 3 (eth1): ~. ~example.com $ build/resolvectl domain eth1 '' $ build/resolvectl domain eth1 Link 3 (eth1): $ build/resolvectl domain eth1 '~.' $ build/resolvectl domain eth1 Link 3 (eth1): ~. And similar for "dns" and "nta".
* 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: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* 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.
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-04 01:21:27 +0100