Displaying Information About Profile States

You can use the netadm command with the list subcommand to display all of the available profiles on a system and their current state, or to display a specific profile and its state. For information about the netadm subcommands, see netadm Subcommands.

The syntax for the list subcommand is as follows:

netadm 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:

$ netadm list
TYPE         PROFILE        STATE
ncp          DefaultFixed   disabled
ncp          ncp1           disabled
ncp          Automatic      online
ncu:phys     net0           online
ncu:phys     net1           offline
ncu:ip       net0           online
ncu:ip       net1           offline
loc          Automatic      online
loc          NoNet          offline
loc          User           disabled
loc          DefaultFixed   offline
$

In this example, the current state is displayed for every system-defined and user-defined profile that is on the system. 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.

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

The following example lists the current state of profiles named Automatic, which has been specified by name.

$ netadm list Automatic
TYPE         PROFILE        STATE
ncp          Automatic      online
ncu:ip       net1           offline
ncu:phys     net1           offline
ncu:ip       net0           online
ncu:phys     net0           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.

$ netadm list -p loc
TYPE         PROFILE        STATE
loc          office         disabled
loc          NoNet          offline
loc          Automatic      online
$

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

$ netadm list -c ip
TYPE         PROFILE         STATE
ncu:ip       net0            online
ncu:ip       net1            disabled
$

Displaying 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:

$ netadm list -x
TYPE        PROFILE        STATE          AUXILIARY STATE
ncp         DefaultFixed   disabled       disabled by administrator
ncp         ncp1           disabled       disabled by administrator
ncp         Automatic      online         active
ncu:phys    net0           online         interface/link is up
ncu:phys    net1           offline        interface/link is down
ncu:ip      net0           online         interface/link is up
ncu:ip      net1           offline        conditions for activation are unmet
loc         Automatic      offline        conditions for activation are unmet
loc         NoNet          offline        conditions for activation are unmet
loc         office         online         active
loc         DefaultFixed   offline        conditions for activation are unmet
$

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