Check the status
udev should detect your network interface controller (NIC) and automatically load the necessary kernel module at startup. Check the "Ethernet controller" entry (or similar) from the
lspci -v output. It should tell you which kernel module contains the driver for your network device. For example:
$ lspci -v
02:00.0 Ethernet controller: Attansic Technology Corp. L1 Gigabit Ethernet Adapter (rev b0) ... Kernel driver in use: atl1 Kernel modules: atl1
Next, check that the driver was loaded by running
dmesg | grep module_name as root. For example:
# dmesg | grep atl1
... atl1 0000:02:00.0: eth0 link is up 1000 Mbps full duplex
Skip the next section if the driver was loaded successfully. Otherwise, you will need to know which module is needed for your particular model.
Load the module
Search the internet for the right module/driver for your chipset. Some common modules are
8139too for cards with a Realtek chipset, or
sis900 for cards with a SiS chipset. Once you know which module to use, try to load it manually. If you get an error saying that the module was not found, verify first if you recently upgraded the kernel (see General troubleshooting#Cannot use some peripherals after kernel upgrade). Alternatively, it is possible that the driver is not included in the Arch kernel. You may search the AUR for the module name.
If udev is not detecting and loading the proper module automatically during bootup, you can explicitly load the module at boot.
Tips and tricks
ifplugd for laptops
is a daemon which will automatically configure your Ethernet device when a cable is plugged in and automatically unconfigure it if the cable is pulled. This is useful on laptops with onboard network adapters, since it will only configure the interface when a cable is really connected. Another use is when you just need to restart the network but do not want to restart the computer or do it from the shell.
By default it is configured to work for the
eth0 device. This and other settings like delays can be configured in
netctl-ifplugd@.service, otherwise you can use
ifplugd@.service from the package. For example, enable
Forcing 100Mbps or 10Mbps full-duplex speed on a gigabit ethernet NIC can save a lot of power (~1W) on most network workloads. This also reduces components temperature.
ethtool -s eth0 autoneg off speed 100 on every boot is inconvenient.
Boot time initialization of lower ethernet NIC speed is possible through systemd.link files. The actual setup is performed by the
net_setup_link udev builtin. Add the
AutoNegotiation option to the network link file:
[Match] MACAddress=aa:bb:cc:dd:ee:ff [Link] NamePolicy=kernel database onboard slot path AutoNegotiation=no Duplex=full BitsPerSecond=100M
Also seefor more information.
AutoNegotiationmust be set, to
no, otherwise there will be a Speed/Duplex setting not supported error and the link will not initialize.
- Only the first matching file is applied. The content of the default link file
/usr/lib/systemd/network/99-default.linkshipped with systemd has to be included, otherwise the interface might be misconfigured.
- To be considered, the file name should alphabetically come before the default
99-default.link. For example
- This configuration applies only to the link-level, and is independent of network-level daemons such as NetworkManager or systemd-networkd.
- In the
OriginalName=can also be used to identify the interface.
Swapping computers on the cable modem
Some cable ISPs (Vidéotron for example) have the cable modem configured to recognize only one client PC, by the MAC address of its network interface. Once the cable modem has learned the MAC address of the first PC or equipment that talks to it, it will not respond to another MAC address in any way. Thus if you swap one PC for another (or for a router), the new PC (or router) will not work with the cable modem, because the new PC (or router) has a MAC address different from the old one. To reset the cable modem so that it will recognise the new PC, you must power the cable modem off and on again. Once the cable modem has rebooted and gone fully online again (indicator lights settled down), reboot the newly connected PC so that it makes a DHCP request, or manually make it request a new DHCP lease.
If this method does not work, you will need to clone the MAC address of the original machine. See also MAC address spoofing.
Explicit Congestion Notification
To enable ECN for both incoming and outgoing connections:
# sysctl net.ipv4.tcp_ecn=1
To enable ECN only when requested by incoming connections (the reasonably safe, kernel default):
# sysctl net.ipv4.tcp_ecn=2
To disable ECN completely (to e.g. test whether ECN was causing problems):
# sysctl net.ipv4.tcp_ecn=0
See also the kernel documentation.
This Broadcom chipset sometimes does not behave well unless you specify the order of the modules to be loaded. The modules are
tg3, the former needing to be loaded first.
These steps should help if your computer has this chipset:
- Find your NIC in lspci output:
$ lspci | grep Ethernet
02:00.0 Ethernet controller: Broadcom Corporation NetLink BCM57780 Gigabit Ethernet PCIe (rev 01)
- If your wired networking is not functioning in some way or another, unplug your cable then do the following:
# modprobe -r tg3 # modprobe broadcom # modprobe tg3
- Plug your network cable back in and check whether the module succeeded with:
# dmesg | grep tg3
- If this procedure solved the issue you can make it permanent by adding
tg3(in this order) to the
MODULES=(.. broadcom tg3 ..)
- Regenerate the initramfs
- Alternatively, you can create an
softdep tg3 pre: broadcom
Users with Realtek 8168 8169 8101 8111(C) 8156B based NICs (cards / and on-board) may notice a problem where the NIC seems to be disabled on boot and has no Link light. This can usually be found on a dual boot system where Windows is also installed. It seems that using the official Realtek drivers (dated anything after May 2007) under Windows is the cause. These newer drivers disable the Wake-On-LAN feature by disabling the NIC at Windows shutdown time, where it will remain disabled until the next time Windows boots. You will be able to notice if this problem is affecting you if the Link light remains off until Windows boots up; during Windows shutdown the Link light will switch off. Normal operation should be that the link light is always on as long as the system is on, even during POST. This problem will also affect other operating systems without newer drivers (eg. Live CDs). Here are a few fixes for this problem.
Enable the NIC directly in Linux
Follow Network configuration#Enabling and disabling network interfaces to enable the interface.
Rollback/change Windows driver
You can roll back your Windows NIC driver to the Microsoft provided one (if available), or roll back/install an official Realtek driver pre-dating May 2007 (may be on the CD that came with your hardware).
Enable WOL in Windows driver
Probably the best and the fastest fix is to change this setting in the Windows driver. This way it should be fixed system-wide and not only under Arch (eg. live CDs, other operating systems). In Windows, under Device Manager, find your Realtek network adapter and double-click it. Under the "Advanced" tab, change "Wake-on-LAN after shutdown" to "Enable".
Disable has no effect (you will notice the Link light still turns off upon Windows shutdown). One rather dirty workaround is to boot to Windows and just reset the system (perform an ungraceful restart/shutdown) thus not giving the Windows driver a chance to disable LAN. The Link light will remain on and the LAN adapter will remain accessible after POST - that is until you boot back to Windows and shut it down properly again.
Enable LAN Boot ROM in BIOS/CMOS
It appears that setting Integrated Peripherals > Onboard LAN Boot ROM > Enabled in BIOS/CMOS reactivates the Realtek LAN chip on system boot-up, despite the Windows driver disabling it on OS shutdown.
Disable USB AutoSuspend
When using power saving features, specifically USB autosuspend, the device can fail to load correctly, resulting in a NO-CARRIER state (tested with RT8156B), and no established link.
# lspci | grep Ethernet
03:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. RTL8111/8168B PCI Express Gigabit Ethernet controller (rev 02)
The adapter should be recognized by the
r8169 module. However, with some chip revisions the connection may go off and on all the time. The alternative should be used for a reliable connection in this case. Blacklist
r8169, if is not automatically loaded by udev, you can explicitly load the module at boot.
Another fault in the drivers for some revisions of this adapter is poor IPv6 support. IPv6#Disable functionality can be helpful if you encounter issues such as hanging webpages and slow speeds.
Gigabyte Motherboard with Realtek 8111/8168/8411
With motherboards such as the Gigabyte GA-990FXA-UD3, booting with IOMMU off (which can be the default) will cause the network interface to be unreliable, often failing to connect or connecting but allowing no throughput. This will apply to the onboard NIC and to any other pci-NIC in the box because the IOMMU setting affects the entire network interface on the board. Enabling IOMMU and booting with the install media will throw AMD I-10/xhci page faults for a second, but then boots normally, resulting in a fully functional onboard NIC (even with the r8169 module).
When configuring the boot process for your installation, add
iommu=soft as a kernel parameter to eliminate the error messages on boot and restore USB3.0 functionality.
MicroStar Motherboard with Realtek 8111/8168/8411
With motherboards such as the "MicroStar B450M MORTAR TITANIUM", unpluging/pluging Ethernet cables or restarting router's DHCP server would cause
r8169 to enter a downshifted status, and downgrade the 1000 Mbit/s Ethernet speed to 100 Mbit/s. The kernel log will show:
# dmesg | grep r8169
Generic FE-GE Realtek PHY r8169-2200:00: Downshift occurred from negotiated speed 1Gbps to actual speed 100Mbps, check cabling! r8169 0000:22:00.0 enp34s0: Link is Up - 100Mbps/Full (downshifted) - flow control rx/tx
In this case, restart the adapter (set it down and up). For example:
# ip link set dev enp34s0 down # ip link set dev enp34s0 up
Realtek RTL8153 Tx timeout
USB Network Adapters with the following controller will often hang and stop transmit until its link is reset. This is accompanied with
Tx status -2 or
Tx status -71 errors in the kernel log. This can be fixed by setting
The quirk can be set at boot by adding the kernel parameter
usbcore.quirks=2357:0601:k. It can also be set immediately via the sysfs by
# echo 2357:0601:k > /sys/module/usbcore/parameters/quirks
2357:0601 should be replaced with your own device's USB ID which can be found using lsusb.