Man page - apmd(8)

Manual

APMD

名 前
書 式
説 明
オ プ シ ョ ン
バ グ
フ ァ イ ル
著 者
関 連 項 目

---

名 前

apmd - Advanced Power Management (APM) デ ー モ ン

書 式

apmd [ -c check_seconds ] [ -P proxy_cmd ] [ -p percent_to_log ] [ -qVvW ] [ -w warn_percent ] [ -? ] [deprecated options]

説 明

apmd は APM を 監 視 す る デ ー モ ン で 、 OS の カ ー ネ ル の APM BIOS ド ラ イ バ ー を 利 用 し て 動 作 す る 。 apmd は ド ラ イ バ ー か ら イ ベ ン ト の 発 生 が 通 知 さ れ た 時 に コ マ ン ド (通 常 は シ ェ ル ス ク リ プ ト ) を 実 行 す る こ と が で き 、 ま た シ ス テ ム の 電 力 状 態 が 変 化 (AC 電 源 供 給 の オ ン ・ オ フ な ど ) し た と き に syslogd (8) を 使 っ て ロ グ を 残 す こ と が で き る 。 電 池 の 残 量 が わ ず か に な っ た 時 に は 、 シ ス テ ム の 全 ユ ー ザ ー に い ろ い ろ な 方 法 で 警 告 を 通 知 す る こ と も で き る 。

カ ー ネ ル の APM ド ラ イ バ ー か ら サ ス ペ ン ド や ス タ ン バ イ を 行 い た い 旨 の 要 求 を 受 け 取 る と 、 apmd は 適 切 な コ マ ン ド を 実 行 し 、 そ の イ ベ ン ト を ロ グ に 書 き 、 デ ー タ を デ ィ ス ク に sync (2) し 、 全 て の デ ー タ が デ ィ ス ク に 実 際 に 書 き こ ま れ る よ う に 少 し の 間 ス リ ー プ し 、 そ の 後 APM ド ラ イ バ ー に 処 理 を 続 行 す る よ う に 通 知 す る 。 し か し 「 ク リ テ ィ カ ル 」 な サ ス ペ ン ド (緊 急 シ ャ ッ ト ダ ウ ン ) の 場 合 に は 、 途 中 の 段 階 を す べ て 飛 ば し て ド ラ イ バ ー に 処 理 の 続 行 通 知 を 送 る 。

こ の デ ー モ ン の 主 な 利 用 法 は proxy コ マ ン ド を 使 用 し て 電 力 の 節 約 を す る こ と で あ る 。 こ の コ マ ン ド の デ フ ォ ル ト の 検 索 場 所 は /etc/apmd_proxy で あ り 、 起 動 の 際 に は 1 個 ま た は 2 個 の 引 数 が 付 け ら れ る 。

	start		デ ー モ ン の 起 動 時 に 呼 び だ さ れ る 。 通 常 、 シ ス テ ム 全 体 の 電 力 管 理 設 定 を 行 う 。 例 え ば 電 池 使 用 時 /非 使 用 時 の IDE ハ ー ド デ ィ ス ク の ス タ ン バ イ 時 間 な ど で あ る 。
	stop		デ ー モ ン の 停 止 時 に 呼 び だ さ れ る 。 通 常 は デ ー モ ン の 開 始 時 に 設 定 さ れ た 電 源 の 設 定 を 元 に 戻 す 。

suspend [ system | user ]

シ ス テ ム の サ ス ペ ン ド 開 始 を APM ド ラ イ バ ー が 通 知 し た 時 に 呼 び だ さ れ る 。 二 番 目 の 引 数 は 、 サ ス ペ ン ド の 開 始 が BIOS に よ る も の か 、 ユ ー ザ ー の ア ク シ ョ ン (ラ ッ プ ト ッ プ を 閉 じ た 時 な ど ) に よ る も の か を 示 す 。

BIOS の 「 サ ス ペ ン ド 」 モ ー ド は 積 極 的 に 電 力 を 節 約 す る 。 通 常 は CPU の コ ア 部 分 と メ モ リ を 除 い て 全 て の デ バ イ ス の 電 源 を カ ッ ト し 、 こ れ ら も 超 低 電 力 モ ー ド (very low power mode) に す る 。 多 く の ラ ッ プ ト ッ プ で は 、 電 池 だ け で 数 日 間 サ ス ペ ン ド し 続 け る こ と が で き る 。 (「 ハ イ バ ネ ー シ ョ ン 」 は さ ら な る サ ス ペ ン ド と 言 え る 。 こ れ は 全 て の 状 態 が デ ィ ス ク に 書 き だ さ れ る の で CPU の コ ア の 電 源 供 給 も カ ッ ト す る こ と が で き 、 電 池 か ら 電 源 供 給 を す る 必 要 が ま っ た く な く な る 。 現 段 階 で は Linux は ハ イ バ ネ ー シ ョ ン を サ ポ ー ト し て い な い 。 ) PCMCIA デ バ イ ス は cardctl (8) を 使 っ て 手 動 で サ ス ペ ン ド す べ き で あ る 。 ま た い く つ か の ド ラ イ バ ー モ ジ ュ ー ル も ア ン ロ ー ド し て お く 必 要 が あ る か も し れ な い 。

standby [ system | user ]

シ ス テ ム の ス タ ン バ イ 開 始 を APM ド ラ イ バ ー が 通 知 し た 時 に 呼 び だ さ れ る 。 二 番 目 の 引 数 は ス タ ン バ イ の 開 始 が BIOS に よ る も の か ユ ー ザ ー の ア ク シ ョ ン ( apm -s の 実 行 な ど ) に よ る も の か を 示 し て い る 。

BIOS の 「 ス タ ン バ イ 」 モ ー ド は 多 少 電 力 の 節 約 を す る 。 マ シ ン は ユ ー ザ ー の 操 作 に ほ と ん ど 即 時 に 反 応 で き る 状 態 に 保 た れ る 。 多 く の ラ ッ プ ト ッ プ で は ス タ ン バ イ モ ー ド の ま ま だ と 電 池 だ け で は 一 日 も も た な い 。 通 常 は 、 BIOS が す る こ と 以 外 に は 何 も し な く て よ い 。

resume [ suspend | standby | critical ]

シ ス テ ム の 通 常 オ ペ レ ー シ ョ ン へ の レ ジ ュ ー ム を APM ド ラ イ バ ー が 通 知 し た 時 に 呼 び だ さ れ る 。 二 番 目 の 引 数 は 、 以 前 の 状 態 が 「 サ ス ペ ン ド 」 モ ー ド (「 ク リ テ ィ カ ル 」 な サ ス ペ ン ド の 可 能 性 も あ る ) だ っ た か 「 ス タ ン バ イ 」 モ ー ド だ っ た か を 示 し て い る 。

シ ス テ ム ク ロ ッ ク を ハ ー ド ウ ェ ア ク ロ ッ ク に 一 致 す る よ う に 更 新 す る 必 要 が あ る 。 こ れ は 通 常 カ ー ネ ル の APM ド ラ イ バ ー に よ っ て 処 理 さ れ る 。 PCMCIA デ バ イ ス は cardctl (8) を 使 用 し て 手 動 で レ ジ ュ ー ム す る 必 要 が あ る か も し れ な い 。 ま た 再 ロ ー ド や 再 初 期 化 が 必 要 に な る ド ラ イ バ ー モ ジ ュ ー ル も 存 在 す る 。 ク リ テ ィ カ ル な サ ス ペ ン ド の 時 に は 緊 急 シ ャ ッ ト ダ ウ ン に よ り 、 シ ス テ ム の 状 態 が 完 全 に は 保 存 さ れ て い な い こ と も あ る た め 、 ア プ リ ケ ー シ ョ ン や ド ラ イ バ ー の 状 態 が お か し く な る か も し れ な い 。

change power

APM ド ラ イ バ ー の 「 電 源 状 態 の 変 化 」 イ ベ ン ト の う ち の 幾 つ か に 対 応 す る (特 に AC 電 源 の 挿 抜 な ど )。 こ れ が 起 き る と シ ス テ ム 全 体 の 電 力 管 理 設 定 を 変 更 す る 場 合 が 多 い 。 例 え ば 電 池 し か 使 え な い 場 合 に IDE HDD を 積 極 的 に ス タ ン バ イ モ ー ド に 入 れ る よ う に す る な ど 。

change battery

少 な く と も 一 つ の (あ る い は 複 数 の ) 電 池 の 残 量 が "low" で あ る 、 と い う BIOS の 判 断 が APM ド ラ イ バ ー か ら 通 知 さ れ た 。 た だ し 、 少 な く と も 10 分 ぶ ん の 電 力 は 残 っ て い る 。

change capability

シ ス テ ム の 電 力 管 理 設 定 機 能 の ど れ か が 変 更 さ れ た 旨 が 報 告 さ れ た 。 何 ら か の セ ッ ト ア ッ プ ユ ー テ ィ リ テ ィ の 操 作 や デ バ イ ス の 追 加 ・ 取 り 外 し な ど が 考 え ら れ る 。

こ の デ ー モ ン は い ろ い ろ な ロ グ メ ッ セ ー ジ を 発 行 す る 。 ほ と ん ど は 見 れ ば わ か る だ ろ う が 、 電 池 の 状 態 に 関 す る メ ッ セ ー ジ に は 少 々 説 明 が 必 要 か も し れ な い 。 ロ グ の "Battery" ま た は "Charge" メ ッ セ ー ジ に は 、 続 い て 4 つ の フ ィ ー ル ド が 記 述 さ れ る 。

	1) 消 費 レ ー ト (パ ー セ ン ト /分 )。 負 の 場 合 は 充 電 を 示 す 。
	2) 完 全 充 電 ・ 完 全 消 費 状 態 か ら の 経 過 時 間 (hh:mm:ss)。 こ の 値 は 100% ま た は 0% に な っ た 状 態 か ら の 経 過 時 間 を 反 映 し て い る 場 合 に の み 意 味 が あ る 。 そ れ 以 外 の 場 合 に は 時 間 は 括 弧 で 括 ら れ 、 最 後 に apmd

の 「 重 要 な 」 状 態 変 化 (デ ー モ ン の 起 動 、 AC 電 源 か ら 電 池 駆 動 へ の 移 行 な ど ) が 起 き て か ら の 経 過 時 間 を 表 す 。

3) 完 全 に 電 池 を 消 費 し て し ま う ま で (あ る い は 完 全 に 充 電 さ れ る ま で ) の 予 測 時 間 。 最 後 に レ ジ ュ ー ム 状 態 か ら 復 帰 し て 以 降 (あ る い は AC 電 源 が 接 続 さ れ て 移 行 ) と 同 じ よ う な 利 用 状 態 が 続 く と 仮 定 し て い る 。 こ の 時 間 は apmd

自 身 が 計 算 し て い る 。

4) 括 弧 に 挟 ま れ た 、 充 電 率 と 電 池 の 寿 命 。 こ れ は APM BIOS の 予 測 値 で あ る (イ ン テ リ ジ ェ ン ト な 電 池 自 身 か ら の 、 や や 控 え め な 見 積 り で あ る こ と が 多 い )。 こ の 情 報 は 、 こ の デ ー モ ン か ら の メ ッ セ ー ジ の ほ と ん ど に 追 加 さ れ る 。

こ の デ ー モ ン は APM BIOS 1.2 イ ベ ン ト を サ ポ ー ト し て い る 。 し か し 複 数 の 電 池 の 取 り 扱 い な ど 、 よ り 高 度 な 機 能 は サ ポ ー ト し て い な い 。 ま た 最 近 の PC ハ ー ド ウ ェ ア に あ る ACPI サ ポ ー ト と の 連 携 は 、 ま だ で き な い 。

オ プ シ ョ ン

-c seconds, --check seconds

/dev/apm_bios デ バ イ ス を 何 秒 間 ブ ロ ッ ク す る か を 制 御 す る 。 通 常 デ ー モ ン は APM ド ラ イ バ ー が イ ベ ン ト を 報 告 す る ま で ブ ロ ッ ク す る 。 こ の 数 字 を 変 え る と 、 電 池 の 充 電 速 度 ・ 消 費 速 度 を よ り 頻 繁 に チ ェ ッ ク で き る 。

-P proxy_cmd, --apmd_proxy proxy_cmd

APM ド ラ イ バ ー の イ ベ ン ト が 報 告 さ れ た と き に 起 動 す る コ マ ン ド を 指 定 す る 。 こ の ス ク リ プ ト に 付 加 さ れ る 引 数 に 関 す る 情 報 は 上 述 の 説 明 を 見 よ 。

-p percent_change, --percentage percent_change

(消 費 や 充 電 に よ っ て ) 利 用 可 能 な 電 池 残 量 が percent_change づ つ 変 わ る ご と に 、 情 報 を ロ グ に 送 る 。 デ フ ォ ル ト は 5。 こ の 機 能 を 無 効 に し た い 場 合 は 100 よ り 大 き い 値 を 指 定 す る 。

-V, --version

デ ー モ ン の バ ー ジ ョ ン を 表 示 し て 終 了 す る 。

-v, --verbose

詳 細 出 力 モ ー ド を 有 効 に す る 。 APM ド ラ イ バ ー か ら 報 告 さ れ る 全 て の イ ベ ン ト が ロ グ に 送 ら れ る 。

-W, --wall

電 池 の 状 態 が ( -w オ プ シ ョ ン や APM BIOS に よ っ て 定 め ら れ た ) "low" に な っ た と き 、 syslog (2) を 用 い て ロ グ を と る だ け で な く 、 wall (1) を 用 い て 全 て の ユ ー ザ ー に 警 告 を 発 す る 。 こ れ は syslogd (8) の 設 定 で 、 ALERT メ ッ セ ー ジ が ユ ー ザ に 送 ら れ る よ う に な っ て い な い 場 合 に 非 常 に 便 利 で あ る 。 両 方 が 用 い ら れ る と 、 危 険 な 状 態 に な っ た と き に よ り た く さ ん の 警 告 が 発 せ ら れ る 。

-w warn_percent, --warn warn_percent

電 池 が 充 電 状 態 に な く 、 か つ 残 量 が warn_percent 以 下 に な っ た と き に ALERT レ ベ ル の 警 告 を syslog (2) に 送 る 。 -W ま た は --wall フ ラ グ が 与 え ら れ て い る と 、 デ ー モ ン は wall (1) も 使 っ て ユ ー ザ ー に い ま そ こ に あ る 危 機 を 警 告 す る 。 警 告 は パ ー セ ン テ ー ジ が 変 わ る ご と に 発 せ ら れ る 。 デ フ ォ ル ト は 10。 こ の 機 能 を 無 効 に す る に は 負 の 値 を 指 定 す る 。

-q, --quiet

-W オ プ シ ョ ン や -w オ プ シ ョ ン か ら 生 じ る 警 告 メ ッ セ ー ジ を 出 さ な く す る 。 (多 く の マ シ ン で は 、 APM BIOS は 電 力 を 使 い 切 り そ う に な る と 警 告 音 を 発 す る の で 、 そ れ 以 上 の 警 告 は 必 要 な い 。 )

-?, --help

利 用 法 を 表 示 し て 終 了 す る 。

こ れ か ら 書 く ソ フ ト は 、 proxy ス ク リ プ ト だ け を 使 う よ う に す べ き で あ る 。 以 下 の オ プ シ ョ ン は 今 後 は 使 う べ き で な い (こ れ ら の ほ と ん ど は 正 式 リ リ ー ス に は 存 在 し な い )。 指 定 さ れ る と 、 各 イ ベ ン ト か ら 起 動 さ れ る ど の proxy コ マ ン ド よ り も 優 先 さ れ る 。
-a ac_online_cmd, --ac_online ac_online_cmd

AC 電 源 が 利 用 で き る よ う に な っ た と き (た だ し デ ー モ ン が 最 初 に 起 動 さ れ た と き は 除 く ) に 実 行 す べ き コ マ ン ド を 指 定 す る 。

-b ac_offline_cmd, --ac_offline ac_offline_cmd

マ シ ン が 電 池 駆 動 に な っ た と き (た だ し デ ー モ ン が 最 初 に 起 動 さ れ た と き は 除 く ) に 実 行 す べ き コ マ ン ド を 指 定 す る 。

-l low_battery_cmd, --low_battery low_battery_cmd

電 池 の 残 量 が "low" で あ る と APM BIOS が 判 断 し た 場 合 に 実 行 す べ き コ マ ン ド を 指 定 す る 。

-s pre_suspend_cmd, --pre_suspend pre_suspend_cmd

ド ラ イ バ 経 由 で サ ス ペ ン ド す る 前 に 実 行 す べ き コ マ ン ド を 指 定 す る 。

-r post_resume_cmd, --post_resume post_resume_cmd

ド ラ イ バ 経 由 で 復 帰 し た 後 に 実 行 す べ き コ マ ン ド を 指 定 す る 。

-u, --utc

(こ の オ プ シ ョ ン は 現 在 は 完 全 に 無 視 さ れ る 。 ) BIOS ク ロ ッ ク が UTC (GMT) に セ ッ ト さ れ て い る 。 し た が っ て サ ス ペ ン ド モ ー ド や レ ジ ュ ー ム モ ー ド か ら 復 帰 し た り BIOS の update time イ ベ ン ト の 際 に は 、 デ ー モ ン は clock や hwclock プ ロ グ ラ ム に -u オ プ シ ョ ン を 渡 さ な け れ ば な ら な い 。

バ グ

電 力 状 態 が 変 わ っ た あ と 、 最 初 に 出 さ れ る 報 告 は 不 正 確 か も し れ な い 。 な ぜ な ら 1% 以 下 の 変 化 は 1% に 丸 め ら れ る か ら で あ る 。 例 え ば 、 あ る 程 度 マ シ ン を 使 っ て 50.9% の 電 池 が 残 っ て い る と す る と 、 こ れ は 50% と 報 告 さ れ る 。 マ シ ン の 充 電 が 始 ま る と 、 残 量 が 51% に な る ま で の 変 化 は 0.1% だ け で あ る 。 し た が っ て 充 電 速 度 は 劇 的 に 大 き な 値 に な っ て し ま う 。

他 の ア プ リ ケ ー シ ョ ン に 、 シ ス テ ム の 電 源 管 理 方 針 決 定 に 参 画 さ せ る に は 、 よ り 一 般 的 な フ ッ ク が 必 要 で あ る 。

現 在 の と こ ろ 、 複 数 の 電 池 は 1 つ の 大 き な 電 池 と し て し か 取 り 扱 わ れ な い 。

フ ァ イ ル

/dev/apm_bios
/proc/apm
/etc/apmd/apmd_proxy

著 者

こ の プ ロ グ ラ ム は Rik Faith (faith@cs.unc.edu) に よ っ て 書 か れ 、 GNU 一 般 公 共 使 用 許 諾 の も と で 自 由 に 再 配 布 で き る 。 こ の プ ロ グ ラ ム は 「 完 全 に 無 保 証 」 で あ る 。 現 在 の 管 理 者 は Avery Pennarun (apenwarr@worldvisions.ca) で あ る 。

関 連 項 目

apm (1), xapm (1), cardctl (8), hdparm (8), syslogd (8)

---