Xen PCI Passthrough - Revision history

John3-16: Style/grammar amendments.

2026-02-01T01:33:35Z

Style/grammar amendments.

← Older revision		Revision as of 01:33, 1 February 2026
Line 1:		Line 1:
	This guide is to show how to configure PCI Passthrough on Alpine.		This guide is to show how to configure PCI Passthrough on Alpine Linux.

	First, use lspci to find the PCI~~-Address~~ of the ~~Device~~ you want to ~~Passthrough~~:		First, use ''lspci'' to find the PCI address of the device that you want to passthrough:
	<pre>		<pre>
	node03:~# lspci		node03:~# lspci
Line 19:		Line 19:
	</pre>		</pre>

	In this example, ~~I want to~~ passthrough the SAS ~~Controller~~. So the ~~Address~~ is 01:00.0		In this example, let's passthrough the SAS controller. So the address is ''01:00.0''.

	Make sure xen_pciback is in your /etc/modules:		Make sure that ''xen_pciback'' is in your {{Path\|/etc/modules}}:
	<pre>		<pre>
	node03:~# grep pciback /etc/modules		node03:~# grep pciback /etc/modules
Line 27:		Line 27:
	</pre>		</pre>

	Edit /etc/conf.d/xen-pci to add the device:		Edit {{Path\|/etc/conf.d/xen-pci}} to add the device:
	<pre>		<pre>
	node03:~# cat /etc/conf.d/xen-pci		node03:~# cat /etc/conf.d/xen-pci
Line 36:		Line 36:
	</pre>		</pre>

	Add the xen-pci daemon to the default runlevel and reboot:		Add the ''xen-pci'' daemon to the default runlevel, and reboot:
	<pre>		<pre>
	rc-update add xen-pci default		rc-update add xen-pci default
	</pre>		</pre>

	After rebooting, you should be able to verify the ~~pci-~~device is using the pciback ~~Kernelmodule~~ and that it's visible to passthrough via xl:		After rebooting, you should be able to verify that the PCI device is using the pciback kernel module, and that it is visible to passthrough via ''xl'':
	<pre>		<pre>
	node03:~# lspci -k \| grep -A2 '01:00.0'		node03:~# lspci -k \| grep -A2 '01:00.0'
Line 51:		Line 51:
	</pre>		</pre>

	Add the following line to your DomU's ~~Config~~:		Add the following line to your DomU's configuration file:
	<pre>		<pre>
	pci = [ '01:00.0' ]		pci = [ '01:00.0' ]
Line 57:		Line 57:

	====Known Issue with LSI Controllers====		====Known Issue with LSI Controllers====
	As the ~~Kernelmodule~~ for LSI ~~Controllers~~ is built into the Alpine ~~Initramfs~~, the real ~~Module~~ is loaded before the pciback ~~Module~~ can be assigned.		As the kernel module for LSI controllers is built into the Alpine Linux initramfs, the real module is loaded before the pciback module can be assigned.
	<BR>You~~'ll~~ need to blacklist the mpt2sas module in /etc/modprobe.d/blacklist.conf and rebuild your initramfs.		<BR>You will need to blacklist the ''mpt2sas'' module in {{Path\|/etc/modprobe.d/blacklist.conf}} and rebuild your initramfs:
	<pre>		<pre>
	node03:~# grep sas /etc/modprobe.d/blacklist.conf		node03:~# grep sas /etc/modprobe.d/blacklist.conf

Statzitz: There was two 'the' on the second sentence of the page. I removed one of them

2026-01-14T18:58:50Z

There was two 'the' on the second sentence of the page. I removed one of them

← Older revision		Revision as of 18:58, 14 January 2026
Line 1:		Line 1:
	This guide is to show how to configure PCI Passthrough on Alpine.		This guide is to show how to configure PCI Passthrough on Alpine.

	First, use lspci to find ~~the~~ the PCI-Address of the Device you want to Passthrough:		First, use lspci to find the PCI-Address of the Device you want to Passthrough:
	<pre>		<pre>
	node03:~# lspci		node03:~# lspci

Statzitz: Use the xen-pci service to do a pci passthrough on alpine linux in /etc/conf.d/xen-pci

2026-01-14T18:52:41Z

Use the xen-pci service to do a pci passthrough on alpine linux in /etc/conf.d/xen-pci

← Older revision		Revision as of 18:52, 14 January 2026
Line 20:		Line 20:

	In this example, I want to passthrough the SAS Controller. So the Address is 01:00.0		In this example, I want to passthrough the SAS Controller. So the Address is 01:00.0
	~~Currently there is a bug [https://gitlab.alpinelinux.org/alpine/aports/-/issues/3609 #3609]in Alpine that prevents using default Kernelparameters.~~

	~~Edit~~ /etc/modules ~~and reboot the server~~:		Make sure xen_pciback is in your /etc/modules:
	<pre>		<pre>
	node03:~# grep pciback /etc/modules		node03:~# grep pciback /etc/modules
	xen_pciback ~~hide~~=(01:00.0)		xen_pciback
			</pre>

			Edit /etc/conf.d/xen-pci to add the device:
			<pre>
			node03:~# cat /etc/conf.d/xen-pci
			# /etc/conf.d/xen-pci

			# PCI devices that will be used by domUs
			DEVICES="01:00.0"
			</pre>

			Add the xen-pci daemon to the default runlevel and reboot:
			<pre>
			rc-update add xen-pci default
	</pre>		</pre>

Sertonix: use https link

2023-08-25T02:19:32Z

use https link

← Older revision		Revision as of 02:19, 25 August 2023
Line 20:		Line 20:

	In this example, I want to passthrough the SAS Controller. So the Address is 01:00.0		In this example, I want to passthrough the SAS Controller. So the Address is 01:00.0
	Currently there is a bug [~~http~~://~~bugs~~.alpinelinux.org/issues/3609 #3609]in Alpine that prevents using default Kernelparameters.		Currently there is a bug [https://gitlab.alpinelinux.org/alpine/aports/-/issues/3609 #3609]in Alpine that prevents using default Kernelparameters.

	Edit /etc/modules and reboot the server:		Edit /etc/modules and reboot the server:

Bt129 at 16:04, 6 August 2021

2021-08-06T16:04:41Z

← Older revision		Revision as of 16:04, 6 August 2021
Line 1:		Line 1:
	This guide is to show how to configure PCI Passthrough on Alpine.		This guide is to show how to configure PCI Passthrough on Alpine.

	First use lspci to find ~~out what~~ PCI-Address the Device ~~that~~ you want to Passthrough ~~has~~:		First, use lspci to find the the PCI-Address of the Device you want to Passthrough:
	<pre>		<pre>
	node03:~# lspci		node03:~# lspci
Line 19:		Line 19:
	</pre>		</pre>

	In ~~my case i~~ want to passthrough the SAS Controller so the Address is 01:00.0		In this example, I want to passthrough the SAS Controller. So the Address is 01:00.0
	Currently there is a bug [http://bugs.alpinelinux.org/issues/3609 #3609]in Alpine ~~due to which we can't use the Default way to use~~ Kernelparameters ~~for it~~.		Currently there is a bug [http://bugs.alpinelinux.org/issues/3609 #3609]in Alpine that prevents using default Kernelparameters.

	Edit /etc/modules and reboot the server:		Edit /etc/modules and reboot the server:
Line 28:		Line 28:
	</pre>		</pre>

	After ~~a reboot~~ you should be able to ~~see that~~ the pci-device is using the pciback Kernelmodule and ~~should be~~ visible to passthrough via xl:		After rebooting, you should be able to verify the pci-device is using the pciback Kernelmodule and that it's visible to passthrough via xl:
	<pre>		<pre>
	node03:~# lspci -k \| grep -A2 '01:00.0'		node03:~# lspci -k \| grep -A2 '01:00.0'
Line 38:		Line 38:
	</pre>		</pre>

	~~Now just add a~~ line to your DomU's Config ~~and everything should be fine.~~		Add the following line to your DomU's Config:
	<pre>		<pre>
	pci = [ '01:00.0' ]		pci = [ '01:00.0' ]
Line 45:		Line 45:
	====Known Issue with LSI Controllers====		====Known Issue with LSI Controllers====
	As the Kernelmodule for LSI Controllers is built into the Alpine Initramfs, the real Module is loaded before the pciback Module can be assigned.		As the Kernelmodule for LSI Controllers is built into the Alpine Initramfs, the real Module is loaded before the pciback Module can be assigned.
	~~Just~~ blacklist the mpt2sas module in /etc/modprobe.d/blacklist.conf and ~~rebuilt~~ your initramfs.		<BR>You'll need to blacklist the mpt2sas module in /etc/modprobe.d/blacklist.conf and rebuild your initramfs.
	<pre>		<pre>
	node03:~# grep sas /etc/modprobe.d/blacklist.conf		node03:~# grep sas /etc/modprobe.d/blacklist.conf

John3-16: Categorized: Virtualization

2017-09-21T04:10:31Z

Categorized: Virtualization

← Older revision		Revision as of 04:10, 21 September 2017
Line 54:		Line 54:
	33641 blocks		33641 blocks
	</pre>		</pre>

			[[Category:Virtualization]]

Tze at 02:15, 20 January 2015

2015-01-20T02:15:43Z

← Older revision		Revision as of 02:15, 20 January 2015
Line 1:		Line 1:
	~~Placeholder~~ for ~~TZE~~		This guide is to show how to configure PCI Passthrough on Alpine.

			First use lspci to find out what PCI-Address the Device that you want to Passthrough has:
			<pre>
			node03:~# lspci
			00:00.0 Host bridge: Intel Corporation Xeon E3-1200 Processor Family DRAM Controller (rev 09)
			00:19.0 Ethernet controller: Intel Corporation 82579LM Gigabit Network Connection (rev 05)
			00:1a.0 USB controller: Intel Corporation 6 Series/C200 Series Chipset Family USB Enhanced Host Controller #2 (rev 05)
			00:1c.0 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 1 (rev b5)
			00:1c.4 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 5 (rev b5)
			00:1d.0 USB controller: Intel Corporation 6 Series/C200 Series Chipset Family USB Enhanced Host Controller #1 (rev 05)
			00:1e.0 PCI bridge: Intel Corporation 82801 PCI Bridge (rev a5)
			00:1f.0 ISA bridge: Intel Corporation C204 Chipset Family LPC Controller (rev 05)
			00:1f.2 SATA controller: Intel Corporation 6 Series/C200 Series Chipset Family SATA AHCI Controller (rev 05)
			00:1f.3 SMBus: Intel Corporation 6 Series/C200 Series Chipset Family SMBus Controller (rev 05)
			01:00.0 Serial Attached SCSI controller: LSI Logic / Symbios Logic SAS2008 PCI-Express Fusion-MPT SAS-2 [Falcon] (rev 03)
			02:00.0 Ethernet controller: Intel Corporation 82574L Gigabit Network Connection
			03:03.0 VGA compatible controller: Matrox Electronics Systems Ltd. MGA G200eW WPCM450 (rev 0a)
			</pre>

			In my case i want to passthrough the SAS Controller so the Address is 01:00.0
			Currently there is a bug [http://bugs.alpinelinux.org/issues/3609 #3609]in Alpine due to which we can't use the Default way to use Kernelparameters for it.

			Edit /etc/modules and reboot the server:
			<pre>
			node03:~# grep pciback /etc/modules
			xen_pciback hide=(01:00.0)
			</pre>

			After a reboot you should be able to see that the pci-device is using the pciback Kernelmodule and should be visible to passthrough via xl:
			<pre>
			node03:~# lspci -k \| grep -A2 '01:00.0'
			01:00.0 Serial Attached SCSI controller: LSI Logic / Symbios Logic SAS2008 PCI-Express Fusion-MPT SAS-2 [Falcon] (rev 03)
			Subsystem: LSI Logic / Symbios Logic Device 3020
			Kernel driver in use: pciback
			node03:~# xl pci-assignable-list
			0000:01:00.0
			</pre>

			Now just add a line to your DomU's Config and everything should be fine.
			<pre>
			pci = [ '01:00.0' ]
			</pre>

			====Known Issue with LSI Controllers====
			As the Kernelmodule for LSI Controllers is built into the Alpine Initramfs, the real Module is loaded before the pciback Module can be assigned.
			Just blacklist the mpt2sas module in /etc/modprobe.d/blacklist.conf and rebuilt your initramfs.
			<pre>
			node03:~# grep sas /etc/modprobe.d/blacklist.conf
			blacklist mpt2sas
			node03:~# mkinitfs
			==> initramfs: creating /boot/initramfs-grsec
			11538 blocks
			33641 blocks
			</pre>

Nangel: Created page with "Placeholder for TZE"

2015-01-03T19:51:21Z

Created page with "Placeholder for TZE"

New page

Placeholder for TZE