Official Red Hat Linux Administrators Guide

Interface configuration files control the operation of individual network interface devices. As your Red Hat Linux system boots, it uses these files to determine what interfaces to bring up and how to configure them. These files are usually named ifcfg-name, where name refers to the name of the device that the configuration file controls.

Ethernet Interfaces

One of the most common interface files is ifcfg-eth0, which controls the first network interface card, or NIC, in the system. A system with multiple NICs will also have multiple ifcfg-eth files, each one having a unique number at the end of the file name. Because each device has its own configuration file, you can control how each individual interface functions.

Following is a sample ifcfg-eth0 file for a system using a fixed IP address:

DEVICE=eth0 BOOTPROTO=none ONBOOT=yes NETWORK=10.0.1.0 NETMASK=255.255.255.0 IPADDR=10.0.1.27 USERCTL=no

The values required in an interface configuration file can change based on other values. For example, the ifcfg-eth0 file for an interface using DHCP looks quite a bit different from that for a system using a fixed IP address, because IP information is provided by the DHCP server:

DEVICE=eth0 BOOTPROTO=dhcp ONBOOT=yes

Most of the time you will probably want to use a GUI utility, such as the Network Administration Tool (redhat-config-network), to make changes to the various interface configuration files.

You can also edit the configuration file for a given network interface manually. Following is a listing of the parameters one can expect to configure in an interface configuration file. Within each of the interface configuration files, the following values are common:

• BOOTPROTO=protocol, where protocol is one of the following:

  • none — No boot-time protocol should be used.

  • bootp — The BOOTP protocol should be used.

  • dhcp — The DHCP protocol should be used.

• BROADCAST=address, where address is the broadcast address. This directive is deprecated.

• DEVICE=name, where name is the name of the physical device (except for dynamically allocated PPP devices, where it is the logical name).

• DNS{1,2}=address, where address is a nameserver address to be placed in /etc/resolv.conf if the PEERDNS directive is set to yes.

• IPADDR=address, where address is the IP address.

• NETMASK=mask, where mask is the netmask value.

• NETWORK=address, where address is the network address. This directive is deprecated.

• ONBOOT=answer, where answer is one of the following:

  • yes — This device should be activated at boot time.

  • no — This device should not be activated at boot time.

• PEERDNS=answer, where answer is one of the following:

  • yes — Modify /etc/resolv.conf if the DNS directive is set. If you are using DCHP, yes is the default.

  • no — Do not modify /etc/resolv.conf.

• SRCADDR=address, where address is the specified source IP address for outgoing packets.

• USERCTL=answer, where answer is one of the following:

  • yes — Non-root users are allowed to control this device.

  • no — Non-root users are not allowed to control this device.

Dial-up Interfaces

If you connect to the Internet via PPP dial-up connection, you need a configuration file for that interface as well. This file is created automatically for you when you use wvdial, the Network Administration Tool, or Kppp to create a dial-up account. In addition, any changes to dial-up account settings are reflected in these interface configuration files. The Official Red Hat Linux User’s Guide (Red Hat Press/Wiley, 2003) contains instructions for using these GUI-based dial-up connection tools. You can also create and edit this file manually.

A typical ifcfg-ppp0 file looks like this:

DEVICE=ppp0 NAME=test WVDIALSECT=test MODEMPORT=/dev/modem LINESPEED=115200 PAPNAME=test USERCTL=true ONBOOT=no PERSIST=no DEFROUTE=yes PEERDNS=yes DEMAND=no IDLETIMEOUT=600

Serial Line Internet Protocol (SLIP) is another dial-up interface, although it is less commonly used. SLIP files have interface configuration file names such as ifcfg-sl0. Among the options not already discussed that may be used in these files are the following:

• DEFROUTE=answer, where answer is one of the following:

  • yes — Set this interface as the default route.

  • no — Do not set this interface as the default route.

• DEMAND=answer, where answer is one of the following:

  • yes — This interface will allow pppd to initiate a connection when someone attempts to use it.

  • no — A connection must be manually established for this interface.

• IDLETIMEOUT=value, where value is the number of seconds of idle activity before the interface disconnects itself.

• INITSTRING=string, where string is the initialization string passed to the modem device. This option is used primarily with SLIP interfaces.

• LINESPEED=value, where value is the baud rate of the device. Possible standard values here are 57600, 38400, 19200, and 9600.

• MODEMPORT=device, where device is the name of the serial device that is used to establish the connection for the interface.

• MTU=value, where value is the Maximum Transfer Unit (MTU) setting for the interface. The MTU refers to the largest number of bytes of data a frame can carry, not counting its header information. In some dial-up situations, setting this to a value of 576 will result in fewer dropped packets and slightly improve the throughput for a connection.

• NAME=name, where name is the reference to the title given to a collection of dial-up connection configurations.

• PAPNAME=name, where name is the username given during the Password Authentication Protocol (PAP) exchange that allows you to connect to a remote system.

• PEERDNS=answer, where answer is one of the following:

  • yes — Modify the dd system’s /etc/resolv.conf file entries to use the DNS servers provided by the remote system when a connection is established.

  • no — The /etc/resolv.conf file will not be modified.

• PERSIST=answer, where answer is one of the following:

  • yes — This interface should be kept active at all times, even if deactivated after a modem hangup.

  • no — This interface should not be kept active at all times.

• REMIP=address, where address is the remote system’s IP address. This is usually left unspecified.

• WVDIALSECT=name, where name associates this interface with a dialer configuration in /etc/wvdial.conf, which contains the phone number to be dialed and other important information for the interface.

Other Interfaces

Other common interface configuration files that use these options include ifcfg-lo, which controls the IP protocol’s local loopback device; ifcfg-irlan0, which arranges settings for the first infrared device; ifcfg-plip0, which controls the first PLIP device; and ifcfg-tr0, used with the first Token Ring device. A local loopback interface is often used in testing, as well as a variety of applications that require an IP address pointing back to the same system. Any data sent to the loopback device is immediately returned to the host’s network layer.

An infrared interface allows information between devices, such as a laptop and a printer, to flow over an infrared link that works in a similar way to an Ethernet device except that it commonly occurs over a peer-to-peer connection. A Parallel Line Interface Protocol (PLIP) connection works much the same way, except that it utilizes a parallel port. Token Ring topologies are not as common on local area networks as they once were, having been eclipsed by Ethernet.

Alias and Clone Files

Two lesser-used types of interface configuration files found in the /etc/sysconfig/network-scripts/ directory are alias and clone files. alias interface configuration files take names in the format of ifcfg-if-name:alias-value, and they allow an alias to point to an interface. For example, a ifcfg-eth0:0 file could be configured to specify DEVICE=eth0:0 and a static IP address of 10.0.0.2, serving as an alias of an Ethernet interface already configured to receive its IP information via DHCP in ifcfg-eth0. At that point, the eth0 device is bound to a dynamic IP address, but it can always be referred to on that system via the fixed 10.0.0.2 IP address.

A clone interface configuration file should follow this naming convention: ifcfg-if-name-clone-name. While an alias file is another way to refer to an existing interface configuration file, a clone file is used to specify additional options when specifying an interface. For example, if you have a standard DHCP Ethernet interface called eth0, it may look similar to this:

DEVICE=eth0 ONBOOT=yes BOOTPROTO=dhcp

Since USERCTL is set to no if it is not specified, users cannot bring this interface up and down. To give users this ability, create a clone by copying ifcfg-eth0 to ifcfg-eth0-user and add the following line:

USERCTL=yes

When a user brings up the eth0 interface with the ifup eth0-user command, the configuration options from ifcfg-eth0 and ifcfg-eth0-user are combined. While this is a very basic example, this method can be used with a variety of options and interfaces. The easiest way to create alias and clone interface configuration files is to use the GUI-based Network Administration Tool. For more on using this tool, see Chapter 13.