RC.INET1.CONF(5)

NAME
rc.inet1.conf - Slackware network configuration file.

DESCRIPTION
rc.inet1.conf . This file contains the configuration settings for network interfaces. It consists basically of a series of variable array definitions. Array elements with the same index number will all belong to the same network interface.

By default, index number `0' is used for the configuration of interface eth0, index number `1' is used for eth1 and so forth. The default interface name can be overruled by the use of the variable IFNAME.

This is what a typical section of the file looks like for a card that is configured to use DHCP, showing all array variables with the index number [0]:

# Config information for eth0:
IPADDR[0]=""
NETMASK[0]=""
USE_DHCP[0]="yes"
DHCP_HOSTNAME[0]=""
DHCP_TIMEOUT[0]=""

Alternatively, here is an example for a card that uses a static IP address and has a non-default name ( ath0 instead of eth1 ). The array index is [1] in this case.

# Config information for ath0 (using static IP address):
IFNAME[1]="ath0"
IPADDR[1]="192.168.3.11"
NETMASK[1]="255.255.255.0"
USE_DHCP[1]=""
DHCP_HOSTNAME[1]=""
GATEWAY="192.168.3.1"

GENERAL PARAMETERS
This is a list of network parameters you can set for any card (wired as well as wired). The example section is for `eth0' by default, i.e. the array variables all have the array index [0]:

# Config information for eth0:

IPADDR[0]=""
    # Set this value to an actual IP address if you want static IP address assignment

NETMASK[0]=""
    # With a static IP address, you are required to also set a netmask (255.255.255.0 is common)

USE_DHCP[0]="yes"
    # If set to "yes", we will run a DHCP client and have the IP address dynamically assigned

DHCP_HOSTNAME[0]="mybox"
    # Tell the DHCP server what hostname to register

DHCP_TIMEOUT[0]=15
    # The default timeout for the DHCP client to wait for server response is 30 seconds, but you might want a shorter wait.

IFNAME[0]="eth0:1"
    # Set up an IP alias.

HWADDR[0]="00:01:23:45:67:89"
    # Overrule the card's hardware MAC address

MTU[0]=""
    # The default MTU is 1500, but you might need 1360 when you use NAT'ed IPSec traffic.

DHCP_KEEPRESOLV[0]="yes"
    # If you do not want `/etc/resolv.conf' overwritten by the DHCP client

DHCP_KEEPNTP[0]="yes"
    # If you do not want `/etc/ntp.conf' overwritten by the DHCP client

DHCP_KEEPGW[0]="yes"
    # If you do not want the DHCP client to change your default gateway

DHCP_DEBUG[0]="yes"
    # Make dhcpcd show verbose diagnostics

DHCP_NOIPV4LL[0]="yes"
    # Do not assign an `ipv4ll' address when a DHCP server is not found (ipv4 link-local addressing in the IP range 169.254.0.0/16 is also known as `zeroconf' address assignment)

DHCP_IPADDR[0]=""
    # Request a specific IP address from the DHCP server

WIRELESS PARAMETERS
For wireless cards, several additional parameter definitions are available. All these parameters (or better, variables) start with the prefix WLAN_ .

WLAN_ESSID[4]=DARKSTAR
    # Your Wireless Access Point's name

WLAN_MODE[4]=Managed
    # "Managed" mode for use with Access Points. "Ad-Hoc" is for peer-to-peer connections.

WLAN_RATE[4]="54M auto"
    # The transmission rates you want the driver to try ("auto" means that bandwidth can be variable)

WLAN_CHANNEL[4]="auto"
    # The channel to which the Access Point is tuned ("auto" to let the driver find out the correct channel)

WLAN_KEY[4]="D5A31F54ACF0487C2D0B1C10D2"
    # Definition of a WEP key

WLAN_IWPRIV[4]="set AuthMode=WPAPSK | set EncrypType=TKIP | set WPAPSK=the_64_character_key"
    # Some drivers require a private ioctl to be set through the iwpriv command. If more than one is required, you can place them in the IWPRIV parameter (separated with the pipe (|) character, see the example).

WLAN_WPA[4]="wpa_supplicant"
    # Run wpa_supplicant for WPA support

WLAN_WPADRIVER[4]="ndiswrapper"
    # Tell wpa_supplicant to specifically use the ndiswrapper driver. If you leave this empty the `wext' driver is used by default; most modern wireless drivers use 'wext'.

WLAN_WPAWAIT[4]=30
    # In case it takes long for the WPA association to finish, you can increase the wait time before rc.wireless decides that association failed (defaults to 10 seconds)

FILES

/etc/rc.d/rc.inet1
    network configuration script

/etc/rc.d/rc.inet1.conf
    configuration parameter file (is being read by rc.inet1 andrc.wireless)

/etc/rc.d/rc.wireless
    wireless configuration script

/etc/rc.d/rc.wireless.conf
    configuration parameter file ( deprecated )

CAVEATS
The network interface definitions are stored in variable arrays. The bash shell has no facilities to retrieve the largest array index used. Therefore, the rc.inet1 script makes the assumption that array indexes stay below the value of 6 .

If you want to configure more than six network interfaces, you will have to edit the file /etc/rc.d/rc.inet1 and change the value `6' in the line MAXNICS=${MAXNICS:-6} to the number of network interfaces you wish to use.

AUTHOR
Eric Hameleers <alien@slackware.com>

SEE ALSO
rc.inet1(8)