FreeBSD kernel with Fibre Channel target mode support for QLogic cards

Introduction

FreeBSD doesn't enable target mode support for QLogic cards, so we need to compile a custom kernel. We'll assume we have installed a release and we have a populated /usr/src.

Create the kernel configuration file

cat <<EOF >/tmp/FCTARGET
include GENERIC
ident FCTARGET

options ISP_TARGET_MODE
EOF
sudo install -g staff -o aram /tmp/FCTARGET /usr/src/sys/amd64/conf

Create /etc/make.conf

cat <<EOF >/tmp/make.conf
# Build and install FCTARGET and GENERIC kernels
# FCTARGET will be installed by default.
KERNCONF=FCTARGET GENERIC
EOF
sudo install -g staff -o aram /tmp/make.conf /etc

Exclude the kernels from freebsd-update(8)

Make sure /etc/freebsd-update.conf doesn't list the kernels:

Components src world

Create /usr/obj

Assuming you have ZFS:

sudo zfs create zroot/usr/obj
sudo chown aram:staff /usr/obj

Build and install the kernels

Build the kernels:

cd /usr/src
# builds FCTARGET and GENERIC
make buildkernel -j24

Install the kernels:

# install FCTARGET into /boot/kernel (default) and GENERIC into /boot/GENERIC
sudo make -j24 installkernel
sudo make -j24 installkernel KERNCONF=GENERIC INSTKERNNAME=GENERIC

Load isp(4) driver firmware in /etc/loader.conf

As root:

sudo su -
echo ispfw_load="YES" >> /boot/loader.conf

isp(4) is already compiled into the kernel, no need to load it.

Reboot and test

sudo reboot

Update

When updating to the same RELEASE, run freebsd-update(8) to get new source and binaries, then recompile the kernels and reboot.

You can't upgrade to a newer RELEASE without rebuilding the newer kernel first.

References

• FreeBSD Handbook: Building and Installing a Custom Kernel
• FreeBSD Handbook: 23.2.3.1. Custom Kernels with FreeBSD 9.X and Later
• make.conf(5)
• src.conf(5)
• build(7)
• isp(4)