ATOM(1)                                                               ATOM(1)



NAME
   atom - a system for building customized analysis tools

SYNTAX
   atom [application program] [instrumentation file] [analysis file] options
  ...

DESCRIPTION
  The atom command takes an application program, instrumentation file, and
  analysis file as input, and produces a non-shared instrumented application
  program executable.  The name of the output executable may be specified
  with -o option, otherwise progname.atom is used.

  If only the application program is specified, and no analysis and instru-
  mentation files are given, atom produces a non-shared uninstrumented exe-
  cutable.

  The application program must be a fully liked non_shared object module. It
  may be produced by giving cc the Wl,-r and -non_shared option.  See ATOM's
  user manual on how to build application program modules.

  The instrumentation and analysis file may be .c or  .o file. If analysis
  routines are in more than one file, the .o of each file may be linked
  together into one file using ld with a -r option. The instrumentation file
  modules may also be combined in this manner.



OPTIONS

 -o filename
            filename is the name of the output executable.


 -P toolname
            toolname is the name of the tool produced in the intermediate
            step.  It is not deleted.

 -T textaddress
            textaddress is the start of the text address for the application
            program.

 -D dataaddress
            dataaddress is the start of the data address for the application
            program.

 -32addr
            the textaddress starts at 0x20000000 and data address starts at
            0x40000000.

 -heap offset
            the start of the heap of the analysis routines is bumped by
            offset.  This is used to divide the heap between the application
            and analysis routines.

 -tool toolname
            toolname is the name of a general-purpose tool that is provided
            with the ATOM kit.  Do `man atomtools ' to find the current set
            of tools that are supported.

 -g
            produce the instrumented program with debugging information.
            This enables debugging of analysis routines

 -dbx
            allows debugging of instrumentation routines.  ATOM puts the con-
            trol in dbx with a stop at Instrument routine.  See the Reference
            Manual Appendix B on how to use dbx with ATOM.

 -v
            display each step of atom.

 -toolargs=arg1,arg2,...
            allows argument to be passed to Instrument routine.  Instrument
            routine now takes (int argc, char **argv) as arguments.

 -A1
            ATOM optimizes the calls to analysis routines by reducing the
            number of registers that need to be restored.

 -version
            display the version number of atom.

  The disgnostic messages produced by atom are printed on the standard error
  file.


FILES

  /usr/lib/atom/doc/user.ps
  /usr/lib/atom/doc/ref.ps


SEE ALSO

  omdiag(1), third(1), atomtools(5)