Browse Source

doc clarifications for server flags

The "-f" is a shortcut for "-c" ... and providing any "-c" options
means the "openocd.cfg" file isn't implicitly used.  Both the User's
Guide and the manual page were weak on these points, which has led
to some confusion.

Also update the manual page to include highlights of the search path
mechanism, including the facts that it exists and that "-s" adds to it.
Stop saying only the current directory is involved; the OpenOCD
script library is quite significant.

(Missing: complete manpage coverage of the search path, including a
FILES section listing all components and saying where the script
library is found.)

Signed-off-by: David Brownell <>
David Brownell 13 years ago
2 changed files with 23 additions and 14 deletions
  1. +19
  2. +4

+ 19
- 11
doc/openocd.1 View File

@@ -22,19 +22,23 @@ please check the \fIopenocd\fR info page for the complete list.
.B "\-f, \-\-file <filename>"
Use configuration file
.BR <filename> .
This is a shortcut for a \fB\-c "[script \fI<filename>\fB]"\fR
command, using a search path to load the configuration file
.IR <filename> .
In order to specify multiple config files, you can use multiple
.B \-\-file
arguments. If this option is omitted, the config file
arguments. If no such \fB\-c\fR
options are included, the first config file
.B openocd.cfg
in the current working directory will be used.
in the search path will be used.
.B "\-s, \-\-search <dirname>"
Search for config files and scripts in the directory
.BR <dirname> .
If this option is omitted, OpenOCD searches for config files and scripts
in the current directory.
.I <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.
.B "\-d, \-\-debug <debuglevel>"
Set debug level. Possible values are:
@@ -52,13 +56,17 @@ The default level is
.B "\-l, \-\-log_output <filename>"
Redirect log output to the file
.BR <filename> .
.IR <filename> .
Per default the log output is printed on
.BR stderr .
.B "\-c, \-\-command <cmd>"
Run the command
.BR <cmd> .
Add the command
.I <cmd>
to a list of commands executed on server startup.
Note that you will need to explicitly invoke
.I init
if the command requires access to a target or flash.
.B "\-p, \-\-pipe"
Use pipes when talking to gdb.

+ 4
- 3
doc/openocd.texi View File

@@ -513,9 +513,10 @@ bash$ openocd --help
--pipe | -p use pipes when talking to gdb
@end verbatim

By default OpenOCD reads the configuration file @file{openocd.cfg}.
To specify a different (or multiple)
configuration file, you can use the @option{-f} option. For example:
If you don't give any @option{-f} or @option{-c} options,
OpenOCD tries to read the configuration file @file{openocd.cfg}.
To specify one or more different
configuration files, use @option{-f} options. For example:

openocd -f config1.cfg -f config2.cfg -f config3.cfg