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

# logger.1

LOGGER(1)

FreeBSD General Commands Manual

LOGGER(1)

## 名称

`logger` —

在系统日志中创建条目

## 概要

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

## 描述

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

可以使用以下选项：

[`-4`](#4)

强制 `logger` 仅使用 IPv4 地址。

[`-6`](#6)

强制 `logger` 仅使用 IPv6 地址。

`-A`

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

[`-i`](#i)

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

[`-s`](#s)

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

[`-f`](#f) file

将指定文件的内容读入 syslog。 如果还指定了消息，则忽略此选项。

`-H` hostname

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

[`-h`](#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`](#p) pri

以指定优先级记录消息。 优先级可以用数字或 `facility.level` 对指定。 例如， “`-p` `local3.info`” 将消息作为 local3 设施中的 informational 级别记录。 默认为 “`user.notice`” 。

`-S` addr:port

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

[`-t`](#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”) 兼容。

July 3, 2023

FreeBSD 13.1-RELEASE