Manpages

名 前

xprop - プ ロ パ テ ィ 表 示 ア プ リ ケ ー シ ョ ン

書 式

xprop [-help] [-grammar] [-id id] [-root] [-name name] [-frame] [-font font] [-display display] [-len n] [-notype] [-fs file] [-remove property-name] [-set property-name value] [-spy] [-f atom format [dformat]]* [format [dformat] atom]*

概 要

xprop は X サ ー バ 内 の ウ ィ ン ド ウ と フ ォ ン ト の プ ロ パ テ ィ を 表 示 す る た め の ユ ー テ ィ リ テ ィ で あ る 。 xprop に お い て は 、 コ マ ン ド 行 の 引 き 数 を 使 っ て ウ ィ ン ド ウ ま た は フ ォ ン ト を 1 つ 選 択 す る 。 ウ ィ ン ド ウ の 場 合 に は ウ ィ ン ド ウ を ク リ ッ ク し て 選 択 す る こ と も で き る 。 こ れ に よ り 、 プ ロ パ テ ィ の リ ス ト と (た ぶ ん )フ ォ ー マ ッ ト 情 報 が 与 え ら れ る 。

オ プ シ ョ ン

-grammar コ マ ン ド 行 オ プ シ ョ ン の 全 て に 対 す る 、 細 か い 文 法 の 説 明 を 表 示 す る 。

id で 選 択 す る こ と が で き る 。 こ の オ プ シ ョ ン は X の ア プ リ ケ ー シ ョ ン を デ バ ッ グ す る と き に 大 変 便 利 で あ る 。 す な わ ち 、 対 象 の ウ ィ ン ド ウ が ス ク リ ー ン に マ ッ プ さ れ な い 場 合 や 、 ポ イ ン タ が 利 用 で き な い 場 合 、 ポ イ ン タ が ア プ リ ケ ー シ ョ ン の 動 作 を 妨 げ る 場 合 に 有 効 で あ る 。
-name name こ の 引 き 数 を 使 う と 、 ポ イ ン タ を 使 っ て 対 象 の ウ ィ ン ド ウ を 選 択 す る 代 わ り に 、 name と い う 名 前 を 持 つ ウ ィ ン ド ウ を コ マ ン ド 行 か ら 選 択 す る こ と が で き る 。
-font font こ の 引 き 数 を 使 う と 、 ユ ー ザ は フ ォ ン ト font の プ ロ パ テ ィ を 表 示 さ せ る こ と が で き る 。

こ の オ プ シ ョ ン は 、 ル ー ト ウ ィ ン ド ウ が 他 の ウ ィ ン ド ウ に 完 全 に 隠 さ れ て い る 場 合 に 便 利 で あ る 。

-display display こ の 引 き 数 を 使 う と 、 接 続 す る サ ー バ を 指 定 す る こ と が で き る 。 X(7) を 参 照 す る こ と 。

る 。

-fs file 多 数 の プ ロ パ テ ィ に 対 す る フ ォ ー マ ッ ト を 入 力 す る フ ァ イ ル と し て file を 使 う こ と を 指 定 。

れ も 与 え な い と き )に 、 ク ラ イ ア ン ト の ウ ィ ン ド ウ の 代 わ り に (も し あ れ ば )ウ ィ ン ド ウ マ ネ ー ジ ャ の フ レ ー ム を 参 照 す る こ と を 指 定 す る 。

-remove property-name 指 定 し た 名 前 の プ ロ パ テ ィ を 、 指 定 さ れ た ウ ィ ン ド ウ か ら 取 り 除 く こ と を 指 定 す る 。
-set property-name value 指 定 し た 名 前 の プ ロ パ テ ィ と そ の プ ロ パ テ ィ の 値 を 指 定 し 、 こ れ ら を 指 定 し た ウ ィ ン ド ウ に 設 定 す る 。

-f name format [dformat]

name に 対 す る format が format で あ る こ と と name に 対 す る dformat が dformat で あ る こ と を を 指 定 す る 。 dformat を 省 略 し た 場 合 に は 、 " = $0+\n" が 指 定 さ れ た も の と 見 な さ れ る 。

説 明

こ れ ら の プ ロ パ テ ィ の そ れ ぞ れ に つ い て 、 選 択 さ れ た ウ ィ ン ド ウ や フ ォ ン ト が 持 つ 値 は 、 フ ォ ー マ ッ ト 情 報 が 与 え ら れ て い れ ば そ れ を 使 っ て 表 示 さ れ る 。 フ ォ ー マ ッ ト 情 報 が 与 え ら れ て い な け れ ば 、 内 部 的 な デ フ ォ ル ト 値 が 使 用 さ れ る 。 選 択 さ れ た ウ ィ ン ド ウ や フ ォ ン ト に お い て プ ロ パ テ ィ が 定 義 さ れ て い な け れ ば 、 そ の プ ロ パ テ ィ に 対 し て は "not defined" が 表 示 さ れ る 。 プ ロ パ テ ィ の リ ス ト が 与 え ら れ て い な い 場 合 に は 、 選 択 さ れ た ウ ィ ン ド ウ や フ ォ ン ト が 所 有 し て い る 全 て の プ ロ パ テ ィ が 表 示 さ れ る 。 ウ ィ ン ド ウ は 次 の 4つ の 方 法 の う ち の い ず れ か で 選 択 す る こ と が で き る 。 第 一 に 、 ル ー ト ウ ィ ン ド ウ を 選 択 し た い 場 合 に は -root オ プ シ ョ ン が 利 用 で き る 。 選 択 し た い ウ ィ ン ド ウ が ル ー ト ウ ィ ン ド ウ で な い 場 合 、 コ マ ン ド 行 か ら 選 択 す る 方 法 は 2つ あ る 。 す な わ ち 、 xwininfo 等 で 得 ら れ る ウ ィ ン ド ウ ID を 使 う 方 法 と 、 ウ ィ ン ド ウ が 持 っ て い る 名 前 を 使 う 方 法 で あ る 。 -id オ プ シ ョ ン は 10進 数 か 16進 数 の ID 番 号 で ウ ィ ン ド ウ を 使 っ て 選 択 す る (16進 数 の 場 合 は 0x で 始 め な け れ ば な ら な い )。 -name オ プ シ ョ ン は 名 前 を 使 っ て ウ ィ ン ド ウ を 選 択 す る 。 ウ ィ ン ド ウ を 選 択 す る 最 後 の 方 法 は 、 コ マ ン ド 行 と は 全 く 関 係 が な い 。 -font, -id, -name, -root の い ず れ も 指 定 さ れ て い な い 場 合 、 十 字 形 の カ ー ソ ル が 表 示 さ れ 、 ユ ー ザ は 選 択 し た い ウ ィ ン ド ウ 上 で ポ イ ン タ の ボ タ ン を ク リ ッ ク す る こ と で 表 示 さ れ て い る 任 意 の ウ ィ ン ド ウ を 選 択 す る こ と が で き る 。 ウ ィ ン ド ウ で は な く フ ォ ン ト の プ ロ パ テ ィ を 表 示 し た い 場 合 に は 、 -font オ プ シ ョ ン を 使 っ て コ マ ン ド 行 か ら 選 択 す る し か な い 。 上 記 の 4つ の オ プ シ ョ ン と ヘ ル プ を 見 る た め の -help オ プ シ ョ ン 、 コ マ ン ド ラ イ ン の 詳 し い 文 法 を 表 示 す る た め の -grammer オ プ シ ョ ン を 除 い た コ マ ン ド 行 で の 引 き 数 は 全 て 、 表 示 さ れ る プ ロ パ テ ィ の フ ォ ー マ ッ ト と プ ロ パ テ ィ の 表 示 の 仕 方 を 指 定 す る た め に 使 わ れ る 。 -len n オ プ シ ョ ン は 、 与 え ら れ た プ ロ パ テ ィ の う ち 長 く て も n バ イ ト だ け が 読 み 込 み 、 表 示 さ れ る よ う に 指 定 す る 。 例 え ば 、 全 部 表 示 さ せ る と 何 ペ ー ジ に な る か も し れ な い ル ー ト ウ ィ ン ド ウ の カ ッ ト バ ッ フ ァ を 表 示 さ せ る よ う な 場 合 に は 、 こ の オ プ シ ョ ン が 有 効 で あ る 。 通 常 は プ ロ パ テ ィ 名 の そ れ ぞ れ に 対 し て 、 プ ロ パ テ ィ 名 が 最 初 に 表 示 さ れ 、 次 に (も し あ れ ば )そ の 型 が 括 弧 付 き で 表 示 さ れ 、 そ れ か ら 値 が 表 示 さ れ る 。 -notype オ プ シ ョ ン を 指 定 す る と プ ロ パ テ ィ の 型 は 表 示 さ れ な い 。 -fs オ プ シ ョ ン は プ ロ パ テ ィ の フ ォ ー マ ッ ト を 記 述 し た フ ァ イ ル を 指 定 す る た め に 使 わ れ 、 -f オ プ シ ョ ン は プ ロ パ テ ィ 1つ に 対 し て フ ォ ー マ ッ ト を 指 定 す る た め に 使 わ れ る 。 プ ロ パ テ ィ に 対 す る フ ォ ー マ ッ ト 情 報 は 具 体 的 に は 2つ の 部 分 、 す な わ ち format と dformat か ら 構 成 さ れ る 。 format は プ ロ パ テ ィ の 実 際 の フ ォ ー マ ッ ト (つ ま り 、 word, byte, long 等 か ら な る )を 指 定 し 、 dformat は プ ロ パ テ ィ を ど の よ う に 表 示 す る か を 指 定 す る 。 以 降 の 段 落 に お い て は 、 format と dformat の 記 述 方 法 を 説 明 す る 。 し か し 、 ほ と ん ど の ユ ー ザ と そ の 使 用 目 的 に 対 し て は 必 要 が な い で あ ろ う 。 な ぜ な ら 、 デ フ ォ ル ト で 組 み 込 ま れ て い る フ ォ ー マ ッ ト に は 全 て の 標 準 プ ロ パ テ ィ を 表 示 す る た め に 必 要 な format と dformat が 含 ま れ て い る か ら で あ る 。

format は 、 0, 8, 16, 32 の い ず れ か の 後 に 1つ 以 上 の フ ォ ー マ ッ ト 文 字 を 続 け た も の で あ る 。 0, 8, 16, 32 の 数 字 は プ ロ パ テ ィ に お い て フ ィ ー ル ド ご と に い く つ ビ ッ ト が あ る か を 指 定 す る 。 0 は 特 別 な 場 合 で 、 プ ロ パ テ ィ そ の も の に 対 応 す る フ ィ ー ル ド サ イ ズ 情 報 を 使 う こ と を 意 味 す る 。 (こ れ は 、 プ ロ パ テ ィ の フ ィ ー ル ド の サ イ ズ に よ っ て 3つ の 異 な る 型 と な る INTEGER 型 の よ う な 、 特 別 な 場 合 に の み 必 要 と な る 。 ) 値 が 8 の 場 合 に は 、 プ ロ パ テ ィ は バ イ ト 列 で あ り 、 16の 場 合 に は プ ロ パ テ ィ は ワ ー ド 列 で あ る 。 こ の 2つ の 違 い は 、 プ ロ パ テ ィ を 出 力 し た 元 の マ シ ン と は 逆 の バ イ ト 順 を 持 つ マ シ ン で プ ロ パ テ ィ を 読 み だ し た 場 合 、 ワ ー ド 列 で は バ イ ト 交 換 が 行 わ れ る が 、 バ イ ト 列 で は バ イ ト 列 が 行 わ れ な い と い う 点 で あ る 。 プ ロ パ テ ィ の フ ォ ー マ ッ ト や 格 納 の 方 法 に 関 す る 詳 し い 情 報 に つ い て は 、 Xlib の マ ニ ュ ア ル を 参 照 す る こ と 。 フ ィ ー ル ド の サ イ ズ が 指 定 さ れ る と 、 そ れ ぞ れ の フ ィ ー ル ド の 型 を 指 定 す る 必 要 が あ る (つ ま り 、 整 数 、 文 字 列 、 ア ト ム な ど )。 こ れ は フ ィ ー ル ド ご と の フ ォ ー マ ッ ト 文 字 1文 字 を 使 っ て 指 定 す る 。 プ ロ パ テ ィ が 与 え た フ ォ ー マ ッ ト 文 字 よ り も 多 く フ ィ ー ル ド を 持 っ て い る 場 合 、 フ ォ ー マ ッ ト 文 字 の 数 を 越 え た 分 の フ ィ ー ル ド に 対 し て は 、 最 後 の フ ォ ー マ ッ ト 文 字 が 必 要 な だ け 繰 り 返 さ れ る 。 フ ォ ー マ ッ ト 文 字 列 と そ の 意 味 を 以 下 に 示 す :

32で な け れ ば な ら な い 。

す 。

て い る 。

は バ イ ト 列 を 表 す 。 こ の フ ォ ー マ ッ ト 文 字 と 共 に 使 え る の は サ イ ズ が 8の フ ィ ー ル ド だ け で あ る 。 こ の フ ィ ー ル ド は 大 抵 は 文 字 列 を 表 す た め に 使 わ れ る 。

テ キ ス ト 文 字 列 を 表 す 。 こ の フ ォ ー マ ッ ト 文 字 列 で 使 え る フ ィ ー ル ド の サ イ ズ は 8 だ け で あ る 。 こ の 文 字 列 は ICCCM 準 拠 の エ ン コ ー デ ィ ン グ で 使 わ れ る こ と と 、 出 力 さ れ る 前 に 現 在 の ロ ケ ー ル の エ ン コ ー デ ィ ン グ に 変 換 さ れ る こ と が 前 提 と な る 。

ウ ィ ン ド ウ ID 等 を 表 示 す る と き に 非 常 に 便 利 で あ る )。 プ ロ パ テ ィ が 各 32ビ ッ ト の フ ィ ー ル ド を 3つ 持 ち 、 そ の 最 初 の フ ィ ー ル ド が 符 号 付 き 整 数 、 2番 目 の フ ィ ー ル ド が 符 号 無 し 整 数 、 3つ め の フ ィ ー ル ド が ア ト ム で あ る も の の format は 32ica で あ る 。

format と は 異 な り 、 dformat の フ ォ ー マ ッ ト は あ ま り 厳 密 で は な い 。 dformat の 制 限 は 、 文 字 と ダ ッ シ ュ で 始 ま っ て は な ら な い こ と だ け で あ る 。 こ れ は 、 プ ロ パ テ ィ 名 や オ プ シ ョ ン と 区 別 で き る よ う に す る た め で あ る 。 dformat は 、 printf で 使 わ れ て い る フ ォ ー マ ッ ト 文 字 列 と 同 様 の 方 法 で 様 々 な フ ィ ー ル ド に 様 々 な 場 所 に 表 示 さ せ る た め の 、 特 別 な 文 字 列 を 含 む テ キ ス ト 文 字 列 で あ る 。 例 え ば dformat が " is ( $0, $1 \)\n" で あ る 場 合 、 フ ォ ー マ ッ ト が 32ii で あ る POINT 3, -4 に 対 し て は " is ( 3, -4 )\n" と 表 示 さ れ る 。

dformat に 含 ま れ る $, ?, \, ( 以 外 の 文 字 は そ の ま ま 表 示 さ れ る 。 $, ?, \, ( を 表 示 す る に は そ の 文 字 の 前 に \ を 付 け る こ と 。 例 え ば 、 $ を 表 示 す る に は \$ と す る 。 バ ッ ク ス ラ ッ シ ュ を 使 っ た 特 殊 シ ー ケ ン ス の 中 に は シ ョ ー ト カ ッ ト と し て 使 わ れ る も の が あ る 。 例 え ば 、 \n は 改 行 文 字 を 表 示 さ せ 、 \t は タ ブ 文 字 を 表 示 さ せ る 。 ま た 、 \o (oは 10進 数 )は 、 文 字 コ ー ド が o で あ る 文 字 を 表 示 さ せ る 。

$ の 後 に 数 字 n を 続 け る と 、 番 号 n の フ ィ ー ル ド が 表 示 さ れ る 。 表 示 さ れ る フ ィ ー ル ド の フ ォ ー マ ッ ト は 、 対 応 す る format で フ ォ ー マ ッ ト を 記 述 す る た め に 使 わ れ て い る フ ォ ー マ ッ ト 文 字 に よ っ て 決 ま る 。 つ ま り 、 基 数 が ’c’ で 記 述 さ れ て い る 場 合 は 10進 数 で 表 示 さ れ 、 ’x’ で 記 述 さ れ て い る 場 合 に は 16進 数 で 表 示 さ れ る 。 フ ィ ー ル ド が プ ロ パ テ ィ に 含 ま れ て い な い 場 合 (こ の よ う な プ ロ パ テ ィ が い く つ か あ る )、 そ の 代 わ り に <field not available> が 表 示 さ れ る 。 $n+ は 、 番 号 n の フ ィ ー ル ド 、 コ ン マ 、 番 号 n+1 の フ ィ ー ル ド 、 コ ン マ 、 ... の よ う な 表 示 を 、 定 義 さ れ て い る 最 後 の フ ィ ー ル ド ま で 続 け る 。 フ ィ ー ル ド n が 定 義 さ れ て い な い 場 合 に は 、 何 も 表 示 さ れ な い 。 こ れ は 値 の リ ス ト に な っ て い る プ ロ パ テ ィ を 表 示 す る 際 に 便 利 で あ る 。

? は 条 件 式 、 つ ま り if-then 分 の よ う な も の を 始 め る と き に 使 う 。 ?exp(text)は 、 exp を 評 価 し た 値 が ゼ ロ 以 外 の 時 に 限 っ て text を 表 示 す る 。 こ れ は 次 の 2点 に お い て 有 効 で あ る 。 第 一 に 、 フ ラ グ が セ ッ ト さ れ て い る 時 に 限 っ て 表 示 を 行 う こ と が 可 能 に な る 。 第 二 に 、 状 態 数 を 単 な る 数 字 と し て で は な く 、 名 前 と し て 表 示 す る こ と が 可 能 に な る 。 exp の 文 法 を 以 下 に 示 す :

! 演 算 子 は 論 理 演 算 の 「 not(否 定 )」 で あ り 、 0 を 1 に 変 化 さ せ 、 0で な い 値 を 0に 変 化 さ せ る 。 = は 等 値 演 算 子 で あ る 。 内 部 的 に は 全 て の 式 は 32ビ ッ ト の 数 と し て 表 現 さ れ る た め 、 -1 と 65535 は 異 な る 値 で あ る 点 に 注 意 す る こ と 。 = は 2つ の 値 が 等 し い 場 合 に は 1 を 返 し 、 異 な る 場 合 に は 0 を 返 す 。 n は 定 数 n を 表 し 、 $n は 番 号 n の フ ィ ー ル ド の 値 を 表 す 。 mn は 、 対 応 す る format に お い て フ ォ ー マ ッ ト 文 字 が ’m’ で あ る 最 初 の フ ィ ー ル ド が 持 つ 番 号 n の フ ラ グ が 1 な ら ば 1 を 返 し 、 そ う で な け れ ば 0 を 返 す 。 例 : ?m3(count: $3\n) は 、 (0か ら 数 え て )番 号 3の フ ラ グ が 立 っ て い る 場 合 に の み フ ィ ー ル ド 3 に count と い う ラ ベ ル を 付 け て 表 示 す る 。 ?$2=0(True)?!$2=0(False) は 、 フ ィ ー ル ド 2 の 真 偽 値 の 反 対 の 値 を 表 示 す る 。 プ ロ パ テ ィ を 表 示 す る に は 、 xprop は format と dformat の 両 方 を 表 示 す る 。 xprop は 、 format の デ フ ォ ル ト 値 32x と dformat の デ フ ォ ル ト 値 " = { $0+ }\n" を 使 う 前 に 、 よ り 細 か い フ ォ ー マ ッ ト の 検 索 を 試 み 、 い く つ か の 場 所 を 調 べ る 。 ま ず 、 プ ロ パ テ ィ 名 を 使 っ て 検 索 が 行 わ れ る 。 こ れ が 失 敗 す る と プ ロ パ テ ィ の 型 を 使 っ て 検 索 が 行 わ れ る 。 こ れ に よ り 、 あ る フ ォ ー マ ッ ト の セ ッ ト を 使 っ て STRING 型 を 定 義 す る 一 方 で 、 STRING 型 で あ る プ ロ パ テ ィ WM_NAME を こ れ と 異 な る フ ォ ー マ ッ ト で 定 義 す る こ と が で き る 。 こ の よ う に し て 、 特 定 の プ ロ パ テ ィ に 対 し て は 与 え ら れ た 型 の 表 示 フ ォ ー マ ッ ト を 上 書 き す る こ と が で き る 。 検 索 は 次 の 順 序 で 行 わ れ る : (も し あ れ ば )プ ロ パ テ ィ 名 で 指 定 さ れ た フ ォ ー マ ッ ト (WM_NAME で は 8x)、 -f オ プ シ ョ ン で 指 定 さ れ た フ ォ ー マ ッ ト (最 後 の 指 定 か ら 最 初 の 指 定 へ の 順 )、 (も し あ れ ば )-fs オ プ シ ョ ン で 指 定 し た フ ァ イ ル の 内 容 、 (も し あ れ ば )環 境 変 数 XPROPFORMATS で 指 定 し た フ ァ イ ル の 内 容 、 xprop に 組 み 込 み の フ ォ ー マ ッ ト の フ ァ イ ル 。

-fs オ プ シ ョ ン や 環 境 変 数 XPROPFORMATS で 参 照 さ れ る フ ァ イ ル の フ ォ ー マ ッ ト は 、 以 下 の 形 式 の 行 を 1つ 以 上 持 つ も の で あ る 。

name format [dformat]

name は プ ロ パ テ ィ 名 か 型 の 名 前 で あ り 、 format は name と 共 に 使 わ れ る format で あ り 、 dformat は name と 共 に 使 わ れ る dformat で あ る 。 dformat を 省 略 し た 場 合 に は 、 " = $0+\n" が 指 定 さ れ た も の と し て 処 理 さ れ る 。

例

ル ー ト ウ ィ ン ド ウ の 名 前 を 表 示 : xprop -root WM_NAME

clock に 対 す る ウ ィ ン ド ウ マ ネ ー ジ ャ ヒ ン ト を 表 示 : xprop -name xclock WM_HINTS カ ッ ト バ ッ フ ァ の 先 頭 部 分 を 表 示 : xprop -root -len 100 CUT_BUFFER0 固 定 幅 フ ォ ン ト の ポ イ ン ト サ イ ズ を 表 示 : xprop -font fixed POINT_SIZE

ID 0x200007 の ウ ィ ン ド ウ の 全 て の プ ロ パ テ ィ を 表 示 : xprop -id 0x200007

環 境 変 数

XPROPFORMATS

xprop が 取 得 す る 追 加 的 な フ ォ ー マ ッ ト の 内 容 を 含 む フ ァ イ ル の 名 前 を 指 定 す る 。

関 連 項 目

X(7), xwininfo(1)

著 者

Mark Lillibridge, MIT Project Athena