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)