SCIOSTUNIT (装置開始) SCSI アダプター・デバイス・ドライバーの ioctl 操作
目的
選択した SCSI 装置に対して SCSI Start Unit コマンドを発行する手段を提供します。
説明
SCIOSTUNIT操作により、呼び出し元は選択されたSCSIアダプタにSCSI Start Unitコマンドを発行することができる。 このコマンドは、SCSI 装置の構成を支援するために、システム管理ルーチンによって使用することができます。 SCIOSTUNITオペレーションでは、argパラメータはsc_startunit構造体のアドレスです。 この構造体は /usr/include/sys/scsi.hファイルで定義されている。
sc_startunit構造体により、呼び出し元は、起動する SCSI アダプター上のデバイスの SCSI ID と論理ユニット番号（LUN）ID を指定できる。 SC_ASYNCフラグ（渡されたパラメータ・ブロックのフラグ・バイト内）は、このコマンドの最初の試行時に設定されてはならない。
このstart_flagフィールドで、SCIOSTUNIT操作の開始オプションを指定します。 使用中のstart_flagフィールドがTRUEに設定されている場合、論理ユニットを使用可能な状態にする。 FALSE の場合、論理装置は停止されます。
注意を指定した場合immed_flagフィールドが TRUE に設定されている場合、 SCSI アダプタ・デバイス・ドライバは、接続されているすべてのデバイスに対して同時にSCIOSTUNIT操作を許可します。 SCSI Start Unitコマンドを同時に実行する場合、呼び出し元は、SCSI Start Unitコマンドの連続操作の間に少なくとも10秒の遅延を与えることが重要である。 この遅延により、共通の電源機構を共用する装置が十分な電力を使用できるようになります。 この方法で遅延させないと、システム・ユニットや接続された機器に損傷を与える可能性があります。 特定の装置の技術仕様書、およびご使用のシステムに該当するハードウェア技術解説書を参照してください。
このimmed_flagフィールドは、SCIOSTUNIT操作の即時オプションを示す。 使用中のimmed_flagフィールドが TRUE に設定されている場合、デバイスがコマンドを受信するとすぐにステータスが返される。 フィールドが FALSE に設定されている場合、操作の完了後に状況が返されます。 呼び出し側はimmed_flagフィールドを TRUE に設定することで、SCSI バス上の複数のデバイスに対する「SCIOSTUNIT操作のオーバーラップを許可する。 この場合、SCIOTUR操作を使用して、SCIOSTUNIT が実際にいつ完了したかを判断することができます。
戻り値
正常に完了すると、SCIOSTUNITオペレーションは値 0 を返します。 そうでない場合は-1が返され、 errnoグローバル変数に以下の値のいずれかが設定される：
| 値 | 説明 |
|---|---|
| EFAULT | カーネルとユーザー・スペースの間で不良コピーが発生したことを示します。 |
| EINVAL | このコマンドの前にSCIOSTARTコマンドが発行されていないことを示す。 |
| EIO | リカバリー不能な入出力エラーが発生したことを示します。 EIOを受信した場合、最初のコマンドでデバイスのエラー状態がクリアされた可能性があるため、呼び出し側は少なくとも1回はこのコマンドを再試行すべきである。 回復されないエラーの場合、アダプタのエラー状態情報はシステム・エラー・ログに記録される。 |
| ENOCONNECT | バス障害が発生したことを示します。 呼び出し側は、渡されたパラメータのフラグバイトにSC_ASYNCフラグをセットして再試行することで応答すべきである。 複数のリトライが試みられた場合、SC_ASYNCフラグがセットされた最後のリトライのみが行われるべきである。 通常、SCSI アダプター・デバイス・ドライバーは、SCSI バス障害の原因となったデバイスを判別できないため、このエラーはログに記録されません。 |
| ENODEV | 要求された SCSI ID に対して SCSI コントローラーが応答しなかったことを示します。 この状態は必ずしもエラーではなく、ログに記録されません。 |
| ENOMEM | コマンドを完了するために使用できるメモリーが不足していることを示します。 |
| ETIMEDOUT | 内部コマンド・タイムアウト値が期限切れになる前に、アダプターが状況で応答しなかったことを示します。 ETIMEDOUTを受信した場合、最初のコマンドでデバイスのエラー状態がクリアされた可能性があるため、呼び出し側は少なくとも1回はこのコマンドを再試行すべきである。 このエラーは、システム・エラー・ログに記録されます。 |
ファイル
| 項目 | 説明 |
|---|---|
| /dev/scsi0, /dev/scsi1,..., /dev/scsin | SCSI デバイス・ドライバーが SCSI デバイスまたはアダプターにアクセスできるようにするインターフェースを提供します。 |
| /dev/vscsi0, '/dev/vscsi1,..., /dev/vscsin | SCSI-2 Fast/Wide アダプター /A および SCSI-2 Differential Fast/Wide Adapter/A デバイス・ドライバーが SCSI デバイスまたはアダプターにアクセスできるようにするインターフェースを提供します。 |