NAME

diag − diagnostic script execution program

SYNOPSIS

diag [ catalog ]

DESCRIPTION

Diag is an example of a standalone program written with the standalone library.  Diag reads a catalog of standalone programs to be run, and executes each of the programs listed with the arguments indicated in the catalog.  Diag is used at MIPS to run a series of diagnostics, hence the name diag.

Diag is normally placed in the bfsd(8spp) home directory on some UMIPS-BSD server.  Standalone systems attached to an ethernet may then run diag with the prom monitor command:
boot -f bfs()diag catalog_file

Once running, diag prepends "bfs()" before the catalog_file and reads this file via the ethernet and bfsd(8spp). If catalog_file is not specified, the file "bfs()catalog" is read. 

Catalog_file should be a list of commands and their arguments.  Each command in the list is prepended with "bfs()" and then booted with the arguments that appear on in the catalog_file. 

An example catalog might be:

test1 arg1
test2 arg2

Given this catalog file diag would first boot "bfs()test1" with the argument "arg1", after test1 completes diag would the boot "bfs()test2" with the argument "arg2". 

BUGS

Diag must not be overlayed by the programs it loads, since these programs return control to diag. At MIPS, we load diag #define PCATCH 0400 #define PSWP 0 #define PINOD 10 #define PRIBIO 20 #define PZERO 25 #d