mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-31 22:45:39 +00:00
Code Issues Releases Wiki Activity

Merge branch 'pspacek/doc-cleanup' into 'main'

Browse Source 
Developer docs cleanup

See merge request isc-projects/bind9!4527
This commit is contained in:
Petr Špaček
2022-01-18 16:20:55 +00:00
parent 3c5dbe5742 69d0fe9e72
commit 710f62bf39
1 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/dev/dev.md
View File

@@ -83,7 +83,7 @@ comments; they must be clearly written and consistent with existing style.
* Read the diff * Read the diff
* Read accompanying notes in the ticket * Read accompanying notes in the ticket
* Apply the diff to the appropriate branch * Apply the diff to the appropriate branch
* Run `configure` (using at least `--enable-developer --with-atf`) * Run `configure` (using at least `--enable-developer`)
* Build * Build
* Read the documentation, if any * Read the documentation, if any
* Read the tests * Read the tests
@@ -139,11 +139,11 @@ interfaces (as root):
$ sudo sh ifconfig.sh up $ sudo sh ifconfig.sh up
$ cd ../../.. $ cd ../../..
To run the tests, build BIND (be sure to use --with-atf to run unit To run the tests, build BIND (be sure to use --with-cmocka to run unit
tests), then run `make` `check`. An easy way to check the results: tests), then run `make` `check`. An easy way to check the results:
$ make check 2>&1 | tee /tmp/check.out $ make check 2>&1 | tee /tmp/check.out
$ grep '^R:' /tmp/check.out | sort | uniq -c $ grep -A 10 'Testsuite summary' /tmp/check.out
This will show all of the test results. One or two "R:SKIPPED" is okay; if This will show all of the test results. One or two "R:SKIPPED" is okay; if
there are a lot of them, then you probably forgot to create the loopback there are a lot of them, then you probably forgot to create the loopback
@@ -153,6 +153,10 @@ unit tests, so you can't rely on it to catch everything.)
To run only the system tests, omitting unit tests: To run only the system tests, omitting unit tests:
$ make test
Or:
$ cd bin/tests/system $ cd bin/tests/system
$ sh runall.sh $ sh runall.sh
@@ -221,9 +225,9 @@ in `rbt.c`. (There are exceptions to this rule, though; for instance,
different files in `lib/isc`.) different files in `lib/isc`.)
When BIND is built with unit tests, they will be run as part of When BIND is built with unit tests, they will be run as part of
`make` `check`. But if you want to run *only* the ATF unit tests: `make` `check`. But if you want to run *only* the unit tests:
$ sh unit/unittest.sh $ make unit
You can also run the unit tests for only one library: You can also run the unit tests for only one library: