Swift Package IndexBuild Information
Successful build of libpcache_Swift, reference main (9acca1), with Swift 6.3 for macOS (SPM) on 7 May 2026 08:06:35 UTC.
Swift 6 data race errors: 0
Build Command
env DEVELOPER_DIR=/Applications/Xcode-26.4.0.app xcrun swift build --arch arm64Build Log
========================================
RunAll
========================================
Builder version: 4.70.0
Interrupt handler set up.
========================================
Checkout
========================================
Clone URL: https://github.com/RuiNelson/libpcache_Swift.git
Reference: main
Initialized empty Git repository in /Users/admin/builder/spi-builder-workspace/.git/
From https://github.com/RuiNelson/libpcache_Swift
* branch main -> FETCH_HEAD
* [new branch] main -> origin/main
HEAD is now at 9acca11 docs: improve discoverability with SEO keywords and SPI config
Submodule path 'Sources/CLibPCache/libpcache': checked out '9d943bb0fd86c7f8f6c854d720e08f01723c3d1f'
Submodule path 'Sources/CLibPCache/xxhash': checked out 'e626a72bc2321cd320e953a0ccf1584cad60f363'
Submodule 'Sources/CLibPCache/libpcache' (https://github.com/RuiNelson/libpcache.git) registered for path 'Sources/CLibPCache/libpcache'
Submodule 'Sources/CLibPCache/xxhash' (https://github.com/Cyan4973/xxHash.git) registered for path 'Sources/CLibPCache/xxhash'
Cloning into '/Users/admin/builder/spi-builder-workspace/Sources/CLibPCache/libpcache'...
Cloning into '/Users/admin/builder/spi-builder-workspace/Sources/CLibPCache/xxhash'...
Cloned https://github.com/RuiNelson/libpcache_Swift.git
Revision (git rev-parse @):
9acca11b9b07c7dbf4eb259301b796f42394d9f8
SPI manifest file found: $PWD/.spi.yml
SUCCESS checkout https://github.com/RuiNelson/libpcache_Swift.git at main
========================================
ResolveProductDependencies
========================================
Resolving dependencies ...
{
"identity": ".resolve-product-dependencies",
"name": "resolve-dependencies",
"url": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies",
"version": "unspecified",
"path": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies",
"traits": [
"default"
],
"dependencies": [
{
"identity": "libpcache_swift",
"name": "libpcache_Swift",
"url": "https://github.com/RuiNelson/libpcache_Swift.git",
"version": "unspecified",
"path": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies/.build/checkouts/libpcache_Swift",
"traits": [
"default"
],
"dependencies": [
]
}
]
}
Fetching https://github.com/RuiNelson/libpcache_Swift.git
[1/295] Fetching libpcache_swift
Fetched https://github.com/RuiNelson/libpcache_Swift.git from cache (0.76s)
Creating working copy for https://github.com/RuiNelson/libpcache_Swift.git
Working copy of https://github.com/RuiNelson/libpcache_Swift.git resolved at main (9acca11)
warning: '.resolve-product-dependencies': dependency 'libpcache_swift' is not used by any target
Found 0 product dependencies
========================================
Build
========================================
Selected platform: macosSpm
Swift version: 6.3
Building package at path: $PWD
https://github.com/RuiNelson/libpcache_Swift.git
Running build ...
env DEVELOPER_DIR=/Applications/Xcode-26.4.0.app xcrun swift build --arch arm64
Building for debugging...
[0/9] Write sources
[1/9] Write swift-version--6988338F2F200930.txt
[2/9] Compiling xxhash.c
[3/9] Compiling pages.c
[4/9] Compiling handle.c
[5/9] Compiling db.c
[6/9] Compiling pages_util.c
[7/9] Compiling maintenance.c
[8/9] Compiling volume.c
[10/24] Compiling libpcache_Swift PC-Write.swift
[11/24] Compiling libpcache_Swift Errors.swift
[12/25] Compiling libpcache_Swift PC-Check.swift
[13/25] Compiling libpcache_Swift PC-Delete.swift
[14/25] Compiling libpcache_Swift PC-Maintenance.swift
[15/25] Compiling libpcache_Swift BridgeStructures.swift
[16/25] Compiling libpcache_Swift ValidationHelpers.swift
[17/25] Emitting module libpcache_Swift
[18/25] Compiling libpcache_Swift BridgeErrors.swift
[19/25] Compiling libpcache_Swift BridgeMethods.swift
[20/25] Compiling libpcache_Swift PC-Read.swift
[21/25] Compiling libpcache_Swift PC-Introspection.swift
[22/25] Compiling libpcache_Swift PC-Lifecycle.swift
[23/25] Compiling libpcache_Swift BridgeBuffers.swift
[24/25] Compiling libpcache_Swift BridgeEnums.swift
[25/25] Compiling libpcache_Swift StructsAndEnums.swift
Build complete! (6.45s)
Build complete.
{
"dependencies" : [
],
"manifest_display_name" : "libpcache_Swift",
"name" : "libpcache_Swift",
"path" : "/Users/admin/builder/spi-builder-workspace",
"platforms" : [
{
"name" : "macos",
"version" : "10.15"
},
{
"name" : "ios",
"version" : "13.0"
},
{
"name" : "maccatalyst",
"version" : "13.0"
},
{
"name" : "tvos",
"version" : "12.0"
},
{
"name" : "visionos",
"version" : "1.0"
},
{
"name" : "watchos",
"version" : "4.0"
}
],
"products" : [
{
"name" : "libpcache_Swift",
"targets" : [
"libpcache_Swift"
],
"type" : {
"library" : [
"automatic"
]
}
}
],
"targets" : [
{
"c99name" : "libpcache_SwiftTests",
"module_type" : "SwiftTarget",
"name" : "libpcache_SwiftTests",
"path" : "Tests/libpcache_SwiftTests",
"sources" : [
"ReadmeExampleTests.swift",
"libpcache_SwiftTests.swift"
],
"target_dependencies" : [
"libpcache_Swift"
],
"type" : "test"
},
{
"c99name" : "libpcache_Swift",
"module_type" : "SwiftTarget",
"name" : "libpcache_Swift",
"path" : "Sources/libpcache_Swift",
"product_memberships" : [
"libpcache_Swift"
],
"sources" : [
"Internal/BridgeBuffers.swift",
"Internal/BridgeEnums.swift",
"Internal/BridgeErrors.swift",
"Internal/BridgeMethods.swift",
"Internal/BridgeStructures.swift",
"Internal/ValidationHelpers.swift",
"Public/PC-Check.swift",
"Public/PC-Delete.swift",
"Public/PC-Introspection.swift",
"Public/PC-Lifecycle.swift",
"Public/PC-Maintenance.swift",
"Public/PC-Read.swift",
"Public/PC-Write.swift",
"Public/Types/Errors.swift",
"Public/Types/StructsAndEnums.swift"
],
"target_dependencies" : [
"CLibPCache"
],
"type" : "library"
},
{
"c99name" : "CLibPCache",
"module_type" : "ClangTarget",
"name" : "CLibPCache",
"path" : "Sources/CLibPCache",
"product_memberships" : [
"libpcache_Swift"
],
"sources" : [
"libpcache/src/db.c",
"libpcache/src/handle.c",
"libpcache/src/maintenance.c",
"libpcache/src/pages.c",
"libpcache/src/pages_util.c",
"libpcache/src/volume.c",
"xxhash/xxhash.c"
],
"type" : "library"
}
],
"tools_version" : "6.2"
}
✅ Doc result (pending) reported
========================================
GenerateDocs
========================================
Generating docs at path: $PWD/.docs/ruinelson/libpcache_swift/main
Repository: RuiNelson/libpcache_Swift
Swift version used: 6.3
Target: libpcache_Swift
Extracting symbol information for 'libpcache_Swift'...
Finished extracting symbol information for 'libpcache_Swift'. (27.77s)
Building documentation for 'libpcache_Swift'...
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:19:21-19:32
17 | ///
18 | /// - Returns: `true` if the page exists, `false` otherwise.
19 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `id` has the wrong length;
20 | /// ``CheckPagesError`` on check failure;
21 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:37:21-37:32
35 | /// page that exists, `false` otherwise.
36 | ///
37 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids` is not a multiple of `idWidth`;
38 | /// ``CheckPagesError`` on check failure;
39 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:56:21-56:32
54 | /// - results: Caller-supplied array of at least `count` booleans.
55 | ///
56 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
57 | /// ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
58 | /// ``CheckPagesError/invalidArgument`` if `position` is out of bounds, the counter overflows,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:57:13-57:24
55 | ///
56 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
57 + /// ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
58 | /// ``CheckPagesError/invalidArgument`` if `position` is out of bounds, the counter overflows,
59 | /// or `endianness` is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:91:21-91:32
89 | /// - Returns: The number of pages in the range.
90 | ///
91 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if either buffer has the wrong length;
92 | /// ``CheckPagesError/rangeInvalidRange`` if `first > last`;
93 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:112:21-112:32
110 | ///
111 | /// - Returns: `true` if the page exists, `false` otherwise.
112 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
113 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
114 | func checkPage(id: RawSpan) throws -> Bool {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:127:21-127:32
125 | /// where `count = ids.byteCount / idWidth`.
126 | ///
127 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
128 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `results` has fewer elements than required;
129 | /// ``CheckPagesError`` on check failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:128:13-128:24
126 | ///
127 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
128 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `results` has fewer elements than required;
129 | /// ``CheckPagesError`` on check failure;
130 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:156:21-156:32
154 | ///
155 | /// - Returns: Array of booleans, `true` for each page that exists.
156 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
157 | /// ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
158 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:157:13-157:24
155 | /// - Returns: Array of booleans, `true` for each page that exists.
156 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
157 + /// ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
158 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
159 | func checkPages(counter: Counter, count: Int) throws -> [Bool] {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:174:21-174:32
172 | ///
173 | /// - Returns: The number of pages in the range.
174 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
175 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
176 | func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:193:21-193:32
191 | ///
192 | /// - Returns: `true` if the page exists, `false` otherwise.
193 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
194 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
195 | func checkPage(id: some ContiguousBytes) throws -> Bool {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:206:21-206:32
204 | ///
205 | /// - Returns: Array of booleans, `true` for each page that exists.
206 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
207 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
208 | func checkPages(ids: some ContiguousBytes) throws -> [Bool] {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:229:21-229:32
227 | ///
228 | /// - Returns: The number of pages in the range.
229 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
230 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
231 | func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:248:21-248:32
246 | ///
247 | /// - Returns: Array of booleans, `true` for each page that exists.
248 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure;
249 | /// ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
250 | func checkPages(ids: [Data]) throws -> [Bool] {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:21:21-21:32
19 | /// - durable: If `true`, block until data is durable on disk.
20 | ///
21 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `id` has the wrong length;
22 | /// ``DeletePagesError`` on delete failure;
23 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:25:13-25:23
23 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
24 | /// ``CommonErrors/outOfMemory`` on allocation failure;
25 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
26 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
27 | func deletePage(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:51:21-51:32
49 | /// - durable: If `true`, block until data is durable on disk.
50 | ///
51 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids` is not a multiple of `idWidth`;
52 | /// ``DeletePagesError`` on delete failure;
53 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:55:13-55:23
53 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
54 | /// ``CommonErrors/outOfMemory`` on allocation failure;
55 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
56 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
57 | func deletePages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:81:21-81:32
79 | /// - durable: If `true`, block until data is durable on disk.
80 | ///
81 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
82 | /// ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
83 | /// ``DeletePagesError/invalidArgument`` if `position` is out of bounds, the counter overflows,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:82:13-82:24
80 | ///
81 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
82 + /// ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
83 | /// ``DeletePagesError/invalidArgument`` if `position` is out of bounds, the counter overflows,
84 | /// or `endianness` is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:87:13-87:23
85 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
86 | /// ``CommonErrors/outOfMemory`` on allocation failure;
87 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
88 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
89 | func deletePages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:122:21-122:32
120 | /// - durable: If `true`, block until data is durable on disk.
121 | ///
122 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if either buffer has the wrong length;
123 | /// ``DeletePagesError/invalidRange`` if `first > last`;
124 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:126:13-126:23
124 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
125 | /// ``CommonErrors/outOfMemory`` on allocation failure;
126 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
127 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
128 | func deletePagesRange(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:156:21-156:32
154 | /// - durable: If `true`, block until data is durable on disk.
155 | ///
156 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
157 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
158 | func deletePage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:157:31-157:41
155 | ///
156 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
157 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
158 | func deletePage(
159 | id: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:175:21-175:32
173 | /// - durable: If `true`, block until data is durable on disk.
174 | ///
175 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
176 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
177 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:176:31-176:41
174 | ///
175 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
176 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
177 | func deletePages(
178 | ids: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:195:21-195:32
193 | /// - durable: If `true`, block until data is durable on disk.
194 | ///
195 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
196 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
197 | func deletePagesRange(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:196:31-196:41
194 | ///
195 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
196 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
197 | func deletePagesRange(
198 | first: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:226:21-226:32
224 | /// - durable: If `true`, block until data is durable on disk.
225 | ///
226 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
227 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
228 | func deletePage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:227:31-227:41
225 | ///
226 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
227 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
228 | func deletePage(
229 | id: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:245:21-245:32
243 | /// - durable: If `true`, block until data is durable on disk.
244 | ///
245 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
246 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
247 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:246:31-246:41
244 | ///
245 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
246 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
247 | func deletePages(
248 | ids: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:265:21-265:32
263 | /// - durable: If `true`, block until data is durable on disk.
264 | ///
265 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
266 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
267 | func deletePagesRange(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:266:31-266:41
264 | ///
265 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
266 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
267 | func deletePagesRange(
268 | first: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:296:21-296:32
294 | /// - durable: If `true`, block until data is durable on disk.
295 | ///
296 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
297 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
298 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:297:31-297:41
295 | ///
296 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure;
297 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
298 | func deletePages(
299 | ids: [Data],
warning: Parameter 'options.preallocateDatabase' not found in type method declaration
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:79:11-80:60
77 | /// - files: Paths to the database and data files.
78 | /// - configuration: Volume parameters (page size, capacity, id width, eviction policy).
79 + /// - options.preallocateDatabase: If `true`, pre-allocate slots in the index for all `maxPages` pages,
| ╰─suggestion: Remove 'options.preallocateDatabase' parameter documentation
80 + /// enabling O(1) allocation on subsequent inserts.
81 | /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
82 | ///
warning: Parameter 'options.preallocateDatafile' not found in type method declaration
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:81:11-82:9
79 | /// - options.preallocateDatabase: If `true`, pre-allocate slots in the index for all `maxPages` pages,
80 | /// enabling O(1) allocation on subsequent inserts.
81 + /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
| ╰─suggestion: Remove 'options.preallocateDatafile' parameter documentation
82 + ///
83 | /// - Throws: ``CreateVolumeError`` if the volume cannot be created;
84 | /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: Parameter 'options' is missing documentation
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:82:9-82:9
80 | /// enabling O(1) allocation on subsequent inserts.
81 | /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
82 + ///
| ╰─suggestion: Document 'options' parameter
83 | /// - Throws: ``CreateVolumeError`` if the volume cannot be created;
84 | /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/create(files:configuration:options:)'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:84:13-84:23
82 | ///
83 | /// - Throws: ``CreateVolumeError`` if the volume cannot be created;
84 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
85 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
86 | static func create(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/init(files:)'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:107:13-107:23
105 | /// - Throws: ``OpenVolumeError`` if the volume cannot be opened;
106 | /// ``CommonErrors/outOfMemory`` on allocation failure;
107 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
108 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
109 | convenience init(files: FilePair) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/close()'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:120:13-120:23
118 | ///
119 | /// - Throws: ``CommonErrors/invalidHandle`` if the volume handle is invalid;
120 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on WAL checkpoint failure;
121 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
122 | func close() throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/defragment(shrinkFile:durable:progress:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:32:13-32:23
30 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
31 | /// ``CommonErrors/outOfMemory`` on allocation failure;
32 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
33 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
34 | func defragment(shrinkFile: Bool, durable: Bool = true, progress: @escaping @Sendable (Double) -> Bool) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/setNewMaxPages(_:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:52:21-52:32
50 | /// - durable: If `true`, block until data is durable on disk.
51 | ///
52 + /// - Throws: ``InvalidCall/invalidArguments`` if `maxPages` is ≤ 0;
53 | /// ``VolumeSetMaxPagesError`` if the reduction would discard pages on a FIXED volume;
54 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/setNewMaxPages(_:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:56:13-56:23
54 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
55 | /// ``CommonErrors/outOfMemory`` on allocation failure;
56 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
57 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
58 | func setNewMaxPages(_ maxPages: Int, durable: Bool = true) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/preallocate(database:datafile:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:73:21-73:32
71 | /// - durable: If `true`, block until data is durable on disk.
72 | ///
73 + /// - Throws: ``InvalidCall/invalidArguments`` if both flags are `false`;
74 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
75 | /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/preallocate(database:datafile:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:75:13-75:23
73 | /// - Throws: ``InvalidCall/invalidArguments`` if both flags are `false`;
74 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
75 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
76 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
77 | func preallocate(database: Bool, datafile: Bool, durable: Bool = true) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:18:21-18:32
16 | /// - data: Destination buffer; must be exactly ``Configuration/pageSizeInt`` bytes.
17 | ///
18 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize``
19 | /// if either buffer has the wrong length; ``GetPagesError`` on read failure;
20 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:18:69-18:80
16 | /// - data: Destination buffer; must be exactly ``Configuration/pageSizeInt`` bytes.
17 | ///
18 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize``
19 | /// if either buffer has the wrong length; ``GetPagesError`` on read failure;
20 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:22:13-22:23
20 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
21 | /// ``CommonErrors/outOfMemory`` on allocation failure;
22 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
23 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
24 | func getPage(id: CBuffer, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:39:21-39:32
37 | /// - data: Destination buffer; must be `count * pageSize` bytes.
38 | ///
39 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
40 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
41 | /// if the buffers are mismatched; ``GetPagesError`` on read failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:40:13-40:24
38 | ///
39 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
40 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
41 | /// if the buffers are mismatched; ``GetPagesError`` on read failure;
42 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:44:13-44:23
42 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
43 | /// ``CommonErrors/outOfMemory`` on allocation failure;
44 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
45 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
46 | func getPages(ids: CBuffer, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:58:21-58:32
56 | /// - data: Destination buffer; must be `count * pageSize` bytes.
57 | ///
58 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
59 | /// ``GetPagesError`` on read failure;
60 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:62:13-62:23
60 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
61 | /// ``CommonErrors/outOfMemory`` on allocation failure;
62 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
63 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
64 | func getPages(counter: Counter, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:95:21-95:32
93 | /// - Returns: The number of pages retrieved.
94 | ///
95 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if any buffer has the wrong length;
96 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
97 | /// if `idsOut` and `pagesOut` have different capacities;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:96:13-96:24
94 | ///
95 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if any buffer has the wrong length;
96 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
97 | /// if `idsOut` and `pagesOut` have different capacities;
98 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:102:13-102:23
100 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
101 | /// ``CommonErrors/outOfMemory`` on allocation failure;
102 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
103 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
104 | func getPagesRange(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:144:21-144:32
142 | /// - data: Destination buffer; must be at least ``Configuration/pageSizeInt`` bytes.
143 | ///
144 + /// - Throws: ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than ``Configuration/pageSizeInt``
145 | /// bytes;
146 | /// ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:146:13-146:24
144 | /// - Throws: ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than ``Configuration/pageSizeInt``
145 | /// bytes;
146 + /// ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
147 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
148 | func getPage(id: RawSpan, into data: consuming MutableRawSpan) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:147:31-147:41
145 | /// bytes;
146 | /// ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
147 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
148 | func getPage(id: RawSpan, into data: consuming MutableRawSpan) throws {
149 | let pageSize = try configuration.pageSizeInt
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:170:21-170:32
168 | /// where `count = ids.byteCount / idWidth`.
169 | ///
170 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
171 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required;
172 | /// ``GetPagesError`` on read failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:171:13-171:24
169 | ///
170 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
171 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required;
172 | /// ``GetPagesError`` on read failure;
173 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:173:31-173:41
171 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required;
172 | /// ``GetPagesError`` on read failure;
173 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
174 | func getPages(ids: RawSpan, into data: consuming MutableRawSpan) throws {
175 | let cfg = try configuration
warning: 'checkPagesRange(first:last:)-swift.method' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/PC-Read.swift:197:31-197:44
195 | /// Retrieves all pages whose identifier falls within the closed interval `[first, last]`.
196 | ///
197 + /// Call ``checkPagesRange(first:last:)-swift.method`` first to determine the required buffer capacity.
| ├─suggestion: Replace 'swift.method' with '(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Replace 'swift.method' with '(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Replace 'swift.method' with '(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
198 | /// Pages are returned in ascending identifier order.
199 | ///
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:208:21-208:32
206 | /// - Returns: The number of pages retrieved.
207 | ///
208 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
209 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
210 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:209:13-209:24
207 | ///
208 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
209 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
210 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
211 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:210:13-210:24
208 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
209 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
210 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
211 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`;
212 | /// ``GetPagesError/rangeBufferTooSmall`` if the buffers are too small;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:213:31-213:41
211 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`;
212 | /// ``GetPagesError/rangeBufferTooSmall`` if the buffers are too small;
213 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
214 | func getPagesRange(
215 | first: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:245:21-245:32
243 | ///
244 | /// - Returns: The page data.
245 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
246 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
247 | func getPage(id: some ContiguousBytes) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:246:31-246:41
244 | /// - Returns: The page data.
245 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
246 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
247 | func getPage(id: some ContiguousBytes) throws -> Data {
248 | var data = try Data(count: configuration.pageSizeInt)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:262:21-262:32
260 | ///
261 | /// - Returns: `Data` containing all retrieved pages concatenated.
262 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
263 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
264 | func getPages(ids: some ContiguousBytes) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:263:31-263:41
261 | /// - Returns: `Data` containing all retrieved pages concatenated.
262 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
263 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
264 | func getPages(ids: some ContiguousBytes) throws -> Data {
265 | let cfg = try configuration
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:287:21-287:32
285 | ///
286 | /// - Returns: `Data` containing all retrieved pages concatenated.
287 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
288 | /// ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
289 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:288:13-288:24
286 | /// - Returns: `Data` containing all retrieved pages concatenated.
287 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
288 + /// ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
289 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
290 | func getPages(counter: Counter, count: Int) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:289:31-289:41
287 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative;
288 | /// ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
289 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
290 | func getPages(counter: Counter, count: Int) throws -> Data {
291 | guard count >= 0 else { throw InvalidCall.invalidArguments }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:307:21-307:32
305 | ///
306 | /// - Returns: Tuple containing `(ids, pages)`.
307 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
308 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
309 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data) {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:308:31-308:41
306 | /// - Returns: Tuple containing `(ids, pages)`.
307 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
308 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
309 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data) {
310 | let bufferCapacity = try checkPagesRange(first: first, last: last)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:331:21-331:32
329 | ///
330 | /// - Returns: Array of `(id, page)` tuples, one per retrieved page.
331 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
332 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
333 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)] {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:332:31-332:41
330 | /// - Returns: Array of `(id, page)` tuples, one per retrieved page.
331 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
332 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
333 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)] {
334 | let bufferCapacity = try checkPagesRange(first: first, last: last)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:387:21-387:32
385 | ///
386 | /// - Returns: `Data` containing all retrieved pages concatenated.
387 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
388 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
389 | func getPages(ids: [Data]) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:388:31-388:41
386 | /// - Returns: `Data` containing all retrieved pages concatenated.
387 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
388 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
389 | func getPages(ids: [Data]) throws -> Data {
390 | guard !ids.isEmpty else { return Data() }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:408:21-408:32
406 | ///
407 | /// - Returns: Array of `Data` objects, one per page.
408 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
409 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
410 | func getPages(ids: [Data]) throws -> [Data] {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:409:31-409:41
407 | /// - Returns: Array of `Data` objects, one per page.
408 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure;
409 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
410 | func getPages(ids: [Data]) throws -> [Data] {
411 | guard !ids.isEmpty else { return [] }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:23:21-23:32
21 | /// - durable: If `true`, block until data is durable on disk.
22 | ///
23 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize``
24 | /// if either buffer has the wrong length; ``PutPagesError`` on write failure;
25 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:23:69-23:80
21 | /// - durable: If `true`, block until data is durable on disk.
22 | ///
23 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize``
24 | /// if either buffer has the wrong length; ``PutPagesError`` on write failure;
25 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:27:13-27:23
25 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
26 | /// ``CommonErrors/outOfMemory`` on allocation failure;
27 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
28 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
29 | func putPage(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:58:21-58:32
56 | /// - durable: If `true`, block until data is durable on disk.
57 | ///
58 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
59 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
60 | /// if the buffers are mismatched; ``PutPagesError`` on write failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:59:13-59:24
57 | ///
58 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
59 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer``
60 | /// if the buffers are mismatched; ``PutPagesError`` on write failure;
61 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:63:13-63:23
61 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
62 | /// ``CommonErrors/outOfMemory`` on allocation failure;
63 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
64 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
65 | func putPages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:91:21-91:32
89 | /// - durable: If `true`, block until data is durable on disk.
90 | ///
91 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong;
92 | /// ``PutPagesError`` on write failure;
93 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:95:13-95:23
93 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid;
94 | /// ``CommonErrors/outOfMemory`` on allocation failure;
95 + /// ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
96 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
97 | func putPages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:134:21-134:32
132 | /// - durable: If `true`, block until data is durable on disk.
133 | ///
134 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
135 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
136 | func putPage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:135:31-135:41
133 | ///
134 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
135 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
136 | func putPage(
137 | id: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:162:21-162:32
160 | /// - durable: If `true`, block until data is durable on disk.
161 | ///
162 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
163 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
164 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:163:31-163:41
161 | ///
162 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
163 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
164 | func putPages(
165 | ids: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:190:21-190:32
188 | /// - durable: If `true`, block until data is durable on disk.
189 | ///
190 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
191 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
192 | func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:191:31-191:41
189 | ///
190 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
191 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
192 | func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws {
193 | try data.withUnsafeBytes { dataBuf in
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:215:21-215:32
213 | /// - durable: If `true`, block until data is durable on disk.
214 | ///
215 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
216 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
217 | func putPage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:216:31-216:41
214 | ///
215 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
216 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
217 | func putPage(
218 | id: some ContiguousBytes,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:243:21-243:32
241 | /// - durable: If `true`, block until data is durable on disk.
242 | ///
243 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
244 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
245 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:244:31-244:41
242 | ///
243 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
244 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
245 | func putPages(
246 | ids: some ContiguousBytes,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:271:21-271:32
269 | /// - durable: If `true`, block until data is durable on disk.
270 | ///
271 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
272 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
273 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:272:31-272:41
270 | ///
271 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
272 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
273 | func putPages(
274 | counter: Counter,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:323:21-323:32
321 | /// - durable: If `true`, block until data is durable on disk.
322 | ///
323 + /// - Throws: ``InvalidCall`` on invalid buffer size or mismatched array counts;
324 | /// ``PutPagesError`` on write failure;
325 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:325:31-325:41
323 | /// - Throws: ``InvalidCall`` on invalid buffer size or mismatched array counts;
324 | /// ``PutPagesError`` on write failure;
325 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
326 | func putPages(ids: [Data], data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
327 | guard ids.count == data.count else {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:351:21-351:32
349 | /// - durable: If `true`, block until data is durable on disk.
350 | ///
351 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
352 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
353 | func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:352:31-352:41
350 | ///
351 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure;
352 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
353 | func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
354 | guard !data.isEmpty else { return }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(pages:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:378:21-378:32
376 | /// - durable: If `true`, block until data is durable on disk.
377 | ///
378 + /// - Throws: ``InvalidCall`` on invalid buffer size;
379 | /// ``PutPagesError`` on write failure;
380 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(pages:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:380:31-380:41
378 | /// - Throws: ``InvalidCall`` on invalid buffer size;
379 | /// ``PutPagesError`` on write failure;
380 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
381 | func putPages(
382 | pages: [(id: Data, data: Data)],
warning: 'putPage(id:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:57:48-57:86
55 | /// Errors returned by write operations on a ``PersistentCache`` volume.
56 | ///
57 + /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func putPage(id: CBuffer, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(RawSpan,_,_,_)' for 'func putPage(id: RawSpan, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(ContiguousBytes,_,_,_)' for 'func putPage(id: some ContiguousBytes, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
58 | /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
59 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
warning: 'putPages(ids:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:58:23-58:63
56 | ///
57 | /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
58 + /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func putPages(ids: CBuffer, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(RawSpan,_,_,_)' for 'func putPages(ids: RawSpan, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-([Data],_,_,_)' for 'func putPages(ids: [Data], data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(ContiguousBytes,_,_,_)' for 'func putPages(ids: some ContiguousBytes, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
59 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
60 | public enum PutPagesError: Error, Equatable {
warning: 'putPages(counter:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:59:23-59:67
57 | /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
58 | /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
59 + /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
| ├─suggestion: Insert '-(_,CBuffer,_,_)' for 'func putPages(counter: Counter, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,RawSpan,_,_)' for 'func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,[Data],_,_)' for 'func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(_,ContiguousBytes,_,_)' for 'func putPages(counter: Counter, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
60 | public enum PutPagesError: Error, Equatable {
61 | /// FIXED volume is full and has no free slots.
warning: 'getPagesRange(first:last:idsOut:pagesOut:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:73:27-73:69
71 | /// Read operations include ``PersistentCache/getPage(id:data:)``,
72 | /// ``PersistentCache/getPages(ids:data:)``, ``PersistentCache/getPages(counter:data:)``,
73 + /// and ``PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)``.
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func getPagesRange(first: CBuffer, last: CBuffer, idsOut: CMutableBuffer, pagesOut: CMutableBuffer) throws -> Int'
| ╰─suggestion: Insert '-(RawSpan,_,_,_)' for 'func getPagesRange(first: RawSpan, last: RawSpan, idsOut: consuming MutableRawSpan, pagesOut: consuming MutableRawSpan) throws -> Int'
74 | public enum GetPagesError: Error, Equatable {
75 | /// No page with the given identifier exists in the volume.
warning: 'checkPage(id:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:87:48-87:62
85 | /// Errors returned by check operations on a ``PersistentCache`` volume.
86 | ///
87 + /// Check operations include ``PersistentCache/checkPage(id:)``,
| ├─suggestion: Insert '-(CBuffer)' for 'func checkPage(id: CBuffer) throws -> Bool'
| ├─suggestion: Insert '-(RawSpan)' for 'func checkPage(id: RawSpan) throws -> Bool'
| ╰─suggestion: Insert '-(ContiguousBytes)' for 'func checkPage(id: some ContiguousBytes) throws -> Bool'
88 | /// ``PersistentCache/checkPages(ids:)``, ``PersistentCache/checkPages(counter:count:)``,
89 | /// and ``PersistentCache/checkPagesRange(first:last:)``.
warning: 'checkPages(ids:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:88:23-88:39
86 | ///
87 | /// Check operations include ``PersistentCache/checkPage(id:)``,
88 + /// ``PersistentCache/checkPages(ids:)``, ``PersistentCache/checkPages(counter:count:)``,
| ├─suggestion: Insert '-([Data])' for 'func checkPages(ids: [Data]) throws -> [Bool]'
| ╰─suggestion: Insert '-(ContiguousBytes)' for 'func checkPages(ids: some ContiguousBytes) throws -> [Bool]'
89 | /// and ``PersistentCache/checkPagesRange(first:last:)``.
90 | public enum CheckPagesError: Error, Equatable{
warning: 'checkPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:89:27-89:55
87 | /// Check operations include ``PersistentCache/checkPage(id:)``,
88 | /// ``PersistentCache/checkPages(ids:)``, ``PersistentCache/checkPages(counter:count:)``,
89 + /// and ``PersistentCache/checkPagesRange(first:last:)``.
| ├─suggestion: Insert '-(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Insert '-(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Insert '-(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
90 | public enum CheckPagesError: Error, Equatable{
91 | /// `position` is out of bounds, the counter would overflow, or `endianness` is invalid.
warning: 'deletePage(id:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:99:49-99:85
97 | /// Errors returned by delete operations on a ``PersistentCache`` volume.
98 | ///
99 + /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
| ╰─suggestion: Replace 'deletePage(id:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
100 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
101 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``,
warning: 'deletePages(ids:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:100:23-100:61
98 | ///
99 | /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
100 + /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
| ╰─suggestion: Replace 'deletePages(ids:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
101 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``,
102 | /// and ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
warning: 'deletePages(counter:count:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:101:23-101:71
99 | /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
100 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
101 + /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``,
| ╰─suggestion: Replace 'deletePages(counter:count:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
102 | /// and ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
103 | public enum DeletePagesError: Error, Equatable {
warning: 'deletePagesRange(first:last:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:102:27-102:77
100 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
101 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``,
102 + /// and ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
| ╰─suggestion: Replace 'deletePagesRange(first:last:wipeDataFile:durable:)' with 'deletePagesRange(first:last:wipe:durable:)'
103 | public enum DeletePagesError: Error, Equatable {
104 | /// `first` is greater than `last`.
warning: 'PersistentCache.create(files:configuration:options:)' doesn't exist at '/libpcache_Swift/Configuration'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:44:18-44:70
42 | /// These values are fixed at creation time and stored in the `metadata` table of the SQLite index.
43 | ///
44 + /// - SeeAlso: ``PersistentCache.create(files:configuration:options:)`` to create a volume with this configuration
45 | public struct Configuration: Sendable, Equatable {
46 | /// Size of every page, in bytes.
warning: 'getPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:154:49-154:75
152 | /// Byte order used when embedding a counter in page identifiers.
153 | ///
154 + /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
| ├─suggestion: Insert '->(_,_)' for 'func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data)'
| ╰─suggestion: Insert '->_' for 'func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)]'
155 | /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``)
156 | /// prefer ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering).
warning: 'checkPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:155:23-155:51
153 | ///
154 | /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
155 + /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``)
| ├─suggestion: Insert '-(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Insert '-(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Insert '-(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
156 | /// prefer ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering).
157 | /// With big-endian, the most-significant byte occupies the lowest address, so a larger counter
warning: 'deletePagesRange(first:last:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:155:73-155:102
153 | ///
154 | /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
155 + /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``)
| ├─suggestion: Replace 'deletePagesRange(first:last:)' with 'deletePagesRange(first:last:wipe:durable:)'
| ├─suggestion: Replace 'deletePagesRange(first:last:)' with 'getPagesRange(first:last:)'
| ╰─suggestion: Replace 'deletePagesRange(first:last:)' with 'checkPagesRange(first:last:)'
156 | /// prefer ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering).
157 | /// With big-endian, the most-significant byte occupies the lowest address, so a larger counter
warning: 'template' doesn't exist at '/libpcache_Swift/Counter'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:172:78-172:86
170 | ///
171 | /// ``Counter`` derives page identifiers automatically from a template: a `UInt32` counter — starting at
172 + /// ``initialValue``, incremented per page — is XOR'd into four bytes of ``template``.
173 | /// The operations ``PersistentCache/putPages(counter:data:failIfExists:durable:)``,
174 | /// ``PersistentCache/getPages(counter:count:)``, ``PersistentCache/checkPages(counter:count:)``,
warning: 'putPages(counter:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:173:38-173:82
171 | /// ``Counter`` derives page identifiers automatically from a template: a `UInt32` counter — starting at
172 | /// ``initialValue``, incremented per page — is XOR'd into four bytes of ``template``.
173 + /// The operations ``PersistentCache/putPages(counter:data:failIfExists:durable:)``,
| ├─suggestion: Insert '-(_,CBuffer,_,_)' for 'func putPages(counter: Counter, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,RawSpan,_,_)' for 'func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,[Data],_,_)' for 'func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(_,ContiguousBytes,_,_)' for 'func putPages(counter: Counter, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
174 | /// ``PersistentCache/getPages(counter:count:)``, ``PersistentCache/checkPages(counter:count:)``,
175 | /// and ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)`` share the same identifier
warning: 'deletePages(counter:count:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:175:27-175:75
173 | /// The operations ``PersistentCache/putPages(counter:data:failIfExists:durable:)``,
174 | /// ``PersistentCache/getPages(counter:count:)``, ``PersistentCache/checkPages(counter:count:)``,
175 + /// and ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)`` share the same identifier
| ╰─suggestion: Replace 'deletePages(counter:count:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
176 | /// derivation scheme. The operations are therefore symmetric: the same `template`, `start`, `count`,
177 | /// `position`, and `endianness` reconstruct the same identifiers for reads, checks, and deletes
warning: 'bigEndian' doesn't exist at '/libpcache_Swift/Counter'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:182:40-182:49
180 | /// ### Identifier Derivation Example
181 | /// With `idWidth = 8`, `template = {0xDE,0xAD,0xBE,0xEF, 0x00,0x00,0x00,0x00}`,
182 + /// `start = 5`, `position = 0`, and ``bigEndian``, the counter value 5 is encoded as
183 | /// `{0x00,0x00,0x00,0x05}` and XOR'd into bytes `[4..7]`:
184 | /// ```swift
Finished building documentation for 'libpcache_Swift' (0.44s)
Generated documentation archive at:
/Users/admin/builder/spi-builder-workspace/.docs/ruinelson/libpcache_swift/main
Fetching https://github.com/swiftlang/swift-docc-plugin
[1/2287] Fetching swift-docc-plugin
Fetched https://github.com/swiftlang/swift-docc-plugin from cache (1.09s)
Computing version for https://github.com/swiftlang/swift-docc-plugin
Computed https://github.com/swiftlang/swift-docc-plugin at 1.5.0 (3.56s)
Fetching https://github.com/swiftlang/swift-docc-symbolkit
[1/3712] Fetching swift-docc-symbolkit
Fetched https://github.com/swiftlang/swift-docc-symbolkit from cache (1.17s)
Computing version for https://github.com/swiftlang/swift-docc-symbolkit
Computed https://github.com/swiftlang/swift-docc-symbolkit at 1.0.0 (1.90s)
Creating working copy for https://github.com/swiftlang/swift-docc-plugin
Working copy of https://github.com/swiftlang/swift-docc-plugin resolved at 1.5.0
Creating working copy for https://github.com/swiftlang/swift-docc-symbolkit
Working copy of https://github.com/swiftlang/swift-docc-symbolkit resolved at 1.0.0
Building for debugging...
[0/8] Write sources
[1/8] Write snippet-extract-tool-entitlement.plist
[3/8] Write sources
[4/8] Write swift-version--6988338F2F200930.txt
[6/54] Emitting module SymbolKit
[7/58] Compiling Snippets SnippetLanguage.swift
[8/58] Compiling Snippets Snippet.swift
[9/58] Emitting module Snippets
[10/58] Compiling Snippets SnippetParser.swift
[11/58] Compiling SymbolKit Relationship.swift
[12/58] Compiling SymbolKit RelationshipKind.swift
[13/58] Compiling SymbolKit SourceOrigin.swift
[14/58] Compiling SymbolKit GenericConstraints.swift
[15/58] Compiling SymbolKit Swift.swift
[16/58] Compiling SymbolKit Names.swift
[17/58] Compiling SymbolKit SPI.swift
[18/58] Compiling SymbolKit Snippet.swift
[19/58] Compiling SymbolKit Extension.swift
[20/58] Compiling SymbolKit Symbol.swift
[21/58] Compiling SymbolKit SymbolKind.swift
[22/58] Compiling SymbolKit SymbolGraph.swift
[23/58] Compiling SymbolKit GraphCollector.swift
[24/58] Compiling SymbolKit Mixin+Equals.swift
[25/58] Compiling SymbolKit Mixin+Hash.swift
[26/58] Compiling SymbolKit Mixin.swift
[27/58] Compiling SymbolKit LineList.swift
[28/58] Compiling SymbolKit Position.swift
[29/58] Compiling SymbolKit GenericConstraint.swift
[30/58] Compiling SymbolKit GenericParameter.swift
[31/58] Compiling SymbolKit Generics.swift
[32/58] Compiling SymbolKit Namespace.swift
[33/58] Compiling SymbolKit SourceRange.swift
[34/58] Compiling SymbolKit Metadata.swift
[35/58] Compiling SymbolKit Module.swift
[36/58] Compiling SymbolKit OperatingSystem.swift
[37/58] Compiling SymbolKit Platform.swift
[38/58] Compiling SymbolKit Identifier.swift
[39/58] Compiling SymbolKit KindIdentifier.swift
[40/58] Compiling SymbolKit Location.swift
[41/58] Compiling SymbolKit Mutability.swift
[42/58] Compiling SymbolKit SemanticVersion.swift
[43/58] Compiling SymbolKit AccessControl.swift
[44/58] Compiling SymbolKit Availability.swift
[45/58] Compiling SymbolKit AvailabilityItem.swift
[46/58] Compiling SymbolKit Domain.swift
[47/58] Compiling SymbolKit DeclarationFragments.swift
[48/58] Compiling SymbolKit Fragment.swift
[49/58] Compiling SymbolKit FragmentKind.swift
[50/58] Compiling SymbolKit FunctionParameter.swift
[51/58] Compiling SymbolKit FunctionSignature.swift
[52/58] Compiling SymbolKit UnifiedSymbol+Encodable.swift
[53/58] Compiling SymbolKit UnifiedSymbol.swift
[54/58] Compiling SymbolKit UnifiedSymbolGraph+Encodable.swift
[55/58] Compiling SymbolKit UnifiedSymbolGraph.swift
[56/62] Compiling snippet_extract URL+Status.swift
[57/62] Compiling snippet_extract SymbolGraph+Snippet.swift
[58/62] Emitting module snippet_extract
[59/62] Compiling snippet_extract SnippetBuildCommand.swift
[59/62] Write Objects.LinkFileList
[60/62] Linking snippet-extract-tool
[61/62] Applying snippet-extract-tool
Build of product 'snippet-extract' complete! (4.38s)
Building for debugging...
[0/1] Write swift-version--6988338F2F200930.txt
Build of target: 'libpcache_Swift' complete! (0.26s)
416
4 /Users/admin/builder/spi-builder-workspace/.docs/ruinelson/libpcache_swift/main
✅ Doc result (uploading) reported
========================================
SyncDocs
========================================
Doc archive source directory: $PWD/.docs/ruinelson/libpcache_swift/main
File count: 416
Doc size: 4.0MB
Preparing doc bundle ...
Uploading prod-ruinelson-libpcache_swift-main-c3604d83.zip to s3://spi-docs-inbox/prod-ruinelson-libpcache_swift-main-c3604d83.zip
Copying... [16%]
Copying... [24%]
Copying... [32%]
Copying... [48%]
Copying... [56%]
Copying... [64%]
Copying... [72%]
Copying... [87%]
Copying... [95%]
Copying... [100%]
Done.