btrfs

Bindings to the btrfs API

https://github.com/redneb/hs-btrfs

LTS Haskell 24.24:0.2.1.0
Stackage Nightly 2025-12-16:0.2.1.0
Latest on Hackage:0.2.1.0

See all snapshots btrfs appears in

BSD-3-Clause licensed and maintained by Marios Titas <rednebΑΤgmxDΟΤcom>
This version can be pinned in stack with:btrfs-0.2.1.0@sha256:05206e8912ca8e180300da1df0a4bc858776af1fa3513d246089fd21dc9070f7,3923

Module documentation for 0.2.1.0

  • System
    • System.Linux
      • System.Linux.Btrfs
        • System.Linux.Btrfs.ByteString
        • System.Linux.Btrfs.Time
        • System.Linux.Btrfs.UUID
Depends on 4 packages(full list with versions):
base, bytestring, time, unix

This package provides bindings to the low-level btrfs API (i.e. the BTRFS_IOC_* ioctls). Currently, only a subset of the API is supported, including all functions needed to work with subvolumes/snapshots as well as file cloning.

In order to build this package, linux-headers needs to be installed.

Warning: btrfs is still considered experimental. This module is also experimental and may contain serious bugs that may result in data loss. Do not use it on data that has not been backed up yet.

Changes

0.2.1.0 2023-06-23

* Support building with `ghc-9`.
* Support building with `unix-2.8`.

0.2.0.0 2018-10-25

* Implement getFSInfo.
* Remove an ugly hack that was used to block signals while defrag was running.
* Support Zstd compression.
* Make CompressionType abstract.
* Fix handling of filenames that are not valid according to the current locale.
* Deprecate System.Linux.Btrfs.ByteString.
* Support getting/setting file system labels.

0.1.2.3 2017-01-30

* System.Linux.Btrfs.UUID.fromString did not handle all malformed
UUIDs correctly.

0.1.2.2 2016-11-15

* Fix compilation error when libcap is not installed.

0.1.2.1 2016-11-13

* Support cloneRangeIfSame on read-only subvolumes (requires
CAP_SYS_ADMIN).

0.1.2.0 2016-02-23

* Expose System.Linux.Btrfs.Time.
* Add example program that prints the file creation timestamp.

0.1.1.1 2014-10-05

* Support getting/setting the id of the default subvolume.

0.1.1.0 2014-10-05

* Support defraging file ranges.

0.1.0.0 2014-09-01

* Initial public release.