Manpages

名 前

dhcpcd − DHCP ク ラ イ ア ン ト デ ー モ ン

書 式

dhcpcd [−dknrBCDHNRSTY] [−t <timeout>] [−c <ExecFilePath>] [-h <hostname>] [-i <vendorClassID>] [-I <clientID>] [−l <leasetime>] [−s [ipaddr]] [−G [gateway]] [−w <windowsize>] [−L <ConfigDir>] [interface]

説 明

dhcpcd は RFC2131 (-r オ プ シ ョ ン が 指 定 さ れ な か っ た 場 合 ) と RFC1541 (-r オ プ シ ョ ン が 指 定 さ れ た 場 合 ) に 基 づ く DHCP ク ラ イ ア ン ト の 実 装 で あ る 。

DHCP サ ー バ か ら ホ ス ト の 情 報 (IP ア ド レ ス 、 ネ ッ ト マ ス ク 、 ブ ロ ー ド キ ャ ス ト ア ド レ ス な ど ) を 取 得 し 、 そ の マ シ ン の ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス を 設 定 す る 。 ま た 、 RFC2131 ま た は RFC1541 (obsolete;す で に 廃 止 さ れ た ) に 基 づ く 貸 し 出 し 期 間 (lease time) を 更 新 し よ う と 試 み る 。

オ プ シ ョ ン

−d こ の フ ラ グ に よ り

dhcpcd は 、 各 実 行 ス テ ッ プ ご と に

syslog(LOG_DEBUG,...) で ロ グ を 出 力 す る 。 あ ま り 多 く の 出 力 は 行 わ な い が 、 何 か 問 題 が 起 き た 場 合 に は 解 決 の 大 き な 助 け と な る の で 、 こ の オ プ シ ョ ン の 利 用 が 推 奨 さ れ る 。 dhcpcd は 、 そ の 出 力 に syslog 機 能 分 類 (facility) LOCAL0 を 使 う 。 dhcpcd の デ バ ッ グ 出 力 を 捕 捉 す る に は 、 /etc/syslog.conf フ ァ イ ル に

local0.* /var/log/dhcpcd.log と い う 行 を 追 加 し 、

kill -1 ’cat /var/run/syslogd.pid’ に よ っ て syslogd デ ー モ ン を リ フ レ ッ シ ュ す る こ と 。

−k 現 在 動 い て い る

dhcpcd プ ロ セ ス へ SIGHUP シ グ ナ ル を 送 る 。 SIGHUP

シ グ ナ ル を dhcpcd が 受 け 取 る と 、 DHCP_RELEASE メ ッ セ ー ジ を サ ー バ へ 送 り 、 dhcpcd の キ ャ ッ シ ュ を 破 棄 す る 。 SIGTERM シ グ ナ ル は 、 普 通 、 シ ス テ ム を 再 起 動 す る 時 に shutdown(8) が 送 る が 、 そ の シ グ ナ ル を dhcpcd が 受 け 取 っ た 場 合 は 、 dhcpcd は DHCP_RELEASE メ ッ セ ー ジ を 送 ら ず 、 キ ャ ッ シ ュ を 破 棄 し な い 。 そ し て シ ス テ ム が 起 動 す る 時 に dhcpcd は 、 シ ス テ ム が 落 ち る 前 に DHCP サ ー バ か ら 割 り 当 て ら れ て い た の と 同 じ IP ア ド レ ス を 要 求 す る た め に 、 キ ャ ッ シ ュ を 用 い る 。

−n 現 在 動 い て い る

dhcpcd プ ロ セ ス に SIGALRM シ グ ナ ル を 送 り 、 貸 し 出

し 期 間 を 更 新 さ せ る 。 dhcpcd が 稼 働 し て い な い 場 合 は 、 こ の フ ラ グ は 無 視 さ れ 、 通 常 の 起 動 手 順 で dhcpcd が 起 動 さ れ る 。

−r

dhcpcd を RFC1541 (obsolete) 準 拠 で 動 か す 。 dhcpcd は こ の オ プ シ ョ ン が 指 定 さ れ な い 限 り RFC2131 に 準 拠 す る 。

−B

DHCP サ ー バ に ブ ロ ー ド キ ャ ス ト で の 応 答 を 要 求 す る 。

−C

dhcpcd に 受 信 し た パ ケ ッ ト の チ ェ ッ ク サ ム (checksum) を 計 算 さ せ る 。

−D

dhcpcd に 対 し て 、 そ の マ シ ン の ド メ イ ン 名 を 、 DHCP サ ー バ か ら 提 供 さ れ る ド メ イ ン 名 オ プ シ ョ ン (domainname option) に 設 定 さ せ る 。

−H

dhcpcd に 対 し て 、 そ の マ シ ン の ホ ス ト 名 を 、 DHCP サ ー バ か ら 提 供 さ れ る ホ ス ト 名 オ プ シ ョ ン (hostname option) に 設 定 さ せ る 。 デ フ ォ ル ト で は dhcpcd は そ の マ シ ン の ホ ス ト 名 を 、 DHCP サ ー バ か ら 受 け 取 っ た ホ ス ト 名 オ プ シ ョ ン に は 設 定 し な い 。

−L <ConfigDir>

dhcpcd は 、 設 定 情 報 を 格 納 す る た め に 、 デ フ ォ ル ト の /etc/dhcpc で は な く <ConfigDir> デ ィ レ ク ト リ を 使 う 。

−S

dhcpcd が 最 初 の DHCP_DISCOVER メ ッ セ ー ジ に 対 し て DHCP_OFFER メ ッ セ ー ジ を 受 信 し た 後 で あ っ て も 、 2 回 目 の DHCP_DISCOVER メ ッ セ ー ジ を 送 信 さ せ る 。 「 ク ラ イ ア ン ト は DHCP_REQUEST を 返 答 す る 前 に 2 回 目 の DHCP_DISCOVER を 送 信 す る 」 と 仮 定 し て い る DHCP サ ー バ も あ る 。

−R

す で に 存 在 す る フ ァ イ ル /etc/resolv.conf を dhcpcd が 置 き 換 え な い よ う に す る 。
−Y

dhcpcd が 既 存 の /etc/yp.conf フ ァ イ ル を 置 き 換 え な い よ う に す る 。 -D を 指 定 し な い 限 り 、 ド メ イ ン 名 は 更 新 さ れ な い 。

−N

dhcpcd が 既 存 の /etc/ntp.conf フ ァ イ ル を 置 き 換 え な い よ う に す る 。

−T

テ ス ト 用 。 dhcpcd は DHCP ネ ゴ シ エ ー シ ョ ン シ ー ケ ン ス に 入 る が 、 実 際 に は イ ン タ ー フ ェ ー ス を 設 定 し な い 。 し か し 、 フ ァ イ ル <ConfigDir>/dhcpcd-<interface>.info と <ConfigDir>/dhcpcd-<interface>.cache を 書 き 込 み 、 <ConfigDir>/dhcpcd.exe ス ク リ プ ト を 実 行 し よ う と す る 。 実 行 可 能 ス ク リ プ ト dhcpcd.exe の パ ス 名 は 、 −c  <ExecFilePath> オ プ シ ョ ン で 変 更 で き る 。 −T オ プ シ ョ ン は 主 に DHCP サ ー バ の テ ス ト に 使 わ れ る 。 同 じ ダ ミ ー イ ン タ フ ェ ー ス の た め の 複 数 の IP ア ド レ ス を 取 得 し た り 、 −L  <ConfigDir> や −I  <ClientID> オ プ シ ョ ン

−t <timeout> ど れ く ら い の 時 間 dhcpcd が IP ア ド レ ス を 取 得 し よ う と 試 み る か を (秒 数 で ) 指 定 す る 。 デ フ ォ ル ト は 60 秒 。 dhcpcd は 使 用 可 能 な IP ア ド レ ス を 取 得 し 、 親 プ ロ セ ス へ 0 を 返 す ま で は バ ッ ク グ ラ ウ ン ド へ と fork し な い 。 dhcpcd が 使 用 可 能 な IP ア ド レ ス を DHCP サ ー バ か ら 受 け 取 る 前 に タ イ ム ア ウ ト し た 場 合 は 、 dhcpcd は 親 プ ロ セ ス へ 終 了 コ ー ド 1 を 返 す 。
−c <ExecFilePath>

dhcpcd は イ ン タ フ ェ ー ス が 設 定 ま た は 落 さ れ る 度 に 、 デ フ ォ ル ト の <ConfigDir>/dhcpcd.exe ス ク リ プ ト で は な く 、 <ExecFilePath> ス ク リ プ ト を 実 行 し よ う と す る 。 下 記 の 「 フ ァ イ ル 」 セ ク シ ョ ン に お け る ス ク リ プ ト dhcpcd.exe に つ い て の 説 明 を 参 照 す る こ と 。

−h <hostname>

dhcpcd が 送 る DHCP メ ッ セ ー ジ の ホ ス ト 名 オ プ シ ョ ン に 使 わ れ る 文 字 列 を 指 定 す る 。 ク ラ イ ア ン ト か ら の DHCP メ ッ セ ー ジ の 中 で 、 ホ ス ト 名 オ プ シ ョ ン が 指 定 さ れ て い る こ と を 要 求 す る DHCP サ ー バ も あ る (特 に 家 庭 内 ネ ッ ト ワ ー ク で 使 わ れ る DHCP サ ー バ )。

−i <vendorClassID> ベ ン ダ ー ク ラ ス 識 別 子 (vendor class identifier) を 指 定 す る 。 何 も 指 定 さ れ な か っ た 場 合 、 dhcpcd は デ フ ォ ル ト の ベ ン ダ ー ク ラ ス 識 別 子 (シ ス テ ム 名 、 シ ス テ ム リ リ ー ス 、 マ シ ン タ イ プ ) を 用 い る 。
−I <ClientID> ク ラ イ ア ン ト 識 別 子 (client identifier) を 指 定 す る 。 何 も 指 定 さ れ な か っ た 場 合 、 dhcpcd は デ フ ォ ル ト の ク ラ イ ア ン ト 識 別 子 (ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の MAC ア ド レ ス ) を 用 い る 。
−l <leasetime> サ ー バ へ 推 奨 す る 貸 し 出 し 時 間 を (秒 数 で ) 指 定 す る 。 (サ ー バ は こ の 値 を 、 適 切 な 値 へ と 上 書 き で き る こ と に 注 意 )。 こ の 値 は DHCP_DISCOVER メ ッ セ ー ジ に 使 わ れ る 。 デ フ ォ ル ト は 無 限 大 (0xffffffff)。
−s [ipaddr]

DHCP_INFORM メ ッ セ ー ジ を ipaddr を 使 っ て DHCP サ ー バ へ 送 る 。 省 略 可 能 な パ ラ メ ー タ ipaddr は xxx.xxx.xxx.xxx と い う 形 式 で な け れ ば な ら な い 。 も し 、 コ マ ン ド ラ イ ン で ipaddr パ ラ メ ー タ が 与 え ら れ な け れ ば 、 dhcpcd は 現 在 イ ン タ フ ェ ー ス に 割 り 当 て ら れ て い る IP ア ド レ ス を 用 い る 。 も し 現 在 、 イ ン タ フ ェ ー ス に IP ア ド レ ス が 割 り 当 て ら れ て い な け れ ば 、 dhcpcd は フ ァ イ ル <ConfigDir>/dhcpcd-<interface>.cache に 記 録 さ れ て い る 、 以 前 に 獲 得 し た IP ア ド レ ス を 用 い る 。

−G [gateway]

DHCP サ ー バ に よ っ て 提 供 さ れ た デ フ ォ ル ト の 経 路 を dhcpcd に イ ン ス ト ー ル さ せ な い よ う に す る 。 オ プ シ ョ ン で ゲ ー ト ウ ェ イ ip ア ド レ ス パ ラ メ ー タ が 指 定 さ れ た 場 合 、 そ れ を デ フ ォ ル ト の 経 路 と し て 使 う 。

−w <windowsize> ゲ ー ト ウ ェ イ 経 路 の ウ イ ン ド ウ サ イ ズ を 指 定 す る 。 デ フ ォ ル ト は 32768 で あ る 。
interface ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の 名 前 (eth0, eth1 な ど ) を 指 定 す る 。 名 前 が 明 示 さ れ な か っ た 場 合 、 dhcpcd は ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス と し て eth0 を 用 い る 。

フ ァ イ ル

/etc/dhcpc

dhcpcd に よ っ て 作 成 さ れ た フ ァ イ ル を 保 存 す る の に 用 い ら れ る デ フ ォ ル ト の <ConfigDir> デ ィ レ ク ト リ 。 上 記 の −L <ConfigDir> オ プ シ ョ ン を 参 照 す る こ と 。

<ConfigDir>/dhcpcd-<interface>.info

dhcpcd が ホ ス ト 情 報 を 記 録 す る フ ァ イ ル 。 interface は 、 実 際 に は eth0 の よ う な 、 dhcpcd で 管 理 さ れ て い る ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の 名 前 で 置 き 換 え ら れ る 。

<ConfigDir>/dhcpcd.exe イ ン タ フ ェ ー ス を 設 定 ま た は 落 す 度 に 、 dhcpcd が 実 行 し よ う と す る ス ク リ プ ト フ ァ イ ル 。 こ の 実 行 可 能 ス ク リ プ ト へ の パ ス は 、 −c  <ExecFilePath> オ プ シ ョ ン で 変 更 で き る 。 dhcpcd は dhcpcd.exe ス ク リ プ ト に 3 つ の パ ラ メ ー タ を 渡 す 。
dhcpcd.exe <HostInfoFilePath> <up|down|new> [-d] 最 初 の パ ラ メ ー タ <HostInfoFilePath> は dhcpcd-<interface>.info フ ァ イ ル へ の パ ス で あ る 。 <interface> は 、 実 際 に は "eth0" の よ う な dhcpcd で 管 理 さ れ て い る ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の 名 前 で 置 き 換 え ら れ る 。 2 番 目 の パ ラ メ ー タ 値 <up|down|new> は 、 前 と 同 じ IP ア ド レ ス で イ ン タ フ ェ ー ス を 上 げ る ("up")、 新 し い IP ア ド レ ス で イ ン タ フ ェ ー ス を 上 げ る ("new")、 イ ン タ フ ェ ー ス を 落 す ("down") と い う 意 味 で あ る 。 パ ラ メ ー タ -d は 、 dhcpcd を デ バ ッ グ フ ラ グ -d で 起 動 す る 場 合 に 渡 す 。
<ConfigDir>/dhcpcd-<interface>.cache 以 前 に 割 り 当 て ら れ た IP ア ド レ ス な ど を 含 む キ ャ ッ シ ュ フ ァ イ ル 。 <interface> は 、 実 際 に は eth0 の よ う な 、 dhcpcd で 管 理 さ れ て い る ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の 名 前 で 置 き 換 え ら れ る 。
/etc/resolv.conf ク ラ イ ア ン ト が DNS と ド メ イ ン 名 オ プ シ ョ ン を 受 け 取 っ た 時 に dhcpcd が 作 成 す る フ ァ イ ル 。 既 に /etc/resolv.conf が 存 在 す る 場 合 、 元 の フ ァ イ ル は /etc/resolv.conf.sv と い う 名 前 に 変 更 さ れ 、 何 ら か の 理 由 で dhcpcd が 終 了 し た 時 に は 元 に 戻 さ れ る 。
/etc/yp.conf ク ラ イ ア ン ト が NIS オ プ シ ョ ン を 受 信 し た 場 合 に 、 dhcpcd に よ っ て 作 成 さ れ る フ ァ イ ル 。 既 に /etc/yp.conf が 存 在 す る 場 合 、 元 の フ ァ イ ル は /etc/yp.conf.sv と い う 名 前 に 変 更 さ れ 、 何 ら か の 理 由 で dhcpcd が 終 了 し た 時 に は 元 に 戻 さ れ る 。
/etc/ntp.conf ク ラ イ ア ン ト が NTP オ プ シ ョ ン を 受 信 し た 場 合 に 、 dhcpcd に よ っ て 作 成 さ れ る フ ァ イ ル 。 既 に /etc/ntp.conf が 存 在 す る 場 合 、 元 の フ ァ イ ル は /etc/ntp.conf.sv と い う 名 前 に 変 更 さ れ 、 何 ら か の 理 由 で dhcpcd が 終 了 し た 時 に は 元 に 戻 さ れ る 。
<ConfigDir>/dhcpcd-<interface>.pid

dhcpcd の プ ロ セ ス ID を 格 納 す る フ ァ イ ル 。 <interface> は 、 実 際 に は eth0 の よ う な 、 dhcpcd で 管 理 さ れ て い る ネ ッ ト ワ ー ク イ ン タ フ ェ ー ス の 名 前 で 置 き 換 え ら れ る 。

関 連 項 目

Dynamic Host Configuration Protocol, RFC2131 お よ び RFC1541 (obsolete) DHCP Options and BOOTP Vendor Extensions, RFC2132

バ グ

dhcpcd は 貸 し 出 し の 終 了 期 限 を 計 算 す る の に time(3) を 用 い る 。 ク ラ イ ア ン ト の 実 行 中 に シ ス テ ム 時 刻 が 変 更 さ れ る と 、 貸 し 出 し の 終 了 期 限 は 予 測 不 可 能 と な る 。

著 者

バ ー ジ ョ ン 1.3 未 満

Yoichi Hariguchi <yoichi [AT] fore.com> バ ー ジ ョ ン 1.3
Sergei Viznyuk <sv [AT] phystech.com>