AUTONET(1)

NAME
autonet - automatic network configuration for multiple networks

SYNOPSIS
autonet [-hvV] [-s device] [-u seconds] [start | stop | restart]

DESCRIPTION
autonet is intended to handle automatic network configuration on a machine which connects to a variety of different networks, such as a laptop.

This manpage is very much a work in progress

When started autonet will check for the first interface matching the following criteria:

•   An Ethernet interface with 'status: active'

•   An WEP configured access point via a IEEE802.11 interface with an ssid where there is an entry in rc.conf of the form: autonet_<ssid>_nwkey=0x13347d6e1e6b9dec884a9711a1

•   An non WEP configured access point via a IEEE802.11 interface.

CONFIGURATION
The following configuration options can be set in rc.conf:

autonet_<ssid>_nwkey
    WEP nwkey for a given ssid

autonet_<x>_ifconfig
    Parameters to pass to ifconfig instead of running dhclient. <x> can be an interface or an ssid

autonet_<x>_defaultroute
    Default route to set. <x> can be an interface or an ssid

autonet_media
    Order of media types to try. Default: "Ethernet IEEE802.11".

autonet_localscript
    Pathname of a local script to be called at various phases. This can be used to perform any additional configuration after a network interface is configured or before it is shutdown, such as starting or stopping daemons. Default: /etc/autonet.local

autonet_flags
    If an Ethernet interface needs to be brought up before it will register as active, can specify '-u <secs>' in autonet_flags to cause interfaces to be be brought up followed by a sleep of <secs> before testing (Not required on a wm0 or ath0) The audio cues can also be disabled by specifying -s ""

dhclient should be set to NO in rc.conf. If you want autonet to stop and start other daemons such as named, ntp, they should also be set to NO, and /etc/autonet.local should call onestart and onestop

If /usr is separate to / then critical_filesystems_local should include /usr

EXAMPLES
An example for a static configuration on a WEP encrypted access point with an ssid of 'groundhog'.

    autonet_groundhog_nwkey=0xe20b93a2bee05c3cee2e9fcd03
    autonet_groundhog_ifconfig=192.168.1.253
    autonet_groundhog_defaultroute=192.168.1.1

AUTHORS

FILES

${PREFIX}/share/examples/autonet/autonet.local
    Sample autonet_localscript. Should be copied to /etc/autonet.local and modified for use

${PREFIX}/share/examples/autonet/lid_switch
    Sample powerd lid switch script. Can be copied to /etc/powerd/scripts/lid_switch for use

${PREFIX}/share/examples/rc.d/autonet
    rc.d script for automatic use on autonet on machine startup. Copy to /etc/rc.d/autonet for use

BUGS
There is no general purpose way to describe a set of rc.d scripts to be run on autonet start and autonet stop. eg 'autonet_xxxx=YES in rc.conf'

On successful configuration does not take down unused interfaces. This may turn out to be a useful feature if ifwatchd is used in conjunction with autonet to detect when ethernet cables are inserted and removed.

Cannot handle two disparate access points with the same SSID but requiring different configurations, unless one uses WEP and the other does not.

May have issues with SSIDs containing strange characters.

Has not been tested on anything other than NetBSD.

Only prelimiminary testing with ifwatchd - when called with 'ifwatchd -c /usr/pkg/bin/autonet -n /usr/pkg/bin/autonet wm0' ifwatchd appears to call autonet twice on an interface transition from no carrier to carrer.

Calls "wiconfig -D twice" on each interface, once to extract access points with WEP set, and a second time for those without WEP. Should only call once.