atf-test-case.4 (262855) | atf-test-case.4 (272307) |
---|---|
1.\" 2.\" Automated Testing Framework (atf) 3.\" 4.\" Copyright (c) 2007 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 12 unchanged lines hidden (view full) --- 21.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 23.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 25.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 26.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 27.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28.\" | 1.\" 2.\" Automated Testing Framework (atf) 3.\" 4.\" Copyright (c) 2007 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 12 unchanged lines hidden (view full) --- 21.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 23.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 25.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 26.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 27.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28.\" |
29.Dd January 13, 2011 | 29.Dd March 2, 2014 |
30.Dt ATF-TEST-CASE 4 31.Os 32.Sh NAME 33.Nm atf-test-case 34.Nd generic description of test cases 35.Sh DESCRIPTION 36A 37.Em test case --- 128 unchanged lines hidden (view full) --- 166A brief textual description of the test case's purpose. 167Will be shown to the user in reports. 168Also good for documentation purposes. 169.It has.cleanup 170Type: boolean. 171Optional. 172.Pp 173If set to true, specifies that the test case has a cleanup routine that has | 30.Dt ATF-TEST-CASE 4 31.Os 32.Sh NAME 33.Nm atf-test-case 34.Nd generic description of test cases 35.Sh DESCRIPTION 36A 37.Em test case --- 128 unchanged lines hidden (view full) --- 166A brief textual description of the test case's purpose. 167Will be shown to the user in reports. 168Also good for documentation purposes. 169.It has.cleanup 170Type: boolean. 171Optional. 172.Pp 173If set to true, specifies that the test case has a cleanup routine that has |
174to be executed by 175.Xr atf-run 1 176during the cleanup phase of the execution. | 174to be executed by the runtime engine during the cleanup phase of the execution. |
177This property is automatically set by the framework when defining a test case 178with a cleanup routine, so it should never be set by hand. 179.It ident 180Type: textual. 181Required. 182.Pp 183The test case's identifier. 184Must be unique inside the test program and should be short but descriptive. --- 61 unchanged lines hidden (view full) --- 246.Pp 247If the test case is running as a regular user and this property is 248.Sq root , 249the test case is 250.Em skipped . 251.Pp 252If the test case is running as root and this property is 253.Sq unprivileged , | 175This property is automatically set by the framework when defining a test case 176with a cleanup routine, so it should never be set by hand. 177.It ident 178Type: textual. 179Required. 180.Pp 181The test case's identifier. 182Must be unique inside the test program and should be short but descriptive. --- 61 unchanged lines hidden (view full) --- 244.Pp 245If the test case is running as a regular user and this property is 246.Sq root , 247the test case is 248.Em skipped . 249.Pp 250If the test case is running as root and this property is 251.Sq unprivileged , |
254.Xr atf-run 1 255will automatically drop the privileges if the | 252the runtime engine will automatically drop the privileges if the |
256.Sq unprivileged-user 257configuration property is set; otherwise the test case is 258.Em skipped . 259.It timeout 260Type: integral. 261Optional; defaults to 262.Sq 300 . 263.Pp --- 45 unchanged lines hidden (view full) --- 309To do so, the runtime engine will perform a recursive removal of the work 310directory without crossing mount points; if a mount point is found, the 311file system will be unmounted (if possible). 312.Ss File creation mode mask (umask) 313Test cases are always executed with a file creation mode mask (umask) of 314.Sq 0022 . 315The test case's code is free to change this during execution. 316.Sh SEE ALSO | 253.Sq unprivileged-user 254configuration property is set; otherwise the test case is 255.Em skipped . 256.It timeout 257Type: integral. 258Optional; defaults to 259.Sq 300 . 260.Pp --- 45 unchanged lines hidden (view full) --- 306To do so, the runtime engine will perform a recursive removal of the work 307directory without crossing mount points; if a mount point is found, the 308file system will be unmounted (if possible). 309.Ss File creation mode mask (umask) 310Test cases are always executed with a file creation mode mask (umask) of 311.Sq 0022 . 312The test case's code is free to change this during execution. 313.Sh SEE ALSO |
317.Xr atf-run 1 , 318.Xr atf-test-program 1 , 319.Xr atf-formats 5 , 320.Xr atf 7 | 314.Xr atf-test-program 1 |