|Skip Navigation Links|
|Exit Print View|
|Oracle Solaris Administration: Network Interfaces and Network Virtualization Oracle Solaris 11 Information Library|
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.
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 User disabled ncp Automatic online ncu:ip net1 offline ncu:phys net1 offline ncu:ip net0 online ncu:phys net0 online loc foo disabled loc test disabled 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.
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:
Indicates a manually activated profile that has not been enabled.
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.
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.
Indicates that the activation of the profile was attempted, but the activation failed.
Indicates that the profile is valid, but no action has been taken on the profile.
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 5-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:
$ 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 foo disabled loc test 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 currently active NCP:
$ netadm list -c ip TYPE PROFILE STATE ncu:ip net0 online ncu:ip net1 disabled $
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 Automatic disabled disabled by administrator ncp User online active ncu:phys nge0 online interface/link is up ncu:ip nge0 online interface/link is up ncu:phys nge1 offline interface/link is down ncu:ip nge1 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
Auxiliary state values vary, depending on the profile type. For detailed information about auxiliary states, see the nwamd(1M) man page.