"Fossies" - the Fresh Open Source Software Archive

Member "ncc-2.8/doc/KEYS.txt" (24 Dec 2002, 1225 Bytes) of package /linux/privat/old/ncc-2.8.tar.gz:

    1 
    2 ncc KEYS
    3 ========
    4 
    5 Some times, it is useful to pass additional information to the ncc output.
    6 For example resolving handlers or providing the call flow of assembly code.
    7 
    8 This can be done with the -nckey option.
    9 With this option ncc will scan the string literals of the
   10 source file for the ones starting with
   11 
   12 	"ncc-key"
   13 
   14 and print everything the rest of this string to the output.
   15 
   16 An example, in linux kernel, every one jiffie, the do_timers() is called
   17 which marks the timers bottom half handler active. Then, the next time the
   18 scheduler will run, it will run do_bottom_half().
   19 do_bottom_half() will then call timer_bh() which will call update_times(),
   20 etc. Here is the text resolving that and adding it to the ncc output nicely
   21 for nccnav format.
   22 
   23 /*
   24 somewhere inside sched.c ....
   25 */
   26 
   27 #ifdef __NCC__
   28 char some_unused_name [] = "ncc-key"
   29 "
   30 D: do_bottom_half()
   31 F: timer_bh()
   32 ";
   33 #endif
   34 
   35 ------
   36 
   37 keys can have names. For instance, -nckey-special-assembly-output-3D
   38 will search for the strings starting with:
   39 
   40 	"ncc-key-special-assembly-output-3D"
   41 
   42 
   43 -----
   44 
   45 This feature is a bit irrelevant with the compiler and on the other hand can
   46 be greatly improved. We keep it as a "hack" to join manually nodes in the
   47 call flow graph.