{"uid":"cap_RJlSrIc-kDRLGmE31vlXH","slug":"posix-iovec-partial-scatter-provenance-analyzer-5ae2feb8","name":"POSIX iovec Partial Scatter Provenance Analyzer","description":"An offline vectored-read fixture author needs exact residual buffer vectors and final anonymous byte-origin mapping after short reads and no-progress errors, especially when destination slices overlap.","url":"https://detect.halowerk.com/v1/F-A-NIGHT-OS-IOV-SCATTER/posix-iovec-partial-scatter-provenance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","required":["iov_scatter"],"properties":{"iov_scatter":{"type":"object","required":["claim","iovecs","results"],"properties":{"claim":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"iovecs":{"type":"array","items":{"type":"object","required":["buffer","length","offset"],"properties":{"buffer":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"length":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"offset":{"type":"number","maximum":1000000000000,"minimum":-1000000000000}},"additionalProperties":false},"maxItems":512},"results":{"type":"array","items":{"type":"object","required":["count","error"],"properties":{"count":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"error":{"type":"number","maximum":1000000000000,"minimum":-1000000000000}},"additionalProperties":false},"maxItems":512}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mIEt1U0t7E-ANmoDPxMVA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes residual buffer vectors and anonymous byte-origin mappings for POSIX iovec scatter-read operations after short reads and no-progress errors, including overlapping destination slices.","exampleAgentPrompt":"I have a POSIX iovec scatter read that completed short — can you compute the residual buffer vectors and final byte-origin mapping? I'll give you the iovec array with buffers, lengths, and offsets, plus the per-operation read counts and error codes from the results, and the total byte claim of 4096.","exampleUseCases":[{"title":"Debugging short read in iovec scatter","prompt":"My iovec scatter read returned fewer bytes than expected across 3 iovecs — can you tell me which buffer regions are still unfilled and map which bytes came from which source? The claimed total is 8192, the iovecs have buffers at offsets 0, 512, and 1024 with lengths 2048, 2048, and 4096, and the results show counts of 1024 and 0 with error code -11 on the second."},{"title":"Overlapping destination slice provenance","prompt":"I have a scatter read where two of my destination iovecs overlap in memory — can you compute the final byte-origin mapping and residual vectors after the read? Claim is 2048, iovecs share a buffer region, and I got a short read count of 512 with no error on the first op."},{"title":"No-progress error residual analysis","prompt":"My POSIX scatter IO hit a no-progress error partway through — I need to know the exact residual buffer vectors remaining and which bytes were actually written. The claim was 65536, I have 8 iovecs, and the results show a mix of partial counts and error code -35."}],"resultDescription":"Returns the exact residual (unfilled) buffer vectors remaining after the scatter read operation completed, along with an anonymous byte-origin mapping that identifies which source provided each byte in the destination buffers, accounting for short reads, no-progress errors, and overlapping destination slice regions.","failureModes":["Invalid iovec array structure (mismatched buffer/length/offset fields)","Results array length does not correspond to iovec count","Claim value out of valid range","Buffer overlap detection failure on malformed offset combinations","No-progress error code not recognized"],"whenToPreferThis":"Use this endpoint when you need deterministic, auditable provenance of POSIX iovec scatter-read byte origins after partial or error-affected reads, especially when destination slices may overlap. It is the right choice for offline fixture authoring, test vector generation, or debugging complex scatter-gather I/O behavior where standard OS tooling cannot isolate residual buffer state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:41:26.451Z","isFirstParty":false,"canonicalSlug":"posix-iovec-partial-scatter-provenance-analyzer-5ae2feb8"}