BUS_DESCRIBE_INTR(9) | FreeBSD Kernel Developer's Manual | BUS_DESCRIBE_INTR(9) |
名称
BUS_DESCRIBE_INTR, bus_describe_intr — アクティブな割り込みハンドラで記述を関連付ける書式
#include < sys/param.h>#include < sys/bus.h>
int
BUS_BIND_INTR( device_t dev, device_t child, struct resource *irq, void *cookie, const char *descr);
int
bus_describe_intr( device_t dev, struct resource *irq, void *cookie, const char *fmt, ...);
解説
BUS_DESCRIBE_INTR() メソッドは、アクティブな割り込みハンドラで記述を関連付けます。 cookie パラメータは、割り込み irq のために BUS_SETUP_INTR(9) への呼び出しが成功することによって返された値でなければなりません。bus_describe_intr() 関数は、 BUS_DESCRIBE_INTR() の周りの簡単なラッパです。便宜上、 bus_describe_intr() によって、呼び出し側は、 fmt を使用して記述文字列を構築するために printf(9) スタイルの形式を使用できます。
割り込みハンドラが BUS_SETUP_INTR(9) によって確立されるとき、ハンドラは、ハンドラが確立されるデバイスにちなんで名前が付けられます。この名前は、 systat(1) と vmstat(8) によって表示される割り込み統計のような様々な場所で使用されます。単一の割り込みを使用するデバイスに関して、デバイス名は、割り込みハンドラを識別するために十分ユニークです。しかしながら、複数の割り込みを使用するデバイスについて、それは、割り込みハンドラを区別するために役に立てることができます。記述が、アクティブな割り込みハンドラのために設定されるとき、記述に続くコロンは、割り込みハンドラ名を形成するためにデバイス名に追加されます。
戻り値
成功すれば、0 が返され、そうでなければ、適切なエラーが返されます。歴史
BUS_DESCRIBE_INTR() メソッドと bus_describe_intr() 関数は、 FreeBSD 8.1 ではじめて登場しました。バグ
現在、アクティブな割り込みハンドラから記述を取り除くことはできません。October 14, 2009 | FreeBSD |