使用 netcfg 命令配置配置文件

netcfg(1M) 手册页中描述了 netcfg 命令，该命令用于配置网络配置文件的属性和值。

可使用 netcfg 命令执行以下任务：

• 创建或销毁用户定义的配置文件。

  ---

  注 - 不能创建或销毁系统定义的配置文件。

  ---

• 列出系统中的所有配置文件及其属性值。

• 列出指定配置文件的所有属性值和资源。

• 显示与配置文件关联的每个属性。

• 设置或修改指定配置文件的一个或所有属性。

• 将用户定义的配置文件的当前配置导出到标准输出或文件。

  ---

  注 - 不能导出系统定义的配置文件。

  ---

• 删除对配置文件所做的任何更改并恢复为该配置文件以前的配置。

• 验证配置文件具有有效的配置。

可在交互模式、命令行模式、命令文件模式下使用 netcfg 用户界面。因为 netcfg 命令是分层的，所以在交互模式下使用时更易理解。

范围的概念用于 netcfg 命令。以交互方式使用该命令时，您在任何给定时间所处的范围取决于配置文件类型和您正在执行的任务。当您在终端窗口键入 netcfg 命令后，显示的提示符将位于全局范围内。

在这里，您可以使用 select或 create 子命令查看、修改或创建以下顶层配置文件：

• NCP

• 位置

• ENM

• 已知 WLAN

创建或选择一个配置文件之前，netcfg 交互式提示将以如下形式显示：

netcfg>

已创建或选择一个配置文件之后，netcfg 交互式提示的显示如下：

netcfg:profile-type:profile-name>

有关使用 netcfg 命令的分步说明，请参见第 4 章。有关使用 netcfg 命令的更多信息，请参见 netcfg(1M) 手册页。

netcfg 交互模式

在 netcfg 交互模式下，选择或创建顶层配置文件将导致命令提示符显示在位置配置文件和 ENM 的配置文件范围内。例如：

netcfg> select loc foo
netcfg:loc:foo>

如果选择了 NCP，命令提示符将显示在 NCP 范围 内。在 NCP 范围内，可以选择或创建 NCU。选择或创建 NCU 会导致配置文件范围提示您选择 NCU。在此范围内，可以查看和设置所有与当前选定的配置文件相关联的属性，如以下示例中所示。在该示例中，先选择了 User NCP，然后在该 NCP 范围内创建了一个 NCU。此操作导致配置文件范围应用在新创建的 NCU。在此范围内，可以查看或设置 NCU 的属性：

netcfg> select ncp User
netcfg:ncp:User> create ncu phys net2
Created ncu 'net2'.  Walking properties ...
activation-mode (manual) [manual|prioritized]>

在任何给定的范围内，命令提示符都指示当前选定的配置文件。在此范围内对配置文件所做的任何更改都可以提交，这意味着更改将保存到持久性系统信息库。退出范围时会隐式提交更改。如果不希望提交对选定的配置文件所做的更改，可以恢复到该配置文件上次提交的状态。此操作将恢复对在这一级别的配置文件所做的任何更改。revert 和 cancel 子命令产生的效果相似。

netcfg 命令行模式

在命令行模式下，任何影响选定的配置文件或属性的子命令，都必须在该选定配置文件或属性所在的特定范围内执行。例如，要获取 NCU 的属性的值，应在该特定 NCU 的范围内使用 get 子命令。在 netcfg 交互模式下，很容易理解此命令所使用的语法。但是，在命令行模式下，语法可能不太明显。

例如，“foo”属性是 User NCP 中名为 myncu 的 NCU 的一个属性，要获取该属性的值，应使用以下语法：

$ netcfg "select ncp User; select ncu ip myncu; get foo"

在此示例中，请注意以下信息：

• 各个范围之间用分号分隔。

• 在每个范围内都发出 select 子命令，一次是在全局范围内发出，一次是在配置文件范围内发出。

• get 子命令是在属性“foo”所在的范围内使用的。

• 需要使用直双引号，以防止 shell 解释分号。

netcfg 命令文件模式

在命令文件模式下，配置信息取自一个文件。export 子命令用于生成此文件。然后可以将配置打印到标准输出，也可以使用 -f 选项指定一个输出文件。export 子命令也能以交互方式使用。有关更多信息，请参见netcfg 支持的子命令。

netcfg 支持的子命令

交互模式和命令行模式支持以下 netcfg 子命令。注意某些子命令在各范围内有不同的语义。如果某个子命令不能在某种模式下使用，会在该子命令的说明中指出

• cancel

  结束当前配置文件指定而不将当前更改提交到持久性存储，接着继续进行到前一范围，前一范围是一个更高的级别。

• clear prop-name

  清除指定属性的值。

• commit

  将当前配置文件提交到持久性存储。要提交，配置必须正确。因此，此操作也将自动对配置文件或对象执行 verify。使用 end 或 exit 子命令退出当前范围时，会自动尝试 commit 操作。

• create [ -t template ] object-type [ class ] object-name

  用指定的类型和名称创建内存配置文件。-t template 选项指定新的配置文件与 template 完全相同，其中 template 是相同类型的现有配置文件的名称。如果未使用 -t 选项，就会使用缺省值创建新的配置文件。

• destroy -a

  从内存和持久性存储中删除所有用户定义的配置文件。

• destroy object-type [ class ] object-name

  从内存和持久性存储中删除指定的用户定义的配置文件。

  ---

  注意 - 此操作是即时操作，不需要提交。已销毁的配置文件无法恢复。

  ---

• end

  结束当前配置文件指定，继续进行到前一范围，前一范围是一个更高的级别。结束编辑操作之前会验证并提交当前配置文件。如果 verify 或 commit 操作失败，将显示一条错误消息。然后，您可以选择结束操作而不提交当前更改，也可以保持在当前范围内并继续编辑配置文件。

• exit

  退出 netcfg 交互式会话。在当前会话结束之前会验证并提交当前配置文件。如果 verify 或 commit 操作失败，将显示一条错误消息。然后，您可以选择结束会话而不提交当前更改，也可以保持在当前范围内并继续编辑配置文件。

• export [ -d ] [- f output-file ] [ object-type [ class ] object-name ]

  将当前范围内或指定范围内的当前配置打印到标准输出或使用 -f 选项指定的文件。-d 选项生成 destroy -a 子命令作为输出的第一行。此子命令生成的输出采用适合在命令文件中使用的格式。

  ---

  注 - 无法导出系统定义的配置文件（包括“自动”NCP“自动”、“无网络”和“原有”位置）。

  ---

• get [ -V ] prop-name

  获取指定属性的内存当前值。缺省情况下，属性名称和值都会打印。如果指定了 -V 选项，只打印属性值。

• help [ subcommand ]

  显示一般帮助或关于特定主题的帮助。

• list [-a] [object-type [ class ] object-name ]

  列出在当前或指定范围内将使用的所有配置文件、属性值对、资源。如果指定了 -a 选项，将列出所有属性，包括那些根据当前设置将被忽略的属性。

• revert

  删除先前对配置文件所做的任何当前更改，然后恢复到持久性存储中的值。

• select object-type [ class ] object-name

  选择指定的对象。

• set prop-name= value

  设置指定属性的内存当前值。

  如果在命令行模式下执行，更改也会立即提交到持久性存储。

  多值属性的分隔符是逗号 (,)。如果给定属性的某个值包含逗号，逗号前面必须加反斜杠 (\)。包含在只有一个值的属性内的逗号不解释为分隔符，也不需要在逗号前面加反斜杠。

• verify

  验证内存当前配置文件或对象具有有效的配置。

• walkprop [-a]

  “遍历”与当前配置文件相关联的每个属性。对于每个属性，将显示名称和当前值。会提供提示，使您能够更改当前值。如果根据先前指定的值，某个属性未使用，则不显示该属性。例如，如果 ipv4-addrsrc 属性设置为 static，ipv4-addr 属性未使用，因而不会遍历或列出，除非指定 -a 选项。

  如果使用 -a 选项，该选项将迭代指定的配置文件或对象的所有可用属性。

  多值属性的分隔符是逗号 (,)。如果给定属性的某个值包含逗号，逗号前面必须加反斜杠 (\)。包含在只有一个值的属性内的逗号不解释为分隔符，也不需要在逗号前面加反斜杠。

  ---

  注 - 此子命令仅在交互模式下使用时有意义。

  ---

有关与任务相关的信息，请参见第 4 章。