make rocksdb_recovery_mode a u8, document it

Signed-off-by: strawberry <[email protected]>

conduwuit-example.toml

@@ -361,6 +361,21 @@ url_preview_check_root_domain = false
 # Defaults to false as this uses more CPU when compressing.
 #rocksdb_bottommost_compression = false
 
+# RocksDB WAL recovery mode
+# If the database becomes corrupted, an attempt at some form of recovery or at least opening it can be made
+# using this config option.
+#
+# The options are:
+# 0 = AbsoluteConsistency
+# 1 = TolerateCorruptedTailRecords (default)
+# 2 = PointInTime
+# 3 = SkipAnyCorruptedRecord
+#
+# See https://github.com/facebook/rocksdb/wiki/WAL-Recovery-Modes#ktoleratecorruptedtailrecords for more information
+#
+# Defaults to 1 (TolerateCorruptedTailRecords)
+#rocksdb_recovery_mode = 1
+
 
 
 ### Request Timeouts, Connection Timeouts, and Connection Pooling

src/config/mod.rs

@@ -162,7 +162,7 @@ pub struct Config {
 	#[serde(default)]
 	pub rocksdb_bottommost_compression: bool,
 	#[serde(default = "default_rocksdb_recovery_mode")]
-	pub rocksdb_recovery_mode: u32,
+	pub rocksdb_recovery_mode: u8,
 
 	pub emergency_password: Option<String>,
 
@@ -454,7 +454,7 @@ impl fmt::Display for Config {
 				&self.rocksdb_bottommost_compression.to_string(),
 			),
 			#[cfg(feature = "rocksdb")]
-			("RocksDB Recovery mode", &self.rocksdb_recovery_mode.to_string()),
+			("RocksDB Recovery Mode", &self.rocksdb_recovery_mode.to_string()),
 			("Prevent Media Downloads From", {
 				let mut lst = vec![];
 				for domain in &self.prevent_media_downloads_from {
@@ -576,7 +576,7 @@ fn default_presence_idle_timeout_s() -> u64 { 5 * 60 }
 
 fn default_presence_offline_timeout_s() -> u64 { 30 * 60 }
 
-fn default_rocksdb_recovery_mode() -> u32 { 1 }
+fn default_rocksdb_recovery_mode() -> u8 { 1 }
 
 fn default_rocksdb_log_level() -> String { "error".to_owned() }
 

src/database/abstraction/rocksdb.rs

@@ -116,7 +116,7 @@ fn db_options(
 	// Misc
 	db_opts.create_if_missing(true);
 
-	// https://github.com/facebook/rocksdb/wiki/WAL-Recovery-Modes#ktoleratecorruptedtailrecords
+	// Default: https://github.com/facebook/rocksdb/wiki/WAL-Recovery-Modes#ktoleratecorruptedtailrecords
 	//
 	// Unclean shutdowns of a Matrix homeserver are likely to be fine when
 	// recovered in this manner as it's likely any lost information will be