ifconfig

ifconfig
Initial release	August 1983; 41 years ago
Operating system	Unix and Unix-like
Type	Command

ifconfig (short for interface config) is a system administration utility in Unix-like operating systems for network interface configuration.

The utility is a command-line interface tool and is also used in the system startup scripts of many operating systems. It has features for configuring, controlling, and querying TCP/IP network interface parameters. Ifconfig originally appeared in 4.2BSD as part of the BSD TCP/IP suite.

Many Linux distributions have deprecated ifconfig in favor of tools from iproute2.

Usage

Common uses for ifconfig include setting the IP address and subnet mask of a network interface and disabling or enabling an interface.^[1] At boot time, many Unix-like operating systems initialize their network interfaces with shell scripts that call ifconfig. As an interactive tool, system administrators routinely use the utility to display and analyze network interface parameters. The following two examples show the output of the tool when querying the state of a single active interface each on a Linux-based host (interface eth0) and the ural0 interface on an OpenBSD installation.

 eth0      Link encap:Ethernet  HWaddr 00:0F:20:CF:8B:42
           inet addr:192.168.1.128  Bcast:  Mask:255.255.255.192
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:2472694671 errors:1 dropped:0 overruns:0 frame:0
           TX packets:44641779 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000
           RX bytes:1761467179 (1679.7 Mb)  TX bytes:2870928587 (2737.9 Mb)
           Interrupt:28

 ural0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500
         lladdr 00:0d:0b:ed:84:fb
         media: IEEE802.11 DS2 mode 11b hostap (autoselect mode 11b hostap)
         status: active
         ieee80211: nwid ARK chan 11 bssid 00:0d:0b:ed:84:fb  100dBm
         inet 172.30.50.1 netmask 0xffffff00 broadcast 172.30.50.255
         inet6 fe80::20d:bff:feed:84fb%ural0 prefixlen 64 scopeid 0xa

HWaddr: hardware address, MAC address.
The parameter txqueuelen is measured in number of Ethernet frames and is the size of the buffer that is being managed by the network scheduler.

Medium access control functions

ifconfig is also commonly used to change the medium access control (MAC) address of an interface. In this process, the network interface is first disabled (set down) with the ifconfig command, followed by a MAC change command:

ifconfig wlan0 down
ifconfig wlan0 hw ether 13:11:20:33:49:66
ifconfig wlan0 up

Release status

The Berkeley Software Distribution UNIX operating systems (e.g., NetBSD, OpenBSD, and FreeBSD) continue active development of ifconfig and extension of its functionality to cover the configuration of wireless networking interfaces, VLAN trunking, controlling hardware features such as TSO or hardware checksumming or setting up bridge and tunnel interfaces. Solaris has historically used ifconfig for all network interface configuration, but as of Solaris 10 introduced dladm to perform data-link (OSI model layer 2) configuration, reducing ifconfig's purview to IP configuration.

In older Linux distributions, ifconfig, in conjunction with the utility route, was used to connect a computer to a network, and to define routes between networks. ifconfig for Linux is part of the package net-tools, released as the latest version 2.10 on 7 January 2021.^[2]

Many Linux distributions have deprecated the use of ifconfig and route in favor of the software suite iproute2, such as ArchLinux^[3] or RHEL since version 7,^[4] which has been available since 1999 for Linux 2.2.^[5] iproute2 includes support for all common functions of ifconfig(8), route(8), arp(8) and netstat(1). It also includes multicast configuration support, tunnel and virtual link management, traffic control, and low-level IPsec configuration, among other features.

Related tools

Another higher-level Linux command line tool is ifup (including ifdown and ifquery). In addition to controlling the interfaces, it also provides control of other aspects of the network such as specifying the DNS servers to use. The command is configured using the file /etc/network/interfaces, which contains "stanzas" for each interface.

NetworkManager is a Linux daemon that automatically reconfigures the network in dynamic environments, such as moving between WiFi hotspots. It is usually used in conjunction with a graphical front-end such as GNOME Shell.

Versions of Microsoft Windows from Windows 95 to Windows Me used winipcfg to give a graphical display of current IP information. ipconfig, a command similar to ifconfig, comes with Microsoft operating-systems based on the Windows NT kernel. ipconfig also controls the Windows DHCP client.

In macOS, the ifconfig command functions as a wrapper to the IPConfiguration agent, and can control the BootP and DHCP clients from the command-line. Use of ifconfig to modify network settings in Mac OS X is discouraged, because ifconfig operates below the level of the system frameworks which help manage network configuration.

iwconfig, a component of Wireless tools for Linux, which took its name from ifconfig, manages wireless network interfaces outside the original scope of Linux's ifconfig. iwconfig sets such specialized settings as a wireless network's SSID and WEP keys, and functions in tandem with iwlist. Linux also features iwspy, to read the signal, noise and quality of a wireless connection.

Other related tools for configuring Ethernet adapters are: ethtool, mii-tool, and mii-diag in Linux and the command dladm show-link in Solaris.

The ip suite has a similar purpose and is meant to replace the deprecated ifconfig.^[6]

References

^ "Interface Configuration for IP". Linux Network Administrators Guide. June 2000. Retrieved 12 March 2024.
^ net-tools on SourceForge
^ Gundersen, Tom (8 June 2011). "News: Deprecation of net-tools". Retrieved 28 March 2019.
^ Jonathan Corbet (4 January 2017). "Moving on from net-tools". LWN.net. Retrieved 23 September 2019.
^ Litvak, Michail (6 March 2019). "ip(8) manual page". Retrieved 28 March 2019.
^ Carrigan, Tyler (6 May 2020). "Linux networking: ifconfig versus ip | Enable Sysadmin". Red Hat. Retrieved 2 November 2022.

External links

ifconfig(8), official manpage for Linux net-tools ifconfig
ifconfig(8), manpage for the FreeBSD ifconfig
ifconfig(8), manpage for the Solaris ifconfig

[1] "Interface Configuration for IP". Linux Network Administrators Guide. June 2000. Retrieved 12 March 2024.

[2] t-tools on SourceForge

[3] Gundersen, Tom (8 June 2011). "News: Deprecation of net-tools". Retrieved 28 March 2019.

[4] Jonathan Corbet (4 January 2017). "Moving on from net-tools". LWN.net. Retrieved 23 September 2019.

[5] Litvak, Michail (6 March 2019). "ip(8) manual page". Retrieved 28 March 2019.

[6] Carrigan, Tyler (6 May 2020). "Linux networking: ifconfig versus ip | Enable Sysadmin". Red Hat. Retrieved 2 November 2022.

[1]

[2]

[3]

[4]

[5]

[6]

v t e Unix command-line interface programs and shell builtins
File system	cat chattr chmod chown chgrp cksum cmp cp dd du df file fuser ln ls mkdir mv pax pwd rm rmdir split tee touch type umask
Processes	at bg crontab fg kill nice ps time
User environment	env exit logname mesg talk tput uname who write
Text processing	awk basename comm csplit cut diff dirname ed ex fold head iconv join m4 more nl paste patch printf read sed sort strings tail tr troff uniq vi wc xargs
Shell builtins	alias cd echo test unset wait
Searching	find grep
Documentation	man
Software development	ar ctags lex make nm strip yacc
Miscellaneous	bc cal expr lp od sleep true and false
Categories Standard Unix programs Unix SUS2008 utilities List