mkpath 命令

在线编辑

用途

向系统添加另一个到支持 MPIO 设备的路径。

语法

mkpath [ -l 名称 ] [ -p Parent ] [ -w 连接 ] [ -i PathID]

mkpath [ -l 名称 ] [ -p 父 ] [ -w 连接 ] [ -d ]

mkpath -h

描述

mkpath 命令定义且可能配置到目标设备（-l Name）的一个或多个路径。 路径由 -l Name、-p Parent 和 -w Connection 标志的组合来标识。 目标设备和父设备都必须在系统中事先定义以定义一个路径。 它们都必须是“可用的”以配置路径。

如果指定了 -d 标志，mkpath 命令只定义到系统的新路径。 如果没有指定 -d 标志，那么当路径不存在时 mkpath 命令在试图配置该路径前先试图定义该路径。 配置一个路径要求已经定义了该路径并且该设备和父设备都已进行了配置。

一旦完成，mkpath 命令就会显示一条状态信息。 某些路径可能可以配置而其他的则无法配置。

注意任何不能使用 mkdev 命令来手动定义的设备将无法手动定义路径以使用 mkpath 命令。 为这些设备存储路径信息的方式导致了这些限制。 光纤通道设备属于该类别。

mkpath 命令提供了关于操作结果的状态消息。 将生成下列格式之一的消息：
path [ available | defined ]
当 mkpath 在单独一个路径上运行时，显示该消息。 如果成功地配置了该路径，显示消息“路径可用”。 如果未成功配置该路径且没有该方法返回的明确的错误码，显示消息“路径已定义”。
路径可用
如果定义了多个路径并且成功配置了所有的路径，那么显示该消息。
某些路径可用
如果定义了多个路径但只成功配置了部分路径，那么显示该消息。
没有处理任何路径
如果没有找到与选择标准匹配的路径，那么显示该消息。

标志

项 描述
-d 通过将路径定义添加到系统来定义到设备的一条新路径。 当指定了 -d 标志时，将不会自动配置新路径。 注意一次只可以定义一个路径。
-h 显示命令用法的消息。
-i PathID 指示与所要添加的路径相关联的路径标识，并用于唯一地标识路径。 该标志不能和 -d 标志配合使用。
-l 名称 指定路径添加到的目标设备的逻辑设备名。 要添加的路径由 -p 和 -w 标志来限定。
-p 父级 表示与要添加的路径相关的父设备的逻辑设备名。 如果指定了 -d 标志，那么需要该标志。
-w 连接 表示与要添加的路径相关的连接信息。 如果指定了 -d 标志，那么需要该标志。

安全性

特权控制：只有 root 用户和系统组成员有该命令的执行权限。

审计事件：
事件 信息
DEV_Change mkpath,定义,<定义方法参数>
DEV_Change mkpath,Configure,<configure method arguments> 配置方法参数

示例

  1. 要定义和配置一个已定义的路径，该路径位于 SCSI ID 5 和 LUN 0（例如，连接 5,0）的 scsi0 与 hdisk1 设备之间，请输入：
    mkpath -l hdisk1 -p scsi0 -w 5,0
    系统显示与以下内容类似的消息：
    path available
  2. 要配置一个已定义的路径，该路径从‘fscsi0’到光纤通道磁盘‘hdisk1’，命令为：
    mkpath -l hdisk1 -p fscsi0
    该消息将类似于：
    path available
  3. 要只将路径定义添加到 Customized Paths 对象类，该定义位于 SCSI ID 5 和 LUN 0 的 scsi0 与 hdisk1 磁盘设备之间，请输入：
    mkpath -d -l hdisk1 -p scsi0 -w 5,0
    系统显示与以下内容类似的消息：
    path defined

文件

项 描述
/usr/sbin/mkpath 包含 mkpath 命令。