Some qa cleanup.
[xfstests-dev.git] / tools / README.auto-qa
index 9fc03517dae5921aecd3d1356e107ea97b306f03..86e362150235b3aa2f185ed92af17aa59979eac5 100644 (file)
@@ -3,18 +3,18 @@ ______________________                                      ______________
 
 
        - pick/create a user to run auto-qa and check they 
-            can use ptools to check out of the tree
-       - add your host to cmd/xfstests/common.config
-       - add your host to cmd/xfstests/tools/auto-qa
-               check both these files in
+          can use ptools to check out of the tree
+       - add your host to xfstests/common.config and check this file in
+          OR create a local.config file in your xfstests directory
        - make a directory "$HOME/qa"
-       - make a workarea "$HOME/qa/linux-xfs" for linux-xfs
-               (easiest to copy one from elsewhere)
-       - cd $HOME/qa ; ln -s linux-xfs/cmd/xfstests/tools/auto-qa .
+       - make a kernel workarea "$HOME/qa/2.4.x-xfs" for 2.4.x-xfs
+         and a commands workarea "$HOME/qa/xfs-cmds" for xfs-cmds
+               (easiest to copy them from elsewhere)
+       - cd $HOME/qa ; ln -s xfs-cmds/xfstests/tools/auto-qa .
                (auto-qa must be a link into it's own source tree
                so it can update itself)
        - copy an appropriate .config file to
-               $HOME/qa/$HOSTNAME-2.4-xfs-qa.config
+               $HOME/qa/$HOSTNAME.config
        - You'll need a hacked version of 'su' in $HOME/qa that
                 lets your user su to root/root without a password
                 (if you want to run from cron, it mustn't require
@@ -24,7 +24,7 @@ ______________________                                      ______________
        - chmod 6755 $HOME/qa/su
        - add the soon to be kernel to /etc/lilo.conf
 
-               image=/boot/vmlinuz-2.4-xfs-qa
+               image=/boot/vmlinuz-xfs-qa
                        label=linux-xfs-qa
                        append = "console=ttyS0,38400n8"
                
@@ -47,15 +47,15 @@ To get it going automagically:
                30 4 * * *      $HOME/qa/auto-qa cron-restarted
 
 Notes:
-       - if MODULAR=1 in auto-qa XFS and pagebuf are expected to
-                be modules. if MODULAR=0 they should be built into
-                the kernel
+       - if MODULAR=1 in auto-qa the XFS filesystem is expected to
+                be a module; if MODULAR=0 it should be built into
+                the kernel.
        - the test device is cleaned at the start of the QA run
                (to stop nightly QA being stuffed up if someone
                leaves the device inconsistant etc)
        - I'm using a hacked su because PCP sudo won't set the
                gid properly, and normal linux su won't run
-               without a tty even if PAM is pissed-off.
+               without a tty even if PAM is switched off.
        - The QA is restarted after reboot by a second cron entry
                to avoid the test being able to get itself into
                some stupid loop and so that it's always started
@@ -65,7 +65,7 @@ Notes:
        - When run in "cron-init" or "init" states, the script
                will p_tupdate itself and restart. If you start
                with an empty source tree, you'll need to check
-               out the cmd/xfstests/tools/auto-qa script before it'll
+               out the xfstests/tools/auto-qa script before it'll
                work (duh).
 
 good luck.