OSTEST(1) Retro Project Manual OSTEST(1) NNAAMMEE ostest - oskit test driver SSYYNNOOPPSSIISS oosstteesstt [_O_P_T_I_O_N]... [_K_I_T]... oosstteesstt ----hheellpp DDEESSCCRRIIPPTTIIOONN oosstteesstt organizes the automatized testing of oskits. If no _K_I_T argument is given a default set of oskits is tested. The default set depends on the available memory and thus on the board (specified with ----ssyyss). If _K_I_T arguments are given only these oskits will be tested. oosstteesstt starts for each oskit the operating system and executes some commands to verify basic system functionality. The major steps are: - determine the execution mode, either from the ----mmooddee option or the default _r_r_i, and load the execution mode package. - determine the target board, either from the ----ssyyss option or from the EEXXPPTTEESSTT__SSYYSS environment variable, and source the setup defini- tion. That defines board properties, like memory size, and the de- fault set of oskits. - configure the connected board if the ----ccoonnffiigg option is specified. - for each oskit: - source the oskit definition. That loads os family-specific code and defines oskit-specific parameters. - verify in the preboot procedure whether all preconditions for the execution of the oskit are met, e.g. a network environment. - check whether disk/tape images for the oskit are loaded, and if not, download and unpack them with oosskkiitt__sseettuupp(1). - boot the operating system and set the system time. - execute some tests. - execute shutdown procedure. - wait till the CPU enters the HALT state. OOPPTTIIOONNSS ----ssyyss==_s_y_s Defines the system which is configured, or in case the ----ccoonnffiigg is given, is to be configured. Must be specified if the EEXX-- PPTTEESSTT__SSYYSS environment variable is not specified. ----mmooddee==_m_o_d_e Defines the execution mode. The default is _r_r_i and is currently the only supported mode. ----lloogg[[==_f_n_a_m]] The output is written to a logfile. In case no name is specified an automatically generated name will be used. ----lloogguu Show full session on _s_t_d_o_u_t even when _-_-_l_o_g is active. ----ccoonnffiigg The connected board is configured with the system defined with the ----ssyyss option or the EEXXPPTTEESSTT__SSYYSS environment variable. First is checked with a _m_a_k_e _-_n whether the _<_s_y_s_>_._b_i_t file is avail- able and up-to-date. The script is aborted if the test fails. --hheellpp print full help text and exit. EENNVVIIRROONNMMEENNTT EEXXPPTTEESSTT__SSYYSS Defines the default system in case no ----ssyyss option is given. RREETTRROOBBAASSEE Defines root of all retro project files. FFIILLEESS _$_R_E_T_R_O_B_A_S_E_/_t_o_o_l_s_/_t_c_l_/_e_x_p_t_e_s_t___<_m_o_d_e_>_._t_c_l Implementation for execution mode _m_o_d_e. _$_R_E_T_R_O_B_A_S_E_/_t_o_o_l_s_/_e_x_p_t_e_s_t_/_s_y_s_/_<_s_y_s_>___s_e_t_u_p_._t_c_l Setup file for system _s_y_s. _$_R_E_T_R_O_B_A_S_E_/_t_o_o_l_s_/_o_s_k_i_t_/_t_e_s_t_/_k_i_t_/_<_k_i_t_>___s_e_t_u_p_._t_c_l Setup file for oskit _k_i_t. _$_R_E_T_R_O_B_A_S_E_/_t_o_o_l_s_/_o_s_k_i_t_/_t_e_s_t_/_o_s Path for ostest environment for os class of oskit _k_i_t. _$_R_E_T_R_O_B_A_S_E_/_t_o_o_l_s_/_o_s_k_i_t_/_<_k_i_t_>_/ Path for execution environment for oskit _k_i_t. EEXXAAMMPPLLEESS oosstteesstt ----ssyyss==ssyyss__ww1111aa__nn44dd --lloogg This command expects that a Digilent Nexys4 A7 board is connected and already configured with the _s_y_s___w_1_1_a___n_4_d system. It will exe- cute the set of default tests for this board and produce output like -I: log to ostest-2019-07-13-151006-sys_w11a_n4d.log ----- 15:10:06 ( 0.0, 0.0): 211bsd_rpmin ----- 15:10:34 ( 27.9, 27.9): 211bsd_rk ----- 15:11:00 ( 53.9, 26.0): 211bsd_rl ----- 15:11:27 ( 80.7, 26.8): 211bsd_rp ----- 15:11:55 ( 109.0, 28.3): 211bsd_rpeth -I: 'tap0' device required but not available -I: skip kit '211bsd_rpeth' The _2_1_1_b_s_d___r_p_e_t_h test was skipped because preconditions were not fulfilled. oosstteesstt ----ssyyss==ssyyss__ww1111aa__aarrttyy --lloogg 221111bbssdd__rrppmmiinn rrssxx1111mmpp--3300__rrpp This command expects that a Digilent Arty board is connected and already configured with the _s_y_s___w_1_1_a___a_r_t_y system and executes the _2_1_1_b_s_d___r_p_m_i_n and _r_s_x_1_1_m_p_-_3_0___r_p tests. SSEEEE AALLSSOO oosskkiitt__sseettuupp(1), mmcctteesstt(1) AAUUTTHHOORR Walter F.J. Mueller Retro Project 2022-05-09 OSTEST(1)