Next Previous Contents

4. SHILKA Usage




SHILKA(1)                  User Manuals                 SHILKA(1)


NAME
       shilka - keywords description translator

SYNOPSIS
       shilka  [  -c++  --statistics -inline -strip -length -case
       -no-definitions -interface -export  -enum  -pprefix  -time
       -fast n -w -h -help -v] specification-file

DESCRIPTION
       SHILKA  generates  code  for  fast recognition of pipeline
       hazards of processor which is described  in  specification
       file.  The specification file must have suffix `.shilka'

       The  generated  code  consists  of  optional interface and
       implementation files having the same names as one of spec-
       ification  file  and  correspondingly  suffixes  `.h'  (if
       option -interface is given) and `.c' (C  code)  or  `.cpp'
       (C++ code).

       The  fast  recognition  of  keywords is based on structure
       called as minimal prunned O-trie.  Full  documentation  of
       SHILKA is in SHILKA User's manual.

OPTIONS
       The options which are known for SHILKA are:

       -c++   Output  of  C++  code  instead  of C code (which is
              default).

       -statistics
              Generation of macro definition  which  switches  on
              gathering  and  printing keyword occurrence statis-
              tics.  Then such statistics can be used for setting
              up  frequencies  in the description file for faster
              recognition of keywords.

       -inline
              Generation of function of  keyword  recognition  as
              inline  (take care with used C compiler).  This can
              be speed up keyword recognition.

       -strip Striping  off  code  for  gathering  and   printing
              statistics.   By default the code is present in the
              implementation file.  The code can be  switched  on
              by definition of a macro (see option -statistics ).

       -length
              Usage of strncmp instead of strcmp to compare  key-
              words.   This  can  be  useful if keyword is repre-
              sented by a string  without  C  string  end  marker
              (' ').

       -case  Keywords  case is ignored during their recognition.
              This  is  useful  for  recognition   keywords   (or



COCOM                       5 APR 2001                          1





SHILKA(1)                  User Manuals                 SHILKA(1)


              standard  identifiers) in such language as Fortran.

       -no-definitions
              No generation of macros (or  enumeration)  defining
              identifiers of keywords.

       -interface
              Generation  of additional interface file (with suf-
              fix `.h' ).

       -export
              SHILKA generates  macros  defining  identifiers  of
              keywords  in  the interface file (instead of in the
              implementation file).  This option has  sense  only
              when -interface is present.

       -enum  Output  of enumeration instead of macro definitions
              for identifiers of keywords.

       -pprefix
              Usage of prefix  instead  of  `KR_'  (default)  for
              names of generated objects.

       -time  Output  of  time  statistics of the SHILKA run into
              stderr.

       -fast n
              If number of rested unchecked characters is less or
              equal  n,  then  functions `strcmp' or `strncmp' is
              not used at all.  Instead of this, simply comparing
              rested  unchecked  characters  is  used.   This can
              speed up keyword recognition.  The default value of
              the parameter is 3.

       -w     Disable generation of all warnings.

       -h, -help
              Output of brief help message about SHILKA usage.

       -v     Creation of description file containing details how
              the code generated by  SHILKA  will  recognize  the
              keywords.

FILES
       file.shilka
              SHILKA specification file
       file.c
              generated C implementation file
       file.cpp
              generated C++ implementation file
       file.h
              generated interface file

       There are no any temporary files used by SHILKA.



COCOM                       5 APR 2001                          2





SHILKA(1)                  User Manuals                 SHILKA(1)


ENVIRONMENT
       There  are  no  environment  variables which affect SHILKA
       behavior.

DIAGNOSTICS
       SHILKA diagnostics is self-explanatory.

AUTHOR
       Vladimir N. Makarov, vmakarov@users.sourceforge.net

SEE ALSO
       msta(1), oka(1), sprut(1), nona(1).  SHILKA manual.

BUGS
       Please, report bugs to cocom-bugs@lists.sourceforge.net.










































COCOM                       5 APR 2001                          3


Next Previous Contents