caget
caget [options] <PV name> ...
Description
Get and print value for PV(s).
The values for one or multiple PVs are read and printed to stdout. The
DBR_... format in which the data is read, the output format, and a
number of details of how integer and float values are represented can be
controlled using command line options.
When getting multiple PVs, their order on the command line is retained in the output.
Options
- -h
Print usage information
Channel access options
- -w <sec>
Wait time, specifies longer CA timeout, default is 1.0 second.
- -c
Asynchronous get (use ca_get_callback instead of ca_get).
- -p <prio>
CA priority (0–99, default 0=lowest)
Format and data type options
Default output format is name value
- -t
Terse mode — print only value, without name.
- -a
Wide mode
name timestamp value stat sevr(read PVs asDBR_TIME_xxx)
- -d <type>
Request specific dbr type; use string (
DBR_prefix may be omitted) or number of one of the following types:- STRING:
0
- INT:
1
- SHORT:
1
- FLOAT:
2
- ENUM:
3
- CHAR:
4
- LONG:
5
- DOUBLE:
6
- STS_STRING:
7
- STS_INT:
8
- STS_SHORT:
8
- STS_FLOAT:
9
- STS_ENUM:
10
- STS_CHAR:
11
- STS_LONG:
12
- STS_DOUBLE:
13
- TIME_STRING:
14
- TIME_INT:
15
- TIME_SHORT:
15
- TIME_FLOAT:
16
- TIME_ENUM:
17
- TIME_CHAR:
18
- TIME_LONG:
19
- TIME_DOUBLE:
20
- GR_STRING:
21
- GR_INT:
22
- GR_SHORT:
22
- GR_FLOAT:
23
- GR_ENUM:
24
- GR_CHAR:
25
- GR_LONG:
26
- GR_DOUBLE:
27
- CTRL_STRING:
28
- CTRL_INT:
29
- CTRL_SHORT:
29
- CTRL_FLOAT:
30
- CTRL_ENUM:
31
- CTRL_CHAR:
32
- CTRL_LONG:
33
- CTRL_DOUBLE:
34
- STSACK_STRING:
37
- CLASS_NAME:
38
Enum format
- -n
Print
DBF_ENUMvalue as number (default is enum string)
Arrays
Value format: Print number of requested values, then list of values.
By default: print all values.
- -# <count>
Print first <count> elements of an array.
- -S
Print array of char as a string (long string).
Floating point type format
By default: use %g format.
- -e <nr>
Use
%eformat, with a precision of <nr> digits.
- -f <nr>
Use
%fformat, with a precision of <nr> digits.
- -g <nr>
Use
%gformat, with a precision of <nr> digits.
- -s
Get value as string (honors server-side precision).
- -lx
Round to long integer and print as hex number.
- -lo
Round to long integer and print as octal number.
- -lb
Round to long integer and print as binary number.
Integer number format
By default: print as decimal number.
- -0x
Print as hex number.
- -0o
Print as octal number.
- -0b
Print as binary number.
Alternate output field separator
- -F <ofs>
Use <ofs> as an alternate output field separator.