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