NAME

       nescc-ncg - extract constants from nesC files

SYNOPSIS

       nescc-ncg [any nescc option] [tool-specific options]
                 [-o output-file] [-nescc=driver]
                 tool nesC-file filenames-or-constant-names...

DESCRIPTION

       nescc-ncg is a tool to extract constants from nesC files for use with other applications. It is typically
       used in conjunction with nescc-mig (which generates code to process nesC messages) to  extract  constants
       that are used in particular messages (e.g., constants representing various commands).

       The tool argument specifies what tool should be generated, the nesC-file specifies a nesC file which uses
       the constants you want to extract.  If your constants are all in a single .h file that does not depend on
       any  other  files, then you can specify the .h file directly as the msg-format-file. Note that if some of
       your constants are defined with unique(...) or uniqueCount(...), you must specify your whole  application
       as the nesC-file, or you will not get the correct constant values.

       Each  filenames-or-constant-names  is either a constant name (if it consists only of letters, numbers and
       _) or a filename. In the former case, the specified constant will be extracted, in the  latter  case  all
       constants  from  the specified C file will be extracted. Only constants declared in C files will be found
       by nescc-ncg.

       The current tools are java, python and C, which generate java, python and C code that contains the values
       of the requested constants.

OPTIONS

       You can pass any nescc option, as well as

       -o output-file
              Specify the file in which to output the generated code.

       -nescc=driver
              Use driver instead of nescc to extract constants.  For example, if you specify -nescc=ncc, you can
              use nescc-ncg to extract constants from TinyOS applications  (which  are  normally  compiled  with
              ncc).

       tool-specific options
              See below.

JAVA TOOL

       This  tool  generates  a  java class with the values of the requested constants.  These constants will be
       public final static and have a type chosen from byte, short, char, int, long (the chosen type will be the
       first one in this list that can hold the constants value - this reduces the need for casts).

       The java tool accepts the following options:

       -java-classname=full-class-name
              This  option  is  required and specifies the package and name of the generated class. If the full-
              class-name has no '.', then no package directive is included in the output.

       -java-extends=class-name
              Specify the class the generated class will extend. The default is Object.

PYTHON TOOL

       This tool generates a Python class with the values of the requested constants.  These constants  will  be
       class (rather than instance) variables.

       The Python tool accepts the following options:

       -python-classname=full-class-name
              This option is required and specifies the name of the generated class.

       -python-extends=class-name
              Specify the class the generated class will extend. The default is is to not inherit.

C TOOL

       This  tool  generates  a  C  header  file  with  the  values  of the requested constants (defined as enum
       constants).

       The C tool accepts the following option:

       -c-prefix=prefix
              This option specifies a prefix to attach to the generated constants.

ERRORS

       nescc-ncg reports an error if ncc cannot compile nesC-file.

SEE ALSO

       nescc(1), nescc-mig(1)

                                                 April 27, 2004                                     nescc-ncg(1)