X-Git-Url: https://git.distorted.org.uk/~mdw/mLib/blobdiff_plain/d18364663d0d78b4ba0000372fd432e1f31c2aa9..419895bb703f5cba6fc86d56277abdc4e6b28330:/man/trace.3

diff --git a/man/trace.3 b/man/trace.3
index 68d87ad..0318eb0 100644
--- a/man/trace.3
+++ b/man/trace.3
@@ -1,10 +1,11 @@
 .\" -*-nroff-*-
-.TH trace 3 "21 October 1999" mLib
+.TH trace 3 "21 October 1999" "Straylight/Edgeware" "mLib utilities library"
 .SH "NAME"
 trace \- configurable tracing output
 .\" @trace
 .\" @trace_block
 .\" @trace_on
+.\" @trace_custom
 .\" @trace_level
 .\" @tracing
 .\" @traceopt
@@ -20,10 +21,13 @@ trace \- configurable tracing output
 .BI "                 const void *" b ", size_t " sz );
 
 .BI "void trace_on(FILE *" fp ", unsigned " l );
+.BI "void trace_custom(void (*" func ")(const char *" buf ,
+.BI "                               size_t " sz ", void *" v ),
+.BI "                  void *" v );
 .BI "void trace_level(unsigned " l );
 .BI "unsigned tracing(void);"
 
-.BI "unsigned traceopt(trace_opt *" t ", const char *" p ,
+.BI "unsigned traceopt(const trace_opt *" t ", const char *" p ,
 .BI "                  unsigned " f ", unsigned " bad );
 
 .BI T( statements\fR... )
@@ -72,6 +76,11 @@ which takes the new level as its single argument.  The function
 .B tracing
 returns the current trace level, or zero if there is no trace
 destination set.
+.PP
+For more advanced programs, a custom output function may be provided by
+.B trace_custom
+and passing a function which will write a buffer of data somewhere
+sensible.
 .SS "Parsing user trace options"
 The function
 .B traceopt