# Read IPC status

Source: https://stratadb.org/docs/reference/admin/ipc_status

Report this process's multi-process IPC state.

| | |
|---|---|
| Command | `admin.ipc_status` |
| CLI | `strata ipc status` |
| Wire type | `ipc_status` |
| Python | `db.admin.ipc_status() -> 'Any'` |
| Access | read |
| Commit | no commit |
| Wire status | stable |

Reports the same-machine multi-process state for this handle: whether this process owns the store (holds the writer lock) or is a client of another owner, whether it is hosting a broker socket, the socket path and owning process id when one exists, and the number of clients currently connected to the host. A single-process open (cache, or a durable open with IPC off) reports `is_owner: true`, `hosting: false`, and no socket.

Status commands return a scalar or compact status payload and do not mutate database state.

## Examples

Check whether this process hosts the multi-process broker socket.

### CLI

```console
$ strata ipc status
```

### Wire

```json
{"type":"ipc_status"}
```

### Python

```python
db.admin.ipc_status().hosting
```

## Returns

`StatusResponse<AdminIpcStatus>`

- `data` (`AdminIpcStatus`)
- `type` (`string`)

## Errors

Recover by code, never by message.

| Code | Retry | Commit outcome |
|---|---|---|
| [`failed_precondition.engine.runtime_closed`](https://stratadb.org/e/failed_precondition.engine.runtime_closed) | never | not_started |

## Related

- [Read sanitized config](https://stratadb.org/docs/reference/admin/config)
- [Read one config value](https://stratadb.org/docs/reference/admin/config_key)
- [Describe database](https://stratadb.org/docs/reference/admin/describe)
- [Read database health](https://stratadb.org/docs/reference/admin/health)
- [Clone hub dataset](https://stratadb.org/docs/reference/admin/hub_clone)
- [Read database info](https://stratadb.org/docs/reference/admin/info)
- [Stop IPC hosting](https://stratadb.org/docs/reference/admin/ipc_stop)
- [Read database metrics](https://stratadb.org/docs/reference/admin/metrics)
- [Ping database](https://stratadb.org/docs/reference/admin/ping)
- [Read remote origin](https://stratadb.org/docs/reference/admin/remote)