名 前
sysfs − フ ァ イ ル シ ス テ ム (file system) の 情 報 を 取 得 す る
書 式
int sysfs(int option, const char *fsname);
int sysfs(int option, unsigned int fs_index, char *buf);
int sysfs(int option);
説 明
sysfs() は 現 在 カ ー ネ ル (kernel) に 存 在 し て い る フ ァ イ ル シ ス テ ム の 型 (type) 情 報 を 返 す 。 そ れ ぞ れ の sysfs() コ ー ル の 形 式 と 返 さ れ る 情 報 は option に 依 存 し て お り 、 そ れ は :
|
1 フ ァ イ ル シ ス テ ム 識 別 文 字 列 |
(identifier string) fsname を フ ァ イ ル シ |
ス テ ム の 型 イ ン デ ッ ク ス (type index) に 翻 訳 す る 。
|
2 フ ァ イ ル シ ス テ ム の 型 イ ン デ ッ ク ス |
fs_index を ヌ ル 終 端 さ れ た フ ァ イ ル シ |
ス テ ム 識 別 文 字 列 に 翻 訳 す る 。 こ の 文 字 列 は buf で 指 定 さ れ た バ ッ フ ァ ー へ 書 き 込 ま れ る 。 buf に 文 字 列 を 入 れ る だ け の 十 分 な 容 量 が あ る こ と を 確 か め る こ と 。
|
3 現 在 カ ー ネ ル に 存 在 す る フ ァ イ ル シ ス テ ム 型 の 数 の 合 計 を 返 す 。 フ ァ イ ル シ ス テ ム の 型 イ ン デ ッ ク ス の 数 は ゼ ロ か ら 始 ま る 。 |
返 り 値
成 功 し た 場 合 sysfs() は 、 オ プ シ ョ ン 1 で は フ ァ イ ル シ ス テ ム の イ ン デ ッ ク ス を 返 す 。 オ プ シ ョ ン 2 で は ゼ ロ を 返 す 。 オ プ シ ョ ン 3 は 現 在 設 定 さ れ て い る フ ァ イ ル シ ス テ ム の 数 を 返 す 。 エ ラ ー の 場 合 は 、 −1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。
エ ラ ー
|
EFAULT |
fsname と buf の ど ち ら か が ア ク セ ス 可 能 な ア ド レ ス 空 間 の 外 に あ る 。 | ||
|
EINVAL |
fsname が 正 し い フ ァ イ ル シ ス テ ム の 型 識 別 子 で は な い ; fs_index が 範 囲 の 外 に あ る ; option が 正 し く な い 。 |
準 拠
SVr4.
注 意
こ の System−V 由 来 の シ ス テ ム コ ー ル は 廃 止 予 定 (obsolete) で あ り 、 使 用 し な い こ と 。 /proc が 利 用 で き る シ ス テ ム で は 、 同 じ 情 報 が /proc/filesystems 経 由 で 取 得 で き 、 こ の イ ン タ ー フ ェ ー ス を 使 用 す る こ と 。
バ グ
libc ま た は glibc の サ ポ ー ト は 存 在 し な い 。 buf の 大 き さ が ど れ だ け 必 要 か を 推 測 す る 方 法 が な い 。
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。