GETWIFI man page

SYNOPSIS

getwifi [ -hisv ]

getwifi handles the precedence of joining wireless networks

OPTIONS

 usage: getwifi [options]

 -h   --help             Show the help message
 -i   --interactive      Interactive mode"
 -s   --scan             Scan for wireless networks
 -v   --version          Show the version

DESCRIPTION

This tool allows a user to specify which networks they would like to join in order. It also provides dynamic configuration of selected ssid's based upon user specification.

Options include: highest precedence or highest signal strength.

EXAMPLE of Similar Configuration of ESSID networks

The following is an example of a config file that defines the various ssid's that will be used.

        # getwifi config file
        DEVICE = wlan0
        TYPE = static
        CONNECT = precedence
        SIMILAR = yes
        IP = 10.0.0.20
        SUBNET = 255.255.255.0
        GATEWAY = 10.0.0.1
        ####
        #### SET 2 ####
        # if the networks are similar
        # List of Networks

        #PROFILE
        ESSID = vanderbilt
        #PROFILE
        ESSID = jimdeb
        #PROFILE
        KEY = f8fed0bfeaf8fecdbf
        ESSID = djimeb
        #PROFILE
        ESSID = jabra.dyndns.org
        #### END SET 2 ####
        #end

DEVICE

Name of the device you would like to use to join wireless networks

TYPE ( dhcp || static )

Can either be dhcp or static depending on what type of connection you would like.

SIMILAR ( currently needs to be set to yes to have a similar configuration)

"no" for a none similar configuration is not yet supported

IP

IP address for connection with static ip address

SUBNET

Subnet for connection with static ip address

GATEWAY

Router or Gateway for connection with static ip address

#PROFILE

This indicates that this is a set of configurations. A ESSID is needed for each profile. If no KEY is specified for the profile the key is set to off.

ESSID

Name of the network for a given profile that you would like to join in order.

KEY

WEP key

NOT IMPLEMENTED

EXAMPLE of non-similar Configuration of ESSID networks

The following is an example of a config file that defines the various ssid's that will be used.

    # getwifi config file
    DEVICE = eth1
    SIMILAR = yes

    #### SET 1 ####
    # if the networks are not similar
    ESSID = vanderbilt
    DEVICE = wlan0
    RATE = auto
    KEY = off
    DHCP = false
    IP = 10.0.0.20
    SUBNET = 255.255.255.0

    ESSID = CCIS
    DEVICE = eth1
    RATE = 11M
    KEY = off
    DHCP = true
    #### END SET 1 ####

AUTHORS

Joshua D. Abraham <jabra at ccs.neu.edu>

This document was created by man2html, using the manual pages.
Time: 01:34:31 GMT, September 29, 2005