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 )
368 line_buffer .len @ if
370 line_buffer .len @ r@ +
371 resize if ENOMEM throw then
373 r@ allocate if ENOMEM throw then
379 : append_to_line_buffer ( addr len -- )
380 dup 0= if 2drop exit then
388 scan_buffer ( -- addr len )
389 line_buffer_resize ( len -- len )
390 append_to_line_buffer ( addr len -- )
394 read_buffer .len @ read_buffer_ptr =
400 read_buffer .addr @ 0= if
401 read_buffer_size allocate if ENOMEM throw then
404 fd @ read_buffer .addr @ read_buffer_size fread
405 dup -1 = if EREAD throw then
406 dup 0= if true to end_of_file? then
410 get-current ( -- wid ) previous definitions >search ( wid -- )
428 only forth also support-functions definitions
430 \ Conf file line parser:
431 \ <line> ::= <spaces><name><spaces>'='<spaces><value><spaces>[<comment>] |
432 \ <spaces>[<comment>]
433 \ <name> ::= <letter>{<letter>|<digit>|'_'}
434 \ <value> ::= '"'{<character_set>|'\'<anything>}'"' | <name>
435 \ <character_set> ::= ASCII 32 to 126, except '\' and '"'
436 \ <comment> ::= '#'{<anything>}
444 vocabulary file-processing
445 also file-processing definitions
453 also parser definitions
455 0 value parsing_function
458 : end_of_line? line_pointer end_of_line = ;
460 \ classifiers for various character classes in the input line
479 : quote? line_pointer c@ [char] " = ;
481 : assignment_sign? line_pointer c@ [char] = = ;
483 : comment? line_pointer c@ [char] # = ;
485 : space? line_pointer c@ bl = line_pointer c@ tab = or ;
487 : backslash? line_pointer c@ [char] \ = ;
489 : underscore? line_pointer c@ [char] _ = ;
491 : dot? line_pointer c@ [char] . = ;
493 \ manipulation of input line
494 : skip_character line_pointer char+ to line_pointer ;
496 : skip_to_end_of_line end_of_line to line_pointer ;
500 end_of_line? if 0 else space? then
506 : parse_name ( -- addr len )
509 end_of_line? if 0 else letter? digit? underscore? dot? or or or then
517 : remove_backslashes { addr len | addr' len' -- addr' len' }
518 len allocate if ENOMEM throw then
522 addr c@ [char] \ <> if
523 addr c@ addr' len' + c!
533 : parse_quote ( -- addr len )
536 end_of_line? if ESYNTAX throw then
542 end_of_line? if ESYNTAX throw then
545 end_of_line? if ESYNTAX throw then
553 parse_name ( -- addr len )
559 parse_quote ( -- addr len )
561 parse_name ( -- addr len )
572 comment? if ['] comment to parsing_function exit then
573 end_of_line? 0= if ESYNTAX throw then
578 ['] white_space_4 to parsing_function
583 letter? digit? quote? or or if
584 ['] variable_value to parsing_function exit
591 ['] white_space_3 to parsing_function
596 assignment_sign? if ['] assignment_sign to parsing_function exit then
602 ['] white_space_2 to parsing_function
607 letter? if ['] variable_name to parsing_function exit then
608 comment? if ['] comment to parsing_function exit then
609 end_of_line? 0= if ESYNTAX throw then
612 get-current ( -- wid ) previous definitions >search ( wid -- )
615 line_buffer strget + to end_of_line
616 line_buffer .addr @ to line_pointer
617 ['] white_space_1 to parsing_function
621 parsing_function execute
623 parsing_function ['] comment =
624 parsing_function ['] white_space_1 =
625 parsing_function ['] white_space_4 =
626 or or 0= if ESYNTAX throw then
629 only forth also support-functions also file-processing definitions
633 : assignment_type? ( addr len -- flag )
638 : suffix_type? ( addr len -- flag )
639 name_buffer .len @ over <= if 2drop false exit then
640 name_buffer .len @ over - name_buffer .addr @ +
644 : loader_conf_files? s" loader_conf_files" assignment_type? ;
646 : nextboot_flag? s" nextboot_enable" assignment_type? ;
648 : nextboot_conf? s" nextboot_conf" assignment_type? ;
650 : verbose_flag? s" verbose_loading" assignment_type? ;
652 : execute? s" exec" assignment_type? ;
654 : module_load? load_module_suffix suffix_type? ;
656 : module_loadname? module_loadname_suffix suffix_type? ;
658 : module_type? module_type_suffix suffix_type? ;
660 : module_args? module_args_suffix suffix_type? ;
662 : module_beforeload? module_beforeload_suffix suffix_type? ;
664 : module_afterload? module_afterload_suffix suffix_type? ;
666 : module_loaderror? module_loaderror_suffix suffix_type? ;
668 \ build a 'set' statement and execute it
669 : set_environment_variable
670 name_buffer .len @ value_buffer .len @ + 5 chars + \ size of result string
671 allocate if ENOMEM throw then
672 dup 0 \ start with an empty string and append the pieces
674 name_buffer strget strcat
676 value_buffer strget strcat
677 ['] evaluate catch if
686 set_environment_variable
687 s" loader_conf_files" getenv conf_files string=
691 value_buffer strget unquote nextboot_conf_file string=
694 : append_to_module_options_list ( addr -- )
695 module_options @ 0= if
699 dup last_module_option @ module.next !
704 : set_module_name { addr -- } \ check leaks
705 name_buffer strget addr module.name string=
709 value_buffer strget \ XXX could use unquote
710 2dup s' "YES"' compare >r
711 2dup s' "yes"' compare >r
712 2dup s" YES" compare >r
713 s" yes" compare r> r> r> and and and 0=
716 : find_module_option ( -- addr | 0 ) \ return ptr to entry matching name_buffer
721 dup module.name strget
723 compare 0= if exit then
728 : new_module_option ( -- addr )
729 sizeof module allocate if ENOMEM throw then
730 dup sizeof module erase
731 dup append_to_module_options_list
735 : get_module_option ( -- addr )
737 ?dup 0= if new_module_option then
741 name_buffer .len @ load_module_suffix nip - name_buffer .len !
742 yes_value? get_module_option module.flag !
746 name_buffer .len @ module_args_suffix nip - name_buffer .len !
747 value_buffer strget unquote
748 get_module_option module.args string=
751 : set_module_loadname
752 name_buffer .len @ module_loadname_suffix nip - name_buffer .len !
753 value_buffer strget unquote
754 get_module_option module.loadname string=
758 name_buffer .len @ module_type_suffix nip - name_buffer .len !
759 value_buffer strget unquote
760 get_module_option module.type string=
763 : set_module_beforeload
764 name_buffer .len @ module_beforeload_suffix nip - name_buffer .len !
765 value_buffer strget unquote
766 get_module_option module.beforeload string=
769 : set_module_afterload
770 name_buffer .len @ module_afterload_suffix nip - name_buffer .len !
771 value_buffer strget unquote
772 get_module_option module.afterload string=
775 : set_module_loaderror
776 name_buffer .len @ module_loaderror_suffix nip - name_buffer .len !
777 value_buffer strget unquote
778 get_module_option module.loaderror string=
782 yes_value? to nextboot?
786 yes_value? to verbose?
790 value_buffer strget unquote
791 ['] evaluate catch if EEXEC throw then
795 name_buffer .len @ 0= if exit then
796 loader_conf_files? if set_conf_files exit then
797 nextboot_flag? if set_nextboot_flag exit then
798 nextboot_conf? if set_nextboot_conf exit then
799 verbose_flag? if set_verbose exit then
800 execute? if execute_command exit then
801 module_load? if set_module_flag exit then
802 module_loadname? if set_module_loadname exit then
803 module_type? if set_module_type exit then
804 module_args? if set_module_args exit then
805 module_beforeload? if set_module_beforeload exit then
806 module_afterload? if set_module_afterload exit then
807 module_loaderror? if set_module_loaderror exit then
808 set_environment_variable
813 \ Free some pointers if needed. The code then tests for errors
814 \ in freeing, and throws an exception if needed. If a pointer is
815 \ not allocated, it's value (0) is used as flag.
822 \ Higher level file processing
824 get-current ( -- wid ) previous definitions >search ( wid -- )
833 ['] process_assignment catch
834 ['] free_buffers catch
839 : peek_file ( addr len -- )
843 fd @ -1 = if EOPEN throw then
847 ['] process_assignment catch
848 ['] free_buffers catch
853 only forth also support-functions definitions
855 \ Interface to loading conf files
857 : load_conf ( addr len -- )
861 fd @ -1 = if EOPEN throw then
862 ['] process_conf catch
867 : print_line line_buffer strtype cr ;
870 line_buffer strtype cr
882 \ Debugging support functions
884 only forth definitions also support-functions
887 ['] load_conf catch dup .
888 ESYNTAX = if cr print_syntax_error then
891 \ find a module name, leave addr on the stack (0 if not found)
892 : find-module ( <module> -- ptr | 0 )
893 bl parse ( addr len )
894 module_options @ >r ( store current pointer )
898 2dup ( addr len addr len )
899 r@ module.name strget
900 compare 0= if drop drop r> exit then ( found it )
903 type ." was not found" cr r>
906 : show-nonempty ( addr len mod -- )
907 strget dup verbose? or if
913 : show-one-module { addr -- addr }
914 ." Name: " addr module.name strtype cr
915 s" Path: " addr module.loadname show-nonempty
916 s" Type: " addr module.type show-nonempty
917 s" Flags: " addr module.args show-nonempty
918 s" Before load: " addr module.beforeload show-nonempty
919 s" After load: " addr module.afterload show-nonempty
920 s" Error: " addr module.loaderror show-nonempty
921 ." Status: " addr module.flag @ if ." Load" else ." Don't load" then cr
926 : show-module-options
936 : free-one-module { addr -- addr }
937 addr module.name strfree
938 addr module.loadname strfree
939 addr module.type strfree
940 addr module.args strfree
941 addr module.beforeload strfree
942 addr module.afterload strfree
943 addr module.loaderror strfree
947 : free-module-options
957 0 last_module_option !
960 only forth also support-functions definitions
962 \ Variables used for processing multiple conf files
964 string current_file_name_ref \ used to print the file name
966 \ Indicates if any conf file was successfully read
968 0 value any_conf_read?
970 \ loader_conf_files processing support functions
972 : get_conf_files ( -- addr len ) \ put addr/len on stack, reset var
973 conf_files strget 0 0 conf_files strset
976 : skip_leading_spaces { addr len pos -- addr len pos' }
978 pos len = if 0 else addr pos + c@ bl = then
985 \ return the file name at pos, or free the string if nothing left
986 : get_file_name { addr len pos -- addr len pos' addr' len' || 0 }
988 addr free abort" Fatal error freeing memory"
993 \ stay in the loop until have chars and they are not blank
994 pos len = if 0 else addr pos + c@ bl <> then
998 addr len pos addr r@ + pos r> -
1001 : get_next_file ( addr len ptr -- addr len ptr' addr' len' | 0 )
1006 : print_current_file
1007 current_file_name_ref strtype
1010 : process_conf_errors
1011 dup 0= if true to any_conf_read? drop exit then
1014 ." Warning: syntax error on file " print_current_file cr
1015 print_syntax_error drop exit
1018 ." Warning: bad definition on file " print_current_file cr
1019 print_line drop exit
1022 ." Warning: error reading file " print_current_file cr drop exit
1025 verbose? if ." Warning: unable to open file " print_current_file cr then
1028 dup EFREE = abort" Fatal error freeing memory"
1029 dup ENOMEM = abort" Out of memory"
1030 throw \ Unknown error -- pass ahead
1033 \ Process loader_conf_files recursively
1034 \ Interface to loader_conf_files processing
1036 : include_conf_files
1037 get_conf_files 0 ( addr len offset )
1039 get_next_file ?dup ( addr len 1 | 0 )
1041 current_file_name_ref strref
1044 conf_files .addr @ if recurse then
1048 : get_nextboot_conf_file ( -- addr len )
1049 nextboot_conf_file strget
1052 : rewrite_nextboot_file ( -- )
1053 get_nextboot_conf_file
1055 fd @ -1 = if EOPEN throw then
1056 fd @ s' nextboot_enable="NO" ' fwrite ( fd buf len -- nwritten ) drop
1060 : include_nextboot_file ( -- )
1061 get_nextboot_conf_file
1062 ['] peek_file catch if 2drop then
1064 get_nextboot_conf_file
1065 current_file_name_ref strref
1068 ['] rewrite_nextboot_file catch if 2drop then
1072 \ Module loading functions
1074 : load_parameters { addr -- addr addrN lenN ... addr1 len1 N }
1076 addr module.args strget
1077 addr module.loadname .len @ if
1078 addr module.loadname strget
1080 addr module.name strget
1082 addr module.type .len @ if
1083 addr module.type strget
1085 4 ( -t type name flags )
1091 : before_load ( addr -- addr )
1092 dup module.beforeload .len @ if
1093 dup module.beforeload strget
1094 ['] evaluate catch if EBEFORELOAD throw then
1098 : after_load ( addr -- addr )
1099 dup module.afterload .len @ if
1100 dup module.afterload strget
1101 ['] evaluate catch if EAFTERLOAD throw then
1105 : load_error ( addr -- addr )
1106 dup module.loaderror .len @ if
1107 dup module.loaderror strget
1108 evaluate \ This we do not intercept so it can throw errors
1112 : pre_load_message ( addr -- addr )
1114 dup module.name strtype
1119 : load_error_message verbose? if ." failed!" cr then ;
1121 : load_successful_message verbose? if ." ok" cr then ;
1124 load_parameters load
1127 : process_module ( addr -- addr )
1131 ['] load_module catch if
1132 dup module.loaderror .len @ if
1133 load_error \ Command should return a flag!
1135 load_error_message true \ Do not retry
1139 load_successful_message true \ Successful, do not retry
1144 : process_module_errors ( addr ior -- )
1145 dup EBEFORELOAD = if
1148 dup module.name strtype
1149 dup module.loadname .len @ if
1150 ." (" dup module.loadname strtype ." )"
1153 ." Error executing "
1154 dup module.beforeload strtype cr \ XXX there was a typo here
1161 dup module.name .addr @ over module.name .len @ type
1162 dup module.loadname .len @ if
1163 ." (" dup module.loadname strtype ." )"
1166 ." Error executing "
1167 dup module.afterload strtype cr
1171 throw \ Don't know what it is all about -- pass ahead
1174 \ Module loading interface
1176 \ scan the list of modules, load enabled ones.
1177 : load_modules ( -- ) ( throws: abort & user-defined )
1178 module_options @ ( list_head )
1182 dup module.flag @ if
1183 ['] process_module catch
1184 process_module_errors
1190 \ h00h00 magic used to try loading either a kernel with a given name,
1191 \ or a kernel with the default name in a directory of a given name
1194 : bootpath s" /boot/" ;
1195 : modulepath s" module_path" ;
1197 \ Functions used to save and restore module_path's value.
1198 : saveenv ( addr len | -1 -- addr' len | 0 -1 )
1199 dup -1 = if 0 swap exit then
1202 : freeenv ( addr len | 0 -1 )
1203 -1 = if drop else free abort" Freeing error" then
1205 : restoreenv ( addr len | 0 -1 -- )
1206 dup -1 = if ( it wasn't set )
1212 r> free abort" Freeing error"
1216 : clip_args \ Drop second string if only one argument is passed
1227 \ Parse filename from a semicolon-separated list
1229 \ replacement, not working yet
1230 : newparse-; { addr len | a1 -- a' len-x addr x }
1231 addr len [char] ; strchr dup if ( a1 len1 )
1232 swap to a1 ( store address )
1233 1 - a1 @ 1 + swap ( remove match )
1240 : parse-; ( addr len -- addr' len-x addr x )
1241 over 0 2swap ( addr 0 addr len )
1243 dup 0 <> ( addr 0 addr len )
1245 over c@ [char] ; <> ( addr 0 addr len flag )
1256 \ Try loading one of multiple kernels specified
1258 : try_multiple_kernels ( addr len addr' len' args -- flag )
1264 s" DEBUG" getenv? if
1265 s" echo Module_path: ${module_path}" evaluate
1266 ." Kernel : " >r 2dup type r> cr
1267 dup 2 = if ." Flags : " >r 2over type r> cr then
1282 \ Try to load a kernel; the kernel name is taken from one of
1283 \ the following lists, as ordered:
1285 \ 1. The "bootfile" environment variable
1286 \ 2. The "kernel" environment variable
1288 \ Flags are passed, if available. If not, dummy values must be given.
1290 \ The kernel gets loaded from the current module_path.
1292 : load_a_kernel ( flags len 1 | x x 0 -- flag )
1298 \ Check if a default kernel name exists at all, exits if not
1299 s" bootfile" getenv dup -1 <> if
1301 flags kernel args 1+ try_multiple_kernels
1306 s" kernel" getenv dup -1 <> if
1313 \ Try all default kernel names
1314 flags kernel args 1+ try_multiple_kernels
1317 \ Try to load a kernel; the kernel name is taken from one of
1318 \ the following lists, as ordered:
1320 \ 1. The "bootfile" environment variable
1321 \ 2. The "kernel" environment variable
1323 \ Flags are passed, if provided.
1325 \ The kernel will be loaded from a directory computed from the
1326 \ path given. Two directories will be tried in the following order:
1331 \ The module_path variable is overridden if load is successful, by
1332 \ prepending the successful path.
1334 : load_from_directory ( path len 1 | flags len' path len 2 -- flag )
1337 args 1 = if 0 0 then
1339 0 0 2local oldmodulepath \ like a string
1340 0 0 2local newmodulepath \ like a string
1343 \ Set the environment variable module_path, and try loading
1345 modulepath getenv saveenv to oldmodulepath
1347 \ Try prepending /boot/ first
1348 bootpath nip path nip + \ total length
1349 oldmodulepath nip dup -1 = if
1352 1+ + \ add oldpath -- XXX why the 1+ ?
1354 allocate if ( out of memory ) 1 exit then \ XXX throw ?
1359 2dup to newmodulepath
1362 \ Try all default kernel names
1363 flags args 1- load_a_kernel
1365 oldmodulepath nip -1 <> if
1366 newmodulepath s" ;" strcat
1367 oldmodulepath strcat
1369 newmodulepath drop free-memory
1370 oldmodulepath drop free-memory
1375 \ Well, try without the prepended /boot/
1376 path newmodulepath drop swap move
1377 newmodulepath drop path nip
1378 2dup to newmodulepath
1381 \ Try all default kernel names
1382 flags args 1- load_a_kernel
1383 if ( failed once more )
1384 oldmodulepath restoreenv
1385 newmodulepath drop free-memory
1388 oldmodulepath nip -1 <> if
1389 newmodulepath s" ;" strcat
1390 oldmodulepath strcat
1392 newmodulepath drop free-memory
1393 oldmodulepath drop free-memory
1399 \ Try to load a kernel; the kernel name is taken from one of
1400 \ the following lists, as ordered:
1402 \ 1. The "bootfile" environment variable
1403 \ 2. The "kernel" environment variable
1404 \ 3. The "path" argument
1406 \ Flags are passed, if provided.
1408 \ The kernel will be loaded from a directory computed from the
1409 \ path given. Two directories will be tried in the following order:
1414 \ Unless "path" is meant to be kernel name itself. In that case, it
1415 \ will first be tried as a full path, and, next, search on the
1416 \ directories pointed by module_path.
1418 \ The module_path variable is overridden if load is successful, by
1419 \ prepending the successful path.
1421 : load_directory_or_file ( path len 1 | flags len' path len 2 -- flag )
1424 args 1 = if 0 0 then
1428 \ First, assume path is an absolute path to a directory
1429 flags path args clip_args load_from_directory
1430 dup 0= if exit else drop then
1432 \ Next, assume path points to the kernel
1433 flags path args try_multiple_kernels
1436 : initialize ( addr len -- )
1437 strdup conf_files strset
1440 : kernel_options ( -- addr len 1 | 0 )
1441 s" kernel_options" getenv
1442 dup -1 = if drop 0 else 1 then
1445 : standard_kernel_search ( flags 1 | 0 -- flag )
1450 dup -1 = if 0 swap then
1454 path nip -1 = if ( there isn't a "kernel" environment variable )
1455 flags args load_a_kernel
1457 flags path args 1+ clip_args load_directory_or_file
1461 : load_kernel ( -- ) ( throws: abort )
1462 kernel_options standard_kernel_search
1463 abort" Unable to load a kernel!"
1466 : load_xen ( -- flag )
1467 s" xen_kernel" getenv dup -1 <> if
1468 1 1 load ( c-addr/u flag N -- flag )
1475 : load_xen_throw ( -- ) ( throws: abort )
1477 abort" Unable to load Xen!"
1480 : set_defaultoptions ( -- )
1481 s" kernel_options" getenv dup -1 = if
1484 s" temp_options" setenv
1488 \ pick the i-th argument, i starts at 0
1489 : argv[] ( aN uN ... a1 u1 N i -- aN uN ... a1 u1 N ai+1 ui+1 )
1490 2dup = if 0 0 exit then \ out of range
1492 1+ 2* ( skip N and ui )
1495 1+ 2* ( skip N and ai )
1499 : drop_args ( aN uN ... a1 u1 N -- )
1507 : queue_argv ( aN uN ... a1 u1 N a u -- a u aN uN ... a1 u1 N+1 )
1515 : unqueue_argv ( aN uN ... a1 u1 N -- aN uN ... a2 u2 N-1 a1 u1 )
1519 \ compute the length of the buffer including the spaces between words
1520 : strlen(argv) ( aN uN .. a1 u1 N -- aN uN .. a1 u1 N len )
1521 dup 0= if 0 exit then
1536 : concat_argv ( aN uN ... a1 u1 N -- a u )
1537 strlen(argv) allocate if ENOMEM throw then
1538 0 2>r ( save addr 0 on return stack )
1543 unqueue_argv ( ... N a1 u1 )
1544 2r> 2swap ( old a1 u1 )
1546 s" " strcat ( append one space ) \ XXX this gives a trailing space
1547 2>r ( store string on the result stack )
1553 : set_tempoptions ( addrN lenN ... addr1 len1 N -- addr len 1 | 0 )
1554 \ Save the first argument, if it exists and is not a flag
1556 0 argv[] drop c@ [char] - <> if
1557 unqueue_argv 2>r \ Filename
1558 1 >r \ Filename present
1560 0 >r \ Filename not present
1563 0 >r \ Filename not present
1566 \ If there are other arguments, assume they are flags
1569 2dup s" temp_options" setenv
1570 drop free if EFREE throw then
1575 \ Bring back the filename, if one was provided
1576 r> if 2r> 1 else 0 then
1579 : get_arguments ( -- addrN lenN ... addr1 len1 N )
1582 \ Get next word on the command line
1587 drop ( empty string )
1590 : load_kernel_and_modules ( args -- flag )
1593 s" temp_options" getenv dup -1 <> if
1599 ?dup 0= if ( success )
1600 r> if ( a path was passed )
1601 load_directory_or_file
1603 standard_kernel_search
1605 ?dup 0= if ['] load_modules catch then
1609 only forth definitions