X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=src%2Fhelper%2Fstartup.tcl;h=2578de9306d8a5610dbac688bc119538e823c9fb;hp=30dc184f7f6fa65270a756130e4730c74f97a617;hb=334552bc831baf4a88f8b42c93e87ed052c923d2;hpb=82449e2d60fbbb5ce8a6285b6e6d60e5767ee429 diff --git a/src/helper/startup.tcl b/src/helper/startup.tcl index 30dc184f7f..2578de9306 100644 --- a/src/helper/startup.tcl +++ b/src/helper/startup.tcl @@ -3,21 +3,6 @@ # Embedded into OpenOCD executable # -# Help text list. A list of command + help text pairs. -# -# Commands can be more than one word and they are stored -# as "flash banks" "help text x x x" - -proc add_help_text {cmd cmd_help} { - global ocd_helptext - lappend ocd_helptext [list $cmd $cmd_help] -} - -proc get_help_text {} { - global ocd_helptext - return $ocd_helptext -} - # We need to explicitly redirect this to the OpenOCD command # as Tcl defines the exit proc @@ -25,76 +10,34 @@ proc exit {} { ocd_throw exit } -proc cmd_help {cmdname h indent} { - set indent [expr $indent * 2] - - set fmt_str [format "%%%ds%%-%ds %%s" $indent [expr 25 - $indent]] - set w [expr 50 - $indent] - set n 0 - - while 1 { - if {$n > [string length $h]} {break} - - set next_a [expr $n + $w] - if {[string length $h] > $n + $w} \ - { - set xxxx [string range $h $n [expr $n + $w]] - for {set lastpos [expr [string length $xxxx] - 1]} \ - {$lastpos >= 0 && [string compare \ - [string range $xxxx $lastpos $lastpos] " "] != 0} \ - {set lastpos [expr $lastpos - 1]} \ - { - } - #set next_a -1 - if {$lastpos != -1} { - set next_a [expr $lastpos + $n + 1] - } - } - - puts [format $fmt_str "" $cmdname \ - [string range $h $n [expr $next_a - 1]] ] - set cmdname "" - set n [expr $next_a] - } -} - -#Print help text for a command. Word wrap -#help text that is too wide inside column. -proc help {args} { - global ocd_helptext - set cmd $args - foreach a [lsort $ocd_helptext] { - if {[string length $cmd] == 0 || \ - [string first $cmd $a] != -1 || \ - [string first $cmd [lindex $a 1]] != -1} \ - { - cmd_help [lindex $a 0] [lindex $a 1] 0 +# All commands are registered with an 'ocd_' prefix, while the "real" +# command is a wrapper that calls this function. Its primary purpose is +# to discard 'handler' command output. +# Due to the two nested proc calls, this wrapper has to explicitly run +# the wrapped command in the stack frame two levels above. +proc ocd_bouncer {name args} { + set cmd [format "ocd_%s" $name] + set type [eval ocd_command type $cmd $args] + set errcode error + set skiplevel [expr [eval info level] > 1 ? 2 : 1] + if {$type == "native"} { + return [uplevel $skiplevel $cmd $args] + } else {if {$type == "simple"} { + set errcode [catch {uplevel $skiplevel $cmd $args}] + if {$errcode == 0} { + return "" + } else { + # 'classic' commands output error message as part of progress output + set errmsg "" } - } -} - -add_help_text help "Tcl implementation of help command" - - -# If a fn is unknown to Tcl, we try to execute it as an OpenOCD command -# -# We also support two level commands. "flash banks" is translated to -# flash_banks -proc unknown {args} { - # do the name mangling from "flash banks" to "flash_banks" - if {[llength $args]>=2} { - set cmd_name "[lindex $args 0]_[lindex $args 1]" - if {[catch {info body $cmd_name}]==0} { - # the command exists, try it... - return [eval "$cmd_name [lrange $args 2 end]"] - } - } - # This really is an unknown command. - return -code error "Unknown command: $args" -} - -proc new_target_name { } { - return [target number [expr [target count] - 1 ]] + } else {if {$type == "group"} { + catch {eval ocd_usage $name $args} + set errmsg [format "%s: command requires more arguments" \ + [concat $name " " $args]] + } else { + set errmsg [format "invalid subcommand \"%s\"" $args] + }}} + return -code $errcode $errmsg } # Try flipping / and \ to find file if the filename does not @@ -112,21 +55,15 @@ proc find {filename} { # make sure error message matches original input string return -code error "Can't find $filename" } -add_help_text find " - print full path to file according to OpenOCD search rules" +add_usage_text find "" +add_help_text find "print full path to file according to OpenOCD search rules" -# Run script +# Find and run a script proc script {filename} { - source [find $filename] + uplevel #0 [list source [find $filename]] } - -add_help_text script " - filename of OpenOCD script (tcl) to run" +add_help_text script "filename of OpenOCD script (tcl) to run" +add_usage_text script "" ######### -# catch any exceptions, capture output and return output -proc capture_catch {a} { - catch { - capture {uplevel $a} - } result - return $result -}