% Ethernet connections
% Arch Linux
%

# Ethernet options reference

## Description
This connection method uses the iproute suite of tools and dhcpcd to gain an IP address.

## Options
INTERFACE (required)
:    The wireless interface to configure
IP (required for IPv4)
:   Can be either 'static' or 'dhcp'.  Static requires at least one of ADDR or IPCFG. 
ADDR (requires IP of 'static')
:   A single IP address to configure a static IP. For example:
GATEWAY (requires IP of 'static')
:   Set specified gateway
NETMASK (requires IP of 'static')
:   Set specified netmask. Defaults to 24
ROUTES
:   An array of custom routes (<address range> via <gateway>)
IPCFG
:   Array of arguments to pass to 'ip'. The power of this options is that it allows both simple and complicated routing configurations, within the framework of netcfg.
IFOPTS (deprecated, requires IP of 'static')
:   Arguments to pass to 'ifconfig'. This allows you to use the syntax for the older 'ifconfig' tool. Retained for compatability.
## IPv6 options
IP6 (required for IPv6)
:   Either 'dhcp', 'dhcp-noaddr', 'stateless', 'static'. Leave unset to disable IPv6.
ADDR6 (required for IP6=static)
:   An array of IPv6 addresses: prefix length may be specified via '1234:bcd::11/64' syntax.
GATEWAY6 (for IP6=static)
:   The gateway address for IPv6 routing.
ROUTES6
:   An array of custom routes (<address range> via <gateway>)
### DNS
DNS
:   Array of DNS nameservers. Simply specify the IP's of each of the DNS nameservers. 
SEARCH
:   "search" line for /etc/resolv.conf
DOMAIN
:   "domain" line for /etc/resolv.conf
HOSTNAME
:   Set the system hostname. Ensure any hostname is correctly referenced in /etc/hosts.
DNS1, DNS2 (deprecated)
:   First and second DNS servers for /etc/resolv.conf
### DHCP
DHCP_OPTIONS (ipv4)
:   String. Any extra arguments to pass to the dhcp client, presently dhcpcd.
DHCP_TIMEOUT
:   Integer. Maximum time to try for a DHCP IP. Default is 10 seconds.
DHCLIENT
:   yes/no. Use dhclient instead of dhcpcd. Defaults to no
DHCLIENT_OPTIONS (ipv4)
:   String. Extra options to pass to dhclient for IPv4.
DHCLIENT6_OPTIONS (ipv6)
:   String. Extra options to pass to dhclient for IPv6.
### 802.11x Authentication
AUTH8021X 
:   Use 802.11x authentication. Enable with 'yes'. 
WPA_CONF (required for an AUTH8021X of 'yes' only)
:   Path to wpa_supplicant configuration. Defaults to '/etc/wpa_supplicant.conf'
WPA_OPTS (optional for an AUTH8021X of 'yes')
:   Extra arguments for wpa_supplicant not specified otherwise. Any option here must specify wpa_supplicant driver. Defaults to '-Dwired'. 

## Examples
### Using ADDR and GATEWAY to set static IP and gateway

    IP="static"
    ADDR="192.168.1.23"
    GATEWAY="192.168.1.1"
 
### Using IPCFG to set a static IP and gateway with custom DNS

    IP="static"
    IPCFG=("addr add dev eth0 192.168.1.23/24 brd +" "route add default via 192.168.1.1")
    DNS=("208.67.222.222" "208.67.220.220")