> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man1/logger.1.md).

# logger.1

`logger` — 在系统日志中记录条目

## 名称

`logger`

## 概要

`logger [-46Ais] [-f file] [-H hostname] [-h host] [-P port] [-p pri] [-S addr:port] [-t tag] [message ...]`

## 描述

`logger` 实用程序提供了 syslog(3) 系统日志模块的 shell 命令接口。

可用选项如下：

**`-4`** 强制 `logger` 仅使用 IPv4 地址。

**`-6`** 强制 `logger` 仅使用 IPv6 地址。

**`-A`** 默认情况下，即使主机有多条 A 或 AAAA 记录，`logger` 也仅尝试将消息发送到一个地址。如果指定了此选项，`logger` 会尝试将消息发送到所有地址。

**`-i`** 在每行中记录 logger 进程的进程 ID。此标志会被忽略，进程 ID 始终会被记录。另见 `-t`。

**`-s`** 将消息记录到标准错误以及系统日志。

**`-f`** `file` 将指定文件的内容读入 syslog。当同时指定了 `message` 时，此选项被忽略。

**`-H`** `hostname` 将消息头中的主机名设置为指定值。如果未指定，将使用 gethostname(3) 的主机部分。

**`-h`** `host` 将消息发送到远程系统 `host`，而非在本地记录。注意，`logger` 目前支持 `AF_INET`（IPv4）、`AF_INET6`（IPv6）和 `AF_LOCAL`（Unix 域套接字）地址族。`host` 中有效的地址格式如下：

`AF_INET` **192.168.2.1**

`AF_INET6` **2001:db8::1**

`AF_LOCAL` **/var/run/log**

**`-P`** `port` 将消息发送到远程系统上指定的 `port` 端口号，可指定为服务名或十进制数字。默认为 "`syslog`"。如果使用了未知的服务名，`logger` 会打印警告并回退到端口 514。

**`-p`** `pri` 以指定优先级记录消息。优先级可以以数字方式或 `facility.level` 对的形式指定。例如，"`-p` `local3.info`" 将消息以 `info`（informational）级别记录到 `local3` facility。默认为 "`user.notice`"。

**`-S`** `addr`:`port` 指定使用 `-h` 选项时的源地址和/或源端口。启用 `-A` 标志时，所有远程地址将使用相同的地址。注意，`addr` 中的数字 IPv6 地址必须用 "`[`" 和 "`]`" 括起来。

**`-t`** `tag` 用指定的 `tag` 标记日志中的每一行，而非默认的当前登录名。使用 `-t` `tag[N]` 可插入特定的十进制进程 ID，而非 `logger` 的 ID。

**`message`** 写入日志的消息；如果未指定且未提供 `-f` 标志，则记录标准输入。

## 退出状态

`logger` 实用程序成功时退出码为 0，发生错误时大于 0。

## 实例

```sh
logger System rebooted

logger -p local0.notice -t HOSTIDM -f /dev/idmc
```

## 参见

syslog(3), syslogd(8)

## 标准

`logger` 命令预期与 IEEE Std 1003.2（"POSIX.2"）兼容。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man1/logger.1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.