# Libtmux_unix.Client.read_hook

- **Module:** Libtmux_unix
- **Package:** libtmux-unix
- **Language:** OCaml
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-ocaml/blob/205dfda49742592b479247049d186956e4a4cfe9/unix/libtmux_unix.mli#L485
- **Public owner:** Libtmux_unix
- **Page:** https://libtmux.org/en/ocaml/latest/reference/libtmux_unix-client-read_hook/

```
val read_hook :
  ?cancel:Cancellation.t ->
  ?include_inherited:bool ->
  t ->
  Libtmux.Options.scope ->
  string -> (Libtmux.Options.value option, Libtmux.Error.t) result
```

Read an exact hook name. Inheritance is included by default; `None` means no entry under the selected policy. Missing targets remain errors.

## Parameters

- `cancel?` (`Cancellation.t`)
- `include_inherited?` (`bool`)
- `arg1` (`t`)
- `arg2` (`Libtmux.Options.scope`)
- `arg3` (`string`)

## tmux command

The tmux commands behind `read_hook`.

- [`show-options`](/en/tmux/latest/manual/show-options/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_show_options_entry`](/en/tmux/latest/reference/c-variable-cmd_show_options_entry/) (attribute)
- [`cmd_show_options_exec`](/en/tmux/latest/reference/c-function-cmd-show-options-c-cmd_show_options_exec/) (function)