rmpath コマンド

目的

MPIO 可能なデバイスへのパスをシステムから除去します。

構文

rmpath {[ -dev 名前 ] [ -pdev 親 ] [ -conn 接続 ]} [ -rm ]

説明

rmpath コマンドは、指定されたターゲット・デバイス (-dev Name) に関連する 1 つ以上のパスの構成解除、また場合によっては定義の解除を行います。 除去されるパスの設定は、-dev Name、-pdev Parent および -conn Connection フラグの組み合わせによって決まります。 このコマンドを実行した結果、デバイスに関連付けられたすべてのパスが構成解除または定義解除される場合は、このコマンドはエラーで終了し、パスの構成解除または定義解除は行われません。 このような場合は、ターゲット・デバイス自体を構成解除または定義解除するのではなく、 rmdev コマンドを使用する必要があります。

デフォルトのアクションは、指定されたそれぞれのパスを構成解除しますが、 システムからそれを完全に除去することはしません。 -rm フラグが指定されると、rmpath コマンドは、システムからの 1つ以上のパス定義の構成解除 (必要な場合) と除去、または削除を行います。

rmpath コマンドは終了時に、状況メッセージを表示します。 パスを構成解除するときは、場合によっては、このコマンドが構成解除できるパスもがあれば、できないパスもあります (例えば、I/O の途中のパスは構成解除できません)。

rmpath コマンドは、操作の結果についての状況メッセージを提供します。 次のいずれかのフォーマットのメッセージが生成されます。
path [ defined | deleted ]
このメッセージは、単一のパスが正常に構成解除または定義解除されたときに表示されます。 パスが正常に構成されると、使用可能なメッセージ・パスが表示されます。 パスが正常に構成されずに、メソッドによって明示的なエラー・コードが戻されない場合は、定義されたメッセージ・パスが表示されます。
paths [defined | deleted]
このメッセージは、複数のパスが指定され、すべてのパスが正常に 構成解除または定義解除された場合に表示されます。 -rm フラグが指定されない場合、メッセージは定義済みパスになります。 -rm フラグが指定さる場合、メッセージは「paths deleted」になります。
some paths [ defined | deleted ]
このメッセージは、複数のパスを指定したけれども、そのいくつかだけが 正常に構成解除または定義解除された場合に表示されます。 -rm フラグが指定されない場合、メッセージは一部の定義済みパスになります。 -rm フラグが指定される場合、メッセージは一部の削除済みパスになります。
no paths processed
このメッセージは、選択基準に一致したパスがなかった場合に生成されます。

フラグ

フラグ名 説明
-rm 指定されたパスをシステムから削除することを指示します。
-dev Name パスを除去するターゲット・デバイスの論理デバイス名を指定します。 除去されるパスは、-pdev フラグおよび -conn フラグによって修飾されます。
-pdev Parent 除去するパスを修飾するときに使用する親デバイスの論理デバイス名を示します。 このコマンドでは、デバイスへのすべてのパスを除去できないため、このフラグか、-conn フラグか、あるいはその両方を指定する必要があります。
-conn 接続 除去するパスを修飾するために使用する接続情報を示します。 このコマンドでは、デバイスへのすべてのパスを除去できないため、このフラグか、-pdev フラグか、あるいはその両方を指定する必要があります。

終了状況

Virtual I/O Server コマンドの終了状況を参照してください。

例

  1. 1. 接続 5、0 の scsi0 から hdisk1 へのパスを構成解除するには、次のように入力します。
    rmpath -dev hdisk1 -pdev scsi0 -conn "5,0"
    次のようなメッセージが生成されます。
    path defined
  2. scsi0 から hdisk1 へのすべてのパスを構成解除するには、次のように入力します。
    rmpath -dev hdisk1 -pdev scsi0
    すべてのパスが正常に構成解除されると、次のようなメッセージが生成されます。
    paths defined
    しかし、パスの一部だけが正常に構成解除された場合は、次のようなメッセージが生成されます。
    some paths defined
  3. 接続 5、0 の scsi0 および hdisk1 間のパス定義を解除するには、次のように入力します。
    rmpath -rm -dev hdisk1 -pdev scsi0 -conn "5,0"
    次のようなメッセージが生成されます。
    path deleted
  4. scsi0 から hdisk1 へのすべてのパスを構成解除するには、次のように入力します。
    rmpath -rm -dev hdisk1 -pdev scsi0
    次のようなメッセージが生成されます。
    paths deleted

関連情報

chpath コマンド、 lspath コマンド、および rmpath コマンドを使用します。