X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fcollectd-unixsock.pod;h=da4f2b22fe3764bc3c35787ec386a576c8272775;hb=63cbff115ba03717e81087d1419fc07c24d205c2;hp=55e46b84526bf856d5a4706762ad7d392afe7554;hpb=721f8d81910c71154aba9ff8d243db52bfb584ed;p=collectd.git diff --git a/src/collectd-unixsock.pod b/src/collectd-unixsock.pod index 55e46b84..da4f2b22 100644 --- a/src/collectd-unixsock.pod +++ b/src/collectd-unixsock.pod @@ -50,14 +50,34 @@ Example: -> | GETVAL myhost/cpu-0/cpu-user <- | 1 value=1.260000e+00 +=item B + +Returnes a list of the values available in the value cache together with the +time of the last update, so that querying applications can issue a B +command for the values that have changed. + +The first line's status number is the number of identifiers returned or less +than zero if an error occured. Each of the following lines containes the +update time as an epoch value and the identifier, seperated by a space. + +Example: + -> | LISTVAL + <- | 69 Values found + <- | 1182204284 leeloo/cpu-0/cpu-idle + <- | 1182204284 leeloo/cpu-0/cpu-nice + <- | 1182204284 leeloo/cpu-0/cpu-system + <- | 1182204284 leeloo/cpu-0/cpu-user + ... + =item B I I Submits a value (identified by I, see below) to the daemon which will dispatch it to all it's write-plugins. The I is a -colon-seperated list of values, either an integer if the data-source is a -counter, of a double if the data-source if of type "gauge". You can submit an -undefined gauge-value by using B. When submitting B to a counter the -behavior is undefined. +colon-seperated list of the time and the values, each either an integer if the +data-source is a counter, of a double if the data-source if of type "gauge". +You can submit an undefined gauge-value by using B. When submitting B to +a counter the behavior is undefined. The time is given as epoch (i.Ee. +standard UNIX time). Example: -> | PUTVAL testhost/interface/if_octets-test0 1179574444:123:456