# libtmux:show-option

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/configuration-acquisition.lisp#L354
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-show-option/

```
(show-option client name &key scope target (key nil key-p) (include-inherited t) cancel-token timeout output-limit (record-limit 4096) (value-limit 1048576))
```

Acquire one decoded option; return VALUE, PRESENT-P and a read-outcome vector.
False returns NIL,T; absence returns NIL,NIL. KEY selects an entry only after
acquiring a whole named array. A missing key does not fall through a present
local array. Mutable key text is copied before I/O and bounded to 1 MiB UTF-8.
Keys normalize under the exact live catalog before payload reads.
Scopes, limits, inheritance, ownership and failure evidence follow SHOW-OPTIONS.

See also: `libtmux:configuration-read-failed`, `libtmux:outcome-value`, `libtmux:show-options`.

## Parameters

- `client`
- `name`
- `scope?`
- `target?`
- `key?`
- `include-inherited?`
- `cancel-token?`
- `timeout?`
- `output-limit?`
- `record-limit?`
- `value-limit?`
