AIX命令参考大全，卷 3，i - m - lspath 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全，卷 3，i - m

lspath 命令

用途

显示关于到允许多路径 I/O（MPIO）的设备的路径信息。

语法

lspath [ -F Format ] [ -H ] [ -l Name ] [ -p Parent ] [ -s Status ] [ -w Connection ]

lspath -A -l Name -p Parent [ -w Connection ] {-D [ -O ] | -E [ -O ] | -F Format [ -Z character ] } [ -a Attribute ] ...[ -f File ] [ -h ] [ -H ]

lspath -A -l Name -p Parent [ -w Connection ] { -D [ -O ] | -F Format [ -Z character ] } [ -a Attribute ] ... [ -f File ] [ -h ] [ -H ]

lspath -A -l Name -p Parent [ -w Connection ] -R -a Attribute [ -f File ] [ -h ] [ -H ]

lspath -h

描述

lspath 命令显示关于到允许 MPIO 的设备路径的两类信息之一。它或者显示到单独设备的一条或多条路径的操作状态，或者显示到单个允许 MPIO 的设备的单独路径的一个或多个属性。以上显示的第一个句法显示了到特定的允许 MPIO 的设备的一个或多个路径的操作状态。在此例中，lspath 命令类似于 lsdev 命令。第二个语法（以 -A 标志的存在为关键字） 显示特定的到允许 MPIO 的设备的单独路径的一个或多个属性。在此例中，lspath 命令类似于 lsattr 命令。事实上，在显示路径属性的时候， lspath 命令支持 lsattr 命令的所有标志。

使用 lspath 命令显示路径状态

当显示路径状态的时候，显示的路径集由在设备配置数据库中搜索符合以下条件的路径来获取：

如果没有指定 -l、-p、-w、-s 标志，那么显示系统已知的所有路径。

缺省情况下，此命令以列格式显示信息。当没有指定限定要显示的路径的标志时，输出格式为： 

状态 设备 父代

缺省显示格式可以使用 -F Format 标志覆盖。-F Format 标志以用户指定的格式显示输出，其中 Format 参数是字段名称引用列表，由非字母数字字符或空格分隔，也可能由它们结尾。字段名称为定义在 CuPath 类中的字段 或上述定义的列标题之一。

注:
以上的列名称没有翻译为其他语言（或者作为列标题输出的时候， 或者作为 -F 标志的 Format 的一部分输入的时候）。

状态列可能出现的值为：

启用
表示路径已经配置过，可以使用了。在为 IO 选择路径的时候会考虑它。
禁用
表示路径已经配置过，但是现在不可使用。它已经被手工禁用，当为 IO 选择路径的时候不会考虑它。
失败
表示路径已经配置过，但是存在 IO 故障致使其不可使用。当为 IO 选择路径的时候不会考虑它。
已定义
表示路径还没有被配置进设备驱动程序中。
丢失
表示路径在前一次引导中已经定义了，但是在最近一次系统引导中没有检测到它。
已检测到
表示在最近一次系统引导中检测到了路径，但是由于某种原因，没有配置它。 路径只会在引导过程中处于此状态，因此该状态不会成为 lspath 命令的结果。

使用 lspath 命令显示路径属性

当显示路径属性的时候，路径必须被全限定。可以显示路径的多个属性，但是属于多个路径的属性不可能通过 一次调用 lspath 命令来显示。因此，除了 -A 标志之外， 还需要 -l、-p 或 -w 标志来唯一标识单一路径。例如：

此外，不允许使用 -s 标志。

lsattr 命令用于显示设备属性的同样的规则 也适用于 lspath 命令用于显示路径属性。

缺省情况下，此命令以列格式显示信息。 输出的格式与 lsattr 命令相同：

属性    值      描述         用户可设置

缺省情况下显示所有的字段。缺省显示格式可以使用 -F Format 标志覆盖。-F Format 标志以用户指定的格式显示输出，其中 Format 参数是列名引用列表，由非字母数字字符或空格分隔符，也可能由它们结尾。允许的列名是 CuPathAt、PdPathAt 和 PdAtXtd 对象类的字段名加上以上列出的列。基于 PdAtXtd 的信息用于基于 Web 的系统管理器。

注:
以上的列名称没有翻译为其他语言（或者作为列标题输出的时候， 或者作为 -F 标志的 Format 的一部分输入的时候）。

标志

-a Attribute 标识了要列出的指定属性。‘Attribute’是特定于路径的属性名。在提供了该标志的时候，仅显示识别的属性。可以使用该标志的多个实例来列出多属性。 如果根本没有指定该标志，那么会列出与该已标识的路径相关的所有属性。
-A 表示要显示特定路径的属性。当出现 -A 标志时，不允许 -s Status 标志。然而，为了全限定路径，必须使用 -l Name、-p Parent 和 -w Connection 标志。
-D 当不与 -O 标志一起使用时，为特定路径显示属性名、缺省值、描述和用户可设置的标志值。当与 -O 标志一起使用的时候，-D 标志仅以 冒号格式显示属性名称和缺省值。该标志仅在显示路径属性的时候有效， 而且它不能和 -E、-F 或 -R 标志一起使用。
-E 当没有与 -O 标志一起使用时，为特定路径显示属性名、当前值、描述和用户可设置的标志值。当与 -O 标志一起使用的时候，-E 标志仅以 冒号格式显示属性名称和当前值。该标志仅在显示路径属性的时候有效， 而且它不能和 -D、-F 或 -R 标志一起使用。
-f File 从 File 参数中读取需要的标志。
-F Format 以用户指定格式显示输出，其中 Format 参数为预定义或定制设备对象类中的列名引用列表，这些列名由非字母数字字符或空格分隔。lspath 命令使用空格作为分隔符， 以对齐列格式显示输出。 有效列名称依赖于所请求的信息类型。为了显示路径，可以指定来自 CuPath 对象类的列名称。 为了显示路径属性（指定了 -A 标志）， 可以指定来自 PdPathAt 和 CuPathAt 对象类的列名称。除了列名称之外，还 可以使用两个特殊用途的名称。名称描述可以用来获得属性描述的显示， 而用户可设置可以用来获取属性是否可更改的指示。 该标志不能和 -E、-D、-O 或 -R 标志一起使用。
-h 显示命令用法消息。
-H 在列输出上面显示头部分。将 -H 标志和 -O 标志一起使用是无意义的， 将使用 -O 标志。将 -H 标志和 -R 标志一起使用是无意义的， 将使用 -R 标志。
-l Name 指定需要显示路径信息的目的设备的逻辑设备名。 对于显示路径状态来说，该标志是可选的，但是对于显示路径属性来说是必需的。
-O 显示由冒号隔开的所有属性名称， 并在第二行上显示由冒号隔开的相对应的属性值。 当还指定了 -E 标志的时候，属性值为当前值，而当指定了 -D 标志的时候，属性值为缺省值。该标志仅在显示路径属性的时候有效， 而且它不能与 -F 和 -R 标志一起使用。
-p Parent 表示要显示的路径的父设备的逻辑设备名称。 对于显示路径状态来说，该标志是可选的，但是对于显示路径属性来说是必需的。
-R 显示属性名称的合法值。-R 标志不能与 -D、-E、-F 和 -O 标志一起使用。 -R 标志以垂直列方式显示列属性值，如下： 
Value1
Value2
.
.
ValueN
-R 标志显示范围属性值为 x...n(+i)，其中 x 为范围的开始，n 为范围的结束，i 为递增量。
-s Status -s Status 标志显示要在将显示的限定路径上使用的状态。在显示路径信息的时候，该标志允许的值为：
enabled
显示对于 MPIO 路径选择为启用的路径。
disabled
显示对于 MPIO 路径选择为禁用的路径。
failed
显示由于 IO 错误而失败的路径。
available
显示其 path_status 为 PATH_AVAILABLE 的路径（即在系统中配置的路径，包括启用、禁用和丢失路径）。
defined
显示 path_status 为 PATH_DEFINED 的路径。
missing
显示 path_status 为 PATH_MISSING 的路径。
-w Connection 表示链接信息用于限定要显示的路径。 对于显示路径状态来说，该标志是可选的，但是对于显示路径属性来说是必需的。
-Z Character -Z Character 标志通常用于需要处理 ODM 字符的程序，该字符可能已经嵌入换行字符。基于 Web 的系统管理器就是这类程序的一个示例。-Z Character 标志用于为每个生成的输出记录（行）更改记录分隔符。新的记录分隔符为该标志的 'Character' 变量。只有指定了 -A 和 -F Format 标志，才与 -Z Character 标志有关。 -Z Character 标志不能与 -D、-E、-O 或 -R 标志一起使用。

安全性

特权控制：所有用户可以执行此命令。

审计事件：无。

示例

显示路径状态示例：

  1. 为了带有列的头部分显示 hdisk1 上所有路径的状态，请输入： 
    lspath -H -l hdisk1
    系统将显示与以下类似的消息： 
    状态   设备     父代
启用   hdisk1   scsi0
禁用   hdisk1   scsi1
丢失   hdisk1   scsi2
  2. 要不带列标题显示其操作状态为禁用的路径集，请输入： 
    lspath -s disabled
    系统将显示与以下类似的消息： 
    禁用  hdisk1   scsi1
禁用  hdisk2   scsi1
禁用  hdisk23  scsi8
禁用  hdisk25  scsi8
  3. 要显示操作状态为失败的路径集，请输入： 
    lspath -s failed
    系统将显示与以下类似的消息： 
    失败  hdisk1   scsi1
失败  hdisk2   scsi1
失败  hdisk23  scsi8
失败  hdisk25  scsi8
  4. 要不带列标题使用用户指定的格式显示到路径状态可用的 hdisk1 的路径集，请输入： 
    lspath -l hdisk1 -s available -F"connection:parent:path_status:status"
    系统显示的信息类似于如下： 
    5,0：scsi0：可用：启用
6,0：scsi1：可用：禁用
    注意，此输出同时显示了设备的路径状态和操作状态。 路径状态简单地表示路径是否已经配置。 操作状态表示在考虑设备驱动程序中的路径选择处理的前提下，如何使用路径。 只有有可用路径状态的路径才有操作状态。 如果路径当前没有配置到驱动程序中，那么它没有操作状态。

显示路径属性示例：

  1. 如果目标设备是 SCSI 磁盘，为了显示连接 5,0 上的到父 scsi0 的路径，请使用命令： 
    lspath -AHE -l hdisk10 -p scsi0 -w "5,0"
    系统将显示与以下类似的消息： 
    属性    值      描述              用户可设置
weight  1    故障转移选择路径顺序  true

相关信息

chpath 命令、mkpath 命令、rmpath 命令。

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]