---
title: "usertty: Send messages to a user terminal"
url: "https://axoflow.com/docs/axosyslog-core/4.28/chapter-destinations/destination-usertty/"
last_modified: "2026-06-24T09:47:00+02:00"
---

> For the complete documentation index, see [llms.txt](https://axoflow.com/docs/axosyslog-core/4.28/llms.txt).

# usertty: Send messages to a user terminal

This driver writes messages to the terminal of a logged-in user.

The `usertty()` driver has a single required argument, specifying a username who should receive a copy of matching messages. Use the asterisk `*` to specify every user currently logged in to the system.

## Declaration

```shell
usertty(username);
```

## Example: Using the usertty() driver

```shell
destination d_usertty { usertty("root"); };
```

## escaping()

|  |  |
| --- | --- |
| Accepted values: | `yes` or `no` |
| Default: | `no` |

Available in AxoSyslog 4.26 and later.

*Description:* Turns on escaping for the `'`, `"`, and backslash characters from the messages. This behavior is useful when the messages are passed to an application that cannot handle escaped characters properly.

## time-reopen()

|  |  |
| --- | --- |
| Accepted values: | number [seconds] |
| Default: | 60 |

*Description:* The time to wait in seconds before a dead connection is reestablished.

Last modified June 24, 2026: [[usertty] adds the escaping option (bf63eaf4)](https://github.com/axoflow/axosyslog-core-docs/commit/bf63eaf4eff57665f75c66e882408ffe8abe1d9f)
