zpool-labelclear(8)

zpool-labelclear8

Remove zfs label information from device

Usage

zpool labelclear [-f] device

Overview

Removes ZFS label information from the specified device. If the device is a cache device, it also removes the L2ARC header (persistent L2ARC). The device must not be part of an active pool configuration.

This overwrites pool metadata, making all data on the device inaccessible without specialized recovery tools. Unlike zpool destroy, this cannot be undone by ZFS tooling. Only use this when you don't care about the data on the device.

-f

Treat exported or foreign devices as inactive.

Releases

15 releases since FreeBSD 13.0-RELEASE; the text changed 4 times.

  1. 13.0
  2. 13.1–13.5
  3. 14.0–14.5
  4. 15.0–15.1
  5. 16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.