JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Administration: Network Interfaces and Network Virtualization     Oracle Solaris 11 Information Library
search filter icon
search icon

Document Information


1.  Overview of the Networking Stack

Network Configuration in This Oracle Solaris Release

The Network Stack in Oracle Solaris

Network Devices and Datalink Names

Administration of Other Link Types

Part I Network Auto-Magic

2.  Introduction to NWAM

3.  NWAM Configuration and Administration (Overview)

Overview of NWAM Configuration

What Are Network Profiles?

Description of an NCP

Description of an NCU

Description of the Automatic and User-Defined NCPs

Description of a Location Profile

Description of an ENM

About Known WLANs

NWAM Configuration Data

NCU Property Values

Property Values of System-Defined Locations

How NWAM Profiles Are Activated

NCP Activation Policy

Example of an NCP Policy

NCU Activation Properties

Location Activation Selection Criteria

Configuring Profiles by Using the netcfg Command

netcfg Interactive Mode

netcfg Command-Line Mode

netcfg Command-File Mode

netcfg Supported Subcommands

Administering Profiles by Using the netadm Command

Overview of the NWAM Daemons

Description of the NWAM Policy Engine Daemon (nwamd)

Description of the NWAM Repository Daemon (netcfgd)

SMF Network Services

Overview of NWAM Security

Authorizations and Profiles That Are Related to NWAM

Authorizations That Are Required to Use the NWAM User Interfaces

4.  NWAM Profile Configuration (Tasks)

5.  NWAM Profile Administration (Tasks)

6.  About the NWAM Graphical User Interface

Part II Datalink and Interface Configuration

7.  Using Datalink and Interface Configuration Commands on Profiles

8.  Datalink Configuration and Administration

9.  Configuring an IP Interface

10.  Configuring Wireless Interface Communications on Oracle Solaris

11.  Administering Bridges

12.  Administering Link Aggregations

13.  Administering VLANs

14.  Introducing IPMP

15.  Administering IPMP

16.  Exchanging Network Connectivity Information With LLDP

Part III Network Virtualization and Resource Management

17.  Introducing Network Virtualization and Resource Control (Overview)

18.  Planning for Network Virtualization and Resource Control

19.  Configuring Virtual Networks (Tasks)

20.  Using Link Protection in Virtualized Environments

21.  Managing Network Resources

22.  Monitoring Network Traffic and Resource Usage



Configuring Profiles by Using the netcfg Command

The netcfg command, which is described in the netcfg(1M) man page, is used to configure properties and values of network profiles.

You can use the netcfg command to perform the following tasks:

You can use the netcfg user interface in interactive mode, command-line mode, or command-file mode. Because the netcfg command is hierarchical, it is more easily understood when used in the interactive mode.

The concept of a scope is used for the netcfg command. When you use the command interactively, the scope you are in at any given time depends on the profile type and the task that you are performing. When you type the netcfg command in a terminal window, a prompt is displayed at the global scope.

From here, you can use the select or create subcommands to view, modify, or create the following top-level profiles:

Before creating or selecting a profile, the netcfg interactive prompt is displayed in the following form:


After you have created or selected a profile, the netcfg interactive prompt is displayed as follows:


Note - In command-line mode, you must type the complete command on a single line. Changes that you make to a selected profile by using the netcfg command in command-line mode are committed to the persistent repository as soon as you finish typing the command.

For step-by-step instructions on using the netcfg command, see Chapter 4, NWAM Profile Configuration (Tasks). For more information about using the netcfg command, see the netcfg(1M) man page.

netcfg Interactive Mode

Selecting or creating a top-level profile while working in the netcfg interactive mode results in a command prompt that is displayed in the profile scope for Location profiles and ENMs. For example:

netcfg> select loc foo

If an NCP is selected, the command prompt is displayed is in the NCP scope. From the NCP scope, an NCU can be selected or created. Selecting or creating an NCU results in a profile scope prompt for the selected NCU. In this scope, all of the properties that are associated with the currently selected profile can be viewed and set, as shown in the following example where the User NCP was first selected, then an NCU was created in the NCP scope. This action resulted in the profile scope for the newly created NCU. In this scope, the properties of the NCU can be viewed or set:

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

At any given scope, the command prompt indicates the currently selected profile. Any changes that you make to the profile in this scope can be committed, meaning the changes are saved to the persistent repository. Changes are implicitly committed upon exiting the scope. If you do not want to commit the changes that you made to the selected profile, you can revert to the last committed state for that profile. Doing this action reverts any changes that you made to the profile at that level. The revert and cancel subcommands work similarly.

netcfg Command-Line Mode

In command-line mode, any subcommands that affect a selected profile or property must be performed in the particular scope that the selected profile or property exists. For example, to obtain the value of a property of an NCU, you would use the get subcommand in the scope of that particular NCU. When you are in the netcfg interactive mode, it is fairly easy to understand the syntax to use for this command. However, in command-line mode, the syntax might be less obvious.

For example, to obtain the value of a property “foo,” which is an attribute of an NCU called myncu in the User NCP, you would use the following syntax:

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

In this example, note the following information:

netcfg Command-File Mode

In command-file mode, configuration information is taken from a file. The export subcommand is used to produce this file. The configuration can then be printed to standard output or the -f option can be used to specify an output file. The export subcommand can be used interactively also. For more information, see netcfg Supported Subcommands.

netcfg Supported Subcommands

The following netcfg subcommands are supported in interactive mode and command-line mode. Note that certain subcommands have different semantics within each scope. If a subcommand cannot be used in a certain mode, it has been noted in the subcommand's description.

For task-related information, see Chapter 4, NWAM Profile Configuration (Tasks).