Manpages

Available in

Contents

• 名 前
• 書 式
• 説 明
• 返 り 値
• エ ラ ー
• 準 拠
• 注 意
• 関 連 項 目
• COMMENTS

名 前

ioctl − デ バ イ ス (device) を 制 御 す る

書 式

#include <sys/ioctl.h>

int ioctl(int d, int request, ...);

説 明

ioctl() 関 数 は ス ペ シ ャ ル ・ フ ァ イ ル を 構 成 す る デ バ イ ス の パ ラ メ ー タ を 操 作 す る 。 特 に 、 キ ャ ラ ク タ 型 の ス ペ シ ャ ル ・ フ ァ イ ル (例 え ば 端 末 (terminal)) の 多 く の 操 作 可 能 な 特 性 を ioctl() リ ク エ ス ト に よ っ て 制 御 す る こ と が で き る 。 引 き 数 d は オ ー プ ン さ れ た フ ァ イ ル ・ デ ィ ス ク リ プ タ で な け れ ば な ら な い 。

2番 目 の 引 き 数 は 、 デ バ イ ス 依 存 の リ ク エ ス ト ・ コ ー ド で あ る 。 3番 目 の 引 き 数 は 、 メ モ リ へ の 型 を 指 定 し な い ポ イ ン タ で あ る 。 こ の 引 き 数 は 伝 統 的 に (C で void * が 有 効 に な る 前 か ら ) char *argp と 表 記 さ れ て い る 。 し た が っ て 、 こ の 文 章 で も そ の よ う に 名 付 け る こ と と す る 。

ioctl() request に は 、 以 下 の 情 報 を バ イ ト 数 で エ ン コ ー ド す る : (1)引 き 数 が 入 力 パ ラ メ ー タ か 出 力 パ ラ メ ー タ の ど ち ら か で あ る か 、 (2) argp の 大 き さ 。 ioctl() request を 指 定 す る た め の マ ク ロ (macro)と 定 義 は <sys/ioctl.h> フ ァ イ ル に あ る 。

返 り 値

ioctl() requests use the return value as an output parameter た い て い の 場 合 、 成 功 し た 場 合 は ゼ ロ が 返 さ れ る 。 い く つ か の ioctl() 要 求 で は 出 力 パ ラ メ ー タ と し て 返 り 値 を 使 用 し て い た り 、 成 功 し た 場 合 に 非 0 の 値 を 返 し た り す る 。 エ ラ ー の 場 合 は −1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。

エ ラ ー