Undocumented SMF Variables
NWAM Picea includes a set of special tuning variables that are
intentionally not documented in the nwamd(1M) man page. These are not
expected to be used, supported, or relied on, as they may change at
any time without notice, but some may be useful when debugging
failures or temporarily working around problems.
For each variable, you can set the value by issuing these commands:
# svccfg -s nwam nwamd///varname// = //value//
# svcadm refresh nwam
where varname is the name of the variable from the table below, and
value is a legal value for that variable.
- debug
This enables and disables debugging mode, where more information is
sent to syslog. By default, this is "false" and only certain
significant events are sent (using facility "daemon"). It can be
set to "true" to enable logging of all events. Use "daemon.debug"
in /etc/syslog.conf to capture these events.
- use_net_svc
This enables and disables the use of the 'start' method from the
svc:/network/service service. By default, this is "true", and
nwamd will internally invoke this service before a new ULP is
activated and DHCP is in use. It can be set to "false" to disable
use of this service.
- autoconf
This enables and disables the use of Wireless Autoconfiguration,
where the driver itself selects the AP to use. This feature is set
to "false" by default. Set to "true" to enable.
- dhcp_wait_time
The DHCP client will run forever on an interface, attempting to get
an address. NWAM does not control that behavior. However, it does
need to set an arbitrary period after which to declare "failure"
and attempt to use the next lower-priority interface. If a
higher-priority interface acquires DHCP information after this
timer goes off, the system will automatically switch back. The
default is 60 seconds, and can be set to any integer number of
seconds.
- scan_interval
This sets the rate at which the wireless thread will attempt to
verify the interface status and, if the interface is disconnected
or has "very weak" signal quality, will trigger a rescan for new
APs. The default is 120 seconds, and can be set to any integer
number of seconds. Setting the value to 0 disables this automatic
scanning and terminates the scanning thread.
- idle_time
This sets the maximum number of seconds between calls to the GUI
event-wait function before the internal state machine declares the
GUI to be "dead" and begins automatic operation using defaults
rather than contacting the user. The default is 10 seconds, and it
can be set to any integer number of seconds.
- strict_bssid
This enables and disables strict BSSID matching mode. This is set
to "false" by default, and we match only on ESSID for the purpose
of determining whether we've seen an AP before. When strict mode
is enabled (set to "true"), we count an AP as being "known" (and
thus eligible for automatic connection) only if the exact ESSID and
BSSID match our internal records in /etc/nwam/known_wifi_nets.