Manpages

NAME

systemd-socket-activate - 測 試 基 於 套 接 字 啓 動 的 守 護 進 程

SYNOPSIS

systemd-socket-activate [OPTIONS...] daemon [OPTIONS...]

描 述

systemd-socket-activate 用 於 測 試 啓 動 基 於 套 接 字 啓 動 的 服 務 進 程 。 還 可 用 於 針 對 單 個 連 接 啓 動 單 獨 的 服 務 進 程 實 例 。 可 以 通 過 daemon 之 後 的 [OPTIONS...] 給 要 啓 動 的 服 務 進 程 傳 遞 命 令 行 選 項 。 如 果 使 用 了 --inetd 選 項 , 那 麼 socket 文 件 描 述 符 將 被 用 作 被 調 用 進 程 的 標 準 輸 入 與 標 準 輸 出 。 否 則 , 將 繼 承 現 有 的 標 準 輸 入 與 標 準 輸 出 , 而 socket 將 被 作 爲 3號 或 更 高 的 文 件 描 述 符 。 通 過 $LISTEN_FDS 傳 遞 給 systemd-socket-activate 的 socket 將 會 被 直 接 傳 遞 給 被 調 用 的 進 程 , 通 過 --listen= 指 定 的 其 他 socket 將 會 使 用 連 續 描 述 符 (consecutive descriptor)。 systemd-socket-activate 默 認 在 流 式 套 接 字 (stream socket)上 監 聽 , 但 是 可 以 使 用 --datagram 選 項 改 爲 在 數 據 報 套 接 字 (datagram socket)上 監 聽 , 或 者 使 用 --seqpacket 選 項 改 爲 在 順 序 包 套 接 字 (sequential packet socket)上 監 聽 。

選 項

-l address, --listen=address 在 指 定 的 address 上 監 聽 。 接 受 一 個 類 似 "2000"(端 口 ) 或 "127.0.0.1:2001"(地 址 :端 口 ) 這 樣 的 字 符 串 。

-a, --accept 爲 每 個 連 接 啓 動 一 個 服 務 進 程 實 例 , 並 傳 遞 連 接 套 接 字 。

-d, --datagram 在 數 據 報 套 接 字 (SOCK_DGRAM)上 監 聽 , 而 不 是 默 認 的 流 式 套 接 字 (SOCK_STREAM)。 不 能 與 --seqpacket 同 時 使 用 。

--seqpacket 在 順 序 包 套 接 字 (SOCK_SEQPACKET)上 監 聽 , 而 不 是 默 認 的 流 式 套 接 字 (SOCK_STREAM)。 不 能 與 --datagram 同 時 使 用 。

--inetd 使 用 inetd 協 議 傳 遞 文 件 描 述 符 , 也 就 是 作 爲 標 準 輸 入 與 標 準 輸 出 , 而 不 是 新 式 的 使 用 $LISTEN_FDS 變 量 來 傳 遞 文 件 描 述 符 。

-E VAR[=VALUE], --setenv=VAR[=VALUE] 向 被 調 用 的 進 程 傳 遞 環 境 變 量 。 如 果 在 VAR 後 面 緊 跟 着 "=" 符 號 , 那 麼 會 將 其 視 爲 "變 量 =值 "的 結 構 。 否 則 表 示 將 systemd-socket-activate 所 擁 有 的 同 名 變 量 傳 遞 過 去 。

--fdname=NAME[:NAME...] 指 定 要 傳 遞 的 文 件 描 述 符 名 稱 。 這 等 價 於 在 單 元 文 件 中 設 置 FileDescriptorName= 並 且 啓 用 sd_listen_fds_with_names(3) 。 可 以 多 次 使 用 此 選 項 以 指 定 多 個 描 述 符 , 也 可 以 在 同 一 個 選 項 中 使 用 冒 號 分 隔 多 個 描 述 符 。 如 果 給 出 的 名 字 多 於 文 件 描 述 符 的 個 數 , 那 麼 多 出 的 名 字 將 會 被 忽 略 。 如 果 給 出 的 名 字 少 於 文 件 描 述 符 的 個 數 , 那 麼 多 出 的 文 件 描 述 符 將 被 視 爲 未 命 名 的 。

-h, --help 顯 示 簡 短 的 幫 助 信 息 並 退 出 。

--version 顯 示 簡 短 的 版 本 信 息 並 退 出 。

環 境 變 量

$LISTEN_FDS, $LISTEN_PID, $LISTEN_FDNAMES 參 見 sd_listen_fds(3) 手 冊 。

$SYSTEMD_LOG_TARGET, $SYSTEMD_LOG_LEVEL, $SYSTEMD_LOG_COLOR, $SYSTEMD_LOG_LOCATIONsystemd(1) 中 的 含 義 相 同 。

例 子

Example 1. 在 2000 端 口 上 運 行 一 個 回 顯 服 務 。

$ systemd-socket-activate -l 2000 --inetd -a cat

Example 2. 運 行 一 個 基 於 套 接 字 啓 動 的 systemd-journal-gatewayd(8) 實 例

$ systemd-socket-activate -l 19531 /usr/lib/systemd/systemd-journal-gatewayd

參 見

systemd(1), systemd.socket(5), systemd.service(5), sd_listen_fds(3), sd_listen_fds_with_names(3), cat(1)

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 翻 譯 人 員 : 金 步 國 金 步 國 作 品 集 : http://www.jinbuguo.com 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh