[Midnightbsd-cvs] src [11909] trunk/share/doc: add tests

[laffer1 at midnightbsd.org]

Revision: 11909
          http://svnweb.midnightbsd.org/src/?rev=11909
Author:   laffer1
Date:     2018-07-18 20:12:17 -0400 (Wed, 18 Jul 2018)
Log Message:
-----------
 add tests

Modified Paths:
--------------
    trunk/share/doc/Makefile

Added Paths:
-----------
    trunk/share/doc/pjdfstest/
    trunk/share/doc/pjdfstest/Makefile
    trunk/share/doc/pjdfstest/README

Modified: trunk/share/doc/Makefile
===================================================================
--- trunk/share/doc/Makefile	2018-07-19 00:11:14 UTC (rev 11908)
+++ trunk/share/doc/Makefile	2018-07-19 00:12:17 UTC (rev 11909)
@@ -8,8 +8,7 @@
 	${_atf} \
 	legal \
 	${_llvm} \
-	${_pjdfstest} \
-	${_roffdocs}
+	${_pjdfstest}
 
 .if ${MK_TESTS} != "no"
 _atf= atf

Added: trunk/share/doc/pjdfstest/Makefile
===================================================================
--- trunk/share/doc/pjdfstest/Makefile	                        (rev 0)
+++ trunk/share/doc/pjdfstest/Makefile	2018-07-19 00:12:17 UTC (rev 11909)
@@ -0,0 +1,9 @@
+# $MidnightBSD$
+# $FreeBSD: stable/10/share/doc/pjdfstest/Makefile 274016 2014-11-03 07:18:42Z ngie $
+
+NO_OBJ=
+
+FILESDIR=	${SHAREDIR}/doc/pjdfstest
+FILES=		README
+
+.include <bsd.prog.mk>


Property changes on: trunk/share/doc/pjdfstest/Makefile
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property
Added: trunk/share/doc/pjdfstest/README
===================================================================
--- trunk/share/doc/pjdfstest/README	                        (rev 0)
+++ trunk/share/doc/pjdfstest/README	2018-07-19 00:12:17 UTC (rev 11909)
@@ -0,0 +1,36 @@
+pjdfstest test suite execution is integrated into kyua. This README describes
+how to use pjdfstest in the default configuration (kyua work directory), and
+with a specific filesystem path.
+
+Method 1. Executing with default configuration (kyua work directory)
+
+    1. Elevate privileges:
+       % su -
+    2. cd to the tests directory:
+       % cd /usr/tests/sys/pjdfstest
+    3. Run kyua:
+       % kyua test
+
+   Executing the commands as shown above will run pjdfstest in the kyua work
+   directory. The kyua work directory defaults to a random generated path under
+   /tmp; please see TMPDIR in kyua(1) for more details on how the temporary path
+   is chosen with kyua.
+
+Method 2. Executing with a specific filesystem path (in this case /mnt)
+
+    1. Elevate privileges:
+       % su -
+    2. cd to the tests directory:
+       % cd /usr/tests/sys/pjdfstest
+    3. Run kyua:
+       % env PJDFSTEST_TEST_PATH=/mnt kyua test
+
+   WARNING: the above method violates the test program isolation algorithm
+   described in kyua(1); as such, $PJDFSTEST_TEST_PATH must be cleaned up after
+   executing the testcases.
+
+   It's highly recommended that $PJDFSTEST_TEST_PATH be pointed to a sandboxed
+   filesystem, e.g. a small UFS-formatted memory disk or ZFS dataset with
+   quotas enabled, so the filesystem can be easily destroyed after the test
+   execution is complete, and the testcases are properly bounded both in terms
+   of time and space.


Property changes on: trunk/share/doc/pjdfstest/README
___________________________________________________________________
Added: mnbsd:nokeywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property