1 \ Copyright (c) 1999 Daniel C. Sobral <dcs@FreeBSD.org>
4 \ Redistribution and use in source and binary forms, with or without
5 \ modification, are permitted provided that the following conditions
7 \ 1. Redistributions of source code must retain the above copyright
8 \ notice, this list of conditions and the following disclaimer.
9 \ 2. Redistributions in binary form must reproduce the above copyright
10 \ notice, this list of conditions and the following disclaimer in the
11 \ documentation and/or other materials provided with the distribution.
13 \ THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 \ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 \ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 \ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 \ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 \ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
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
27 \ Loader.rc support functions:
29 \ initialize ( addr len -- ) as above, plus load_conf_files
30 \ load_conf ( addr len -- ) load conf file given
31 \ include_conf_files ( -- ) load all conf files in load_conf_files
32 \ print_syntax_error ( -- ) print line and marker of where a syntax
34 \ print_line ( -- ) print last line processed
35 \ load_kernel ( -- ) load kernel
36 \ load_modules ( -- ) load modules flagged
38 \ Exported structures:
40 \ string counted string structure
41 \ cell .addr string address
42 \ cell .len string length
43 \ module module loading information structure
44 \ cell module.flag should we load it?
45 \ string module.name module's name
46 \ string module.loadname name to be used in loading the module
47 \ string module.type module's type
48 \ string module.args flags to be passed during load
49 \ string module.beforeload command to be executed before load
50 \ string module.afterload command to be executed after load
51 \ string module.loaderror command to be executed if load fails
52 \ cell module.next list chain
54 \ Exported global variables;
56 \ string conf_files configuration files to be loaded
57 \ cell modules_options pointer to first module information
58 \ value verbose? indicates if user wants a verbose loading
59 \ value any_conf_read? indicates if a conf file was successfully read
61 \ Other exported words:
62 \ note, strlen is internal
63 \ strdup ( addr len -- addr' len) similar to strdup(3)
64 \ strcat ( addr len addr' len' -- addr len+len' ) similar to strcat(3)
65 \ s' ( | string' -- addr len | ) similar to s"
66 \ rudimentary structure support
73 4 constant ESETERROR \ error setting environment variable
74 5 constant EREAD \ error reading
76 7 constant EEXEC \ XXX never catched
77 8 constant EBEFORELOAD
90 \ Crude structure support
93 create here 0 , ['] drop , 0
94 does> create here swap dup @ allot cell+ @ execute
96 : member: create dup , over , + does> cell+ @ + ;
98 : constructor! >body cell+ ! ;
99 : constructor: over :noname ;
100 : ;constructor postpone ; swap cell+ ! ; immediate
101 : sizeof ' >body @ state @ if postpone literal then ; immediate
102 : offsetof ' >body cell+ @ state @ if postpone literal then ; immediate
103 : ptr 1 cells member: ;
104 : int 1 cells member: ;
118 \ Module options linked list
122 sizeof string member: module.name
123 sizeof string member: module.loadname
124 sizeof string member: module.type
125 sizeof string member: module.args
126 sizeof string member: module.beforeload
127 sizeof string member: module.afterload
128 sizeof string member: module.loaderror
132 \ Internal loader structures (preloaded_file, kernel_module, file_metadata)
133 \ must be in sync with the C struct in stand/common/bootstrap.h
134 structure: preloaded_file
138 ptr pf.metadata \ file_metadata
142 ptr pf.modules \ kernel_module
143 ptr pf.next \ preloaded_file
146 structure: kernel_module
149 ptr km.fp \ preloaded_file
150 ptr km.next \ kernel_module
153 structure: file_metadata
155 2 member: md.type \ this is not ANS Forth compatible (XXX)
156 ptr md.next \ file_metadata
157 0 member: md.data \ variable size
165 string nextboot_conf_file
166 create module_options sizeof module.next allot 0 module_options !
167 create last_module_option sizeof module.next allot 0 last_module_option !
171 \ Support string functions
172 : strdup { addr len -- addr' len' }
173 len allocate if ENOMEM throw then
174 addr over len move len
177 : strcat { addr len addr' len' -- addr len+len' }
178 addr' addr len + len' move
182 : strchr { addr len c -- addr' len' }
186 addr c@ c = if addr len exit then
193 : s' \ same as s", allows " in the string
195 state @ if postpone sliteral then
198 : 2>r postpone >r postpone >r ; immediate
199 : 2r> postpone r> postpone r> ; immediate
200 : 2r@ postpone 2r> postpone 2dup postpone 2>r ; immediate
202 : getenv? getenv -1 = if false else drop true then ;
204 \ determine if a word appears in a string, case-insensitive
205 : contains? ( addr1 len1 addr2 len2 -- 0 | -1 )
206 2 pick 0= if 2drop 2drop true exit then
207 dup 0= if 2drop 2drop false exit then
210 swap dup c@ dup 32 = over 9 = or over 10 = or
211 over 13 = or over 44 = or swap drop
212 while 1+ swap 1- repeat
213 swap 2 pick 1- over <
215 2over 2over drop over compare-insensitive 0= if
216 2 pick over = if 2drop 2drop true exit then
217 2 pick tuck - -rot + swap over c@ dup 32 =
218 over 9 = or over 10 = or over 13 = or over 44 = or
219 swap drop if 2drop 2drop true exit then
221 swap dup c@ dup 32 = over 9 = or over 10 = or
222 over 13 = or over 44 = or swap drop
223 if false else true then 2 pick 0> and
224 while 1+ swap 1- repeat
230 : boot_serial? ( -- 0 | -1 )
231 s" console" getenv dup -1 <> if
232 s" comconsole" 2swap contains?
234 s" boot_serial" getenv dup -1 <> if
237 or \ console contains comconsole ( or ) boot_serial
238 s" boot_multicons" getenv dup -1 <> if
241 or \ previous boolean ( or ) boot_multicons
244 \ Private definitions
246 vocabulary support-functions
247 only forth also support-functions definitions
249 \ Some control characters constants
259 80 constant read_buffer_size
263 : load_module_suffix s" _load" ;
264 : module_loadname_suffix s" _name" ;
265 : module_type_suffix s" _type" ;
266 : module_args_suffix s" _flags" ;
267 : module_beforeload_suffix s" _before" ;
268 : module_afterload_suffix s" _after" ;
269 : module_loaderror_suffix s" _error" ;
276 \ Assorted support functions
278 : free-memory free if EFREE throw then ;
280 : strget { var -- addr len } var .addr @ var .len @ ;
282 \ assign addr len to variable.
283 : strset { addr len var -- } addr var .addr ! len var .len ! ;
285 \ free memory and reset fields
286 : strfree { var -- } var .addr @ ?dup if free-memory 0 0 var strset then ;
288 \ free old content, make a copy of the string and assign to variable
289 : string= { addr len var -- } var strfree addr len strdup var strset ;
291 : strtype ( str -- ) strget type ;
293 \ assign a reference to what is on the stack
294 : strref { addr len var -- addr len }
295 addr var .addr ! len var .len ! addr len
299 : unquote ( addr len -- addr len )
300 over c@ [char] " = if 2 chars - swap char+ swap then
303 \ Assignment data temporary storage
308 \ Line by line file reading functions
317 vocabulary line-reading
318 also line-reading definitions
320 \ File data temporary storage
323 0 value read_buffer_ptr
325 \ File's line reading function
327 get-current ( -- wid ) previous definitions
333 >search ( wid -- ) definitions
337 read_buffer .len @ read_buffer_ptr >
339 read_buffer .addr @ read_buffer_ptr + c@ lf = if
340 read_buffer_ptr char+ to read_buffer_ptr
347 : scan_buffer ( -- addr len )
350 read_buffer .len @ r@ >
352 read_buffer .addr @ r@ + c@ lf = if
353 read_buffer .addr @ read_buffer_ptr + ( -- addr )
354 r@ read_buffer_ptr - ( -- len )
355 r> to read_buffer_ptr
360 read_buffer .addr @ read_buffer_ptr + ( -- addr )
361 r@ read_buffer_ptr - ( -- len )
362 r> to read_buffer_ptr
365 : line_buffer_resize ( len -- len )
367 line_buffer .len @ if
369 line_buffer .len @ r@ +
370 resize if ENOMEM throw then
372 r@ allocate if ENOMEM throw then
378 : append_to_line_buffer ( addr len -- )
386 scan_buffer ( -- addr len )
387 line_buffer_resize ( len -- len )
388 append_to_line_buffer ( addr len -- )
392 read_buffer .len @ read_buffer_ptr =
398 read_buffer .addr @ 0= if
399 read_buffer_size allocate if ENOMEM throw then
402 fd @ read_buffer .addr @ read_buffer_size fread
403 dup -1 = if EREAD throw then
404 dup 0= if true to end_of_file? then
408 get-current ( -- wid ) previous definitions >search ( wid -- )
425 only forth also support-functions definitions
427 \ Conf file line parser:
428 \ <line> ::= <spaces><name><spaces>'='<spaces><value><spaces>[<comment>] |
429 \ <spaces>[<comment>]
430 \ <name> ::= <letter>{<letter>|<digit>|'_'}
431 \ <value> ::= '"'{<character_set>|'\'<anything>}'"' | <name>
432 \ <character_set> ::= ASCII 32 to 126, except '\' and '"'
433 \ <comment> ::= '#'{<anything>}
441 vocabulary file-processing
442 also file-processing definitions
450 also parser definitions
452 0 value parsing_function
455 : end_of_line? line_pointer end_of_line = ;
457 \ classifiers for various character classes in the input line
476 : quote? line_pointer c@ [char] " = ;
478 : assignment_sign? line_pointer c@ [char] = = ;
480 : comment? line_pointer c@ [char] # = ;
482 : space? line_pointer c@ bl = line_pointer c@ tab = or ;
484 : backslash? line_pointer c@ [char] \ = ;
486 : underscore? line_pointer c@ [char] _ = ;
488 : dot? line_pointer c@ [char] . = ;
490 \ manipulation of input line
491 : skip_character line_pointer char+ to line_pointer ;
493 : skip_to_end_of_line end_of_line to line_pointer ;
497 end_of_line? if 0 else space? then
503 : parse_name ( -- addr len )
506 end_of_line? if 0 else letter? digit? underscore? dot? or or or then
514 : remove_backslashes { addr len | addr' len' -- addr' len' }
515 len allocate if ENOMEM throw then
519 addr c@ [char] \ <> if
520 addr c@ addr' len' + c!
530 : parse_quote ( -- addr len )
533 end_of_line? if ESYNTAX throw then
539 end_of_line? if ESYNTAX throw then
542 end_of_line? if ESYNTAX throw then
550 parse_name ( -- addr len )
556 parse_quote ( -- addr len )
558 parse_name ( -- addr len )
569 comment? if ['] comment to parsing_function exit then
570 end_of_line? 0= if ESYNTAX throw then
575 ['] white_space_4 to parsing_function
580 letter? digit? quote? or or if
581 ['] variable_value to parsing_function exit
588 ['] white_space_3 to parsing_function
593 assignment_sign? if ['] assignment_sign to parsing_function exit then
599 ['] white_space_2 to parsing_function
604 letter? if ['] variable_name to parsing_function exit then
605 comment? if ['] comment to parsing_function exit then
606 end_of_line? 0= if ESYNTAX throw then
609 get-current ( -- wid ) previous definitions >search ( wid -- )
612 line_buffer strget + to end_of_line
613 line_buffer .addr @ to line_pointer
614 ['] white_space_1 to parsing_function
618 parsing_function execute
620 parsing_function ['] comment =
621 parsing_function ['] white_space_1 =
622 parsing_function ['] white_space_4 =
623 or or 0= if ESYNTAX throw then
626 only forth also support-functions also file-processing definitions
630 : assignment_type? ( addr len -- flag )
635 : suffix_type? ( addr len -- flag )
636 name_buffer .len @ over <= if 2drop false exit then
637 name_buffer .len @ over - name_buffer .addr @ +
641 : loader_conf_files? s" loader_conf_files" assignment_type? ;
643 : nextboot_flag? s" nextboot_enable" assignment_type? ;
645 : nextboot_conf? s" nextboot_conf" assignment_type? ;
647 : verbose_flag? s" verbose_loading" assignment_type? ;
649 : execute? s" exec" assignment_type? ;
651 : module_load? load_module_suffix suffix_type? ;
653 : module_loadname? module_loadname_suffix suffix_type? ;
655 : module_type? module_type_suffix suffix_type? ;
657 : module_args? module_args_suffix suffix_type? ;
659 : module_beforeload? module_beforeload_suffix suffix_type? ;
661 : module_afterload? module_afterload_suffix suffix_type? ;
663 : module_loaderror? module_loaderror_suffix suffix_type? ;
665 \ build a 'set' statement and execute it
666 : set_environment_variable
667 name_buffer .len @ value_buffer .len @ + 5 chars + \ size of result string
668 allocate if ENOMEM throw then
669 dup 0 \ start with an empty string and append the pieces
671 name_buffer strget strcat
673 value_buffer strget strcat
674 ['] evaluate catch if
683 set_environment_variable
684 s" loader_conf_files" getenv conf_files string=
688 value_buffer strget unquote nextboot_conf_file string=
691 : append_to_module_options_list ( addr -- )
692 module_options @ 0= if
696 dup last_module_option @ module.next !
701 : set_module_name { addr -- } \ check leaks
702 name_buffer strget addr module.name string=
706 value_buffer strget \ XXX could use unquote
707 2dup s' "YES"' compare >r
708 2dup s' "yes"' compare >r
709 2dup s" YES" compare >r
710 s" yes" compare r> r> r> and and and 0=
713 : find_module_option ( -- addr | 0 ) \ return ptr to entry matching name_buffer
718 dup module.name strget
720 compare 0= if exit then
725 : new_module_option ( -- addr )
726 sizeof module allocate if ENOMEM throw then
727 dup sizeof module erase
728 dup append_to_module_options_list
732 : get_module_option ( -- addr )
734 ?dup 0= if new_module_option then
738 name_buffer .len @ load_module_suffix nip - name_buffer .len !
739 yes_value? get_module_option module.flag !
743 name_buffer .len @ module_args_suffix nip - name_buffer .len !
744 value_buffer strget unquote
745 get_module_option module.args string=
748 : set_module_loadname
749 name_buffer .len @ module_loadname_suffix nip - name_buffer .len !
750 value_buffer strget unquote
751 get_module_option module.loadname string=
755 name_buffer .len @ module_type_suffix nip - name_buffer .len !
756 value_buffer strget unquote
757 get_module_option module.type string=
760 : set_module_beforeload
761 name_buffer .len @ module_beforeload_suffix nip - name_buffer .len !
762 value_buffer strget unquote
763 get_module_option module.beforeload string=
766 : set_module_afterload
767 name_buffer .len @ module_afterload_suffix nip - name_buffer .len !
768 value_buffer strget unquote
769 get_module_option module.afterload string=
772 : set_module_loaderror
773 name_buffer .len @ module_loaderror_suffix nip - name_buffer .len !
774 value_buffer strget unquote
775 get_module_option module.loaderror string=
779 yes_value? to nextboot?
783 yes_value? to verbose?
787 value_buffer strget unquote
788 ['] evaluate catch if EEXEC throw then
792 name_buffer .len @ 0= if exit then
793 loader_conf_files? if set_conf_files exit then
794 nextboot_flag? if set_nextboot_flag exit then
795 nextboot_conf? if set_nextboot_conf exit then
796 verbose_flag? if set_verbose exit then
797 execute? if execute_command exit then
798 module_load? if set_module_flag exit then
799 module_loadname? if set_module_loadname exit then
800 module_type? if set_module_type exit then
801 module_args? if set_module_args exit then
802 module_beforeload? if set_module_beforeload exit then
803 module_afterload? if set_module_afterload exit then
804 module_loaderror? if set_module_loaderror exit then
805 set_environment_variable
810 \ Free some pointers if needed. The code then tests for errors
811 \ in freeing, and throws an exception if needed. If a pointer is
812 \ not allocated, it's value (0) is used as flag.
819 \ Higher level file processing
821 get-current ( -- wid ) previous definitions >search ( wid -- )
830 ['] process_assignment catch
831 ['] free_buffers catch
836 : peek_file ( addr len -- )
840 fd @ -1 = if EOPEN throw then
844 ['] process_assignment catch
845 ['] free_buffers catch
850 only forth also support-functions definitions
852 \ Interface to loading conf files
854 : load_conf ( addr len -- )
858 fd @ -1 = if EOPEN throw then
859 ['] process_conf catch
864 : print_line line_buffer strtype cr ;
867 line_buffer strtype cr
879 \ Debugging support functions
881 only forth definitions also support-functions
884 ['] load_conf catch dup .
885 ESYNTAX = if cr print_syntax_error then
888 \ find a module name, leave addr on the stack (0 if not found)
889 : find-module ( <module> -- ptr | 0 )
890 bl parse ( addr len )
891 module_options @ >r ( store current pointer )
895 2dup ( addr len addr len )
896 r@ module.name strget
897 compare 0= if drop drop r> exit then ( found it )
900 type ." was not found" cr r>
903 : show-nonempty ( addr len mod -- )
904 strget dup verbose? or if
910 : show-one-module { addr -- addr }
911 ." Name: " addr module.name strtype cr
912 s" Path: " addr module.loadname show-nonempty
913 s" Type: " addr module.type show-nonempty
914 s" Flags: " addr module.args show-nonempty
915 s" Before load: " addr module.beforeload show-nonempty
916 s" After load: " addr module.afterload show-nonempty
917 s" Error: " addr module.loaderror show-nonempty
918 ." Status: " addr module.flag @ if ." Load" else ." Don't load" then cr
923 : show-module-options
933 : free-one-module { addr -- addr }
934 addr module.name strfree
935 addr module.loadname strfree
936 addr module.type strfree
937 addr module.args strfree
938 addr module.beforeload strfree
939 addr module.afterload strfree
940 addr module.loaderror strfree
944 : free-module-options
954 0 last_module_option !
957 only forth also support-functions definitions
959 \ Variables used for processing multiple conf files
961 string current_file_name_ref \ used to print the file name
963 \ Indicates if any conf file was successfully read
965 0 value any_conf_read?
967 \ loader_conf_files processing support functions
969 : get_conf_files ( -- addr len ) \ put addr/len on stack, reset var
970 conf_files strget 0 0 conf_files strset
973 : skip_leading_spaces { addr len pos -- addr len pos' }
975 pos len = if 0 else addr pos + c@ bl = then
982 \ return the file name at pos, or free the string if nothing left
983 : get_file_name { addr len pos -- addr len pos' addr' len' || 0 }
985 addr free abort" Fatal error freeing memory"
990 \ stay in the loop until have chars and they are not blank
991 pos len = if 0 else addr pos + c@ bl <> then
995 addr len pos addr r@ + pos r> -
998 : get_next_file ( addr len ptr -- addr len ptr' addr' len' | 0 )
1003 : print_current_file
1004 current_file_name_ref strtype
1007 : process_conf_errors
1008 dup 0= if true to any_conf_read? drop exit then
1011 ." Warning: syntax error on file " print_current_file cr
1012 print_syntax_error drop exit
1015 ." Warning: bad definition on file " print_current_file cr
1016 print_line drop exit
1019 ." Warning: error reading file " print_current_file cr drop exit
1022 verbose? if ." Warning: unable to open file " print_current_file cr then
1025 dup EFREE = abort" Fatal error freeing memory"
1026 dup ENOMEM = abort" Out of memory"
1027 throw \ Unknown error -- pass ahead
1030 \ Process loader_conf_files recursively
1031 \ Interface to loader_conf_files processing
1033 : include_conf_files
1034 get_conf_files 0 ( addr len offset )
1036 get_next_file ?dup ( addr len 1 | 0 )
1038 current_file_name_ref strref
1041 conf_files .addr @ if recurse then
1045 : get_nextboot_conf_file ( -- addr len )
1046 nextboot_conf_file strget
1049 : rewrite_nextboot_file ( -- )
1050 get_nextboot_conf_file
1052 fd @ -1 = if EOPEN throw then
1053 fd @ s' nextboot_enable="NO" ' fwrite ( fd buf len -- nwritten ) drop
1057 : include_nextboot_file ( -- )
1058 get_nextboot_conf_file
1059 ['] peek_file catch if 2drop then
1061 get_nextboot_conf_file
1062 current_file_name_ref strref
1065 ['] rewrite_nextboot_file catch if 2drop then
1069 \ Module loading functions
1071 : load_parameters { addr -- addr addrN lenN ... addr1 len1 N }
1073 addr module.args strget
1074 addr module.loadname .len @ if
1075 addr module.loadname strget
1077 addr module.name strget
1079 addr module.type .len @ if
1080 addr module.type strget
1082 4 ( -t type name flags )
1088 : before_load ( addr -- addr )
1089 dup module.beforeload .len @ if
1090 dup module.beforeload strget
1091 ['] evaluate catch if EBEFORELOAD throw then
1095 : after_load ( addr -- addr )
1096 dup module.afterload .len @ if
1097 dup module.afterload strget
1098 ['] evaluate catch if EAFTERLOAD throw then
1102 : load_error ( addr -- addr )
1103 dup module.loaderror .len @ if
1104 dup module.loaderror strget
1105 evaluate \ This we do not intercept so it can throw errors
1109 : pre_load_message ( addr -- addr )
1111 dup module.name strtype
1116 : load_error_message verbose? if ." failed!" cr then ;
1118 : load_successful_message verbose? if ." ok" cr then ;
1121 load_parameters load
1124 : process_module ( addr -- addr )
1128 ['] load_module catch if
1129 dup module.loaderror .len @ if
1130 load_error \ Command should return a flag!
1132 load_error_message true \ Do not retry
1136 load_successful_message true \ Successful, do not retry
1141 : process_module_errors ( addr ior -- )
1142 dup EBEFORELOAD = if
1145 dup module.name strtype
1146 dup module.loadname .len @ if
1147 ." (" dup module.loadname strtype ." )"
1150 ." Error executing "
1151 dup module.beforeload strtype cr \ XXX there was a typo here
1158 dup module.name .addr @ over module.name .len @ type
1159 dup module.loadname .len @ if
1160 ." (" dup module.loadname strtype ." )"
1163 ." Error executing "
1164 dup module.afterload strtype cr
1168 throw \ Don't know what it is all about -- pass ahead
1171 \ Module loading interface
1173 \ scan the list of modules, load enabled ones.
1174 : load_modules ( -- ) ( throws: abort & user-defined )
1175 module_options @ ( list_head )
1179 dup module.flag @ if
1180 ['] process_module catch
1181 process_module_errors
1187 \ h00h00 magic used to try loading either a kernel with a given name,
1188 \ or a kernel with the default name in a directory of a given name
1191 : bootpath s" /boot/" ;
1192 : modulepath s" module_path" ;
1194 \ Functions used to save and restore module_path's value.
1195 : saveenv ( addr len | -1 -- addr' len | 0 -1 )
1196 dup -1 = if 0 swap exit then
1199 : freeenv ( addr len | 0 -1 )
1200 -1 = if drop else free abort" Freeing error" then
1202 : restoreenv ( addr len | 0 -1 -- )
1203 dup -1 = if ( it wasn't set )
1209 r> free abort" Freeing error"
1213 : clip_args \ Drop second string if only one argument is passed
1224 \ Parse filename from a semicolon-separated list
1226 \ replacement, not working yet
1227 : newparse-; { addr len | a1 -- a' len-x addr x }
1228 addr len [char] ; strchr dup if ( a1 len1 )
1229 swap to a1 ( store address )
1230 1 - a1 @ 1 + swap ( remove match )
1237 : parse-; ( addr len -- addr' len-x addr x )
1238 over 0 2swap ( addr 0 addr len )
1240 dup 0 <> ( addr 0 addr len )
1242 over c@ [char] ; <> ( addr 0 addr len flag )
1253 \ Try loading one of multiple kernels specified
1255 : try_multiple_kernels ( addr len addr' len' args -- flag )
1261 s" DEBUG" getenv? if
1262 s" echo Module_path: ${module_path}" evaluate
1263 ." Kernel : " >r 2dup type r> cr
1264 dup 2 = if ." Flags : " >r 2over type r> cr then
1279 \ Try to load a kernel; the kernel name is taken from one of
1280 \ the following lists, as ordered:
1282 \ 1. The "bootfile" environment variable
1283 \ 2. The "kernel" environment variable
1285 \ Flags are passed, if available. If not, dummy values must be given.
1287 \ The kernel gets loaded from the current module_path.
1289 : load_a_kernel ( flags len 1 | x x 0 -- flag )
1295 \ Check if a default kernel name exists at all, exits if not
1296 s" bootfile" getenv dup -1 <> if
1298 flags kernel args 1+ try_multiple_kernels
1303 s" kernel" getenv dup -1 <> if
1310 \ Try all default kernel names
1311 flags kernel args 1+ try_multiple_kernels
1314 \ Try to load a kernel; the kernel name is taken from one of
1315 \ the following lists, as ordered:
1317 \ 1. The "bootfile" environment variable
1318 \ 2. The "kernel" environment variable
1320 \ Flags are passed, if provided.
1322 \ The kernel will be loaded from a directory computed from the
1323 \ path given. Two directories will be tried in the following order:
1328 \ The module_path variable is overridden if load is successful, by
1329 \ prepending the successful path.
1331 : load_from_directory ( path len 1 | flags len' path len 2 -- flag )
1334 args 1 = if 0 0 then
1336 0 0 2local oldmodulepath \ like a string
1337 0 0 2local newmodulepath \ like a string
1340 \ Set the environment variable module_path, and try loading
1342 modulepath getenv saveenv to oldmodulepath
1344 \ Try prepending /boot/ first
1345 bootpath nip path nip + \ total length
1346 oldmodulepath nip dup -1 = if
1349 1+ + \ add oldpath -- XXX why the 1+ ?
1351 allocate if ( out of memory ) 1 exit then \ XXX throw ?
1356 2dup to newmodulepath
1359 \ Try all default kernel names
1360 flags args 1- load_a_kernel
1362 oldmodulepath nip -1 <> if
1363 newmodulepath s" ;" strcat
1364 oldmodulepath strcat
1366 newmodulepath drop free-memory
1367 oldmodulepath drop free-memory
1372 \ Well, try without the prepended /boot/
1373 path newmodulepath drop swap move
1374 newmodulepath drop path nip
1375 2dup to newmodulepath
1378 \ Try all default kernel names
1379 flags args 1- load_a_kernel
1380 if ( failed once more )
1381 oldmodulepath restoreenv
1382 newmodulepath drop free-memory
1385 oldmodulepath nip -1 <> if
1386 newmodulepath s" ;" strcat
1387 oldmodulepath strcat
1389 newmodulepath drop free-memory
1390 oldmodulepath drop free-memory
1396 \ Try to load a kernel; the kernel name is taken from one of
1397 \ the following lists, as ordered:
1399 \ 1. The "bootfile" environment variable
1400 \ 2. The "kernel" environment variable
1401 \ 3. The "path" argument
1403 \ Flags are passed, if provided.
1405 \ The kernel will be loaded from a directory computed from the
1406 \ path given. Two directories will be tried in the following order:
1411 \ Unless "path" is meant to be kernel name itself. In that case, it
1412 \ will first be tried as a full path, and, next, search on the
1413 \ directories pointed by module_path.
1415 \ The module_path variable is overridden if load is successful, by
1416 \ prepending the successful path.
1418 : load_directory_or_file ( path len 1 | flags len' path len 2 -- flag )
1421 args 1 = if 0 0 then
1425 \ First, assume path is an absolute path to a directory
1426 flags path args clip_args load_from_directory
1427 dup 0= if exit else drop then
1429 \ Next, assume path points to the kernel
1430 flags path args try_multiple_kernels
1433 : initialize ( addr len -- )
1434 strdup conf_files strset
1437 : kernel_options ( -- addr len 1 | 0 )
1438 s" kernel_options" getenv
1439 dup -1 = if drop 0 else 1 then
1442 : standard_kernel_search ( flags 1 | 0 -- flag )
1447 dup -1 = if 0 swap then
1451 path nip -1 = if ( there isn't a "kernel" environment variable )
1452 flags args load_a_kernel
1454 flags path args 1+ clip_args load_directory_or_file
1458 : load_kernel ( -- ) ( throws: abort )
1459 kernel_options standard_kernel_search
1460 abort" Unable to load a kernel!"
1463 : load_xen ( -- flag )
1464 s" xen_kernel" getenv dup -1 <> if
1465 1 1 load ( c-addr/u flag N -- flag )
1472 : load_xen_throw ( -- ) ( throws: abort )
1474 abort" Unable to load Xen!"
1477 : set_defaultoptions ( -- )
1478 s" kernel_options" getenv dup -1 = if
1481 s" temp_options" setenv
1485 \ pick the i-th argument, i starts at 0
1486 : argv[] ( aN uN ... a1 u1 N i -- aN uN ... a1 u1 N ai+1 ui+1 )
1487 2dup = if 0 0 exit then \ out of range
1489 1+ 2* ( skip N and ui )
1492 1+ 2* ( skip N and ai )
1496 : drop_args ( aN uN ... a1 u1 N -- )
1504 : queue_argv ( aN uN ... a1 u1 N a u -- a u aN uN ... a1 u1 N+1 )
1512 : unqueue_argv ( aN uN ... a1 u1 N -- aN uN ... a2 u2 N-1 a1 u1 )
1516 \ compute the length of the buffer including the spaces between words
1517 : strlen(argv) ( aN uN .. a1 u1 N -- aN uN .. a1 u1 N len )
1518 dup 0= if 0 exit then
1533 : concat_argv ( aN uN ... a1 u1 N -- a u )
1534 strlen(argv) allocate if ENOMEM throw then
1535 0 2>r ( save addr 0 on return stack )
1540 unqueue_argv ( ... N a1 u1 )
1541 2r> 2swap ( old a1 u1 )
1543 s" " strcat ( append one space ) \ XXX this gives a trailing space
1544 2>r ( store string on the result stack )
1550 : set_tempoptions ( addrN lenN ... addr1 len1 N -- addr len 1 | 0 )
1551 \ Save the first argument, if it exists and is not a flag
1553 0 argv[] drop c@ [char] - <> if
1554 unqueue_argv 2>r \ Filename
1555 1 >r \ Filename present
1557 0 >r \ Filename not present
1560 0 >r \ Filename not present
1563 \ If there are other arguments, assume they are flags
1566 2dup s" temp_options" setenv
1567 drop free if EFREE throw then
1572 \ Bring back the filename, if one was provided
1573 r> if 2r> 1 else 0 then
1576 : get_arguments ( -- addrN lenN ... addr1 len1 N )
1579 \ Get next word on the command line
1584 drop ( empty string )
1587 : load_kernel_and_modules ( args -- flag )
1590 s" temp_options" getenv dup -1 <> if
1596 ?dup 0= if ( success )
1597 r> if ( a path was passed )
1598 load_directory_or_file
1600 standard_kernel_search
1602 ?dup 0= if ['] load_modules catch then
1606 only forth definitions