interesting
/
riscv-openocd
mirror of https://github.com/riscv/riscv-openocd.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

doc: Refurbish manual page 

Remove the outdated option '--pipe' and bring the description of OpenOCD
up to date without focus on JTAG only.

Change-Id: If52e936a366dde21c1dd514bd3960d100b540e77
Signed-off-by: Marc Schink <dev@zapb.de>
Reviewed-on: https://review.openocd.org/c/openocd/+/8347
Tested-by: jenkins
Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
This commit is contained in:
Marc Schink 2024-06-18 17:26:21 +02:00 committed by Antonio Borneo
parent 636f003eee
commit 6ed058933c
1 changed files with 7 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/openocd.1
View File

@ -1,24 +1,21 @@
.TH "OPENOCD" "1" "November 24, 2009" .TH "OPENOCD" "1" "June 18, 2024"
.SH "NAME" .SH "NAME"
openocd \- A free and open on\-chip debugging, in\-system programming and openocd \- A free and open on\-chip debugging, in\-system programming and
boundary\-scan testing tool for ARM and MIPS systems boundary\-scan testing tool for microcontrollers and other embedded devices
.SH "SYNOPSIS" .SH "SYNOPSIS"
.B openocd \fR[\fB\-fsdlcphv\fR] [\fB\-\-file\fR <filename>] [\fB\-\-search\fR <dirname>] [\fB\-\-debug\fR <debuglevel>] [\fB\-\-log_output\fR <filename>] [\fB\-\-command\fR <cmd>] [\fB\-\-pipe\fR] [\fB\-\-help\fR] [\fB\-\-version\fR] .B openocd \fR[\fB\-fsdlchv\fR] [\fB\-\-file\fR <filename>] [\fB\-\-search\fR <dirname>] [\fB\-\-debug\fR <debuglevel>] [\fB\-\-log_output\fR <filename>] [\fB\-\-command\fR <cmd>] [\fB\-\-help\fR] [\fB\-\-version\fR]
.SH "DESCRIPTION" .SH "DESCRIPTION"
.B OpenOCD .B OpenOCD
is an on\-chip debugging, in\-system programming and boundary\-scan is an on\-chip debugging, in\-system programming and boundary\-scan
testing tool for various ARM and MIPS systems. testing tool for various microcontrollers and other embedded devices.
.PP .PP
The debugger uses an IEEE 1149\-1 compliant JTAG TAP bus master to access Various different types of debug adapters as well as transport protocols like
on\-chip debug functionality available on ARM based microcontrollers or JTAG and SWD are supported by OpenOCD, please check the \fIopenocd\fR info page
system-on-chip solutions. For MIPS systems the EJTAG interface is supported. for the complete list.
.PP .PP
User interaction is realized through a telnet command line interface, User interaction is realized through a telnet command line interface,
a gdb (the GNU debugger) remote protocol server, and a simplified RPC 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. connection that can be used to interface with OpenOCD's Jim Tcl engine.
.PP
OpenOCD supports various different types of JTAG interfaces/programmers,
please check the \fIopenocd\fR info page for the complete list.
.SH "OPTIONS" .SH "OPTIONS"
.TP .TP
.B "\-f, \-\-file <filename>" .B "\-f, \-\-file <filename>"
@ -68,8 +65,6 @@ Note that you will need to explicitly invoke
.I init .I init
if the command requires access to a target or flash. if the command requires access to a target or flash.
.TP .TP
.B "\-p, \-\-pipe"
Use pipes when talking to gdb.
.TP .TP
.B "\-h, \-\-help" .B "\-h, \-\-help"
Show a help text and exit. Show a help text and exit.
@ -82,8 +77,6 @@ Please report any bugs on the mailing list at
.SH "LICENCE" .SH "LICENCE"
.B OpenOCD .B OpenOCD
is covered by the GNU General Public License (GPL), version 2 or later. is covered by the GNU General Public License (GPL), version 2 or later.
.SH "SEE ALSO"
.BR jtag (1)
.PP .PP
The full documentation for The full documentation for
.B openocd .B openocd