system/freebsd-src
system/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src synced 2024-10-15 12:54:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

Delete mentions to removed manpages

Browse source 
Obtained from:  atf (git 23c570d6f393c76dff041360bb5f7779900c7191)
This commit is contained in:
Craig Rodrigues 2014-09-23 22:29:03 +00:00
parent 4c998508be
commit b9306c0473
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=272049
7 changed files with 47 additions and 59 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
contrib/atf/atf-c++/atf-c++-api.3
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd November 15, 2013 .Dd March 2, 2014
.Dt ATF-C++-API 3 .Dt ATF-C++-API 3
.Os .Os
.Sh NAME .Sh NAME
@ -330,9 +330,8 @@ If
.Va exitcode .Va exitcode
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the exit code of the test case
will validate that the exit code of the test case matches the one provided matches the one provided in this call.
in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn expect_fail "reason" .It Fn expect_fail "reason"
Any failure (be it fatal or non-fatal) raised in this mode is recorded. Any failure (be it fatal or non-fatal) raised in this mode is recorded.
@ -368,9 +367,8 @@ If
.Va signo .Va signo
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the signal that terminated the test
will validate that the signal that terminated the test case matches the one case matches the one provided in this call.
provided in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn expect_timeout "reason" .It Fn expect_timeout "reason"
Expects the test case to execute for longer than its timeout. Expects the test case to execute for longer than its timeout.
@ -631,5 +629,4 @@ ATF_INIT_TEST_CASES(tcs)
.Ed .Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-test-program 1 , .Xr atf-test-program 1 ,
.Xr atf-test-case 4 , .Xr atf-test-case 4
.Xr atf 7

15
contrib/atf/atf-c/atf-c-api.3
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd November 15, 2013 .Dd March 2, 2014
.Dt ATF-C-API 3 .Dt ATF-C-API 3
.Os .Os
.Sh NAME .Sh NAME
@ -409,9 +409,8 @@ If
.Va exitcode .Va exitcode
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the exit code of the test case
will validate that the exit code of the test case matches the one provided matches the one provided in this call.
in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn atf_tc_expect_fail "reason" "..." .It Fn atf_tc_expect_fail "reason" "..."
Any failure (be it fatal or non-fatal) raised in this mode is recorded. Any failure (be it fatal or non-fatal) raised in this mode is recorded.
@ -443,9 +442,8 @@ If
.Va signo .Va signo
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the signal that terminated the test
will validate that the signal that terminated the test case matches the one case matches the one provided in this call.
provided in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn atf_tc_expect_timeout "reason" "..." .It Fn atf_tc_expect_timeout "reason" "..."
Expects the test case to execute for longer than its timeout. Expects the test case to execute for longer than its timeout.
@ -771,5 +769,4 @@ ATF_TP_ADD_TCS(tp)
.Ed .Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-test-program 1 , .Xr atf-test-program 1 ,
.Xr atf-test-case 4 , .Xr atf-test-case 4
.Xr atf 7

16
contrib/atf/atf-sh/atf-check.1
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd June 27, 2010 .Dd March 2, 2014
.Dt ATF-CHECK 1 .Dt ATF-CHECK 1
.Os .Os
.Sh NAME .Sh NAME
@ -118,15 +118,20 @@ Analyzes standard error (syntax identical to above)
Executes Executes
.Ar command .Ar command
as a shell command line, executing it with the system shell defined by as a shell command line, executing it with the system shell defined by
.Va ATF_SHELL .Va ATF_SHELL .
in
.Xr atf-config 1 .
You should avoid using this flag if at all possible to prevent shell quoting You should avoid using this flag if at all possible to prevent shell quoting
issues. issues.
.El .El
.Sh EXIT STATUS .Sh EXIT STATUS
.Nm .Nm
exits 0 on success, and other (unspecified) value on failure. exits 0 on success, and other (unspecified) value on failure.
.Sh ENVIRONMENT
.Bl -tag -width ATFXSHELLXX -compact
.It Va ATF_SHELL
Path to the system shell to be used when the
.Fl x
is given to run commands.
.El
.Sh EXAMPLES .Sh EXAMPLES
.Bd -literal -offset indent .Bd -literal -offset indent
# Exit code 0, nothing on stdout/stderr # Exit code 0, nothing on stdout/stderr
@ -146,6 +151,3 @@ atf-check -s signal:sigsegv my_program
# Combined checks # Combined checks
atf-check -o match:foo -o not-match:bar echo foo baz atf-check -o match:foo -o not-match:bar echo foo baz
.Ed .Ed
.Sh SEE ALSO
.Xr atf-config 1 ,
.Xr atf 7

15
contrib/atf/atf-sh/atf-sh-api.3
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd October 13, 2013 .Dd March 2, 2014
.Dt ATF-SH-API 3 .Dt ATF-SH-API 3
.Os .Os
.Sh NAME .Sh NAME
@ -224,9 +224,8 @@ If
.Va exitcode .Va exitcode
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the exit code of the test case
will validate that the exit code of the test case matches the one provided matches the one provided in this call.
in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn atf_expect_fail "reason" .It Fn atf_expect_fail "reason"
Any failure raised in this mode is recorded, but such failures do not report Any failure raised in this mode is recorded, but such failures do not report
@ -258,9 +257,8 @@ If
.Va signo .Va signo
is not is not
.Sq -1 , .Sq -1 ,
.Xr atf-run 1 the runtime engine will validate that the signal that terminated the test
will validate that the signal that terminated the test case matches the one case matches the one provided in this call.
provided in this call.
Otherwise, the exact value will be ignored. Otherwise, the exact value will be ignored.
.It Fn atf_expect_timeout "reason" "..." .It Fn atf_expect_timeout "reason" "..."
Expects the test case to execute for longer than its timeout. Expects the test case to execute for longer than its timeout.
@ -339,5 +337,4 @@ atf_check -s exit:0 -o match:"^foo$" -e empty 'ls'
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-sh 1 , .Xr atf-sh 1 ,
.Xr atf-test-program 1 , .Xr atf-test-program 1 ,
.Xr atf-test-case 4 , .Xr atf-test-case 4
.Xr atf 7

17
contrib/atf/atf-sh/atf-sh.1
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd October 15, 2013 .Dd March 2, 2014
.Dt ATF-SH 1 .Dt ATF-SH 1
.Os .Os
.Sh NAME .Sh NAME
@ -47,10 +47,8 @@ library.
.Pp .Pp
.Nm .Nm
is not a real interpreter though: it is just a wrapper around is not a real interpreter though: it is just a wrapper around
the system-wide shell defined by the the system-wide shell defined by
.Sq atf_shell .Va ATF_SHELL .
configuration value in
.Xr atf-config 1 .
.Nm .Nm
executes the interpreter, loads the executes the interpreter, loads the
.Xr atf-sh-api 3 .Xr atf-sh-api 3
@ -68,7 +66,10 @@ The following options are available:
.It Fl h .It Fl h
Shows a short summary of all available options and their purpose. Shows a short summary of all available options and their purpose.
.El .El
.Sh ENVIRONMENT
.Bl -tag -width ATFXSHELLXX -compact
.It Va ATF_SHELL
Path to the system shell to be used in the generated scripts.
.El
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-config 1 , .Xr atf-sh-api 3
.Xr atf-sh-api 3 ,
.Xr atf 7

14
contrib/atf/doc/atf-test-case.4
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd January 13, 2011 .Dd March 2, 2014
.Dt ATF-TEST-CASE 4 .Dt ATF-TEST-CASE 4
.Os .Os
.Sh NAME .Sh NAME
@ -171,9 +171,7 @@ Type: boolean.
Optional. Optional.
.Pp .Pp
If set to true, specifies that the test case has a cleanup routine that has If set to true, specifies that the test case has a cleanup routine that has
to be executed by to be executed by the runtime engine during the cleanup phase of the execution.
.Xr atf-run 1
during the cleanup phase of the execution.
This property is automatically set by the framework when defining a test case This property is automatically set by the framework when defining a test case
with a cleanup routine, so it should never be set by hand. with a cleanup routine, so it should never be set by hand.
.It ident .It ident
@ -251,8 +249,7 @@ the test case is
.Pp .Pp
If the test case is running as root and this property is If the test case is running as root and this property is
.Sq unprivileged , .Sq unprivileged ,
.Xr atf-run 1 the runtime engine will automatically drop the privileges if the
will automatically drop the privileges if the
.Sq unprivileged-user .Sq unprivileged-user
configuration property is set; otherwise the test case is configuration property is set; otherwise the test case is
.Em skipped . .Em skipped .
@ -314,7 +311,4 @@ Test cases are always executed with a file creation mode mask (umask) of
.Sq 0022 . .Sq 0022 .
The test case's code is free to change this during execution. The test case's code is free to change this during execution.
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-run 1 , .Xr atf-test-program 1
.Xr atf-test-program 1 ,
.Xr atf-formats 5 ,
.Xr atf 7

14
contrib/atf/doc/atf-test-program.1
View file

@ -26,7 +26,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd February 6, 2011 .Dd March 2, 2014
.Dt ATF-TEST-PROGRAM 1 .Dt ATF-TEST-PROGRAM 1
.Os .Os
.Sh NAME .Sh NAME
@ -61,16 +61,17 @@ instead of the test case body; see
Note that the test case is Note that the test case is
.Em executed without isolation , .Em executed without isolation ,
so it can and probably will create and modify files in the current directory. so it can and probably will create and modify files in the current directory.
To execute test cases in a controller manner, refer to To execute test cases in a controller manner, you need a runtime engine
.Xr atf-run 1 , that understands the ATF interface.
which is the preferred way to run test cases. The recommended runtime engine is
.Xr kyua 1 .
You should only execute test cases by hand for debugging purposes. You should only execute test cases by hand for debugging purposes.
.Pp .Pp
In the second synopsis form, the test program will list all available In the second synopsis form, the test program will list all available
test cases alongside their meta-data properties in a format that is test cases alongside their meta-data properties in a format that is
machine parseable. machine parseable.
This list is processed by This list is processed by
.Xr atf-run 1 .Xr kyua 1
to know how to execute the test cases of a given test program. to know how to execute the test cases of a given test program.
.Pp .Pp
The following options are available: The following options are available:
@ -99,5 +100,4 @@ to the value
.Ar value . .Ar value .
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr atf-run 1 , .Xr kyua 1
.Xr atf 7