scsi_hba_detach(9F) (SunOS リファレンスマニュアル 9 : DDI/DKI カーネル関数)

SunOS リファレンスマニュアル 9 : DDI/DKI カーネル関数

scsi_hba_detach(9F)

名前

scsi_hba_attach_setup, scsi_hba_attach, scsi_hba_detach– SCSI HBA 接続および切り離しルーチン

形式

#include <sys/scsi/scsi.h>

dip

hba_dma_attr

hba_tran

hba_flags

dip

hba_lim

hba_tran

hba_flags

hba_options

dip

インタフェースレベル

Solaris アーキテクチャ固有 (Solaris DDI)。

パラメータ

dip: dev_info_t 構造に対するポインタで、HBA デバイスのインスタンスを参照します。
hba_lim: ddi_dma_lim(9S) 構造に対するポインタ。
hba_tran: scsi_hba_tran(9S) 構造に対するポインタ。
hba_flags: フラグ修飾子。唯一の定義済みフラグ値は、SCSI_HBA_TRAN_CLONE です。
hba_options: 将来の拡張に備えて HBA ドライバによって提供されるオプションの機能で、NULL でなければなりません。
hba_dma_attr: ddi_dma_attr(9S) 構造に対するポインタ。

機能説明

scsi_hba_attach_setup() は、scsi_hba_attach() に代わる推奨インタフェースです。

scsi_hba_attach_setup() および scsi_hba_attach() に関して：

scsi_hba_attach() は、DMA 限界値 hba_lim と、dip によって定義される HBA デバイスの各インスタンスの転送ベクトル hba_tran を登録します。scsi_hba_attach_setup() は、DMA 属性 hba_dma_attr と、dip によって定義される HBA デバイスの各インスタンスの転送ベクトル hba_tran を登録します。HBA ドライバは、異なる DMA 限界値または DMA 属性、および必要に応じてデバイスの各インタフェースに対する転送ベクトルを渡すことができ、HBA 自身によって課せられたいかなる制約にも対応します。

scsi_hba_attach() および scsi_hba_attach_setup() は、dev_ops(9S) 構造内の dev_bus_ops フィールドを使用します。 HBA ドライバは、scsi_hba_attach() または scsi_hba_attach_setup() を呼び出す前に、このフィールドを NULL に初期化する必要があります。

SCSI_HBA_TRAN_CLONE が hba_flags で要求される場合、hba_tran 構造は、各ターゲットが HBA に接続されるたびに 1 回複製されます。構造の複製は、ターゲットを初期化するために tran_tgt_init(9E) エントリポイントが呼び出される前に行われます。後続のすべての HBA エントリポイント ( tran_tgt_init(9E) も含めて) で、引数として渡された、または scsi_address 構造で検出された scsi_hba_tran_t 構造は、「複製された」 scsi_hba_tran_t 構造になるので、HBA は、scsi_hba_tran_t の tran_tgt_private フィールドを使用してターゲットごとのデータを指定できます。HBA は、切り離しの際に割り当てられたものと同じ scsi_hba_tran_t 構造だけを注意して解放する必要があります。システムによって割り当てられたすべての「複製された」 scsi_hba_tran_t 構造は、システムによって解放されます。

scsi_hba_attach() および scsi_hba_attach_setup() は、同じ名前の属性がすでにそのノードに接続されていない限り、多数の整数値属性を dip に接続します。HBA ドライバは、これらの構成パラメータを ddi_prop_get_int(9F) を使用して検出し、HBA を提供した機能に対するあらゆる設定に従う必要があります。

scsi-options

省略可能な SCSI 構成ビット

SCSI_OPTIONS_DR: 設定しない場合、HBA はターゲットデバイスに切り離し (Disconnect) 特権を認可しません。
SCSI_OPTIONS_LINK: 設定しない場合、HBA はリンクされたコマンド (Linked Commands) を有効にしません。
SCSI_OPTIONS_TAG: 設定しない場合、HBA は、コマンドタグ付き待ち行列 (Command Tagged Queing) モードでは動作しません。
SCSI_OPTIONS_PARITY: 設定しない場合、HBA はパリティーモードでは作動しません。
SCSI_OPTIONS_QAS: 設定しない場合、HBA はクイックアービトレーション選択 (Quick Arbitration Select) 機能を利用しません。ご使用のマシンが QAS をサポートするかどうかは、サンのハードウェアマニュアルで確認してください。
SCSI_OPTIONS_FAST: 設定しない場合、HBA は、バスを FAST SCSI モードで機能させません。
SCSI_OPTIONS_FAST20: 設定しない場合、HBA は、バスを FAST20 SCSI モードで機能させません。
SCSI_OPTIONS_FAST40: 設定しない場合、HBA は、バスを FAST40 SCSI モードで機能させません。
SCSI_OPTIONS_FAST80: 設定しない場合、HBA は、バスを FAST80 SCSI モードで機能させません。
SCSI_OPTIONS_FAST160: 設定しない場合、HBA は、バスを FAST160 SCSI モードで機能させません。
SCSI_OPTIONS_FAST320: 設定しない場合、HBA は、バスを FAST320 SCSI モードで機能させません。
SCSI_OPTIONS_WIDE: 設定しない場合、HBA は、バスをWIDE SCSI モードで機能させません。
SCSI_OPTIONS_SYNC: 設定しない場合、HBA は、バスを同期転送モードで機能させません。

scsi-reset-delay

SCSI バスまたはデバイスのリセット回復時間 (ミリ秒)。

scsi-selection-timeout

デフォルトの SCSI 選択フェーズタイムアウト値 (ミリ秒)。HBA 固有の情報については、HBA の各マニュアルページを参照してください。

scsi_hba_detach() に関して：

scsi_hba_detach() は、DMA 限界値または属性の構造および HBA ドライバの指定されたインスタンスに対する転送ベクトルへの参照を除去します。

戻り値

scsi_hba_attach()、scsi_hba_attach_setup()、および scsi_hba_detach() は、関数の呼び出しに成功すると DDI_SUCCESS を返し、失敗すると DDI_FAILURE を返します。

コンテキスト

scsi_hba_attach() および scsi_hba_attach_setup() は、attach(9E) から呼び出されます。scsi_hba_detach() は、detach(9E) から呼び出されます。

注意事項

scsi_hba_detach() が呼び出された後に、SCSI ターゲットデバイスドライバの代わりに転送要求が行われないようにするのは HBA ドライバの役割です。

scsi_hba_attach() 関数は、古く、将来のリリースでは廃止されます。この関数は、scsi_hba_attach_setup() で置き換えられます。

SunOS 5.9 最終更新日 2003 年 8 月 15 日