# Linux inotify Unread-Event Coalescing Fixture

> Linux inotify Unread-Event Coalescing Fixture is a paid API for AI agents from detect.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-04).

Simulates and validates Linux inotify queue read behavior including event coalescing, buffer boundary conditions, name padding, and partial batch admission for offline testing fixtures.

## Facts

- Endpoint: POST https://detect.halowerk.com/v1/F-A-NIGHT-OS-INOTIFY/linux-inotify-unread-event-coalescing?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/linux-inotify-unread-event-coalescing-fixture-97951a05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jtXaDGPPNu-glOmKpg_28

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability linux-inotify-unread-event-coalescing-fixture-97951a05 -d '<json body>'
```

Example prompt: Run an inotify unread-queue coalescing test against an event queue with a claim of 4096, two events — one IN_CREATE op with mask 256, watch 1, cookie 0, buffer_bytes 64, and one IN_DELETE op with mask 512, watch 2 — and two names with ids 1 and 2 having byte lengths 32 and 48 respectively.

## When to prefer this

Use this endpoint when building or testing offline fixtures for Linux inotify kernel interface behavior — specifically when you need deterministic simulation of event coalescing, buffer boundary admission, name padding, and partial batch edge cases without a live kernel. Prefer this over live inotify testing when you need reproducible, parameterized fixture results in CI/CD pipelines or unit test suites.

## Known failure modes

- Invalid event op string exceeding maxLength causes validation error
- Claim or buffer_bytes values outside [-1e12, 1e12] range rejected
- Too many events or names (over 512 items) causes schema rejection
- Missing required fields (inotify_queue, claim, events, names) returns 400
- Malformed artifact object structure returns schema validation error

## How this service works

An offline inotify trace fixture author needs exact unread-queue coalescing and whole-record read admission, including too-small buffers, name padding, partial batches and the boundary after consuming a prior event.

## Output

Returns the computed inotify queue state after applying coalescing and read admission rules, including which events were coalesced, boundary conditions encountered (too-small buffer, name padding, partial batch edges), and the resulting unread queue configuration.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "artifact": {
   "type": "object",
   "required": [
    "inotify_queue"
   ],
   "properties": {
    "inotify_queue": {
     "type": "object",
     "required": [
      "claim",
      "events",
      "names"
     ],
     "properties": {
      "claim": {
       "type": "number",
       "maximum": 1000000000000,
       "minimum": -1000000000000
      },
      "names": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "byte_length",
         "id"
        ],
        "properties": {
         "id": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         },
         "byte_length": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         }
        },
        "additionalProperties": false
       },
       "maxItems": 512
      },
      "events": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "op"
        ],
        "properties": {
         "op": {
          "type": "string",
          "maxLength": 1024
         },
         "mask": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         },
         "name": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         },
         "watch": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         },
         "cookie": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         },
         "buffer_bytes": {
          "type": "number",
          "maximum": 1000000000000,
          "minimum": -1000000000000
         }
        },
        "additionalProperties": false
       },
       "maxItems": 512
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/linux-inotify-unread-event-coalescing-fixture-97951a05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from detect.halowerk.com](https://www.zero.xyz/host/detect.halowerk.com/llms.txt)