flush

flush — flushes all buffered output.

Syntax

(flush [label...])
    

Arguments

label

(Optional) A log or group label. If used, only points in this log or group will be flushed.

Returns

On success, t, otherwise one of the following error messages:

(error "textlog: Group or log label does not exist")
(error "textlog: Too few arguments to flush: # < #")
(error "textlog: Invalid command: flush")

or, if none of the above errors apply, nil.

Description

The flush command attempts to log any collected data to the cache. If data is not being cached (with the cache command), the flush command will cause data to be flushed to file or standard output.

This command corresponds to the Cogent C API function LG_Flush.

See Also

cache