| loader_simp.8 (7457840230c5a470ee5df8abed6ab59c4d008a45) | loader_simp.8 (9e1dc7bec331b4d120d4b0687cfd54692e4fddcb) |
|---|---|
| 1.\" Copyright (c) 1999 Daniel C. Sobral 2.\" All rights reserved. 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, this list of conditions and the following disclaimer. --- 10 unchanged lines hidden (view full) --- 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD$ 26.\" | 1.\" Copyright (c) 1999 Daniel C. Sobral 2.\" All rights reserved. 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, this list of conditions and the following disclaimer. --- 10 unchanged lines hidden (view full) --- 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD$ 26.\" |
| 27.Dd July 14, 2021 28.Dt LOADER 8 | 27.Dd September 29, 2021 28.Dt LOADER_SIMP 8 |
| 29.Os 30.Sh NAME | 29.Os 30.Sh NAME |
| 31.Nm loader | 31.Nm loader_simp |
| 32.Nd kernel bootstrapping final stage 33.Sh DESCRIPTION 34The program called 35.Nm 36is the final stage of 37.Fx Ns 's 38kernel bootstrapping process. 39On IA32 (i386) architectures, it is a --- 8 unchanged lines hidden (view full) --- 48automate tasks, do pre-configuration or assist in recovery 49procedures. 50This scripting language is roughly divided in 51two main components. 52The smaller one is a set of commands 53designed for direct use by the casual user, called "builtin 54commands" for historical reasons. 55The main drive behind these commands is user-friendliness. | 32.Nd kernel bootstrapping final stage 33.Sh DESCRIPTION 34The program called 35.Nm 36is the final stage of 37.Fx Ns 's 38kernel bootstrapping process. 39On IA32 (i386) architectures, it is a --- 8 unchanged lines hidden (view full) --- 48automate tasks, do pre-configuration or assist in recovery 49procedures. 50This scripting language is roughly divided in 51two main components. 52The smaller one is a set of commands 53designed for direct use by the casual user, called "builtin 54commands" for historical reasons. 55The main drive behind these commands is user-friendliness. |
| 56The bigger component is an 57.Tn ANS 58Forth compatible Forth interpreter based on FICL, by 59.An John Sadler . | |
| 60.Pp 61During initialization, 62.Nm 63will probe for a console and set the 64.Va console 65variable, or set it to serial console 66.Pq Dq Li comconsole 67if the previous boot stage used that. --- 46 unchanged lines hidden (view full) --- 114.Sh BUILTIN COMMANDS 115In 116.Nm , 117builtin commands take parameters from the command line. 118Presently, 119the only way to call them from a script is by using 120.Pa evaluate 121on a string. | 56.Pp 57During initialization, 58.Nm 59will probe for a console and set the 60.Va console 61variable, or set it to serial console 62.Pq Dq Li comconsole 63if the previous boot stage used that. --- 46 unchanged lines hidden (view full) --- 110.Sh BUILTIN COMMANDS 111In 112.Nm , 113builtin commands take parameters from the command line. 114Presently, 115the only way to call them from a script is by using 116.Pa evaluate 117on a string. |
| 122If an error condition occurs, an exception will be generated, 123which can be intercepted using 124.Tn ANS 125Forth exception handling 126words. 127If not intercepted, an error message will be displayed and | 118In the case of an error, an error message will be displayed and |
| 128the interpreter's state will be reset, emptying the stack and restoring 129interpreting mode. 130.Pp 131The builtin commands available are: 132.Pp 133.Bl -tag -width Ds -compact 134.It Ic autoboot Op Ar seconds Op Ar prompt 135Proceeds to bootstrap the system after a number of seconds, if not --- 155 unchanged lines hidden (view full) --- 291Removes 292.Va variable 293from the environment. 294.Pp 295.It Ic \&? 296Lists available commands. 297.El 298.Ss BUILTIN ENVIRONMENT VARIABLES | 119the interpreter's state will be reset, emptying the stack and restoring 120interpreting mode. 121.Pp 122The builtin commands available are: 123.Pp 124.Bl -tag -width Ds -compact 125.It Ic autoboot Op Ar seconds Op Ar prompt 126Proceeds to bootstrap the system after a number of seconds, if not --- 155 unchanged lines hidden (view full) --- 282Removes 283.Va variable 284from the environment. 285.Pp 286.It Ic \&? 287Lists available commands. 288.El 289.Ss BUILTIN ENVIRONMENT VARIABLES |
| 299The 300.Nm 301has actually two different kinds of 302.Sq environment 303variables. 304There are ANS Forth's 305.Em environmental queries , 306and a separate space of environment variables used by builtins, which 307are not directly available to Forth words. 308It is the latter type that this section covers. 309.Pp | |
| 310Environment variables can be set and unset through the 311.Ic set 312and 313.Ic unset 314builtins, and can have their values interactively examined through the 315use of the 316.Ic show 317builtin. --- 446 unchanged lines hidden --- | 290Environment variables can be set and unset through the 291.Ic set 292and 293.Ic unset 294builtins, and can have their values interactively examined through the 295use of the 296.Ic show 297builtin. --- 446 unchanged lines hidden --- |