Home

GEONius.com
29-Feb-2016
E-mail

glop - EPOCH Global Variable Printer

Program glop provides a running display of the values of one or more global variables. glop submits requests for continuous updates for the variables to the appropriate global servers; as the updates are received, the new values are output.

A single invocation of glop can monitor variables from multiple global servers. For example, if invoked as follows:

    % glop e3_nml@claudius NORMAL_FRM_CNT OBC_FRM_CNT -segment t4_n1@hw_fep4 FRAME

glop will monitor NORMAL_FRM_CNT and OBC_FRM_CNT (served by the global server on claudius) and FRAME (served by the global server on hw_fep4).


Invocation:

% glop [-debug] [-Debug] [-variable 'name=value']
       [-segment] stream[@host]
       [variable1 ... variableN]
       [-all] [-flags mask] [-match pattern]
       [-range lower-upper] [-synchronous] [-timing]

where

-debug
-Debug
enables debug output (written to stdout). -Debug enables copious debug output (hex dumps of network traffic).
-variable 'name=value'
specifies the name and value of a named variable to be embedded in the MSG_CONNECT message sent to the global server. Multiple -variable options can be specified if more than one parameter must be passed to the global server. (Unless explicitly specified on the command line, required parameters are automatically supplied with default values.) When monitoring multiple global segments, the named variables must be specified anew before each segment's spacecraft stream.
-segment
signals that the following argument is a segment name ("stream[@host]") which will apply to subsequent variable names. This option is used if glop is to monitor multiple segments.
stream[@host]
specifies the name of the global segment's spacecraft stream; the default host is the local host. Variables that follow on the command line (until a -segment option) will be retrieved from this segment's global server.
variable1 ... variableN
are the names of the variables to be monitored; the case (upper or lower) of the names is not important.
-all
tells glop to monitor *all* of the variables in the global segment.
-flags mask
tells glop to monitor all variables with the given flags in the global segment.
-match pattern
tells glop to monitor all variables whose names are matched by the given regular expression; the case (upper or lower) of the name is important.
-range lower-upper
tells glop to monitor all variables with indices in the given range.
-synchronous
specifies that synchronous updates will be requested (MSG_GV_REQ_SYNC) for subsequent variables on the command line. I understand the intent, but I have yet to observe any differences between synchronous updates and regular updates (MSG_GV_REQ_UPDATES).
-timing
generates timing messages (to stdout) during the segment glom.

Alex Measday  /  E-mail