ディスクドライバをチューニングするビットマスク形式

ビットマスク形式 (Version1 形式とも呼ばれる) を使用して、パラメータをチューニングできます。このビットマスク形式には、プロパティー配列のエントリを格納する sd-config-list プロパティーが含まれます。

sd ドライバには次の構文を使用します。

sd-config-list = duplet [, duplet ]*;
sd-ver1-conf-data = 1, mask, value-sequence;

ssd ドライバには次の構文を使用します。

ssd-config-list = duplet [, duplet ]*;
sd-ver1-conf-data = 1, mask, value-sequence;

ここで duplet は「VIDPID」、「sd-ver1-conf-data」です。

VID

SCSI INQUIRY コマンドへのデバイス応答のベンダー ID (VID) フィールドの内容。VID フィールドは 8 文字の長さにする必要があります。ベンダー ID フィールドが 8 文字未満の場合、VID の長さが 8 文字になるように空白を追加する必要があります。

PID

SCSI INQUIRY コマンドへのデバイス応答の製品 ID (PID) フィールドの内容。PID には左揃えの 16 文字まで含めることができます。16 文字未満を指定した場合、比較は指定した PID の長さに制限されます。

sd-ver1-conf-data

1 のバージョン番号、マスク番号、および設定されるチューニング可能値から構成されるプロパティー配列。

mask

0x01 から 0x7FFFF までの値。mask の値は複数の目的のフラグの OR 結果にできる場合があります。表 3に、各チューニング可能パラメータのビット値を示します。

value-sequence

mask の値に対応する有効なプロパティー値と 0 の数のシーケンス。value-sequence の長さ制限は 19 文字です。チューニング可能パラメータのデータ型については、ディスクドライバのチューニング可能なパラメータを参照してください。

各ビットの位置の定義はプラットフォームによって異なります。チューニング可能パラメータは異なるプラットフォームの異なるフラグ値に対応する場合があります。Oracle Solaris 11 と Oracle Solaris 10 はどちらもビットマスク形式の同じ一連の 19 個のチューニング可能パラメータをサポートしています。

次の表に、さまざまなプラットフォームでのチューニング可能パラメータとそれらのフラグ値を示します。

表 3  さまざまなプラットフォームでサポートされるチューニング可能パラメータとそれらのフラグ値

ビット フラグ値 SPARC 上の sd ドライバ SPARC 上の ssd ドライバ x86 または x64 上の sd ドライバ 1 0x00001 throttle-max throttle-max throttle-max 2 0x00002 controller-type retries-notready controller-type 3 0x00004 retries-notready retries-busy fab-devid 4 0x00008 fab-devid fab-devid disable_caching 5 0x00010 disable_caching disable_caching BCD-play 6 0x00020 retries-busy controller-type BCD-read-subchannel 7 0x00040 BCD-play BCD-play BCD-read-TOC-TRK 8 0x00080 BCD-read-subchannel BCD-read-subchannel BCD-read-TOC-ADDR 9 0x00100 BCD-read-TOC-TRK BCD-read-TOC-TRK no-READ-HDR 10 0x00200 BCD-read-TOC-ADDR BCD-read-TOC-ADDR CD-read-XD4 11 0x00400 no-READ-HDR no-READ-HDR retries-notready 12 0x00800 CD-read-XD4 CD-read-XD4 retries-busy 13 0x01000 retries-reset retries-reset retries-reset 14 0x02000 timeout-releasereservation timeout-releasereservation timeout-releasereservation 15 0x04000 tur-check tur-check tur-check 16 0x08000 throttle-min throttle-min throttle-min 17 0x10000 disksort disksort disksort 18 0x20000 reset-lun reset-lun reset-lun 19 0x40000 cache-nonvolatile cache-nonvolatile cache-nonvolatile

使用例 6  x86 プラットフォーム上の sd ドライバのチューニング可能パラメータの構成

この例では x86 プラットフォームで sd.conf ファイル内のパラメータをチューニングする方法を示します。

sd-config-list = "SUM     ABC200_R","sd-ver1-x86-example";
sd-ver1-x86-example = 1,0x801,300,0,0,0,0,0,0,0,0,0,0,5,0,0,0,0,0,0,0;

この例では、デバイス SUM の VID は SUM で、PID は ABC200_R です。

マスク値 0x801 は 0x00800 および 0x00001 フラグのビット単位 OR 値です。これらの値は x86 プラットフォームでの retries-busy および throttle-max チューニング可能パラメータです。

使用例 7  SPARC プラットフォーム上の ssd ドライバのチューニング可能パラメータの構成

この例では SPARC プラットフォームで ssd.conf ファイル内のパラメータをチューニングする方法を示します。

ssd-config-list = "SUM     XYZ200_R","sd-ver1-ssd-example";
sd-ver1-ssd-example = 1,0x5,300,0,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0;

この例では、デバイス SUM の VID は SUM で、PID は XYZ200_R です。

マスク値 0x5 は 0x00004 および 0x00001 フラグのビット単位 OR 値です。これらの値は SPARC プラットフォームでの retries-busy および throttle-max チューニング可能パラメータです。

.conf ファイルに同じターゲットデバイスをチューニングする複数の sd-config-list または ssd-config-list エントリが含まれている場合、最初のエントリのみが有効になります。同じ VID と PID を持つ後続のエントリはすべて無視されます。この動作はビットマスク形式と name:value ペア形式のどちらでも同じです。

sd-config-list プロパティーに、同じ VID と PID を持つ複数の duplet が含まれる場合、エントリの順番で後の指定が優先され、以前の duplet に現れた値が置き換えられます。この動作はビットマスク形式と name:value ペア形式のどちらでも同じです。

ビットマスク形式では、value-sequence パラメータの長さが 19 文字を超える場合、 19 番目の文字より後の値は無視されます。value-sequence の長さが 19 文字未満の場合、構成結果はその前の mask 値によって異なります。mask 値のフラグが付けられたビットの対応する値の位置が空の場合、ターゲットドライバのそのプロパティーにランダムな値が割り当てられます。

ターゲットドライバは .conf ファイルの構文チェックを行わないため、チューニング可能パラメータ名のスペルミスや value-sequence の正しくないエントリなどのエラーについての警告メッセージを表示しません。