aboutsummaryrefslogtreecommitdiff
path: root/_www/doc
AgeCommit message (Collapse)Author
2026-03-26all: refactoring DoT and DoH to use listen address instead portHEADmaindevShulhan
Using port makes the IP address of DoT and DoH listen on the same address with UDP. If we set ListenAddress to 0.0.0.0 and TLS termination is handled by proxy, this cause DoT and DoH will also listen on all addresses. This behaviour makes the server open DoT and DoH ports to the public, where it should be on local address only.
2026-02-03all: add option to set minimum TTLShulhan
In the rescached.cfg, we add option where user can force the minimum TTL in the DNS answer. This option is not a standard and not recommended used in public facing network. It should be used only for personal and private network.
2026-01-25_www/doc: escape the links in the documentationShulhan
For link as an example or does not exist, escaped it from being rendered into anchor.
2025-07-04all: cleaning README and expand the index in documentationShulhan
In the README, we remove the EXIT STATUS and AUTHOR sections. Those sections are not informative. In the index, we expand the preamble to include short information about what is rescached.
2024-07-15_www/doc: update TODO listShulhan
Remove items that has been finished or not related to current implementation.
2024-03-21all: move repository to SourceHutShulhan
2022-08-25_www/doc: update the index and resolver documentationShulhan
While at it, rename the README.adoc to README and made symlink to it as README.adoc.
2022-08-06_www/doc: format documentation for resolverShulhan
Some block code in the examples are not formatted correctly due to spaces.
2022-06-12_www: refactoring, various bug fixes and cleanupsShulhan
On refactoring, - standardize the method names on the rescached.js to match with the Client, for example prefixing block.d operations with Blockd. - use the GET /block.d, GET /hosts.d, GET /zone.d to fetch the resources instead of using GET /environment for all. On bug fixes, - fix updating SOA record on zone.d due to refactoring
2022-05-22cmd/resolver: implement command to list hosts in block.dShulhan
Given the following command $ resolver block.d It will print all hosts in block.d in the JSON format, for example { "pgl.yoyo.org": { "Name": "pgl.yoyo.org", "URL": "http://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts\u0026showintro=0\u0026startdate[day]=\u0026startdate[month]=\u0026startdate[year]=\u0026mimetype=plaintext", "LastUpdated": "2022-04-20 01:54:30 WIB", "IsEnabled": false }, "someonewhocares.org": { "Name": "someonewhocares.org", "URL": "http://someonewhocares.org/hosts/hosts", "LastUpdated": "2022-04-20 00:53:22 WIB", "IsEnabled": false }, "winhelp2002.mvps.org": { "Name": "winhelp2002.mvps.org", "URL": "http://winhelp2002.mvps.org/hosts.txt", "LastUpdated": "2022-04-20 01:35:38 WIB", "IsEnabled": false } }
2022-05-22cmd/resolver: add command to print the program versionShulhan
Executing "resolver version" will print the current version based on the latest tag, number of commit, and latest commit hash: v<TAG>.r<number-of-commit>.<commit-hash>
2022-05-22cmd/resolver: changes the help flag to commandShulhan
Executing "resolver help" will print the command usage.
2022-05-22all: simplify cmd/resolver documentationShulhan
It is hard to keep the documentation in sync between manual page, the Go documentation, and command line usage. A changes in manual page need to be copied into two different places. To simplify this, we make the Go doc comment as summary and the command line usage is set from output of `go tool doc ./cmd/resolver`.
2022-05-22all: move the documentation under _www/doc directoryShulhan
This also allow the latest/released documentation viewed on the web user interface under /doc path. While at it, reformat HTML and CSS files using js-beautify and JavaScript files using clang-format [1]. [1] https://google.github.io/styleguide/jsguide.html#formatting