From a0dbff04fd58401f9d54ff9fca6d041f0faf029b Mon Sep 17 00:00:00 2001
From: Monahov Dmitry <mov@jazz.campus>
Date: Thu, 19 Nov 2009 18:21:56 +0300
Subject: [PATCH] Document update

---
 quota.html | 150 ++++++++++++++++++++++++++++++++++++++++---------------------
 quota.org  |  37 +++++++++++----
 2 files changed, 127 insertions(+), 60 deletions(-)

diff --git a/quota.html b/quota.html
index 9685440..7c98049 100644
--- a/quota.html
+++ b/quota.html
@@ -6,8 +6,8 @@ lang="en" xml:lang="en">
 <title>quota</title>
 <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
 <meta name="generator" content="Org-mode"/>
-<meta name="generated" content="2009-11-18 09:25:08 MSK"/>
-<meta name="author" content="Dmitry Monakhov"/>
+<meta name="generated" content="2009-11-19 18:21:17 MSK"/>
+<meta name="author" content="Monahov Dmitry"/>
 <style type="text/css">
  <!--/*--><![CDATA[/*><!--*/
   html { font-family: Times, serif; font-size: 12pt; }
@@ -71,21 +71,23 @@ lang="en" xml:lang="en">
 <h2>Table of Contents</h2>
 <div id="text-table-of-contents">
 <ul>
-<li><a href="#sec-1">1 directory tree quota desing and implementation </a>
+<li><a href="#sec-1">1 directory tree quota design and implementation </a>
 <ul>
-<li><a href="#sec-1.1">1.1 Introduction </a></li>
-<li><a href="#sec-1.2">1.2 Containers fs root requirement </a></li>
-<li><a href="#sec-1.3">1.3 Containers directory tree-id  assumptions </a>
+<li><a href="#sec-1.1">1.1 STATUS </a></li>
+<li><a href="#sec-1.2">1.2 Introduction </a></li>
+<li><a href="#sec-1.3">1.3 Containers fs root requirement </a></li>
+<li><a href="#sec-1.4">1.4 Containers directory tree-id  assumptions </a>
 <ul>
-<li><a href="#sec-1.3.1">1.3.1 -&gt;rename() restriction </a></li>
-<li><a href="#sec-1.3.2">1.3.2 -&gt;link restriction </a></li>
+<li><a href="#sec-1.4.1">1.4.1 -&gt;rename() restriction </a></li>
+<li><a href="#sec-1.4.2">1.4.2 -&gt;link restriction </a></li>
 </ul>
 </li>
-<li><a href="#sec-1.4">1.4 Patche queue </a></li>
-<li><a href="#sec-1.5">1.5 How-to </a>
+<li><a href="#sec-1.5">1.5 Patch queue </a></li>
+<li><a href="#sec-1.6">1.6 How-to </a>
 <ul>
-<li><a href="#sec-1.5.1">1.5.1 Enabling tree quota </a></li>
-<li><a href="#sec-1.5.2">1.5.2 Creating containers tree </a></li>
+<li><a href="#sec-1.6.1">1.6.1 Enabling tree quota an Easy way </a></li>
+<li><a href="#sec-1.6.2">1.6.2 Enabling tree quota from very beginning </a></li>
+<li><a href="#sec-1.6.3">1.6.3 Creating containers tree </a></li>
 </ul>
 </li>
 </ul>
@@ -95,19 +97,30 @@ lang="en" xml:lang="en">
 </div>
 
 <div id="outline-container-1" class="outline-2">
-<h2 id="sec-1">1 directory tree quota desing and implementation </h2>
+<h2 id="sec-1">1 directory tree quota design and implementation </h2>
 <div id="text-1">
 
 
 </div>
 
 <div id="outline-container-1.1" class="outline-3">
-<h3 id="sec-1.1">1.1 Introduction </h3>
+<h3 id="sec-1.1">1.1 STATUS </h3>
 <div id="text-1.1">
 
+<p>V0.07 :: I've succeed in testing journalled tree-quota. At least it survived
+in fsstress and other manual tests.
+</p>
+</div>
+
+</div>
+
+<div id="outline-container-1.2" class="outline-3">
+<h3 id="sec-1.2">1.2 Introduction </h3>
+<div id="text-1.2">
+
 <p>This document contains basic introduction to directory tree
-quota for didicated trees. Currently Linux support many 
-virtualization extentions. One of approaches is containers.
+quota for dedicated trees. Currently Linux support many 
+virtualization extensions. One of approaches is containers.
 Containers is OS level paravirtualization like jail in BSD.
 In two words container is a set of process isolated from
 other system. Each process has it's own name-spaces for
@@ -117,11 +130,11 @@ network,fs,ipc,etc. You may think of container as secure chroot.
 
 </div>
 
-<div id="outline-container-1.2" class="outline-3">
-<h3 id="sec-1.2">1.2 Containers fs root requirement </h3>
-<div id="text-1.2">
+<div id="outline-container-1.3" class="outline-3">
+<h3 id="sec-1.3">1.3 Containers fs root requirement </h3>
+<div id="text-1.3">
 
-<p>So container's root are independent tree or several trees.
+<p>Container's root are independent tree or several trees.
 usually they organized like follows <b>/ct-root/CT${ID\}/${tree-content}</b>
 There are many reasons to keep this trees separate one from another
 </p><dl>
@@ -130,7 +143,7 @@ There are many reasons to keep this trees separate one from another
 <p>
 If inode has links in A and B trees. And A-user call chown() for
 this inode, then B's owner will be surprised.
-The only way to overcome this is to virtualize inode atributes
+The only way to overcome this is to virtualize inode attributes
 (for each tree) which is madness IMHO.
 </p></dd>
 <dt>checkpoint/restore/online-backup</dt><dd>
@@ -144,10 +157,9 @@ FS as a whole.
 </dd>
 </dl>
 
-<p>As I already say there are many way to accomplish this task. But everyone
-has strong disadvantages:
-</p>
-<dl>
+<p>As I already say there are many way to isolate per-container fs-tree. 
+But everyone has strong disadvantages:
+</p><dl>
 <dt>Virtual block devices(qemu-like)</dt><dd>
 problems with consistency and performance
 </dd>
@@ -167,9 +179,9 @@ implement it on native fs level.
 
 </div>
 
-<div id="outline-container-1.3" class="outline-3">
-<h3 id="sec-1.3">1.3 Containers directory tree-id  assumptions </h3>
-<div id="text-1.3">
+<div id="outline-container-1.4" class="outline-3">
+<h3 id="sec-1.4">1.4 Containers directory tree-id  assumptions </h3>
+<div id="text-1.4">
 
 <ol>
 <li>
@@ -190,9 +202,9 @@ other trees. Default tree is used for subtree manipulation.
 </p>
 </div>
 
-<div id="outline-container-1.3.1" class="outline-4">
-<h4 id="sec-1.3.1">1.3.1 -&gt;rename() restriction </h4>
-<div id="text-1.3.1">
+<div id="outline-container-1.4.1" class="outline-4">
+<h4 id="sec-1.4.1">1.4.1 -&gt;rename() restriction </h4>
+<div id="text-1.4.1">
 
 
 
@@ -221,9 +233,9 @@ other trees. Default tree is used for subtree manipulation.
 
 </div>
 
-<div id="outline-container-1.3.2" class="outline-4">
-<h4 id="sec-1.3.2">1.3.2 -&gt;link restriction </h4>
-<div id="text-1.3.2">
+<div id="outline-container-1.4.2" class="outline-4">
+<h4 id="sec-1.4.2">1.4.2 -&gt;link restriction </h4>
+<div id="text-1.4.2">
 
 
 
@@ -241,9 +253,9 @@ other trees. Default tree is used for subtree manipulation.
 
 </div>
 
-<div id="outline-container-1.4" class="outline-3">
-<h3 id="sec-1.4">1.4 Patche queue </h3>
-<div id="text-1.4">
+<div id="outline-container-1.5" class="outline-3">
+<h3 id="sec-1.5">1.5 Patch queue </h3>
+<div id="text-1.5">
 
 <p>I've prepare proof of concept patch queue.
 <a href="http://www.2ka.mipt.ru/~mov/tree-quota.tgz">patch-queue</a>
@@ -251,18 +263,54 @@ other trees. Default tree is used for subtree manipulation.
 
 </div>
 
-<div id="outline-container-1.5" class="outline-3">
-<h3 id="sec-1.5">1.5 How-to </h3>
-<div id="text-1.5">
+<div id="outline-container-1.6" class="outline-3">
+<h3 id="sec-1.6">1.6 How-to </h3>
+<div id="text-1.6">
 
-<p>This part containt some tips of tree-quota usage. Assume you have kernel
+<p>This part contain some tips of tree-quota usage. Assume you have kernel
 with tree-quota patch applied.
 </p>
 </div>
 
-<div id="outline-container-1.5.1" class="outline-4">
-<h4 id="sec-1.5.1">1.5.1 Enabling tree quota </h4>
-<div id="text-1.5.1">
+<div id="outline-container-1.6.1" class="outline-4">
+<h4 id="sec-1.6.1">1.6.1 Enabling tree quota an Easy way </h4>
+<div id="text-1.6.1">
+
+<p>You may download small file-system image with tree-quota enabled.
+<a href="http://www.2ka.mipt.ru/~mov/fs-trquota.img.gz">fs-trquota.img.gz(3Mb)</a>
+mount /test/fs.img /mnt -oloop,quota,grpquota,treeid,trquota
+<b>NOTE in order to use journalling quota use following mount options</b>
+</p>
+
+
+<pre class="example">
+   jqfmt=vfsv0,treeid,trjquota=aquota.tree
+</pre>
+
+
+
+
+<pre class="example">
+    Currently quota-tools has no tree-quota support. So you have to manually
+    create aquota.tree file. Just copy quota-tree/tool/aquota.tree to the root
+    of your fs
+    mount /test/fs.img /mnt -oloop,quota,grpquota,treeid,trquota
+    cp quota-tree/tool/aquota.tree  /mnt/
+    # enable all quotas
+    quota-tree/tool/quotactl --on --all --path /mnt --dev /dev/loop0
+    # show quotas type ==0 -&gt; usrquota, type == 2 -&gt; trqota
+    quota-tree/tool/quotactl --get --all --type 2 --dev /dev/loop0
+</pre>
+
+
+
+</div>
+
+</div>
+
+<div id="outline-container-1.6.2" class="outline-4">
+<h4 id="sec-1.6.2">1.6.2 Enabling tree quota from very beginning </h4>
+<div id="text-1.6.2">
 
 
 
@@ -285,9 +333,9 @@ with tree-quota patch applied.
 
 </div>
 
-<div id="outline-container-1.5.2" class="outline-4">
-<h4 id="sec-1.5.2">1.5.2 Creating containers tree </h4>
-<div id="text-1.5.2">
+<div id="outline-container-1.6.3" class="outline-4">
+<h4 id="sec-1.6.3">1.6.3 Creating containers tree </h4>
+<div id="text-1.6.3">
 
 
 
@@ -298,7 +346,7 @@ with tree-quota patch applied.
     # Assign id for the root
     ./chattr -Q 1 /mnt/ct-root-1
     # set quota limits for tree
-    quota-tree/tool/quotactl --set --type 2 --bsoft 100000 --bhard 110000 --dev /dev/loop0
+    quota-tree/tool/quotactl --set --type 2 --id 1 --bsoft 100000 --bhard 110000 --dev /dev/loop0
     # show quotas
     quota-tree/tool/quotactl --get --all --type 2 --dev /dev/loop0
     # Populate root with content, it will be accounted in to
@@ -314,10 +362,10 @@ with tree-quota patch applied.
 </div>
 </div>
 </div>
-<div id="postamble"><p class="author"> Author: Dmitry Monakhov
-<a href="mailto:dmonakhov@openvz.org">&lt;dmonakhov@openvz.org&gt;</a>
+<div id="postamble"><p class="author"> Author: Monahov Dmitry
+<a href="mailto:mov@jazz.campus">&lt;mov@jazz.campus&gt;</a>
 </p>
-<p class="date"> Date: 2009-11-18 09:25:08 MSK</p>
+<p class="date"> Date: 2009-11-19 18:21:17 MSK</p>
 <p>HTML generated by org-mode 6.21b in emacs 23</p>
 </div></body>
 </html>
diff --git a/quota.org b/quota.org
index 7b887dd..cf5898c 100644
--- a/quota.org
+++ b/quota.org
@@ -1,12 +1,12 @@
-* directory tree quota desing and implementation
+* directory tree quota design and implementation
 ** STATUS
-   V0.07 :: I've succeed in testing journalled tree-quota. At least it surrvived
+   V0.07 :: I've succeed in testing journalled tree-quota. At least it survived
    in fsstress and other manual tests.
 
 ** Introduction
    This document contains basic introduction to directory tree
-   quota for didicated trees. Currently Linux support many 
-   virtualization extentions. One of approaches is containers.
+   quota for dedicated trees. Currently Linux support many 
+   virtualization extensions. One of approaches is containers.
    Containers is OS level paravirtualization like jail in BSD.
    In two words container is a set of process isolated from
    other system. Each process has it's own name-spaces for
@@ -19,7 +19,7 @@
    - inode attr :: 
      If inode has links in A and B trees. And A-user call chown() for
      this inode, then B's owner will be surprised.
-     The only way to overcome this is to virtualize inode atributes
+     The only way to overcome this is to virtualize inode attributes
      (for each tree) which is madness IMHO.
    - checkpoint/restore/online-backup ::
      This is like suspend resume for VM, but in this case only
@@ -68,13 +68,32 @@ implement it on native fs level.
    if(new_dir->i_tree_id != old_inode->i_tree_id)
             return -EXDEV;
 #+END_EXAMPLE
-** Patche queue
+** Patch queue
    I've prepare proof of concept patch queue.
    [[http://www.2ka.mipt.ru/~mov/tree-quota.tgz][patch-queue]]
 ** How-to
-   This part containt some tips of tree-quota usage. Assume you have kernel
+   This part contain some tips of tree-quota usage. Assume you have kernel
    with tree-quota patch applied.
-*** Enabling tree quota
+*** Enabling tree quota an Easy way
+   You may download small file-system image with tree-quota enabled.
+   [[http://www.2ka.mipt.ru/~mov/fs-trquota.img.gz][fs-trquota.img.gz(3Mb)]]
+   mount /test/fs.img /mnt -oloop,quota,grpquota,treeid,trquota
+   *NOTE in order to use journalling quota use following mount options*
+#+BEGIN_EXAMPLE bash
+   jqfmt=vfsv0,treeid,trjquota=aquota.tree
+#+END_EXAMPLE 
+#+BEGIN_EXAMPLE bash
+    Currently quota-tools has no tree-quota support. So you have to manually
+    create aquota.tree file. Just copy quota-tree/tool/aquota.tree to the root
+    of your fs
+    mount /test/fs.img /mnt -oloop,quota,grpquota,treeid,trquota
+    cp quota-tree/tool/aquota.tree  /mnt/
+    # enable all quotas
+    quota-tree/tool/quotactl --on --all --path /mnt --dev /dev/loop0
+    # show quotas type ==0 -> usrquota, type == 2 -> trqota
+    quota-tree/tool/quotactl --get --all --type 2 --dev /dev/loop0
+#+END_EXAMPLE
+*** Enabling tree quota from very beginning
 #+BEGIN_EXAMPLE bash
     Currently quota-tools has no tree-quota support. So you have to manually
     create aquota.tree file. Just copy quota-tree/tool/aquota.tree to the root
@@ -93,7 +112,7 @@ implement it on native fs level.
     # Assign id for the root
     ./chattr -Q 1 /mnt/ct-root-1
     # set quota limits for tree
-    quota-tree/tool/quotactl --set --type 2 --bsoft 100000 --bhard 110000 --dev /dev/loop0
+    quota-tree/tool/quotactl --set --type 2 --id 1 --bsoft 100000 --bhard 110000 --dev /dev/loop0
     # show quotas
     quota-tree/tool/quotactl --get --all --type 2 --dev /dev/loop0
     # Populate root with content, it will be accounted in to
-- 
2.11.4.GIT