X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd-exec.pod;h=c65966bd3d77dbba167ca9fc4bb4869974d4c3a3;hb=e2b289ea039269b60edd459d2d514d3f82820e3a;hp=10f9f618a2ef976f07222cf69e8edfc8d55727a6;hpb=c4da209d3b3ef23d03617c15abc3c8365c0ffd2b;p=collectd.git diff --git a/src/collectd-exec.pod b/src/collectd-exec.pod index 10f9f618..c65966bd 100644 --- a/src/collectd-exec.pod +++ b/src/collectd-exec.pod @@ -17,7 +17,7 @@ collectd-exec - Documentation of collectd's C =head1 DESCRIPTION -The C forks of an executable either to receive values or to +The C forks off an executable either to receive values or to dispatch notifications to the outside world. The syntax of the configuration is explained in L but summarized in the above synopsis. @@ -42,7 +42,7 @@ time and continuously write values to C. See L below for a description of the output format expected from these programs. -B If the executable only writes one value and then exits I will be +B If the executable only writes one value and then exits it will be executed every I seconds. If I is short (the default is 10 seconds) this may result in serious system load. @@ -94,7 +94,7 @@ I is a colon-separated list of the time and the values, each either an integer if the data-source is a counter, or a double if the data-source is 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). +epoch (i.Ee. standard UNIX time) or B to use the current time. You can mix options and values, but the order is important: Options only effect following values, so specifying an option as last field is allowed, but @@ -281,12 +281,12 @@ to make use of collectd's more powerful interface. =over 4 -=item +=item * The user, the binary is executed as, may not have root privileges, i.Ee. must have an UID that is non-zero. This is for your own good. -=item +=item * Early versions of the plugin did not use a command but treated all lines as if they were arguments to the I command. When the I command was