lib/Core/AdNoctem.Substrate.IO.xml
|
<?xml version="1.0"?>
<doc> <assembly> <name>AdNoctem.Substrate.IO</name> </assembly> <members> <member name="T:AdNoctem.Substrate.IO.ApplicationPaths"> <summary>Conventional paths only; construction does not create directories or change access permissions.</summary> </member> <member name="T:AdNoctem.Substrate.IO.FileSnapshot"> <summary>Detached filesystem evidence, including UTC write time and byte length, rather than an open file handle.</summary> </member> <member name="T:AdNoctem.Substrate.IO.FileInventoryError"> <summary>A filesystem location that could not be observed and the exception explaining why.</summary> </member> <member name="T:AdNoctem.Substrate.IO.FileInventory"> <summary>File observations and retained traversal errors; inspect completeness before treating missing entries as absent.</summary> </member> <member name="T:AdNoctem.Substrate.IO.FileInventoryManager"> <summary>Read-only file inventory. Does not follow directory reparse points or infer that unreadable locations contain no files.</summary> </member> <member name="M:AdNoctem.Substrate.IO.FileInventoryManager.Find(AdNoctem.Substrate.IO.FileSystemPath,System.Nullable{System.DateTimeOffset},System.Nullable{System.DateTimeOffset},System.Boolean,System.Boolean,System.Boolean,System.Threading.CancellationToken)"> <remarks>Write-time bounds are exclusive. Cancellation is checked between filesystem calls; an in-flight filesystem call may finish first. A scan is not an atomic filesystem snapshot, and paths may change during enumeration.</remarks> </member> <member name="T:AdNoctem.Substrate.IO.FileManager"> <summary>Explicit filesystem operations. No parent directories or overwrite policy are inferred.</summary> </member> <member name="M:AdNoctem.Substrate.IO.FileManager.WriteAtomicallyAsync(AdNoctem.Substrate.IO.FileSystemPath,System.IO.Stream,System.Boolean,System.Threading.CancellationToken)"> <summary>Copies the remaining stream contents to a temporary sibling and publishes the completed file.</summary> <remarks>The caller retains ownership of the stream; its position advances. The parent directory must already exist. Writes to a sibling temporary file and publishes by rename or replacement. Cancellation before publication leaves the destination intact. Replacement is a single filesystem operation, not a transaction across files; the filesystem must support File.Replace.</remarks> </member> <member name="M:AdNoctem.Substrate.IO.FileManager.WriteAtomically(AdNoctem.Substrate.IO.FileSystemPath,System.IO.Stream,System.Boolean,System.Threading.CancellationToken)"> <summary>Synchronously copies and publishes a file using the same replacement guarantees as the asynchronous operation.</summary> <remarks>The caller owns content; its position advances. The destination's parent must already exist.</remarks> </member> <member name="M:AdNoctem.Substrate.IO.FileManager.ComputeSha256Async(AdNoctem.Substrate.IO.FileSystemPath,System.Threading.CancellationToken)"> <summary>Reads a file and returns its SHA256 digest as 64 lowercase hexadecimal characters.</summary> <remarks>A computed digest identifies content; it does not establish trust without an independently trusted comparison value.</remarks> </member> <member name="M:AdNoctem.Substrate.IO.FileManager.ComputeSha256(AdNoctem.Substrate.IO.FileSystemPath,System.Threading.CancellationToken)"> <inheritdoc cref="M:AdNoctem.Substrate.IO.FileManager.ComputeSha256Async(AdNoctem.Substrate.IO.FileSystemPath,System.Threading.CancellationToken)"/> </member> <member name="T:AdNoctem.Substrate.IO.FileSystemPath"> <summary>An absolute lexical filesystem path, independent of PowerShell providers and the process current directory.</summary> </member> <member name="M:AdNoctem.Substrate.IO.FileSystemPath.Parse(System.String,System.String)"> <summary>Normalizes a fully qualified path or resolves a relative path against an explicit base directory.</summary> <remarks>Relative paths require an explicit absolute base. Normalization does not resolve links, establish existence, or authorize access.</remarks> <exception cref="T:System.ArgumentException">The path is empty, partially qualified, or relative without an absolute base.</exception> </member> <member name="M:AdNoctem.Substrate.IO.FileSystemPath.Combine(System.String)"> <summary>Resolves a relative path beneath this lexical base.</summary> <remarks>Parent segments are normalized and can leave the base directory. This method is not a containment check.</remarks> </member> <member name="M:AdNoctem.Substrate.IO.FileSystemPath.ExpandLongName"> <summary>Expands Windows short names for an existing item. Native failures remain Win32 exceptions; symbolic links are not resolved.</summary> </member> <member name="M:AdNoctem.Substrate.IO.FileSystemPath.Equals(AdNoctem.Substrate.IO.FileSystemPath)"> <summary>Compares normalized paths ordinally, preserving support for case-sensitive Windows directories.</summary> </member> <member name="T:AdNoctem.Substrate.IO.VerifiedArchiveService"> <summary>Publishes one exact ZIP entry after independently verifying the archive and extracted file. Never executes content.</summary> </member> <member name="M:AdNoctem.Substrate.IO.VerifiedArchiveService.ExtractFile(AdNoctem.Substrate.IO.FileSystemPath,AdNoctem.Substrate.IO.FileSystemPath,System.String,System.String,System.String,System.Int64,System.Int64,System.Boolean,System.Threading.CancellationToken)"> <summary>Extracts one exact entry after enforcing archive and file digests, path rules, and size limits.</summary> <remarks>Both digests must be independently trusted. No archive paths become filesystem paths. The destination's parent must exist. Verification uses the same open archive handle as extraction. Failure leaves an existing destination unchanged.</remarks> </member> <member name="M:AdNoctem.Substrate.IO.VerifiedArchiveService.ExtractFileAsync(AdNoctem.Substrate.IO.FileSystemPath,AdNoctem.Substrate.IO.FileSystemPath,System.String,System.String,System.String,System.Int64,System.Int64,System.Boolean,System.Threading.CancellationToken)"> <summary>Performs verified extraction on a worker thread.</summary> <remarks>Offloads synchronous filesystem and ZIP operations. Cancellation is checked between reads and before atomic publication.</remarks> </member> </members> </doc> |