Return to bar CVS log

Up to [MW Coherent from dump] / coherent / d / conf / old_tboot

Annotation of coherent/d/conf/old_tboot/bar, revision 1.1

1.1     ! root        1:  * To pass a new data structure into the kernel:
        !             2:  *
        !             3:  * 1. Define your new data structure in typed.h.  You will probably want
        !             4:  *    to define some supporting routines for your data structure.  These
        !             5:  *    should go in a file by themselves.  Be sure to add the file to the
        !             6:  *    tboot Makefile.
        !             7:  * 
        !             8:  * 2. Write a routine that takes at least an ffp, which will generate your
        !             9:  *    data structure and write it into the ffp.  The routine should return 0
        !            10:  *    if it ran out of space in the FIFO.  Other return values are permissible,
        !            11:  *    but ignored.  Add arguments to prepare_gift() as needed.  It is called
        !            12:  *    only from the end of main() in tboot.c
        !            13:  *
        !            14:  * 3. Add a call to your routine to prepare_gift() in the section marked
        !            15:  *    FILL THE BOX.  This is an if statement with || seperated calls.  The
        !            16:  *    most important data structures should be called first, because later
        !            17:  *    calls will be skipped if the FIFO fills.
        !            18:  *
        !            19:  * 4. In the kernel (probably in a driver) you will want to add a loop to
        !            20:  *    look through the gift for your data structure:
        !            21:  *
        !            22:  *    FIFO *ffp;
        !            23:  *    typed_space *tp;
        !            24:  *
        !            25:  *    ffp = fifo_open(&boot_gift, 0);  -- Open gift for reading. 
        !            26:  * 
        !            27:  *    if (F_NULL == ffp) {
        !            28:  *       indicate_error("Could not open boot_gift.");
        !            29:  *    } else {
        !            30:  *        while (T_NULL != (tp = fifo_read(ffp))) {    -- While not EOFIFO.
        !            31:  *           if (T_MYTYPE == tp->ts_type) {    -- Is this my type?
        !            32:  *               my_handler(tp->ts_data);      -- Process the data.
        !            33:  *           }
        !            34:  *        }
        !            35:  *    }
        !            36:  *
        !            37:  *    Be sure to include fifo_k.c and typed.h into your kernel.
        !            38: 
        !            39: 
        !            40: gift_drive_params
        !            41: 
        !            42: gift_argf
        !            43:  * To read gift_argf from bootgift, use the procedure outlined above in
        !            44:  * point 4 to find the entry marked T_STR_ARGF.  You must then explicitly
        !            45:  * recast it with RETYPE(tp->ts_data, T_FIFO_SIC).  Then you can open it
        !            46:  * as a FIFO, with code modeled on point 4 above.  This scheme seemed
        !            47:  * the simplest for uniquely identifying the argument FIFO.
        !            48:  * Each element of the FIFO is a T_STR_STR, so ts_data for these is
        !            49:  * just a NUL terminated string.
        !            50: 
        !            51: gift_rootdev

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.