Create pcie-passthrough.sh
create a pcie-passthrough helper script which will modify the relevant files according to the Proxmox documentation here: https://pve.proxmox.com/wiki/PCI(e)_Passthrough
This commit is contained in:
Joseph
GitHub
parent
253da053fe
commit
14cf513ecf
1 changed files with 336 additions and 0 deletions
336
misc/pcie-passthrough.sh
Normal file
336
misc/pcie-passthrough.sh
Normal file
|
|
@ -0,0 +1,336 @@
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# Author: jpaveg
|
||||||
|
# Adapted from: tteck (tteckster)
|
||||||
|
# License: MIT
|
||||||
|
# https://github.com/tteck/Proxmox/raw/main/LICENSE
|
||||||
|
header_info() {
|
||||||
|
clear
|
||||||
|
cat <<"EOF"
|
||||||
|
____
|
||||||
|
/ __ \_________ _ ______ ___ ____ _ __
|
||||||
|
/ /_/ / ___/ __ \| |/_/ __ `__ \/ __ \| |/_/
|
||||||
|
/ ____/ / / /_/ /> </ / / / / / /_/ /> <
|
||||||
|
/_/ /_/ \____/_/|_/_/ /_/ /_/\____/_/|_|
|
||||||
|
|
||||||
|
____ __ __ __
|
||||||
|
/ __ \____ ___________/ /_/ /_ _________ __ ______ _/ /_
|
||||||
|
/ /_/ / __ `/ ___/ ___/ __/ __ \/ ___/ __ \/ / / / __ `/ __ \
|
||||||
|
/ ____/ /_/ (__ |__ ) /_/ / / / / / /_/ / /_/ / /_/ / / / /
|
||||||
|
/_/ \__,_/____/____/\__/_/ /_/_/ \____/\__,_/\__, /_/ /_/
|
||||||
|
/____/
|
||||||
|
_____ _ __
|
||||||
|
/ ___/__________(_)___ / /_
|
||||||
|
\__ \/ ___/ ___/ / __ \/ __/
|
||||||
|
___/ / /__/ / / / /_/ / /_
|
||||||
|
/____/\___/_/ /_/ .___/\__/
|
||||||
|
/_/
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
RD=$(echo "\033[01;31m")
|
||||||
|
YW=$(echo "\033[33m")
|
||||||
|
GN=$(echo "\033[1;92m")
|
||||||
|
CL=$(echo "\033[m")
|
||||||
|
BFR="\\r\\033[K"
|
||||||
|
HOLD="-"
|
||||||
|
CM="${GN}✓${CL}"
|
||||||
|
CROSS="${RD}✗${CL}"
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s inherit_errexit nullglob
|
||||||
|
|
||||||
|
GRUB_FILE="/etc/default/grub"
|
||||||
|
GRUB_FILE_BACKUP="/etc/default/grub.bak"
|
||||||
|
SYSTEMD_FILE="/etc/kernel/cmdline"
|
||||||
|
SYSTEMD_FILE_BACKUP="/etc/kernel/cmdline.bak"
|
||||||
|
MODULES_FILE="/etc/modules"
|
||||||
|
MODULES_FILE_BACKUP="/etc/modules.bak"
|
||||||
|
|
||||||
|
CPU_TYPE="unknown"
|
||||||
|
|
||||||
|
msg_info() {
|
||||||
|
local msg="$1"
|
||||||
|
echo -ne " ${HOLD} ${YW}${msg}..."
|
||||||
|
}
|
||||||
|
|
||||||
|
msg_ok() {
|
||||||
|
local msg="$1"
|
||||||
|
echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
|
||||||
|
}
|
||||||
|
|
||||||
|
msg_error() {
|
||||||
|
local msg="$1"
|
||||||
|
echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
|
||||||
|
}
|
||||||
|
|
||||||
|
check_cpu_type() {
|
||||||
|
msg_info "Checking CPU Type"
|
||||||
|
# Check the Vendor ID using lscpu
|
||||||
|
vendor_id=$(lscpu | grep "Vendor ID")
|
||||||
|
vendor_id=$(echo $vendor_id | awk '{print $3}')
|
||||||
|
|
||||||
|
if [ "$vendor_id" == "GenuineIntel" ]; then
|
||||||
|
msg_info "Intel CPU detected"
|
||||||
|
CPU_TYPE="intel"
|
||||||
|
elif [ "$vendor_id" == "AuthenticAMD" ]; then
|
||||||
|
msg_info "AMD CPU detected"
|
||||||
|
CPU_TYPE="amd"
|
||||||
|
else
|
||||||
|
msg_error "Unknown CPU vendor, exiting"
|
||||||
|
exit
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
modify_grub_cmdline() {
|
||||||
|
# Make a backup of the GRUB file
|
||||||
|
sudo cp $GRUB_FILE $GRUB_FILE_BACKUP
|
||||||
|
|
||||||
|
# Extract the content of GRUB_CMDLINE_LINUX_DEFAULT using sed
|
||||||
|
cmdline_flags=$(sed -n 's/^GRUB_CMDLINE_LINUX_DEFAULT="\(.*\)"/\1/p' "$GRUB_FILE")
|
||||||
|
|
||||||
|
# Initialize an associative array to hold key-value pairs
|
||||||
|
declare -A kv_pairs
|
||||||
|
# Initialize a string to hold flags
|
||||||
|
flags=""
|
||||||
|
|
||||||
|
# Iterate over each item in the cmdline_flags
|
||||||
|
for item in $cmdline_flags; do
|
||||||
|
if [[ "$item" != *"="* ]]; then
|
||||||
|
# If it's a flag, add it to the flags string
|
||||||
|
flags="$flags $item"
|
||||||
|
else
|
||||||
|
# If it's a key-value pair, split it and add to associative array
|
||||||
|
IFS='=' read -r key value <<<"$item"
|
||||||
|
kv_pairs["$key"]="$value"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
# Use whiptail to ask user if they want to enable IOMMU passthrough mode
|
||||||
|
if (whiptail --title "GRUB - IOMMU Passthrough" --yesno "Do you want to enable IOMMU passthrough mode?" 10 60); then
|
||||||
|
kv_pairs["iommu"]="pt"
|
||||||
|
else
|
||||||
|
unset kv_pairs["iommu"] # Remove the key if the user selects "No"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check if CPU_TYPE is Intel before enabling Intel IOMMU
|
||||||
|
if [ "$CPU_TYPE" == "intel" ]; then
|
||||||
|
if (whiptail --title "GRUB - Intel IOMMU" --yesno "Do you want to enable Intel IOMMU?" 10 60); then
|
||||||
|
kv_pairs["intel_iommu"]="on"
|
||||||
|
else
|
||||||
|
unset kv_pairs["intel_iommu"] # Remove the key if the user selects "No"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Reconstruct the new GRUB_CMDLINE_LINUX_DEFAULT line
|
||||||
|
new_cmdline_flags="$flags"
|
||||||
|
for key in "${!kv_pairs[@]}"; do
|
||||||
|
new_cmdline_flags="$new_cmdline_flags $key=${kv_pairs[$key]}"
|
||||||
|
done
|
||||||
|
|
||||||
|
# Remove leading space
|
||||||
|
new_cmdline_flags=$(echo "$new_cmdline_flags" | sed 's/^ //')
|
||||||
|
|
||||||
|
# Set the updated flags and key-value pairs in GRUB file
|
||||||
|
msg_info "Setting GRUB_CMDLINE_LINUX_DEFAULT flags"
|
||||||
|
sudo sed -i "/GRUB_CMDLINE_LINUX_DEFAULT=/ s/\(GRUB_CMDLINE_LINUX_DEFAULT=\).*/\1\"$new_cmdline_flags\"/" $GRUB_FILE
|
||||||
|
|
||||||
|
# Output the updated GRUB_CMDLINE_LINUX_DEFAULT line for verification
|
||||||
|
msg_ok "Modified /etc/default/grub: GRUB_CMDLINE_LINUX_DEFAULT=\"$new_cmdline_flags\""
|
||||||
|
|
||||||
|
# Run update-grub to finish changes
|
||||||
|
msg_info "Running update-grub to finalize changes to cmdline"
|
||||||
|
# sudo update-grub
|
||||||
|
}
|
||||||
|
|
||||||
|
modify_systemd_boot_cmdline() {
|
||||||
|
# Make a backup of the cmdline file
|
||||||
|
sudo cp "$SYSTEMD_FILE" "$SYSTEMD_FILE_BACKUP"
|
||||||
|
|
||||||
|
# Extract the content of the cmdline file
|
||||||
|
cmdline_flags=$(cat "$SYSTEMD_FILE")
|
||||||
|
|
||||||
|
# Initialize an associative array to hold key-value pairs
|
||||||
|
declare -A kv_pairs
|
||||||
|
# Initialize a string to hold flags
|
||||||
|
flags=""
|
||||||
|
|
||||||
|
# Iterate over each item in the cmdline_flags
|
||||||
|
for item in $cmdline_flags; do
|
||||||
|
if [[ "$item" != *"="* ]]; then
|
||||||
|
# If it's a flag, add it to the flags string
|
||||||
|
flags="$flags $item"
|
||||||
|
else
|
||||||
|
# If it's a key-value pair, split it and add to associative array
|
||||||
|
IFS='=' read -r key value <<<"$item"
|
||||||
|
kv_pairs["$key"]="$value"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
# Use whiptail to ask user if they want to enable IOMMU passthrough mode
|
||||||
|
if (whiptail --title "SYSTEMD - IOMMU Passthrough" --yesno "Do you want to enable IOMMU passthrough mode?" 10 60); then
|
||||||
|
kv_pairs["iommu"]="pt"
|
||||||
|
else
|
||||||
|
unset kv_pairs["iommu"] # Remove the key if the user selects "No"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check if CPU_TYPE is Intel before enabling Intel IOMMU
|
||||||
|
if [ "$CPU_TYPE" == "intel" ]; then
|
||||||
|
if (whiptail --title "SYSTEMD - Intel IOMMU" --yesno "Do you want to enable Intel IOMMU?" 10 60); then
|
||||||
|
kv_pairs["intel_iommu"]="on"
|
||||||
|
else
|
||||||
|
unset kv_pairs["intel_iommu"] # Remove the key if the user selects "No"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Reconstruct the new kernel cmdline
|
||||||
|
new_cmdline_flags="$flags"
|
||||||
|
for key in "${!kv_pairs[@]}"; do
|
||||||
|
new_cmdline_flags="$new_cmdline_flags $key=${kv_pairs[$key]}"
|
||||||
|
done
|
||||||
|
|
||||||
|
# Remove leading space
|
||||||
|
new_cmdline_flags=$(echo "$new_cmdline_flags" | sed 's/^ //')
|
||||||
|
|
||||||
|
# Set the updated flags and key-value pairs in cmdline file
|
||||||
|
msg_info "Setting kernel cmdline flags"
|
||||||
|
echo -n "$new_cmdline_flags" | sudo tee "$SYSTEMD_FILE" >/dev/null
|
||||||
|
|
||||||
|
# Output the updated cmdline for verification
|
||||||
|
msg_ok "Modified /etc/kernel/cmdline: \"$new_cmdline_flags\""
|
||||||
|
|
||||||
|
# Run proxmox-boot-tool refresh to apply changes
|
||||||
|
msg_info "Running proxmox-boot-tool refresh to apply changes"
|
||||||
|
# sudo proxmox-boot-tool refresh
|
||||||
|
}
|
||||||
|
|
||||||
|
modify_kernel_modules() {
|
||||||
|
# List of required modules
|
||||||
|
required_modules=("vfio" "vfio_iommu_type1" "vfio_pci")
|
||||||
|
|
||||||
|
# Check the kernel version
|
||||||
|
KERNEL_VERSION=$(uname -r | cut -d'-' -f1)
|
||||||
|
KERNEL_MAJOR=$(echo "$KERNEL_VERSION" | cut -d'.' -f1)
|
||||||
|
KERNEL_MINOR=$(echo "$KERNEL_VERSION" | cut -d'.' -f2)
|
||||||
|
|
||||||
|
# Add vfio_virqfd only if the kernel version is older than 6.2
|
||||||
|
if [ "$KERNEL_MAJOR" -lt 6 ] || { [ "$KERNEL_MAJOR" -eq 6 ] && [ "$KERNEL_MINOR" -lt 2 ]; }; then
|
||||||
|
echo $KERNEL_MAJOR $KERNEL_MINOR $KERNEL_VERSION
|
||||||
|
required_modules+=("vfio_virqfd")
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Make a backup of the current modules file
|
||||||
|
sudo cp "$MODULES_FILE" "$MODULES_FILE_BACKUP"
|
||||||
|
|
||||||
|
# Load current modules into an associative array for quick lookup
|
||||||
|
declare -A current_modules
|
||||||
|
if [ -f "$MODULES_FILE" ]; then
|
||||||
|
while IFS= read -r line; do
|
||||||
|
# Skip empty lines and comments
|
||||||
|
[[ "$line" =~ ^#.*$ ]] || [[ -z "$line" ]] && continue
|
||||||
|
current_modules["$line"]=1
|
||||||
|
done <"$MODULES_FILE"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Initialize a flag to track if we need to update the modules file
|
||||||
|
update_needed=false
|
||||||
|
|
||||||
|
# Check each required module and add it if not present
|
||||||
|
for module in "${required_modules[@]}"; do
|
||||||
|
# Use a default value for the lookup to avoid unbound variable errors
|
||||||
|
if [[ -z "${current_modules[$module]+x}" ]]; then
|
||||||
|
echo "$module" | sudo tee -a "$MODULES_FILE" >/dev/null
|
||||||
|
update_needed=true
|
||||||
|
msg_info "Added $module to $MODULES_FILE"
|
||||||
|
else
|
||||||
|
msg_ok "$module is already present in $MODULES_FILE"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
# Refresh initramfs if we added any new modules
|
||||||
|
if [ "$update_needed" = true ]; then
|
||||||
|
msg_info "Updating initramfs to apply module changes"
|
||||||
|
sudo update-initramfs -u -k all
|
||||||
|
msg_ok "Initramfs updated successfully"
|
||||||
|
else
|
||||||
|
msg_ok "No changes needed for $MODULES_FILE"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Main
|
||||||
|
start_routines() {
|
||||||
|
header_info
|
||||||
|
check_cpu_type
|
||||||
|
|
||||||
|
# Display a whiptail menu for the user to choose an option
|
||||||
|
OPTION=$(whiptail --title "Select Command Line Modification" --menu "Choose an option:" 15 60 4 \
|
||||||
|
"1" "Modify GRUB cmdline" \
|
||||||
|
"2" "Modify systemd-boot cmdline" \
|
||||||
|
"3" "Modify both cmdlines" \
|
||||||
|
"4" "Exit" 3>&1 1>&2 2>&3)
|
||||||
|
|
||||||
|
# Act based on the user's choice
|
||||||
|
case $OPTION in
|
||||||
|
"1")
|
||||||
|
modify_grub_cmdline
|
||||||
|
;;
|
||||||
|
"2")
|
||||||
|
modify_systemd_boot_cmdline
|
||||||
|
;;
|
||||||
|
"3")
|
||||||
|
modify_grub_cmdline || msg_error "There was an error modifying the GRUB cmdline, continuing to next step."
|
||||||
|
modify_systemd_boot_cmdline || msg_error "There was an error modifying the SYSTEMD-BOOT cmdline, continuing to next step."
|
||||||
|
;;
|
||||||
|
"4")
|
||||||
|
echo "Exiting without making any changes."
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "Invalid option. Exiting."
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
echo "Debug: Calling modify_kernel_modules"
|
||||||
|
modify_kernel_modules
|
||||||
|
}
|
||||||
|
|
||||||
|
echo -e "\nThis script will modify your cmdline and kernel flags to enable passthrough & vfio.\n"
|
||||||
|
while true; do
|
||||||
|
read -p "Start the Proxmox VE Passthrough Script (y/n)?" yn
|
||||||
|
case $yn in
|
||||||
|
[Yy]*) break ;;
|
||||||
|
[Nn]*)
|
||||||
|
clear
|
||||||
|
exit
|
||||||
|
;;
|
||||||
|
*) echo "Please answer yes or no." ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
if ! pveversion | grep -Eq "pve-manager/8.[0-2]"; then
|
||||||
|
msg_error "This version of Proxmox Virtual Environment is not supported"
|
||||||
|
echo -e "Requires Proxmox Virtual Environment Version 8.0 or later."
|
||||||
|
echo -e "Exiting..."
|
||||||
|
sleep 2
|
||||||
|
exit
|
||||||
|
fi
|
||||||
|
|
||||||
|
start_routines
|
||||||
|
|
||||||
|
# Notification to the user
|
||||||
|
echo -e "\n\nScript execution complete."
|
||||||
|
|
||||||
|
# Notify the user about the need to reboot and verify IOMMU
|
||||||
|
echo -e "To apply the changes, please reboot your system."
|
||||||
|
|
||||||
|
# Provide instructions to verify IOMMU is enabled
|
||||||
|
echo -e "After rebooting, run the following command to ensure IOMMU is enabled:"
|
||||||
|
echo -e " dmesg | grep -e DMAR -e IOMMU -e AMD-Vi"
|
||||||
|
|
||||||
|
# Inform about the backup files
|
||||||
|
echo -e "\nBackup files have been created for your safety:"
|
||||||
|
echo -e " $GRUB_FILE_BACKUP"
|
||||||
|
echo -e " $SYSTEMD_FILE_BACKUP"
|
||||||
|
echo -e " $MODULES_FILE_BACKUP"
|
||||||
|
|
||||||
|
# Provide link for further information
|
||||||
|
echo -e "\nFor more information or if you encounter issues, please visit:"
|
||||||
|
echo -e " https://pve.proxmox.com/wiki/PCI(e)_Passthrough"
|
||||||
Loading…
Reference in a new issue