ghc-trace-events-0.1.0.1: Faster traceEvent and traceMarker, and binary object logging for eventlog

Safe HaskellNone
LanguageHaskell2010

Debug.Trace.ByteString

Description

ByteString variant of the tracing functions in Debug.Trace.

Synopsis

Documentation

traceEvent :: ByteString -> a -> a Source #

ByteString variant of traceEvent.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceEventIO :: ByteString -> IO () Source #

ByteString variant of traceEventIO.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceMarker :: ByteString -> a -> a Source #

ByteString variant of traceMarker.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceMarkerIO :: ByteString -> IO () Source #

ByteString variant of traceMarkerIO.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

unsafeTraceEvent :: ByteString -> a -> a Source #

ByteString variant of traceEvent.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

unsafeTraceEventIO :: ByteString -> IO () Source #

ByteString variant of traceEventIO.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

unsafeTraceMarker :: ByteString -> a -> a Source #

ByteString variant of traceMarker.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

unsafeTraceMarkerIO :: ByteString -> IO () Source #

ByteString variant of traceMarkerIO.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

Note that this function doesn't evaluate the ByteString if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.