# libtmux:show-environment-text

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

```
(show-environment-text client &key scope target name hidden shell-format cancel-token timeout output-limit)
```

Inspect a raw environment table; return owned UTF-8 text and a COMMAND-OUTCOME.
Required SCOPE is :GLOBAL or :SESSION; a session needs a captured TARGET.
NAME is literal nonempty text without NUL or =, including names outside the
mutation identifier grammar. Omission lists the table. HIDDEN selects hidden
entries; NIL selects ordinary entries. A visibility mismatch can return empty
text, which does not prove absence. Empty values, removal markers and native
escaping remain printer syntax. Session output is not a merged child environment.

SHELL-FORMAT selects native shell-looking presentation (-s); returned text is
never evaluated or executed. Ordinary hook output is preserved. This is not a
decoded environment mapping. Blocks under shared preflight/dispatch limits,
starts no daemon and never retries. Missing names remain errors; operational,
resource and UTF-8 failures retain client/outcome diagnostics.

See also: `libtmux:error-outcome`, `libtmux:remove-environment`, `libtmux:set-environment`, `libtmux:show-options-text`.

## Parameters

- `client`
- `scope?`
- `target?`
- `name?`
- `hidden?`
- `shell-format?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## Guides

Pages that discuss `show-environment-text`.

- [Explicit operations](/en/lisp/latest/guides/operations/)