fail.9 (205076) | fail.9 (208027) |
---|---|
1.\" 2.\" Copyright (c) 2009 Isilon Inc http://www.isilon.com/ 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice(s), this list of conditions and the following disclaimer as --- 10 unchanged lines hidden (view full) --- 19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 22.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 25.\" DAMAGE. 26.\" | 1.\" 2.\" Copyright (c) 2009 Isilon Inc http://www.isilon.com/ 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice(s), this list of conditions and the following disclaimer as --- 10 unchanged lines hidden (view full) --- 19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 22.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 25.\" DAMAGE. 26.\" |
27.\" $FreeBSD: head/share/man/man9/fail.9 205076 2010-03-12 10:01:06Z uqs $ | 27.\" $FreeBSD: head/share/man/man9/fail.9 208027 2010-05-13 12:07:55Z uqs $ |
28.\" 29.Dd May 10, 2009 30.Dt FAIL 9 31.Os 32.Sh NAME 33.Nm KFAIL_POINT_CODE , 34.Nm KFAIL_POINT_RETURN , 35.Nm KFAIL_POINT_RETURN_VOID , --- 142 unchanged lines hidden (view full) --- 178.It Sy sysctl debug.fail_point.foobar="5*return(5)->0.1%return(22)" 179For 5 times, return 5. 180After that, 1/1000th of the time, return 22. 181.It Sy sysctl debug.fail_point.foobar="0.1%5*return(5)" 182Return 5 for 1 in 1000 executions, but only 5 times total. 183.It Sy sysctl debug.fail_point.foobar="1%*sleep(50)" 1841/100th of the time, sleep 50ms. 185.El | 28.\" 29.Dd May 10, 2009 30.Dt FAIL 9 31.Os 32.Sh NAME 33.Nm KFAIL_POINT_CODE , 34.Nm KFAIL_POINT_RETURN , 35.Nm KFAIL_POINT_RETURN_VOID , --- 142 unchanged lines hidden (view full) --- 178.It Sy sysctl debug.fail_point.foobar="5*return(5)->0.1%return(22)" 179For 5 times, return 5. 180After that, 1/1000th of the time, return 22. 181.It Sy sysctl debug.fail_point.foobar="0.1%5*return(5)" 182Return 5 for 1 in 1000 executions, but only 5 times total. 183.It Sy sysctl debug.fail_point.foobar="1%*sleep(50)" 1841/100th of the time, sleep 50ms. 185.El |
186.Sh AUTHORS 187.An -nosplit 188This manual page was written by 189.An Zach Loafman Aq zml@FreeBSD.org . |
|
186.Sh CAVEATS 187It is easy to shoot yourself in the foot by setting fail points too 188aggressively or setting too many in combination. 189For example, forcing 190.Fn malloc 191to fail consistently is potentially harmful to uptime. 192.Pp 193The 194.Fn sleep 195sysctl setting may not be appropriate in all situations. 196Currently, 197.Fn fail_point_eval 198does not verify whether the context is appropriate for calling 199.Fn msleep . | 190.Sh CAVEATS 191It is easy to shoot yourself in the foot by setting fail points too 192aggressively or setting too many in combination. 193For example, forcing 194.Fn malloc 195to fail consistently is potentially harmful to uptime. 196.Pp 197The 198.Fn sleep 199sysctl setting may not be appropriate in all situations. 200Currently, 201.Fn fail_point_eval 202does not verify whether the context is appropriate for calling 203.Fn msleep . |
200.Sh AUTHORS 201.An -nosplit 202This manual page was written by 203.An Zach Loafman Aq zml@FreeBSD.org . | |