HPTRR(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

HPTRR(4) 💖 the HighPoint RocketRAID device driver

okay bestie, sit down, hydrate, because we're talking about hptrr — it's a kernel interfaces manual page, section 4, and it's literally all about making your RocketRAID card go brrrr. ✨

🌸 NAME 🌸

hptrr — HighPoint RocketRAID device driver. that's it, that's the name, no cap. 💅

✨ SYNOPSIS ✨

so there's two ways to get this driver living in your kernel, and you gotta pick your fighter. 🥊

option one: bake it into the kernel

drop these lines into your kernel configuration file, fr fr:

device hptrr
device scbus
device da

option two: load it as a module at boot

if you'd rather do the module thing, put this line in loader.conf(5):

hptrr_load="YES"

tunables bestie, from the loader

these are settable from the loader, and there's exactly one, so pay attention 🫶:

  • hw.hptrr.attach_generic — set it to 1 and the driver is allowed to attach to chips that identify with a generic Marvell (non-HighPoint) PCI identification. heads up though: ata(4) and mvs(4) also support those same chips. some vendors are out here using the same chips but without providing a RAID BIOS, so like, know what you're doing. 🙈

🦋 DESCRIPTION 🦋

the hptrr driver provides support for HighPoint's RocketRAID based RAID controllers. it's giving hardware whisperer.

these devices support SATA/ATA disk drives, and they hand you the classic trio of RAID functionality:

  • RAID0 (striping) — speed, speed, speed ⚡
  • RAID1 (mirroring) — your data, duplicated, cozy 🪞
  • RAID5 — parity party 🎉

👑 HARDWARE 👑

here's the full guest list of RAID controllers the hptrr driver supports — every single one, we don't gatekeep:

  • RocketRAID 172x series
  • RocketRAID 174x series
  • RocketRAID 2210
  • RocketRAID 222x series
  • RocketRAID 2240
  • RocketRAID 230x series
  • RocketRAID 231x series
  • RocketRAID 232x series
  • RocketRAID 2340
  • RocketRAID 2522

that's the whole list, periodt. 💅

💀 NOTES 💀

okay this is the part where we get real, because some of this is a little sad. 😭

The hptrr driver only works on the i386 and amd64 platforms.

why, you ask? because it requires a binary blob object from the manufacturer, and they only supply it for those platforms. so if you're on something else, this is not your moment. and listen — the hptrr driver does not work on i386 with pae(4) enabled. that's the tea. 🍵

also:

  • this driver does not support the RR182x series controller. if you need details on support for that one, go read the hptmv(4) manual page.
  • this driver supersedes the older rr232x driver. out with the old, in with the new. 🎀

🌈 SEE ALSO 🌈

go read your siblings, bestie, they're all iconic in their own way:

⭐ HISTORY ⭐

The hptrr device driver first appeared in FreeBSD 6.3. a legend from day one, honestly. ✨

🫶 AUTHORS 🫶

  • The hptrr device driver was written by HighPoint Technologies, Inc., and ported to FreeBSD by Scott Long.
  • This manual page was written by David E. O'Brien.

ty for your service, kings. 👑

🙈 BUGS 🙈

and here's the catch, because there's always a catch:

The hptrr driver does not support manipulating the RAID from the OS. RAIDs need to be set up from the on-board BIOS.

so yeah — you gotta go into the BIOS and do it there, the OS is not gonna hold your hand for this one. it is what it is. 💀

and that's the whole page, bestie!! this one came from Debian and it's dated June 6, 2012 — a vintage icon, honestly, we stan a classic. 🎀 mwah, go set up your RAID. 💖

📦 where this page comes from