module

Beryl::Config::Zpool

Traduction entre les niveaux RAID numériques (convention utilisateur, parlante) et les modes ZFS (convention bsdinstall ZFSBOOT_VDEV_TYPE). Philippe 22 avril 2026 : « Je préfère une valeur de raid plutôt que la valeur FreeBSD qui n'est pas parlante ».

Mapping :

raid zfs min tolérance capacité usage ──── ───── ─── ──────────── ────────── ───────────────── 0 stripe 1 0 Σ(disques) perf max, backup 1 mirror 2 N-1 1 disque 2 disques, critique 5 raidz 3 1 Σ-1 3-5 disques 6 raidz2 4 2 Σ-2 6-8 disques 7 raidz3 5 3 Σ-3 8+ disques 10 mirror×N 4 1 par paire Σ/2 bases de données

Le cas 10 (miroirs de paires consécutives) : pools data, et pool boot avec install_type: packages (script pkgbase, zpool create mirror… mirror…) ; bsdinstall (ZFSBOOT_VDEV_TYPE) ne gère qu'un type de vdev.

Constants

MIN_DISKS = {0 => 1, 1 => 2, 5 => 3, 6 => 4, 7 => 5, 10 => 4}

Nombre minimum de disques par mode. Validation au moment du bootstrap (Beryl::Config::Zpool.validate!).

RAID_TO_ZFS = {0 => "stripe", 1 => "mirror", 5 => "raidz", 6 => "raidz2", 7 => "raidz3", 10 => "mirror_stripe"}

Table de référence : valeur RAID (Int32) → mode ZFS (String).

Instance methods

known?(raid : Int) : Bool

Vrai si raid est un niveau supporté.

Source
legend(levels : Array(Int32), separator : String = " ") : String

Légende 0=stripe 1=mirror … des niveaux donnés.

Source
possible_levels(disks_count : Int) : Array(Int32)

Niveaux réalisables avec disks_count disques (mêmes règles que validate!), dans l'ordre croissant. Sert à ne PROPOSER que ceux-là.

Source
validate!(raid : Int, disks_count : Int) : Nil

Valide la compatibilité entre le niveau RAID et le nombre de disques déclarés. Lève avec message explicite sinon.

Source
zfs_mode(raid : Int) : String

Retourne le mode ZFS correspondant, ou lève si le niveau est inconnu.

Source

Nested types