retools is an EPICS module that contains a few useful EPICS shell commands that use regular expressions. Uses C++11's regexp.
Prints record names that match the regular expression in pattern.
Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> reGrep "X"
ABC:X
epics> reGrep "[X|Y]"
ABC:X
ABC:Y
Tests a substitution of pattern with value, useful for testing before
running reAddAlias or reAddInfo.
Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> reTest "AB(.*):.*$" "$1"
ABC:X C
Adds an alias to all records that match the regular expression in pattern.
Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> reAddAlias "ABC:(.*)" "DEF:$1"
Alias ABC:X -> DEF:X created
Alias ABC:Y -> DEF:Y created
Alias ABC:Z -> DEF:Z created
epics> dbla
DEF:X -> ABC:X
DEF:Y -> ABC:Y
DEF:Z -> ABC:Z
Adds an info tag to all records that match the regular expression in pattern.
Matching groups can be used for value. Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> reAddInfo "(.*):.*" "prefix" "$1"
ABC:X: added info(prefix, 'ABC')
ABC:Y: added info(prefix, 'ABC')
ABC:Z: added info(prefix, 'ABC')
epics> dbDumpRecord
record(ai,"ABC:X") {
field(DTYP,"Soft Channel")
info("prefix","ABC")
}
record(ai,"ABC:Y") {
field(DTYP,"Soft Channel")
info("prefix","ABC")
}
record(ai,"ABC:Z") {
field(DTYP,"Soft Channel")
info("prefix","ABC")
}
Sets the value of a particular field to all records that match the regular expression in pattern.
Can be used for the VAL field. Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> rePutField "(.*):.*" "EGU" "units"
ABC:X: put field(EGU, 'units')
ABC:Y: put field(EGU, 'units')
ABC:Z: put field(EGU, 'units')
epics> dbDumpRecord
record(ai,"ABC:X") {
field(DTYP,"Soft Channel")
field(EGU,"units")
}
record(ai,"ABC:Y") {
field(DTYP,"Soft Channel")
field(EGU,"units")
}
record(ai,"ABC:Z") {
field(DTYP,"Soft Channel")
field(EGU,"units")
}
Gets the value of a particular field to all records that match the regular expression in pattern.
Can be used for the VAL field. Example:
epics> dbl
ABC:X
ABC:Y
ABC:Z
epics> reGetField "(.*):.*" "EGU"
ABC:X 'units'
ABC:Y 'units'
ABC:Z 'units'
By default, retools has verbose output. To disable it, set the variable
reToolsVerbose to 0:
epics> var reToolsVerbose 0
epics>
You may also set reToolsVerbose to 2 so retools only displays the number of record matches found by each function. The option works as a bit mask, e.g., setting it to 3 would enable both the total number of matches and the default verbose output.