# gizlang:capability

The kernel and library capabilities this process has, probed when asked. A name is available when its probe succeeds. `require` is the startup check: a configured capability that is missing, or a name that is not known, fails it with the name in the message, and nothing falls back. CPU features are in gizlang:machine (Machine.has).

```gizlang
import * as Capability from "gizlang:capability";
```

## Types

### `Capability`

```gizlang
type Capability = { name: string; available: bool; }
```

A capability and whether this process has it.

- `name`: `string`
- `available`: `bool`

## Functions

### `available`

```gizlang
function available(sys: System, name: string): bool
```

Whether capability NAME is available: io_uring when a ring can be made, zstd and brotli when their library opens.
False for a name this module does not know.

Effects: fail, io.

### `capabilities`

```gizlang
function capabilities(sys: System): Vec<Capability>
```

Every known capability and whether this process has it.

Effects: fail, io.

### `require`

```gizlang
function require(sys: System, names: Vec<string>): bool throws string
```

The startup check: every configured name must be a known capability (in knownNames) and available. The first name that
is unknown or missing fails it.

Effects: fail, io.