Man page - systemd-socket-activate(1)

Packages contains this manual

Available languages:

en zh_TW zh_CN de

Manual

SYSTEMD-SOCKET-ACTIVATE

NAME
SYNOPSIS
描 述
選 項
環 境 變 數
例 子
參 見
跋

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_LOCATION

與 systemd (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