[PATCH docs v2 3/3] add FreeBSD CTL support for ZFS over iSCSI

["Микола Микола" <nikolaytihonov2022@gmail.com>]

>From 8d724a09390fc52671c2c1ef83250c90612527a7 Mon Sep 17 00:00:00 2001
From: mykola2312 <49044616+mykola2312@users.noreply.github.com>
Date: Mon, 6 Apr 2026 05:17:45 +0300
Subject: [PATCH] storage: document FreeBSD ctld for ZFS over iSCSI

---
 pve-storage-zfs.adoc | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/pve-storage-zfs.adoc b/pve-storage-zfs.adoc
index c07f534..49d9737 100644
--- a/pve-storage-zfs.adoc
+++ b/pve-storage-zfs.adoc
@@ -17,6 +17,7 @@ The following iSCSI target implementations are supported:
 * LIO (Linux)
 * IET (Linux)
 * ISTGT (FreeBSD)
+* CTL / `ctld` (FreeBSD)
 * Comstar (Solaris)

 NOTE: This plugin needs a ZFS capable remote storage appliance, you cannot use
@@ -47,7 +48,7 @@ The backend supports the common storage properties
`content`, `nodes`,
 pool::

 The ZFS pool/filesystem on the iSCSI target. All allocations are done
within that
-pool.
+pool or dataset. This can also be a nested dataset path, for example
`zroot/pve`.

 portal::

@@ -55,11 +56,13 @@ iSCSI portal (IP or DNS name with optional port).

 target::

-iSCSI target.
+iSCSI target. When using `ctld`, this target must already exist on the remote
+FreeBSD host.

 iscsiprovider::

-The iSCSI target implementation used on the remote machine
+The iSCSI target implementation used on the remote machine. `ctld` uses the
+native FreeBSD CTL iSCSI target implementation.

 comstar_tg::

@@ -86,6 +89,11 @@ sparse::
 Use ZFS thin-provisioning. A sparse volume is a volume whose
 reservation is not equal to the volume size.

+With FreeBSD `ctld`, configure the target itself on the remote host first,
+including any portal or authentication groups required by your deployment.
+{pve} then manages inline `lun N` entries below the configured target for the
+zvol-backed guest disks.
+

 .Configuration Examples (`/etc/pve/storage.cfg`)
 ----
@@ -107,6 +115,15 @@ zfs: solaris
    portal 192.0.2.112
    content images

+zfs: freebsd-ctl
+   blocksize 4k
+   target iqn.2026-03.example:freebsd.pve
+   pool zroot/pve
+   iscsiprovider ctld
+   portal 192.0.2.113
+   content images
+   sparse 1
+
 zfs: freebsd
    blocksize 4k
    target iqn.2007-09.jp.ne.peach.istgt:tank1
-- 
2.47.3