Up

Module Output

Signature

type machine_readable_format = [
| `Sexp
| `Sexp_hum
| `Bin_prot
]
val machine_readable_format_of_sexp : Sexplib.Sexp.t -> machine_readable_format
val __machine_readable_format_of_sexp__ : Sexplib.Sexp.t -> machine_readable_format
val sexp_of_machine_readable_format : machine_readable_format -> Sexplib.Sexp.t
type format = [
| machine_readable_format
| `Text
]
val format_of_sexp : Sexplib.Sexp.t -> format
val __format_of_sexp__ : Sexplib.Sexp.t -> format
val sexp_of_format : format -> Sexplib.Sexp.t
type t
val create : ?rotate:(unit -> unit Async_unix.Import.Deferred.t) -> (Message.t Core.Std.Queue.t -> unit Async_unix.Import.Deferred.t) -> t

create f returns a t, given a function that actually performs the final output work. It is the responsibility of the write function to contain all state, and to clean up after itself when it is garbage collected (which may require a finalizer). The function should avoid modifying the contents of the queue; it's reused for each Output.t.

The "stock" output modules support a sexp and bin_prot output format, and other output modules should make efforts to support them as well where it is meaningful/appropriate to do so.

The unit Deferred returned by the function should not be fulfilled until the all of the messages in the given queue are completely handled (e.g. written to disk).

An optional rotate function may be given which will be called when Log.rotate t is called while this output is in effect. This is useful for programs that want very precise control over rotation.

val stdout : unit -> t
val stderr : unit -> t
val writer : format -> Async_unix.Writer.t -> t
val file : format -> filename:string -> t
val rotating_file : format -> basename:string -> Rotation.t -> t

returns a tail of the filenames. When rotate is called, the previous filename is put on the tail

val rotating_file_with_tail : format -> basename:string -> Rotation.t -> t * string Async_unix.Import.Tail.t

returns a tail of the filenames. When rotate is called, the previous filename is put on the tail

See Async_extended.Std.Log for syslog and colorized console output.