aboutsummaryrefslogtreecommitdiff
path: root/development/reckless/README
diff options
context:
space:
mode:
authorAndre Barboza <bmg.andre@gmail.com>2017-01-11 01:34:06 +0700
committerWilly Sudiarto Raharjo <willysr@slackbuilds.org>2017-01-11 01:34:06 +0700
commitd576582f23869e1af547450434fab0296647bc35 (patch)
tree2efb24ff2c8b365d33d21d805d8e1009c8f44007 /development/reckless/README
parent7a07d454463fde80648ed2e9d0487e0b15152668 (diff)
downloadslackbuilds-d576582f23869e1af547450434fab0296647bc35.tar.xz
development/reckless: Added (logging library).
Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
Diffstat (limited to 'development/reckless/README')
-rw-r--r--development/reckless/README17
1 files changed, 17 insertions, 0 deletions
diff --git a/development/reckless/README b/development/reckless/README
new file mode 100644
index 000000000000..9cb58fc3c990
--- /dev/null
+++ b/development/reckless/README
@@ -0,0 +1,17 @@
+Reckless is an extremely low-latency, high-throughput logging library.
+It was created to perform extensive diagnostic logging without
+worrying about performance. Other logging libraries boast the ability
+to throw log messages away very quickly. Reckless boasts the ability
+to keep them all, without worrying about the performance impact.
+Filtering can and should wait until you want to read the log, or need
+to clean up disk space.
+
+The code generated at the call site consists of:
+
+- Pushing the arguments on a thread-local queue. This has the same
+ cost as pushing the arguments on the stack for a normal function
+ call.
+- Call to Boost.Lockless (NB: this is bundled with the library, not
+ an external dependency) to register the write request on a shared
+ lockless queue. The actual message formatting and writing is
+ performed asynchronously by a separate thread.