From 5c84bd6899aa77f101d1fd635fc3d5b0094ecde1 Mon Sep 17 00:00:00 2001
From: Robert Millan <rmh@debian.org>
Date: Fri, 26 Nov 2010 15:45:44 +0000
Subject: Document UFS, document ZFS and its caveats

---
 en/using-d-i/modules/partman.xml | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

(limited to 'en')

diff --git a/en/using-d-i/modules/partman.xml b/en/using-d-i/modules/partman.xml
index 5e5cb1810..7c14d24a8 100644
--- a/en/using-d-i/modules/partman.xml
+++ b/en/using-d-i/modules/partman.xml
@@ -102,9 +102,43 @@ The following file systems are supported.
   <listitem arch="linux-any"><para>
     <emphasis>jfs</emphasis> (not available on all architectures)
   </para></listitem>
+  <listitem arch="kfreebsd-any"><para>
+    <emphasis>ufs</emphasis>
+  </para><para>
+    The default file system is UFS.
+  </para></listitem>
   <listitem arch="linux-any"><para>
     <emphasis>xfs</emphasis> (not available on all architectures)
   </para></listitem>
+  <listitem arch="kfreebsd-any"><para>
+    <emphasis>zfs</emphasis>
+  </para><para>
+    As ZFS support in the installer is still in development, only a basic
+    subset of ZFS features are supported. Some of them can be enabled
+    manually after the initial install, but there are some caveats:
+    <itemizedlist>
+      <listitem>
+        Each ZFS pool will host only one filesystem. After install is finished,
+        more filesystems can be created on this pool by using the
+        <quote>zfs create</quote> command.
+      </listitem>
+      <listitem>
+        Each ZFS pool will be composed of exactly one partition. After install
+        is finished, a single-device ZFS pool can be converted into a multi-device
+        pool by using the <quote>zpool add</quote> command, or into a mirrored
+        pool by using the <quote>zpool attach</quote> command. However, you shouldn't
+        do this on the pool that hosts root filesystem, as it would prevent GRUB
+        from booting your system.
+      </listitem>
+      <listitem>
+        Compression is not currently supported. After the install is finished,
+        compression can be enabled by setting the <quote>compression</quote> property
+        via the <quote>zfs set</quote> command. However, if a compression algorithm
+	other than the default (lzjb) is used on the pool that hosts your root
+        filesystem, this may prevent GRUB from booting your system.
+      </listitem>
+    </itemizedlist>
+  </para></listitem>
   <listitem arch="linux-any"><para>
     <emphasis>reiserfs</emphasis> (optional; not available on all architectures)
   </para><para>
-- 
cgit v1.2.3