Man page - msmtp(1)
Packages contains this manual
Available languages:
en zh_TW zh_CNManual
MSMTP
NAME概 要 (SYNOPSIS)
描 述 (DESCRIPTION)
退 出 状 态 (EXIT STATUS)
选 项 (OPTIONS)
用 法 (USAGE)
配 置 文 件 (CONFIGURATION FILES)
范 例 (EXAMPLES)
文 件 /系 统 环 境 (FILES / ENVIRONMENT)
作 者 (AUTHORS)
参 看 (SEE ALSO)
[中 文 版 维 护 人 ]
[中 文 版 最 新 更 新 ]
[中 文 版 校 对 人 ]
《 中 文 MAN-PAGE计 划 》
跋
NAME
msmtp - An SMTP client
概 要 (SYNOPSIS)
发 邮 件 模 式 (默 认 ):
msmtp
[option...] [--]
recipient...
msmtp
[option...] -t [--] [recipient...]
服 务 器 消 息 模 式 :
msmtp [option...] --serverinfo
远 程 消 息 队 列 模 式 :
msmtp [option...] --rmqs= host | @domain | #queue
描 述 (DESCRIPTION)
在
默 认 的 发 邮 件
模 式 下 ， msmtp 从 标
准 输 入 读 取 邮
件 ， 然 后 把 它
送 给 SMTP 服 务 器 处
理
当 处 于 服 务 器
消 息 模 式 下 ， msmtp
会 显 示 SMTP 服 务 器
的 有 关 信 息
而 当 它 处 于 远
程 消 息 队 列 模
式 时 ， msmtp 将 为 主
机 或 者 域 发 出 RMQS
请 求 ， 或 者 向 SMTP
服 务 器 发 出 队
列 请 求
退 出 状 态 (EXIT STATUS)
这 里 使 用 标 准 的 sendmail 退 出 状 态 代 码 ， 就 像 在 sysexits.h 中 定 义 的 那 样 想 快 速 上 手 ， 可 跳 到 EXAMPLES 部 分
选 项 (OPTIONS)
这
里 的 选 项 将 覆
盖 配 置 文 件 中
的 相 同 选 项
他 们 在 某 些 地
方 与 sendmail 兼 容
一 般 选 项 (General
options)
--version
显 示 版 本 信 息 。 这 些 信 息 包 括 TLS/SSL 库 信 息 （ 如 果 有 ） ， 用 于 验 证 的 库 以 及 这 些 库 所 支 持 的 验 证 方 式 ， 还 有 默 认 的 全 局 配 置 文 件 和 用 户 配 置 文 件 信 息
|
--help |
显 示 帮 助 |
-P, --pretend
显 示 使 用 的 配 置 信 息 ， 但 不 真 正 执 行 什 么 操 作 。 密 码 将 会 以 *** 的 形 式 显 示
-d, --debug
显 示 很 多 调 试 信 息 ， 包 括 与 SMTP 服 务 器 的 所 有 会 话 。 小 心 使 用 这 个 选 项 （ 潜 在 风 险 ） ： 所 有 输 出 没 经 过 什 么 处 理 ， 密 码 可 能 以 一 种 极 易 解 码 的 方 式 被 显 示 出 来
改 变 操 作 模 式 选 项 (Changing the mode of operation)
-S, --serverinfo
显 示 SMTP 服 务 器 的 信 息 并 退 出 。 信 息 中 包 含 了 所 有 支 持 的 特 性 ， 如 邮 件 大 小 限 制 、 验 证 方 式 、 TLS、 DSN 等 等 。 如 果 服 务 器 支 持 TLS 的 话 ， 还 有 TLS 证 书 信 息
--rmqs=( host | @domain | #queue )
为 指 定 的 主 机 或 者 域 发 送 一 个 开 启 远 程 消 息 队 列 的 请 求 ， 或 者 向 SMTP 服 务 器 发 送 队 列 请 求 ， 并 退 出
配 置 选 项 (Configuration options)
-C, --file= filename
用 指 定 的 文 件 代 替 ˜/.msmtprc 作 为 用 户 配 置 文 件
-a, --account= account_name
用 指 定 的 帐 号 代 替 "default" 字 段 中 的 帐 号 。 这 个 帐 号 的 设 置 能 以 命 令 行 选 项 的 方 式 进 行 更 改 。 但 这 个 选 项 不 能 与 --host 合 用
--host= hostname
用 命 令 行 指 定 一 个 SMTP 服 务 器 ， 不 用 配 置 文 件 中 的 任 何 数 据 。 这 个 选 项 不 能 与 --account 选 项 合 用
--port= number
设 置 要 连 接 的 端 口 。 参 看 下 面 port 命 令
--timeout=( off | seconds )
设 定 网 络 超 时 。 参 看 下 面 timeout 命 令 。 为 了 兼 容 老 版 本 ， --connect-timeout 作 为 这 个 选 项 的 别 名
--protocol=( smtp | lmtp )
设 定 所 用 的 协 议 。 参 看 下 面 protocol 命 令
--auth[=( on | off | method )]
开 启 或 关 闭 验 证 ， 也 可 随 意 选 择 一 个 验 证 方 式 。 参 看 下 面 auth 命 令
--user= [username]
设 置 或 清 空 用 于 验 证 的 用 户 名 。 参 看 下 面 user 命 令
--tls[=( on | off )]
开 启 或 关 闭 TLS 加 密 。 参 看 tls 命 令
--tls-starttls[=( on | off )]
开 启 或 关 闭 TLS 加 密 的 STARTTLS 。 参 看 下 面 tls_starttls 命 令
--tls-trust-file=[ file ]
设 置 或 清 空 TLS 加 密 的 trust file。 参 看 下 面 tls_trust_file 命 令
--tls-key-file=[ file ]
设 置 或 清 空 TLS 加 密 的 key file。 参 看 下 面 tls_key_file 命 令
--tls-cert-file=[ file ]
设 置 或 清 空 TLS 加 密 的 cert file。 参 看 下 面 tls_cert_file 命 令
--tls-certcheck[=( on | off )]
开 启 或 关 闭 TLS 加 密 的 证 书 检 验 。 参 看 下 面 tls_certcheck 命 令
--tls-force-sslv3[=( on | off )]
强 制 使 用 SSLv3。 参 看 下 面 tls_force_sslv3 命 令
--domain=[ string ]
设 置 SMTP EHLO (or LMTP LHLO)命 令 的 参 数 。 参 看 domain 命 令
发 件 模 式 的 选 项 (Options specific to sendmail mode)
--auto-from[=( on | off )]
开 启 或 关 闭 automatic envelope-from addresses。 默 认 关 闭 。 参 看 下 面 auto_from 命 令
-f, --from= address
设 定 envelope-from
address。 仅 当
auto_from
关
闭 时 才 有 用
如 果 未 用
--account
或
--host
指 定 帐 号
， 这 个 选 项 会
选 择 第 一 个 拥
有 给 定 envelope-from address 的
帐 号 。 看 看
from
命 令 。 如 果 没
找 到 符 合 条 件
的 帐 号 ， 就 用
"default"
--maildomain=[ domain ]
为 生 成 的 envelope-from addresses 指 定 一 个 域 。 仅 当 auto_from 开 启 时 才 有 用 。 参 看 下 面 maildomain 命 令
-N, --dsn-notify=( off | cond )
设 置 或 清 空 DSN notification conditions。 参 看 下 面 dsn_notify 命 令
-R, --dsn-return=( off | ret )
设 置 或 清 空 DSN notification amount。 参 看 下 面 dsn_return 命 令 。 注 意 为 兼 容 sendmail ， hdrs 被 定 义 成 headers 的 别 名
--keepbcc[=( on | off )]
是 否 保 留 Bcc header。 参 看 下 面 keepbcc 命 令
-X, --logfile=[ file ]
设 置 或 清 除 log file。 参 看 下 面 logfile 命 令
--syslog[=( on | off | facility )]
是 否 启 用 syslog。 参 看 下 面 syslog 命 令
-t, --read-recipients
从 邮 件 的 To, Cc, Bcc headers 处 提 取 收 件 人 地 址 ， 而 不 从 命 令 行 读 入
|
-- |
从 这 以 后 的 参 数 均 被 认 为 是 收 件 人 地 址 ， 即 使 以 ’-’ 开 头 。 这 标 志 着 选 项 列 表 结 束 了 |
以
下 选 项 可 用 ，
但 兼 容 的 sendmail 忽
略 。
-B
type
, -bm, -F
name
, -G, -h
N
, -i, -L
tag
, -m, -n, -O
option=value
, -o
x
value
, -v
用 法 (USAGE)
通 常 ， 全 局 配 置 文 件 和 (或 )用 户 配 置 文 件 包 含 了 SMTP 服 务 器 以 及 如 何 与 之 通 信 的 所 有 信 息 。 但 是 ， 几 乎 所 有 的 选 项 也 可 以 在 命 令 行 上 配 置
SMTP 服 务 器 的 信 息 以 accounts 方 式 组 织 在 一 起 。 每 个 帐 号 描 述 了 一 台 SMTP 服 务 器 的 主 机 名 、 验 证 设 置 、 TLS 设 置 等 等 。 每 个 配 置 文 件 能 定 义 多 个 帐 号
在 发 件 模 式 ， 必 须 要 有 一 个 envelope-from， 这 被 作 为 原 始 发 件 人 发 送 给 SMTP 服 务 器 。 当 auto_from 开 启 时 ， Envelope-from 的 地 址 也 能 自 动 生 成 ， 或 者 也 能 明 确 地 用 form 或 --from 设 定 。 auto_from 能 生 成 形 如 user@domain 这 样 的 地 址 。 user 部 分 将 以 $USER 代 替 ， 如 果 不 行 ， 就 用 $LOGNAME 代 替 ， 再 不 行 的 话 ， 就 用 当 前 登 录 的 用 户 名 。 domain 部 分 能 用 maildomain 设 定 。 如 果 maildomain 未 设 好 ， envelope-from 中 将 只 有 用 户 名 ， 而 不 含 域 名 。
用
户 能 选 择 用 哪
个 帐 号 ， 以 下
方 法 三 选 一 ：
--account=
id
用 给 定 帐 号 。 命 令 行 选 项 会 覆 盖 配 置 文 件 中 的 设 定
--host= hostname
只 用 来 自 命 令 行 的 选 项 ， 不 用 配 置 文 件 中 的
--from= address
从 全 局 或 用 户 配 置 文 件 中 选 择 与 from 命 令 指 定 的 地 址 匹 配 的 envelop-from 地 址 。 只 有 --account 和 --host 都 没 有 设 定 时 才 用 得 到 这 个 选 项
如 果 以 上 选 项 一 个 都 没 用 到 ， 又 或 者 用 了 --from 但 没 有 一 个 帐 号 与 from 命 令 的 结 果 匹 配 ， 那 就 使 用 "default" 帐 号
配 置 文 件 (CONFIGURATION FILES)
如
果 全 局 配 置 文
件 存 在 并 可 读
， 会 调 用 文 件
SYSCONFDIR/msmtprc， SYSCONFDIR 依 赖
于 你 的 系 统 。
用
--version
可 以 找
到 用 了 哪 个 目
录
如 果 用 户 配 置
文 件 存 在 并 可
读 ， 就 调 用 它
(默 认 是 ˜/.msmtprc )。
用 户 配 置 中 的
帐 号 会 覆 盖 全
局 配 置 中 的 相
同 帐 号 。 除 了
拥 有 者 的 读 写
权 外 ， 决 不 给
配 置 文 件 其 它
多 余 的 权 限 。
无 论 哪 个 配 置
文 件 中 的 设 置
都 可 以 用 命 令
行 选 项 更 改
配
置 文 件 是 个 普
通 文 本 而 已 ，
忽 略 空 行 和 注
释 行 (以 ’#’开 头
)
其 它 行 必 须 包
含 一 条 命 令 以
及 可 能 的 参 数
如 果 参 数 的 第
一 个 或 最 后 一
个 有 空 白 ， 要
用 双 引 号 (")括
起 来
如 果 文 件 的 第
一 个 字 符 是
"˜"， 将 会 用 $HOME
代 替 。 如 果 命
令 能 接 受 一 个
on
参 数 ， 它 也
会 接 受 空 参 数
并 默 认 它 是
on
参 数 。
命 令 的 集 合 形
成 groups 。 每 组 以
account
命 令 开 头 ，
接 着 是 SMTP 服 务 器
的 设 置
想 快 速 上 手 ， 可 跳 到 EXAMPLES 部 分
命
令 说 明 如 下 ：
defaults
设 置 defaults。 接 下 去 的 设 置 命 令 将 当 前 配 置 文 件 中 的 所 有 帐 号 指 定 默 认 值
account name [: account [,...]]
开 始 定
义 新 帐 号 ， 填
充 默 认 值
如 果 有 逗 号 和
预 先 定 义 好 的
帐 号 名 跟 在 account
后 面 ， 所 有 列
表 中 的 帐 号 会
拥 有 同 样 的 设
置 ， 并 填 充 默
认 值
host hostname
邮 件 发 送 目 的 地 SMTP 服 务 器 ， 参 数 可 以 是 主 机 名 或 者 网 络 地 址 。 每 个 帐 号 都 必 须 包 含 这 个 命 令
port number
SMTP 服 务 器 监 听 端 口 。 默 认 端 口 会 从 你 操 作 系 统 的 service database 中 获 取 。 对 于 SMTP 来 说 ， 服 务 名 是 "smtp" (默 认 端 口 25)， 除 非 使 用 不 带 STARTTLS 的 TLS ， 在 此 种 情 况 下 服 务 名 是 "ssmtp"(445)。 对 于 LMTP， 服 务 名 是 "lmtp"
timeout ( off | seconds )
设 置 或
清 除 网 络 超 时
(以 秒 计 )。
off
参
数 表 示 不 设 超
时 ， 这 意 味 着
使 用 操 作 系 统
默 认 的 超 时 设
定
为 与 老 版 本 兼
容 ，
connect_timeout
可 作
为 这 条 命 令 的
别 名
protocol ( smtp | lmtp )
设 置 所 用 的 协 议 ， 目 前 只 支 持 SMTP 和 LMTP， 默 认 SMTP。 想 知 道 默 认 端 口 ， 看 上 面 的 port 命 令
auto_from [( on | off )]
是 否 允 许 automatic envelope-from。 默 认 不 允 许 。 开 启 时 ， 会 生 成 类 似 user@domain 形 式 的 envelope-from。 user 部 分 将 以 $USER 代 替 ， 如 果 不 行 ， 就 用 $LOGNAME 代 替 ， 再 不 行 的 话 ， 就 用 当 前 登 录 的 用 户 名 。 domain 部 分 能 用 maildomain 设 定 。 如 果 maildomain 未 设 好 ， envelope-from 中 将 只 有 用 户 名 ， 而 不 含 域 名 。 关 闭 时 ， ， envelope-from 必 须 明 确 指 定
from envelope_from
设 置 envelope-from， 仅 当 auto_from 关 闭 时 才 有 用
maildomain [ domain ]
设 置 envelope 域 名 部 分 。 仅 当 auto_from 开 启 时 才 有 用 ， 域 名 可 以 为 空
auth [( on | off | method )]
这 条 命
令 控 制 是 否 允
许 SMTP 验 证 。 你 没
有 必 要 自 己 来
设 定 验 证 方 式
， 只 要 用 了
on
参 数 ， msmtp 会 为 你
选 择 一 个 最 佳
方 案 (看 下 面 )。
你 可 能 需 要 用
user
命 令 来 设 置
一 个 用 户 名 ，
用
password
命 令 设 置
一 个 密 码 。 如
果 不 指 定 密 码
， 而 msmtp 运 行 时 发
现 在 验 证 时 又
需 要 密 码 ， msmtp 会
试 着 从 ˜/.netrc 中 找
一 个 ， 如 果 不
行 的 话 ， msmtp 会 提
示 你 输 入 一 个
支 持 的 验 证 方
式 有
plain
,
cram-md5
,
digest-md5
,
gssapi
,
external
,
login
, and
ntlm
。 注 意
由 于 可 能 缺 少
下 面 的 验 证 库
， 你 会 有 一 个
或 多 个 验 证 方
式 不 能 用 。 用
--version
选 项 看 看
支 持 哪 些 方 法
。
plain
和
login
把 你 的
验 证 信 息 在 网
上 以 明 文 传 输
， 因 此 应 该 仅
把 它 们 和
tls
命
令 一 起 用 。
如 果 不 自 己 选
择 方 式 的 话 ， msmtp
会 选 择 SMTP 服 务 器
支 持 的 最 安 全
的 方 式 ， 安 全
指 你 的 信 息 在
网 上 不 会 以 明
文 发 送 。 在 TLS 加
密 连 接 下 任 何
一 种 验 证 方 式
都 是 安 全 的 。
如 果 不 用 TLS ， 只
有 gssapi,digest-md5,cram-md5 and ntlm 是
安 全 的 。
external
方 法 比 较 特
殊 ： 真 正 的 验
证 操 作 位 于 SMTP 协
议 之 外 ， 发 送 TLS
客 户 端 证 书 (看
tls_cert_file
命 令 )就 是
个 典 型 例 子 。
external
只 确 认 这 次
验 证 对 于 给 定
的 用 户 是 否 成
功 ， 如 果 不 给
用 户 名 的 话 ，
就 只 确 认 验 证
是 否 成 功 。 [注
： 总 之 它 就 把
具 体 验 证 和 加
密 的 事 情 全 推
给 了 外 面 程 序
， 与 msmtp 无 关 了 ]。
msmtp 不 会 选 这 种 验
证 方 式 ， 你 必
须 亲 自 指 定 。
user [ username ]
设 置 用 于 SMTP 验 证 的 用 户 名 ， 参 数 为 空 时 清 除 用 户 名 。 证 验 操 作 必 须 用 auth 命 令 激 活
password [ secret ]
设 置 用 于 SMTP 验 证 的 密 码 ， 参 数 为 空 时 清 除 密 码 。 证 验 操 作 必 须 用 auto 命 令 激 活 。 如 果 不 指 定 密 码 ， 而 验 证 操 作 又 需 要 密 码 ， msmtp 会 试 着 从 ˜/.netrc 中 找 一 个 ， 如 果 不 行 的 话 ， msmtp 会 提 示 你 输 入 一 个
ntlmdomain [ domain ]
设 置 用 于 ntlm 验 证 方 式 的 域 名 ， 默 认 不 用 域 名 (等 同 于 空 参 数 )。 但 有 些 服 务 器 好 像 要 的 ， 即 便 给 出 的 是 任 意 字 符 串
tls [( on | off )]
是 否 允 许 TLS/SSL 加 密 连 接 。 不 是 每 个 服 务 器 都 支 持 TLS ， 但 有 了 TLS， 可 以 防 止 有 人 偷 听 与 SMTP 的 对 话 。 除 非 用 tls_certcheck 命 令 关 闭 服 务 器 证 书 验 证 ， 否 则 每 次 都 要 完 备 性 检 查 。 为 全 面 发 挥 TLS/SSL 效 力 ， 推 荐 用 tls_trust_file 命 令 (看 下 面 )
tls_starttls [( on | off )]
缺 省 状
态 下 ， TLS 加 密 以
STARTTLS SMTP 命 令 激 活 。
关 闭 后 ， TLS 加 密
会 立 即 启 动 (这
是 有 名 的 SMTP tunneled through
TLS/SSL)。 默 认 端 口
是 465
为 兼 容 老 版 本
，
tls_nostarttls
作 为
tls_starttls off
的 别 名
tls_trust_file [ file ]
这 条 命 令 激 活 严 格 的 服 务 器 证 书 验 证 。 这 个 文 件 必 须 包 含 一 个 或 多 个 以 PEM 格 式 存 在 的 受 信 任 的 证 书 注 册 机 构 (CAs)。 空 参 数 会 关 闭 这 个 特 性 。 msmtp 通 过 受 信 文 件 验 证 服 务 器 的 可 靠 性
tls_key_file [ file ]
与 tls_cert_file 命 令 一 起 ， 使 msmtp 在 需 要 时 发 一 份 客 户 端 证 书 给 SMTP 服 务 器 。 这 个 文 件 必 须 包 含 PEM 格 式 证 书 的 私 钥 。 空 参 数 会 关 闭 这 个 特 性
tls_cert_file [ file ]
与 tls_key_file 命 令 一 起 ， 使 msmtp 在 需 要 时 发 一 份 客 户 端 证 书 给 SMTP 服 务 器 。 这 个 文 件 必 须 包 含 PEM 格 式 的 证 书 。 空 参 数 会 关 闭 这 个 特 性
tls_certcheck [( on | off )]
当 TLS 启 用
时 ， 默 认 对 服
务 器 证 书 进 行
完 备 性 检 查 。
如 果 没 有 检 查
未 通 过 ， 会 取
消 TLS 连 接 。
为 兼 容 老 版 本
，
tls_nocertcheck
作 为
tls_certcheck off
的 别 名
tls_force_sslv3 [( on | off )]
强 制 使 用 TLS/SSL 的 SSLv3 版 本 。 可 能 在 一 些 用 SSL 的 老 旧 服 务 器 上 有 用 。 不 过 万 不 得 已 ， 别 用 这 个
dsn_notify ( off | condition )
设 定 在 哪 在 情 况 下 ， 邮 件 系 统 应 该 发 送 DSN (Delivery Status Notification)信 息 。 off 参 数 明 确 关 闭 DSN 请 求 ， 这 意 味 着 让 邮 件 决 定 什 么 时 候 发 DSN 信 息 ， 默 认 如 此 。 condition 可 以 是 never ， 从 不 发 送 请 求 。 或 者 是 以 逗 号 (没 有 空 格 ！ )分 隔 的 一 个 或 多 个 下 列 参 数 ： failure 失 败 时 发 送 ， delay 延 迟 时 发 送 ， success 成 功 时 发 送 。 SMTP 服 务 器 必 须 支 持 DSN 才 行 。
dsn_return ( off | amount )
在 一 封 邮 件 中 允 许 返 回 多 少 DSN 信 息 。 off 明 确 关 闭 DSN 请 求 ， 这 意 味 着 让 邮 件 系 统 决 定 ， 默 认 如 此 。 amount 可 以 是 headers 只 返 回 信 息 头 ， full 返 回 邮 件 全 部 内 容 。 SMTP 服 务 器 必 须 支 持 DSN 才 行
domain argument
用 来 设 定 SMTP EHLO(or LMTP LHLO)命 令 的 参 数 。 默 认 是 localhost (笨 方 法 ， 但 有 效 )。 其 它 可 能 的 选 择 有 ： 邮 件 地 址 的 域 名 部 分 (provider.example for joe@provider. example)， 或 者 如 果 可 能 的 话 给 出 你 主 机 的 完 整 域 名
keepbcc [( on | off )]
当 发 送 邮 件 时 是 否 保 留 Bcc header 信 息 ， 默 认 不 保 留 。
logfile [ file ]
不 给 参
数 会 关 闭 记 录
， 默 认 如 此 。
当 选 择 一 个 logfile
时 ， msmtp 会 为 每 一
封 指 定 logfile 帐 号
的 邮 件 添 加 一
行 记 录
记 录 中 会 包 含
如 下 信 息 ： 日
期 、 时 间 、 SMTP 服
务 器 名 字 、 是
否 用 TLS、 是 否 验
证 、 用 于 验 证
的 用 户 名 (仅 当
用 了 验 证 后 )、
信 件 来 自 哪 里
、 收 件 人 地 址
、 发 出 去 的 邮
件 大 小 (仅 当 发
送 成 功 时 )、 SMTP 状
态 代 码 、 SMTP 错 误
信 息 (仅 当 发 送
失 败 且 错 误 信
息 可 得 时 )、 错
误 信 息 (仅 当 发
送 失 败 且 错 误
信 息 可 得 时 )、
退 出 代 码 (来 自
sysexits.h； EX_OK 代 表 发 送
成 功 )
如 果 文 件 是 一
短 横 (-)， msmtp 就 把
记 录 信 息 输 出
至 标 准 输 出
syslog [( on | off | facility )]
是 否 允
许 syslog 。 facility 可 以 是
LOG_USER、 LOG_MAIL、 LOG_LOCAL0...LOG_LOCAL7
诸 多 策 略 中 的
一 个 ， 默 认 是
LOG_USER。
每 次 msmtp 通 过 含 有
这 条 命 令 的 帐
号 发 邮 件 时 ，
它 均 会 在 syslog 服 务
中 以 选 定 的 策
略 追 加 一 条 记
录
记 录 中 会 包 含
如 下 信 息 ： 日
期 、 时 间 、 SMTP 服
务 器 名 字 、 是
否 用 TLS、 是 否 验
证 、 用 于 验 证
的 用 户 名 (仅 当
用 了 验 证 后 )、
信 件 来 自 哪 里
、 收 件 人 地 址
、 发 出 去 的 邮
件 大 小 (仅 当 发
送 成 功 时 )、 SMTP 状
态 代 码 、 SMTP 错 误
信 息 (仅 当 发 送
失 败 且 错 误 信
息 可 得 时 )、 错
误 信 息 (仅 当 发
送 失 败 且 错 误
信 息 可 得 时 )、
退 出 代 码 (来 自
sysexits.h； EX_OK 代 表 发 送
成 功 )
范 例 (EXAMPLES)
配 置 文 件 (Configuration file)
# Set default
values for all following accounts.
defaults
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
logfile ˜/.msmtp.log
# A freemail
service
account freemail
host smtp.freemail.example
from joe_smith@freemail.example
auth on
user joe.smith
password secret
# A second mail
address at the same freemail service
account freemail2 : freemail
from joey@freemail.example
# The SMTP
server of the provider.
account provider
host mail.provider.example
from smithjoe@provider.example
auth on
user 123456789
password my_password
# Set a default
account
account default : provider
在 Mutt 中 使 用 msmtp (Using msmtp with Mutt)
为 msmtp
建 立 一 个 配 置
文 件 ， 然 后 把
下 面 几 行 加 到 Mutt
配 置 文 件 中 去
set sendmail="/path/to/msmtp"
set use_from=yes
set realname="Your Name"
set from=you@example.com
set envelope_from=yes
envelope_from=yes 让 Mutt 用 msmtp的
-f
参 数 。 这 样 msmtp
会 选 择 符 合 you@example.com
的 第 一 个 帐 号
你 也 可 以 选 用
-a
参 数
set sendmail="/path/to/msmtp -a my-account"
或 者 从 命 令 行
中 设 定 所 有 内
容
set sendmail="/path/to/msmtp --host=mailhub -f
me@example.com --tls"
如
果 你 有 多 个 邮
件 帐 号 ， 并 且
想 让 Mutt 用
-f
参 数
让 你 可 以 在 帐
号 之 间 轻 松 切
换 ， 把 下 面 几
行 加 到 Mutt 配 置 文
件 中 去
macro generic "<esc>1" ":set
from=you@example.com"
macro generic "<esc>2" ":set
from=you@your-employer.example"
macro generic "<esc>3" ":set
from=you@some-other-provider.example"
在 mail 中 用 上 msmtp (Using msmtp with mail)
定
义 一 个 默 认 帐
号 ， 然 后 把 下
面 一 行 放 在 ˜/.mailrc
中
set sendmail="/path/to/msmtp"
文 件 /系 统 环 境 (FILES / ENVIRONMENT)
SYSCONFDIR/msmtprc
全 局 配 置 文 件 。 用 --version 找 出 系 统 中 的 SYSCONFDIR 在 哪 里
˜/.msmtprc
用 户 配 置 文 件
˜/.netrc
文 件 .netrc 包 含 了 登 录 信 息 。 如 果 在 配 置 文 件 中 没 有 找 到 密 码 信 息 的 话 ， msmtp 会 在 提 示 用 户 输 入 之 前 先 找 这 个 文 件 。 .netrc 的 用 法 在 netrc (5) 或 ftp (1) 中 能 找 到
$USER, $LOGNAME
在 构 造 信 件 来 源 地 址 时 ， 这 些 变 量 会 覆 盖 用 户 的 登 录 名 。 如 果 未 指 定 $USER， 就 用 $LOGNAME
$TMPDIR
建 立 临
时 文 件 的 地 方
。 如 果 未 设 置
就 用 系 统 默 认
定 义
仅 当 用 到
-t/--read-recipients
选 项 时
， 才 会 创 建 临
时 文 件 。 这 个
文 件 用 于 缓 存
邮 件 头 ， 不 包
括 邮 件 本 身 ，
所 以 文 件 不 会
太 大
作 者 (AUTHORS)
msmtp was
written by Martin Lambers <marlam@marlam.de>.
Other authors are listed in the AUTHORS file in the source
distribution.
参 看 (SEE ALSO)
mutt (1), mail (1), sendmail (8), netrc (5) or ftp (1)
[中 文 版 维 护 人 ]
"Nickel Cobalt" <angelerosster@gmail.com>
[中 文 版 最 新 更 新 ]
2007/05/01
[中 文 版 校 对 人 ]
"Nickel Cobalt" <angelerosster@gmail.com>
《 中 文 MAN-PAGE计 划 》
http://cmpp.linuxforum.net
跋
本
页 面 中 文 版 由
中 文 man 手 册 页 计
划 提 供 。
中 文 man 手 册 页 计
划 ：
https://github.com/man-pages-zh/manpages-zh