Wiki code for nwamd(1M)

Hide Line numbers
1: |System Administration Commands|           |nwamd(1M)
2: 
3: == NAME
4: 
5:  nwamd - network auto-magic daemon
6: 
7: == SYNOPSIS
8: 
9:  /lib/inet/nwamd
10: 
11: == DESCRIPTION
12: 
13:  nwamd is a system daemon to manage network interfaces.
14: 
15:  This daemon is started automatically and should not be invoked directly. It does not constitute a programming interface.
16: 
17: == OPERATION
18: 
19:  Whether this daemon is enabled or not depends on your installation medium. To check, enter the following at the command line:
20: 
21: {{{
22: 
23:      % svcs svc:/network/physical
24: 
25: }}}
26: 
27:  The two instances will be listed: one as disabled, the other as online. If the {{code}}nwam{{/code}} instance is online then this daemon will be running. The two instances correspond to the two modes of network configuration: the default instance is for manual mode, while the nwam instance is for auto-magic mode.
28: 
29:  To go from manual mode to auto-magic mode:
30: 
31: {{{
32: 
33:      % svcadm disable svc:/network/physical:default
34:      % svcadm enable svc:/network/physical:nwam
35: 
36: }}}
37: 
38:  To go from auto-magic mode to manual mode:
39: 
40: {{{
41: 
42:      % svcadm disable svc:/network/physical:nwam
43:      % svcadm enable svc:/network/physical:default
44: 
45: }}}
46: 
47:  Warning: when switching modes like this, all network interfaces will be brought down then back up, thus if a different IP address is configured in this process, existing applications and sessions may be disrupted.
48: 
49:  Note that in auto-magic mode, there is a limitation that only one link is active at a time. This mode is thus not recommended for machines which use more than one link at once. For machines with wired and wireless links, wired is preferred by default, although this can be adjusted by altering the order of the lines in the plain text file {{code}}/etc/nwam/llp{{/code}}. Note, however, that this interface is Volatile and may change in a future release.
50: 
51: == PROFILES
52: 
53:  Note that all interfaces listed in this section are Volatile and may change in a future release. They are documented here so that those wishing to experiment with this may do so.
54: 
55:  Profiles are a mechanism for making multiple related changes to the system configuration after IP service is available.
56: 
57:  There is not direct support for them yet, but a "roll your own" mechanism is provided for now. Once an interface is brought up and an IP address is configured for it, the daemon looks for {{code}}/etc/nwam/ulp/check-conditions{{/code}}; if it exists and is executable, it is run. This is expected to print a single line of output, which is the name of the profile which the user wishes to be activated based on the current conditions. If such a line is read successfully (//foo// in this example), then {{code}}/etc/nwam/ulp///foo///bringup{{/code}} is executed. Likewise, when the interface gets torn down for whatever reason, {{code}}/etc/nwam/ulp///foo///teardown{{/code}} is executed. The bringup and teardown scripts are invoked via {{code}}pfexec(1){{/code}} with default basic privileges. Samples for each of these scripts can be found at:
58: 
59: * [[http://opensolaris.org/os/project/nwam/prototype/check-conditions>>Project nwam.check-conditions]]
60: * [[http://opensolaris.org/os/project/nwam/prototype/bringup>>Project nwam.bringup]]
61: * [[http://opensolaris.org/os/project/nwam/prototype/teardown>>Project nwam.teardown]]
62: 
63: == WIRELESS
64: 
65:  When no wired link is available, a scan for wireless LANs will be done, and the resulting list offered via a GUI pop-up to prompt the console user to select his/her preference. If a successful connection is made, the WLAN in question will be stored in the plain text file {{code}}/etc/nwam/known_wifi_nets{{/code}} and subsequently the daemon may connect to any WLAN in that list without prompting again. Should a user wish to revoke his/her preference for a WLAN in that list, editing the file and deleting the line with the entry should suffice. Note, however, that this interface is Volatile and may change in a future release.
66: 
67: == ATTRIBUTES
68: 
69:  See attributes(5) for descriptions of the following attributes:
70: 
71: |=ATTRIBUTE TYPE|=ATTRIBUTE VALUE
72: |Availability|SUNWcsr
73: |Interface Stability|Volatile
74: 
75: == SEE ALSO
76: 
77:  svcs(1), svcadm(1M), attributes(5), smf(5)
78: 
79: == NOTES
80: 
81:  The networking service is managed by the service management facility, smf(5), under the service identifier:
82: 
83: {{{
84: 
85:        svc:/network/physical
86: 
87: }}}
88: 
89:  Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The service’s status can be queried using the svcs(1) command.
OpenSolaris

Top Menu

Wiki code for nwamd(1M)

Search

Collectives

Community Group

Project

User Group

Subsites

Project nwam Pages
