Setting and Changing Property Values of a Profile

Property values for new and existing user-defined profiles are set by using the nwamcfg command with the set subcommand. This subcommand can be used in interactive mode or in command-line mode. If a property value is set or changed in command-line mode, the change is immediately committed to persistent storage.

The syntax for the set subcommand is as follows:

nwamcfg set prop-name=value1[,value2...]

If you need to retrieve a specific property value, use the nwamcfg get command. For more information, see Obtaining Values of a Specific Property.

Example 3-8 Setting Property Values in Command-Line Mode

If you are using the nwamcfg command to set a property value in command-line mode, multiple subcommands can be typed on the command line.

For example, to set the mtu property for a link NCU named net1, you would type the following command:

$ nwamcfg "select ncp User; select ncu phys net1; set mtu=1492"

In this example, the select subcommand is used to select the top-level profile, then again to select the NCU that contains the mtu property value that is modified.

In the following example, the ip-version property value for the NCU myncu in the User NCP is set.

$ nwamcfg "select ncp User; select ncu ip myncu; set ip-version=ipv4"

Multiple properties can be set from the command line at the same time. When setting multiple properties, each property must be separated by a comma (,). If individual values for a specified property also contain a comma, the comma that is part of the property value must be preceded by a backslash (\,). Commas within properties that only have a single value are not interpreted as delimiters and therefore do not need to be preceded by a backslash.

Example 3-9 Interactively Setting Property Values for a Profile

When interactively setting property values, you must first select a profile at the current scope, which moves the interactive session into that profile's scope. From this scope, you can select the object whose property that you want to modify. The selected profile is then loaded into memory from persistent storage. At this scope, you can modify the profile or its properties, as shown in the following example:

$ nwamcfg
nwamcfg> select ncp User
nwamcfg:ncp:User> select ncu ip iwk0
nwamcfg:ncp:User:ncu:iwk0> set ipv4-default-route = 129.174.7.366

In the following example, the ipfilter-config-file property of the location foo is set:

$ nwamcfg
nwamcfg> list
NCPs:
   Automatic
   User
Locations:
   Automatic
   NoNet
   Legacy
   foo

nwamcfg> select loc foo
nwamcfg:loc:foo> list
LOC:foo
   activation-mode              manual
   enabled                      false
   nameservices                 dns
   dns-nameservice-configsrc    dhcp
   nameservices-config-file     "/etc/nsswitch.dns"
nwamcfg:loc:foo> set ipfilter-config-file=/no-file
nwamcfg:loc:foo> list
LOC:foo
   activation-mode              manual
   enabled                      false
   nameservices                 dns
   dns-nameservice-configsrc    dhcp
   nameservices-config-file     "/etc/nsswitch.dns"
   ipfilter-config-file         "/no-file"
nwamcfg:loc:foo> end
Committed changes
nwamcfg> exit
Nothing to commit
$

In the following example, the link-mtu property of the NCU bge0 in the User NCP is modified interactively.

$ nwamcfg
nwamcfg> select ncp User
nwamcfg:ncp:User> select ncu phys bge0
nwamcfg:ncp:User:ncu:bge0> list
NCU:bge0
   type                link
   class               phys
   parent              "User"
   enabled             true
   activation-mode     prioritized
   priority-mode       exclusive
   priority-group      1
nwamcfg:ncp:User:ncu:bge0> set link-mtu=5000
nwamcfg:ncp:User:ncu:bge0> list
NCU:bge0
   type                link
   class               phys
   parent              "User"
   enabled             true
   activation-mode     prioritized
   priority-mode       exclusive
   priority-group      1
   link-mtu            5000
nwamcfg:ncp:User:ncu:bge0> commit
Committed changes
nwamcfg:ncp:User:ncu:bge0> exit
Nothing to commit
$