logger/com.wire.kalium.logger/AppleSuspensionDiagnostics

AppleSuspensionDiagnostics

object AppleSuspensionDiagnostics

Bounded, process-local observations for investigating suspension with shared files open.

This writes directly to Apple's unified log, never through a file logger. Labels use a closed vocabulary; callers must not pass paths, SQL, account identities or exception messages. Unknown labels become other. Database spans measure API operations, not SQLite VFS locks. A lifecycle stage does not establish that the process may execute, that it has suspended, or that its files are safe for suspension. Delivery is best effort.

Functions

fun abandoned(token: Long)

Retire an unsuccessful attempt on a descriptor that stays open. Never clears HELD or UNKNOWN.

fun acquired(token: Long, result: Int, error: Int = 0)

POSIX result zero means acquired; a failed attempt never establishes ownership.

beginDatabaseOperation

fun beginDatabaseOperation(databaseKind: String, operation: String): Long

fun beginLock(kind: String, operation: String, descriptor: Int = -1): Long

fun closed(token: Long, result: Int, error: Int = 0)

A failed or interrupted close leaves UNKNOWN; callers must not retry close for diagnostics.

endDatabaseOperation

fun endDatabaseOperation(token: Long, outcome: String)

setBackgrounded

fun setBackgrounded(backgrounded: Boolean)

fun snapshot(stage: String)

fun unlocked(token: Long, result: Int, error: Int = 0)