NAME

nwamadm – administer network configuration profiles

SYNOPSIS

nwamadm help
nwamadm enable [ -t  ] 
nwamadm disable [ -t  ] 
nwamadm list [ -t  ] [  ]
nwamadm interact [ -v ]
nwamadm help

DESCRIPTION

The nwamadm utility is used to administer NWAM profiles and interact with the NWAM daemon.

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 a different NCP or Location will implicitly disable the current active NCP or Location. The current Location may also be disabled, though the effect of this will be to "turn off" some aspects of the system's networking capabilities, such as name services. Explicitly disabling an NCP is not permitted, as that would effectively shut down the basic network connectivity of the system. An NCP is only disabled implicitly when a different NCP is enabled.

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.

Enabling and disabling of individual link NCUs is also allowed; the specified NCU must be part of the currently active NCP, and must have its activation mode set to MANUAL.

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, ncu, loc, 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 ncu, loc, or enm.

list [ -t <profile-type> ] [ <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. Listing the active NCP will include the NCUs that make up that NCP.

Possible state values include:

• disabled: A manually-activated profile which has not been activated.
• offline: A conditionally- or system-activated profile which has not been activated. It may not be active because its conditions have not been satisfied; or it may be that another profile has more specific conditions that are met and has been activated instead (in the case of profile types which must be activated one at a time, such as NCPs and Locations.
• online: A conditionally- or system-activated profile whose conditions have been met and which has been successfully activated; or a manually-activated profile which has been successfully activated at the request of the user.
• maintenance: Activation of the profile was attempted, but failed.
• uninitialized: The profile represents a configuration object not present in the system; for example, an NCU corresponding to a physical link that has been removed.

interact [ -v ]

Listen for events from the NWAM daemon, requesting user input (such as selection of a WLAN, or entry of a key) when needed. By default, only events requesting information are displayed; if the -v (verbose) option is specified, all events will be displayed.

help

Print a usage message with short descriptions for each subcommand.

SEE ALSO

netcfgd(1M), nwamcfg(1M), nwamd(1M), nwam-manager(1M)

EXAMPLES

Example 1: Enable a user-specified location
# nwamadm enable -t loc office
Disabled loc 'home'.
Enabled loc 'office'.
#

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

Example 3: List all NCPs
# nwamadm list -t ncp
TYPE    PROFILE        STATE
ncp     User           online
 ncu    bge0           online
 ncu    bge1           disabled
ncp     Automatic      offline
#