Tail

Tue May 19 21:43:58 EDT 2009

The name of this protocol is borrowed from the Unix 'tail' command, which will show lines of text as they are appended to a file (specified via the "source" property). This connector does this for files, and named pipes as well. It will also maintain its watch on a file even if the file is deleted (or renamed) and restarted as a fresh file (with the same name).

For named pipes, the "server.tail.isPipe" parameter must be set to "true". It will continue to read from the pipe even after an end-of-file (EOF) is received (which occurs whenever redirected output ends, such as after a '>' command, or when a program closes its file handle on the pipe.

If the "source" property does not specify an absolute path to the tail file, then the setting is offset from the application's home directory.

If the "server.tail.skip" paramter is "false", then all the data available in the named file is broadcast to all listeners connected each the time the connector is started. Otherwise, only file additions are broadcast (the default).