https://github.com/mtorromeo/r8168

Linux device driver for Realtek Ethernet controllers (unofficial mirror)
https://github.com/mtorromeo/r8168

Last synced: about 2 hours ago
JSON representation

Linux device driver for Realtek Ethernet controllers (unofficial mirror)

• Host: GitHub
• URL: https://github.com/mtorromeo/r8168
• Owner: mtorromeo
• Created: 2015-03-16T08:36:28.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-23T22:15:48.000Z (21 days ago)
• Last Synced: 2024-10-24T11:12:11.840Z (20 days ago)
• Language: C
• Homepage: https://www.realtek.com/Download/List?cate_id=584
• Size: 720 KB
• Stars: 246
• Watchers: 21
• Forks: 82
• Open Issues: 26
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        


	This is the Linux device driver released for RealTek Gigabit Ethernet controllers with PCI-Express interface.

	- Kernel source tree (supported Linux kernel 2.6.x and 2.4.x)

	- For linux kernel 2.4.x, this driver supports 2.4.20 and latter.

	- Compiler/binutils for kernel compilation

	Unpack the tarball :

		# tar vjxf r8168-8.aaa.bb.tar.bz2

	Change to the directory:

		# cd r8168-8.aaa.bb

	If you are running the target kernel, then you should be able to do :

		# ./autorun.sh	(as root or with sudo)

	You can check whether the driver is loaded by using following commands.

		# lsmod | grep r8168

		# ifconfig -a

	If there is a device name, ethX, shown on the monitor, the linux

	driver is loaded. Then, you can use the following command to activate

	the ethX.

		# ifconfig ethX up

		,where X=0,1,2,...

	1. Set manually

		a. Set the IP address of your machine.

			# ifconfig ethX "the IP address of your machine"

		b. Set the IP address of DNS.

		   Insert the following configuration in /etc/resolv.conf.

			nameserver "the IP address of DNS"

		c. Set the IP address of gateway.

			# route add default gw "the IP address of gateway"

	2. Set by doing configurations in /etc/sysconfig/network-scripts

	   /ifcfg-ethX for Redhat and Fedora, or /etc/sysconfig/network

	   /ifcfg-ethX for SuSE. There are two examples to set network

	   configurations.

		a. Fixed IP address:

			DEVICE=eth0

			BOOTPROTO=static

			ONBOOT=yes

			TYPE=ethernet

			NETMASK=255.255.255.0

			IPADDR=192.168.1.1

			GATEWAY=192.168.1.254

			BROADCAST=192.168.1.255

		b. DHCP:

			DEVICE=eth0

			BOOTPROTO=dhcp

			ONBOOT=yes

	There are two ways to modify the MAC address of the NIC.

	1. Use ifconfig:

		# ifconfig ethX hw ether YY:YY:YY:YY:YY:YY

	   ,where X is the device number assigned by Linux kernel, and

		  YY:YY:YY:YY:YY:YY is the MAC address assigned by the user.

	2. Use ip:

		# ip link set ethX address YY:YY:YY:YY:YY:YY

	   ,where X is the device number assigned by Linux kernel, and

		  YY:YY:YY:YY:YY:YY is the MAC address assigned by the user.

	1. Force the link status when insert the driver.

	   If the user is in the path ~/r8168, the link status can be forced

	   to one of the 5 modes as following command.

		# insmod ./src/r8168.ko speed=SPEED_MODE duplex=DUPLEX_MODE autoneg=NWAY_OPTION

		,where

			SPEED_MODE	= 1000	for 1000Mbps

					= 100	for 100Mbps

					= 10	for 10Mbps

			DUPLEX_MODE	= 0	for half-duplex

					= 1	for full-duplex

			NWAY_OPTION	= 0	for auto-negotiation off (true force)

					= 1	for auto-negotiation on (nway force)

		For example:

			# insmod ./src/r8168.ko speed=100 duplex=0 autoneg=1

		will force PHY to operate in 100Mpbs Half-duplex(nway force).

	2. Force the link status by using ethtool.

		a. Insert the driver first.

		b. Make sure that ethtool exists in /sbin.

		c. Force the link status as the following command.

			# ethtool -s ethX speed SPEED_MODE duplex DUPLEX_MODE autoneg NWAY_OPTION

			,where

				SPEED_MODE	= 1000	for 1000Mbps

						= 100	for 100Mbps

						= 10	for 10Mbps

				DUPLEX_MODE	= half	for half-duplex

						= full	for full-duplex

				NWAY_OPTION	= off	for auto-negotiation off (true force)

						= on	for auto-negotiation on (nway force)

		For example:

			# ethtool -s eth0 speed 100 duplex full autoneg on

		will force PHY to operate in 100Mpbs Full-duplex(nway force).

	Transmitting Jumbo Frames, whose packet size is bigger than 1500 bytes, please change mtu by the following command.

	# ifconfig ethX mtu MTU

	, where X=0,1,2,..., and MTU is configured by user.

	RTL8168B/8111B supports Jumbo Frame size up to 4 kBytes.

	RTL8168C/8111C and RTL8168CP/8111CP support Jumbo Frame size up to 6 kBytes.

	RTL8168D/8111D supports Jumbo Frame size up to 9 kBytes.