svn commit: r40610 - head/en_US.ISO8859-1/books/faq

[Eitan Adler]

Author: eadler
Date: Sun Jan 13 06:38:31 2013
New Revision: 40610
URL: http://svnweb.freebsd.org/changeset/doc/40610

Log:
  Answer the question "I can not delete or or create files on my ZFS pool.
  How can I fix this?"
  
  Submitted by:       Alexander Yerenkow <yerenkow at gmail.com>
  Reviewed by:        -doc
  Approved by:        bcr (mentor)
  
  Patch recreated from mailing list content

Modified:
  head/en_US.ISO8859-1/books/faq/book.xml

Modified: head/en_US.ISO8859-1/books/faq/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/faq/book.xml	Sun Jan 13 06:30:15 2013	(r40609)
+++ head/en_US.ISO8859-1/books/faq/book.xml	Sun Jan 13 06:38:31 2013	(r40610)
@@ -4472,6 +4472,32 @@ C:\="DOS"</programlisting>
 	      slower.</para>
 	  </answer>
 	</qandaentry>
+
+	<qandaentry>
+	  <question id="zpool-fully-full">
+	    <para>I can not delete or create files on my ZFS pool.
+	      How can I fix this?</para>
+	  </question>
+
+	  <answer>
+	     <para>This could happen because the pool is 100% full.
+	       ZFS requires space on the disk in order to write
+	       transaction metadata.  In order to restore the pool
+	       to a usable state, truncate a file you want to
+	       delete.</para>
+
+	     <screen>&prompt.user; <userinput>truncate -s 0 <replaceable>unimportant-file</replaceable></userinput></screen>
+
+	     <para>File truncation works because a new transaction is
+	       not started, new spare blocks are created instead.</para>
+
+	     <note>
+	       <para>On systems with additional ZFS dataset tuning,
+		 such as deduplication, the space may not be immediately
+		 available</para>
+	     </note>
+	  </answer>
+	</qandaentry>
       </qandaset>
     </sect1>
   </chapter>