NAME

       openocd - A free and open on-chip debugging, in-system programming and boundary-scan testing tool for ARM
       and MIPS systems

SYNOPSIS

       openocd  [-fsdlcphv]  [--file  <filename>]  [--search  <dirname>]  [--debug  <debuglevel>]  [--log_output
       <filename>] [--command <cmd>] [--pipe] [--help] [--version]

DESCRIPTION

       OpenOCD is an on-chip debugging, in-system programming and boundary-scan testing tool for various ARM and
       MIPS systems.

       The debugger uses an IEEE 1149-1 compliant JTAG TAP bus master  to  access  on-chip  debug  functionality
       available on ARM based microcontrollers or system-on-chip solutions. For MIPS systems the EJTAG interface
       is supported.

       User interaction is realized through a telnet command line interface, a gdb  (the  GNU  debugger)  remote
       protocol  server,  and  a  simplified RPC connection that can be used to interface with OpenOCD's Jim Tcl
       engine.

       OpenOCD supports various different types of JTAG interfaces/programmers, please check  the  openocd  info
       page for the complete list.

OPTIONS

       -f, --file <filename>
              This  is  a  shortcut  for  a  -c  "[script  <filename>]" command, using a search path to load the
              configuration file <filename>.  In order to specify multiple config files, you  can  use  multiple
              --file  arguments.  If  no  such -c options are included, the first config file openocd.cfg in the
              search path will be used.

       -s, --search <dirname>
              Add <dirname> to the search path used for config files and scripts.  The search path  begins  with
              the  current directory, then includes these additional directories before other components such as
              the standard OpenOCD script libraries.

       -d, --debug <debuglevel>
              Set debug level. Possible values are:
                * 0 (errors)
                * 1 (warnings)
                * 2 (informational messages)
                * 3 (debug messages)
              The default level is 2.

       -l, --log_output <filename>
              Redirect log output to the file <filename>.  Per default the log output is printed on stderr.

       -c, --command <cmd>
              Add the command <cmd> to a list of commands executed on server startup.  Note that you  will  need
              to explicitly invoke init if the command requires access to a target or flash.

       -p, --pipe
              Use pipes when talking to gdb.

       -h, --help
              Show a help text and exit.

       -v, --version
              Show version information and exit.

BUGS

       Please report any bugs on the mailing list at openocd-devel@lists.sourceforge.net.

LICENCE

       OpenOCD is covered by the GNU General Public License (GPL), version 2 or later.

SEE ALSO

       jtag(1)

       The  full documentation for openocd is maintained as a Texinfo manual. If the info (or pinfo) and openocd
       programs are properly installed at your site, the command info openocd should  give  you  access  to  the
       complete manual.

AUTHORS

       Please see the file AUTHORS.

       This  manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.  It is licensed under the terms of the
       GNU GPL (version 2 or later).

                                                November 24, 2009                                     OPENOCD(1)