1*ba11c5b5SToomas Soome.\" Copyright (c) 2011 Devin Teske 2*ba11c5b5SToomas Soome.\" All rights reserved. 3*ba11c5b5SToomas Soome.\" 4*ba11c5b5SToomas Soome.\" Redistribution and use in source and binary forms, with or without 5*ba11c5b5SToomas Soome.\" modification, are permitted provided that the following conditions 6*ba11c5b5SToomas Soome.\" are met: 7*ba11c5b5SToomas Soome.\" 1. Redistributions of source code must retain the above copyright 8*ba11c5b5SToomas Soome.\" notice, this list of conditions and the following disclaimer. 9*ba11c5b5SToomas Soome.\" 2. Redistributions in binary form must reproduce the above copyright 10*ba11c5b5SToomas Soome.\" notice, this list of conditions and the following disclaimer in the 11*ba11c5b5SToomas Soome.\" documentation and/or other materials provided with the distribution. 12*ba11c5b5SToomas Soome.\" 13*ba11c5b5SToomas Soome.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14*ba11c5b5SToomas Soome.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15*ba11c5b5SToomas Soome.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16*ba11c5b5SToomas Soome.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17*ba11c5b5SToomas Soome.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18*ba11c5b5SToomas Soome.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19*ba11c5b5SToomas Soome.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20*ba11c5b5SToomas Soome.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21*ba11c5b5SToomas Soome.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22*ba11c5b5SToomas Soome.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23*ba11c5b5SToomas Soome.\" SUCH DAMAGE. 24*ba11c5b5SToomas Soome.\" 25*ba11c5b5SToomas Soome.Dd Apr 22, 2017 26*ba11c5b5SToomas Soome.Dt DELAY.4TH 5 27*ba11c5b5SToomas Soome.Os 28*ba11c5b5SToomas Soome.Sh NAME 29*ba11c5b5SToomas Soome.Nm delay.4th 30*ba11c5b5SToomas Soome.Nd loader debugging boot module 31*ba11c5b5SToomas Soome.Sh DESCRIPTION 32*ba11c5b5SToomas SoomeThe file that goes by the name of 33*ba11c5b5SToomas Soome.Nm 34*ba11c5b5SToomas Soomeis a set of commands designed to add debugging capabilities to 35*ba11c5b5SToomas Soome.Xr loader 5 . 36*ba11c5b5SToomas SoomeThe commands of 37*ba11c5b5SToomas Soome.Nm 38*ba11c5b5SToomas Soomeby themselves are not enough for most uses. 39*ba11c5b5SToomas SoomePlease refer to the 40*ba11c5b5SToomas Soomeexamples below for the most common situations, and to 41*ba11c5b5SToomas Soome.Xr loader 5 42*ba11c5b5SToomas Soomefor additional commands. 43*ba11c5b5SToomas Soome.Pp 44*ba11c5b5SToomas SoomeBefore using any of the commands provided in 45*ba11c5b5SToomas Soome.Nm , 46*ba11c5b5SToomas Soomeit must be included 47*ba11c5b5SToomas Soomethrough the command: 48*ba11c5b5SToomas Soome.Pp 49*ba11c5b5SToomas Soome.Dl include delay.4th 50*ba11c5b5SToomas Soome.Pp 51*ba11c5b5SToomas SoomeThis line is present in 52*ba11c5b5SToomas Soome.Pa /boot/forth/beastie.4th 53*ba11c5b5SToomas Soomefile, so it is not needed (and should not be re-issued) in a normal setup. 54*ba11c5b5SToomas Soome.Pp 55*ba11c5b5SToomas SoomeThe commands provided by it are: 56*ba11c5b5SToomas Soome.Pp 57*ba11c5b5SToomas Soome.Bl -tag -width disable-module_module -compact -offset indent 58*ba11c5b5SToomas Soome.It Ic delay_execute 59*ba11c5b5SToomas SoomeExecutes the [string] procedure stored in the 60*ba11c5b5SToomas Soome.Ic delay_command 61*ba11c5b5SToomas Soomeenvironment variable after 62*ba11c5b5SToomas Soome.Ic loader_delay 63*ba11c5b5SToomas Soomeseconds. 64*ba11c5b5SToomas Soome.Pp 65*ba11c5b5SToomas SoomeIf the optional 66*ba11c5b5SToomas Soome.Ic delay_showdots 67*ba11c5b5SToomas Soomeenvironment variable is set, a continuous series of dots is printed. 68*ba11c5b5SToomas Soome.Pp 69*ba11c5b5SToomas SoomeDuring the duration, the user can either press Ctrl-C (or Esc) to abort or 70*ba11c5b5SToomas SoomeENTER to proceed immediately. 71*ba11c5b5SToomas Soome.El 72*ba11c5b5SToomas Soome.Pp 73*ba11c5b5SToomas SoomeThe environment variables that effect its behavior are: 74*ba11c5b5SToomas Soome.Bl -tag -width bootfile -offset indent 75*ba11c5b5SToomas Soome.It Va delay_command 76*ba11c5b5SToomas SoomeThe command to be executed by 77*ba11c5b5SToomas Soome.Ic delay_execute . 78*ba11c5b5SToomas Soome.It Va loader_delay 79*ba11c5b5SToomas SoomeThe duration (in seconds) to delay before executing 80*ba11c5b5SToomas Soome.Ic delay_command . 81*ba11c5b5SToomas Soome.It Va delay_showdots 82*ba11c5b5SToomas SoomeIf set, will cause 83*ba11c5b5SToomas Soome.Ic delay_execute 84*ba11c5b5SToomas Soometo print a continuous series of dots during the delay duration. 85*ba11c5b5SToomas Soome.El 86*ba11c5b5SToomas Soome.Sh FILES 87*ba11c5b5SToomas Soome.Bl -tag -width /boot/forth/loader.4th -compact 88*ba11c5b5SToomas Soome.It Pa /boot/zfsloader 89*ba11c5b5SToomas SoomeThe 90*ba11c5b5SToomas Soome.Xr zfsloader 5 . 91*ba11c5b5SToomas Soome.It Pa /boot/forth/delay.4th 92*ba11c5b5SToomas Soome.Nm 93*ba11c5b5SToomas Soomeitself. 94*ba11c5b5SToomas Soome.It Pa /boot/loader.rc 95*ba11c5b5SToomas Soome.Xr loader 5 96*ba11c5b5SToomas Soomebootstrapping script. 97*ba11c5b5SToomas Soome.El 98*ba11c5b5SToomas Soome.Sh EXAMPLES 99*ba11c5b5SToomas SoomeIntroducing a 5-second delay before including another file from 100*ba11c5b5SToomas Soome.Pa /boot/loader.rc : 101*ba11c5b5SToomas Soome.Pp 102*ba11c5b5SToomas Soome.Bd -literal -offset indent -compact 103*ba11c5b5SToomas Soomeinclude /boot/forth/delay.4th 104*ba11c5b5SToomas Soomeset delay_command="include /boot/forth/other.4th" 105*ba11c5b5SToomas Soomeset delay_showdots 106*ba11c5b5SToomas Soomeset loader_delay=5 107*ba11c5b5SToomas Soomedelay_execute 108*ba11c5b5SToomas Soome.Ed 109*ba11c5b5SToomas Soome.Sh SEE ALSO 110*ba11c5b5SToomas Soome.Xr loader.conf 4 , 111*ba11c5b5SToomas Soome.Xr beastie.4th 5 , 112*ba11c5b5SToomas Soome.Xr loader 5 , 113*ba11c5b5SToomas Soome.Xr loader.4th 5 114