# io.github.libtmux.control.ControlClient.ControlClient.subscribeEvents

- **Module:** io.github.libtmux.control.ControlClient.ControlClient
- **Package:** io.github.libtmux:libtmux
- **Language:** Java
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-java/blob/842228310449e879ebcaa3f910597757c9dbffd6/libtmux/src/main/java/io/github/libtmux/control/ControlClient.java#L260
- **Page:** https://libtmux.org/en/java/latest/reference/io-github-libtmux-control-controlclient-controlclient-subscribeevents/

```
io.github.libtmux.control.ControlClient.ControlClient.subscribeEvents(capacity: int) -> EventSubscription<ControlEvent>
```

Subscribes to state changes tmux volunteers.

## Parameters

- `capacity` (int): how many values this subscriber can retain before its oldest value is dropped

## Returns

a pull subscription owned by the caller

## Raises

- `IllegalArgumentException`: if {@code capacity} is not positive
- `IllegalStateException`: if the client has ended