icfg man page

icfg — Create and modify network interface configuration files


icfg <-i interface name> [options]


icfg is a utility for creating and modifying network interface configuration files.


-h, --help

Prints all available options and their meanings

-i IFACE, --interface=IFACE

Specifies the name of the interface being crated/manipulated

-c, --create

Creates a new interface configuration file, using the name provided with -i/--interface

-t, --type

When creating an interface, This option selects the interface type, so that the proper default keys are created in the file. current supported types are:

eth Standard Ethernet interface

bond Bonded interface

vlan Vlan interface

-q, --quiet

Suppress output on the command line.  Useful for scripting.

-d, --dump

Dump the Key/value pairs of the config file specified with the -i/--interface option to stdout


Add, remove or modify a key in a config file, as specified by the -i/--interface options.  See Examples section for various uses. Note this option can be used iteratively

--enslave SLAVE

Add a slave to a bonded interface

--deslave SLAVE

Remove a slave from a bonded interface


List the slaves of a bonded interface as specified by the -i /--interface option


Create a standard ethernet interface named eth0

icfg -i eth0 -c -t eth

Modify the eth0 config to set the BOOTPROTO and ONBOOT keys

icfg -i eth0 -s BOOTPROTO=dhcp -s ONBOOT=yes

Modify the eth0 config to clear the HWADDR key

icfg -i eth0 -s BOOTPROTO=dhcp -s HWADDR

Dump the contents of eth0 to stdout

icfg -i eth0 -d

Create a bonded interface named bond0 and set its BONDING_OPTS key

icfg -i bond0 -c -t bond -s BONDING_OPTS="mode=active-backup miimon=100"

Enslave eth0 and eth1 to bond0

icfg -i bond0 --enslave eth0 --enslave eth1

Remove eth1 as a slave of bond0

icfg -i bond0 --deslave eth1

List the slaves of bond0 on stdout

icfg -i bond- --list-slaves


Comming soon


Nov 2011 Linux icfg