appender: fix compilation 32-bit platforms like PowerPC (#1675)

This branch is @dzvon's PR #1508, with the following changes:

* Add a newtype wrapping the error counter to hide that it's internally
  an `Arc<AtomicUsize>`. This would allow us to make additional changes
  to the implementation without potentially causing breaking changes.

* Use saturating arithmetic when incrementing the counter to avoid
  wrapping to 0 on overflows. This is more likely to be an issue on
  32-bit platforms.

This is a breaking change that will be released as part of 
`tracing-appender` 0.2.

Closes #1508

Description from @dzvon's original PR:

## Motivation

Currently, tracing-appender crate cannot be compiled on PowerPC
platform. Because

> PowerPC and MIPS platforms with 32-bit pointers do not have
> `AtomicU64` or `AtomicI64` types.

quote from std library docs.
(https://doc.rust-lang.org/std/sync/atomic/index.html#portability)

## Solution

Change `AtomicU64` to `AtomicUsize`.

Co-authored-by: Dezhi Wu <[email protected]>

Author: hawkw

tracing-appender/src/non_blocking.rs

@@ -51,7 +51,7 @@ use crate::Msg;
 use crossbeam_channel::{bounded, SendTimeoutError, Sender};
 use std::io;
 use std::io::Write;
-use std::sync::atomic::AtomicU64;
+use std::sync::atomic::AtomicUsize;
 use std::sync::atomic::Ordering;
 use std::sync::Arc;
 use std::thread::JoinHandle;
@@ -125,11 +125,20 @@ pub struct WorkerGuard {
 /// [fmt]: https://docs.rs/tracing-subscriber/latest/tracing_subscriber/fmt/index.html
 #[derive(Clone, Debug)]
 pub struct NonBlocking {
-    error_counter: Arc<AtomicU64>,
+    error_counter: ErrorCounter,
     channel: Sender<Msg>,
     is_lossy: bool,
 }
 
+/// Tracks the number of times a log line was dropped by the background thread.
+///
+/// If the non-blocking writer is not configured in [lossy mode], the error
+/// count should always be 0.
+///
+/// [lossy mode]: NonBlockingBuilder::lossy
+#[derive(Clone, Debug)]
+pub struct ErrorCounter(Arc<AtomicUsize>);
+
 impl NonBlocking {
     /// Returns a new `NonBlocking` writer wrapping the provided `writer`.
     ///
@@ -158,7 +167,7 @@ impl NonBlocking {
         (
             Self {
                 channel: sender,
-                error_counter: Arc::new(AtomicU64::new(0)),
+                error_counter: ErrorCounter(Arc::new(AtomicUsize::new(0))),
                 is_lossy,
             },
             worker_guard,
@@ -167,7 +176,7 @@ impl NonBlocking {
 
     /// Returns a counter for the number of times logs where dropped. This will always return zero if
     /// `NonBlocking` is not lossy.
-    pub fn error_counter(&self) -> Arc<AtomicU64> {
+    pub fn error_counter(&self) -> ErrorCounter {
         self.error_counter.clone()
     }
 }
@@ -219,7 +228,7 @@ impl std::io::Write for NonBlocking {
         let buf_size = buf.len();
         if self.is_lossy {
             if self.channel.try_send(Msg::Line(buf.to_vec())).is_err() {
-                self.error_counter.fetch_add(1, Ordering::Release);
+                self.error_counter.incr_saturating();
             }
         } else {
             return match self.channel.send(Msg::Line(buf.to_vec())) {
@@ -280,6 +289,43 @@ impl Drop for WorkerGuard {
     }
 }
 
+// === impl ErrorCounter ===
+
+impl ErrorCounter {
+    /// Returns the number of log lines that have been dropped.
+    ///
+    /// If the non-blocking writer is not configured in [lossy mode], the error
+    /// count should always be 0.
+    ///
+    /// [lossy mode]: NonBlockingBuilder::lossy
+    pub fn dropped_lines(&self) -> usize {
+        self.0.load(Ordering::Acquire)
+    }
+
+    fn incr_saturating(&self) {
+        let mut curr = self.0.load(Ordering::Acquire);
+        // We don't need to enter the CAS loop if the current value is already
+        // `usize::MAX`.
+        if curr == usize::MAX {
+            return;
+        }
+
+        // This is implemented as a CAS loop rather than as a simple
+        // `fetch_add`, because we don't want to wrap on overflow. Instead, we
+        // need to ensure that saturating addition is performed.
+        loop {
+            let val = curr.saturating_add(1);
+            match self
+                .0
+                .compare_exchange(curr, val, Ordering::AcqRel, Ordering::Acquire)
+            {
+                Ok(_) => return,
+                Err(actual) => curr = actual,
+            }
+        }
+    }
+}
+
 #[cfg(test)]
 mod test {
     use super::*;
@@ -322,7 +368,7 @@ mod test {
         let error_count = non_blocking.error_counter();
 
         non_blocking.write_all(b"Hello").expect("Failed to write");
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
 
         let handle = thread::spawn(move || {
             non_blocking.write_all(b", World").expect("Failed to write");
@@ -331,7 +377,7 @@ mod test {
         // Sleep a little to ensure previously spawned thread gets blocked on write.
         thread::sleep(Duration::from_millis(100));
         // We should not drop logs when blocked.
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
 
         // Read the first message to unblock sender.
         let mut line = rx.recv().unwrap();
@@ -366,17 +412,17 @@ mod test {
 
         // First write will not block
         write_non_blocking(&mut non_blocking, b"Hello");
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
 
         // Second write will not block as Worker will have called `recv` on channel.
         // "Hello" is not yet consumed. MockWriter call to write_all will block until
         // "Hello" is consumed.
         write_non_blocking(&mut non_blocking, b", World");
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
 
         // Will sit in NonBlocking channel's buffer.
         write_non_blocking(&mut non_blocking, b"Test");
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
 
         // Allow a line to be written. "Hello" message will be consumed.
         // ", World" will be able to write to MockWriter.
@@ -386,12 +432,12 @@ mod test {
 
         // This will block as NonBlocking channel is full.
         write_non_blocking(&mut non_blocking, b"Universe");
-        assert_eq!(1, error_count.load(Ordering::Acquire));
+        assert_eq!(1, error_count.dropped_lines());
 
         // Finally the second message sent will be consumed.
         let line = rx.recv().unwrap();
         assert_eq!(line, ", World");
-        assert_eq!(1, error_count.load(Ordering::Acquire));
+        assert_eq!(1, error_count.dropped_lines());
     }
 
     #[test]
@@ -427,6 +473,6 @@ mod test {
         }
 
         assert_eq!(10, hello_count);
-        assert_eq!(0, error_count.load(Ordering::Acquire));
+        assert_eq!(0, error_count.dropped_lines());
     }
 }