NAME
nwamadm - administer network configuration profiles

SYNOPSIS
nwamadm enable [ -t profile-type ] profile-name
nwamadm disable [ -t profile-type ] profile-name
nwamadm list [ -t profile-type ] [ -n profile-name ]

DESCRIPTION

The nwamadm utility is used to administer NWAM profiles.  There are three
types of NWAM profiles: Network Configuration Profiles (NCPs), Locations, and
External Network Modifiers (ENMs).  See nwam(5) for an overview of profiles,
and their usage in the NWAM framework.

At any given time, there is one active NCP and one active Location on a system.
Enabling an NCP or Location will implicitly disable the current active NCP or
Location.  Explicitly disabling an NCP or Location has the effect of "turning
off" that aspect of the system's network configuration.  For example, if the
current NCP is disabled and no other NCP is then enabled, there will be no
configured links or interfaces on the system.

Conversely, there may be zero or more active ENMs at any given time.  Thus
enabling or disabling one ENM has no effect on other active ENMs.


SUBCOMMANDS

The following subcommands are supported.

enable [ -t <profile-type> ] <profile-name>

Enable the specified profile.  If the profile name is not unique, the profile
type must be specified to identify the profile to be enabled.  Profile type
must be one of ncp, location, or enm.


disable [ -t <profile-type> ] <profile-name>

Disable the specified profile.  If the profile name is not unique, the profile
type must be specified to identify the profile to be disabled.  Profile type
must be one of ncp, location, or enm.


list [ -t <profile-type> ] [ -n <profile-name> ]

List all available profiles and their current state.  If a specific profile is
specified by name, list only the current state of that profile.  If the profile
name is not unique, all profiles with the given name will be listed; or the
profile type may be included to identify a specific profile.  If only a type is
provided, list all profiles of that type.


SEE ALSO

nwamcfg(1M), nwamd(1M)


EXAMPLES

Example 1: Enable the automatic NCP
# nwamadm enable -t ncp automatic
Disabled ncp 'foo'.
Enabled ncp 'automatic'.
#

Example 2: Disable an ENM
# nwamadm disable -t enm myvpn
Disabled enm 'myvpn'.
#

Example 3: List all Locations
# nwamadm list -t location
TYPE		PROFILE		STATE
location	home		inactive
location	office		inactive
location	coffeeshop	active
#