Obtaining Information About Profile States

You can use the nwamadm command with the list subcommand to display of all of the available profiles on a system and their current state, or to display a specific profile and its state.

The syntax for the list subcommand is as follows:

nwamadm list [ -p profile-type ] [ -c ncu-class ] [ profile-name ]

For example, to display all of the profiles on a system and their state, you would type the following command:

$ nwamadm list
TYPE         PROFILE        STATE
ncp          User           disabled
ncp          Automatic      online
ncu:ip       bge1           offline
ncu:phys     bge1           offline
ncu:ip       bge0           online
ncu:phys     bge0           online
loc          foo            disabled
loc          test           disabled
loc          Legacy         offline
loc          NoNet          offline
loc          Automatic      online
$

In this example, every system-defined and user-defined profile that is on the system and its current state is displayed. Note that the list subcommand displays the enabled NCP and all of the NCUs that make up that particular NCP.

Displaying the Current State of a Profile

The profile type and NCU class can be included in the command syntax to identify a specific profile. If only a profile type is provided, all of the profiles that are of that type are displayed. If a profile is specified by name, the current state of that profile is displayed. If the profile name is not unique, all of the profiles with that name are listed.

Possible state values for each profile include the following:

disabled

Indicates a manually activated profile that has not been enabled.

offline

Indicates a conditionally activated or system-activated profile that has not been activated. The profile might not be active because its conditions have not been satisfied or because another profile with more specific conditions that have been met is active.

---

Note - The offline state occurs more often in the case of profile types that must be activated one at a time, such as the Location profile.

---

online

Indicates a conditionally activated or system-activated profile that has conditions that have been met and that has been successfully activated. Or, a manually activated profile that has been successfully enabled at the user's request.

maintenance

Indicates that the activation of the profile was attempted, but the activation failed.

initialized

Indicates that the profile is valid, but no action has been taken on the profile.

uninitialized

Indicates that the profile is not present in the system. For example, this state can occur when an NCU that corresponds to a physical link is removed from the system.

Example 4-1 Displaying the Current State of a Specified Profile

The following example lists the current state of the Automatic NCP, which has been specified by name:

$ nwamadm list Automatic
TYPE         PROFILE        STATE
ncp          Automatic      online
ncu:ip       bge1           offline
ncu:phys     bge1           offline
ncu:ip       bge0           online
ncu:phys     bge0           online
loc          Automatic      online

In the following example, the list subcommand is used with the -p option to display all of the locations that are currently on the system:

$ nwamadm list -p loc
TYPE         PROFILE        STATE
loc          foo            disabled
loc          test           disabled
loc          Legacy         offline
loc          NoNet          offline
loc          Automatic      online
$

In the following example, the list subcommand is used with the -c option to display all of the IP NCUs in the currently active NCP:

$ nwamadm list -c ip
TYPE         PROFILE         STATE
ncu:ip       bge0            online
ncu:ip       bge1            disabled
$

Auxiliary State Values

The auxiliary state of a profile provides an explanation about why a given profile is online or offline (enabled or disabled). To list auxiliary state values, use the -x option with the list subcommand, as shown in the following example:

$ nwamadm list -x
TYPE         PROFILE        STATE          AUXILIARY STATE
ncp          User           offline        conditions for activation are not met
ncp          Automatic      online         active
 ncu:phys    iwk0           offline*       scanning for available networks on WiFi link
 ncu:ip      iwk0           online         interface or link is up
 ncu:phys    e1000g0        online         interface or link is up
 ncu:ip      e1000g0        online         interface or link is up
loc          Automatic      online         active
loc          NoNet          offline        conditions for activation are not met
loc          Legacy         offline        conditions for activation are not met

Auxiliary state values vary, depending on the profile type. For detailed information about auxiliary states, see the nwamd(1M) man page.