[src/trunk]: src/external/cddl/osnet/usr.bin/ztest Describe how unaccounted c...

[sevan <sevan%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/981419cf8101
branches:  trunk
changeset: 995162:981419cf8101
user:      sevan <sevan%NetBSD.org@localhost>
date:      Mon Dec 10 03:58:30 2018 +0000

description:
Describe how unaccounted changes are detected without Star Trek references, for
everyone in 2018.

Thanks to maya & gdt

diffstat:

 external/cddl/osnet/usr.bin/ztest/ztest.1 |  13 +++++++++++--
 1 files changed, 11 insertions(+), 2 deletions(-)

diffs (34 lines):

diff -r f80bc464ad6a -r 981419cf8101 external/cddl/osnet/usr.bin/ztest/ztest.1
--- a/external/cddl/osnet/usr.bin/ztest/ztest.1 Mon Dec 10 00:31:45 2018 +0000
+++ b/external/cddl/osnet/usr.bin/ztest/ztest.1 Mon Dec 10 03:58:30 2018 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: ztest.1,v 1.3 2018/12/08 14:55:53 sevan Exp $
+.\"     $NetBSD: ztest.1,v 1.4 2018/12/10 03:58:30 sevan Exp $
 .\"
 .\" Copyright (c) 2018 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"/
-.Dd December 8, 2018
+.Dd December 10, 2018
 .Dt ZTEST 1
 .Os
 .Sh NAME
@@ -75,6 +75,15 @@
 processes are killed at random with a SIGKILL signal, after which the parent
 process invokes a new child to run the test again on the same storage pool.
 .Pp
+Many of the tests record the transaction group number as part of their data.
+When reading old data, tests verify that the transaction group number is less
+than the current, open state, transaction group to ensure the consistency of
+tests and detect unaccounted changes.
+It is advised that any new tests added to
+.Nm
+should also perform the same check with transaction group numbers, if
+applicable.
+.Pp
 The main
 .Nm
 process uses an