Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / src / kauth / test / testlocking.README
1 Copyright 2000, International Business Machines Corporation and others.
2 All Rights Reserved.
3
4 This software has been released under the terms of the IBM Public
5 License. For details, see the LICENSE file in the top-level source
6 directory or online at http://www.openafs.org/dl/license10.html
7
8 The testlocking scripts are really EXPECT scripts, not merely TCL.
9 They are used by running "expect testlocking.general.tcl" and "expect
10 testlocking.boundaries.tcl". I don't recommend running them simultaneously,
11 as they modify the same user records. That would not be too difficult to
12 change if necessary.
13
14 The output from the scripts is a trace of the entire test, punctuated by lines
15 of the form:
16 SUCCESS blah blah blah
17 or
18 FAILED: blah blah blah
19
20 The easiest way to use these at present is to do something like:
21 % expect testlocking.general.tcl | tee locklog.general | grep '^FAIL'
22 This way, if you don't get any output, you know the test completed successfully,
23 but if you do get output, you can still look at the traces.
24
25 There are some aspects of this new feature that are not explicitly checked by
26 the test scripts, but can be verified by examining the logs. Also, the test
27 scripts don't sleep for any period of time to determine whether an id will
28 automatically unlock properly or not.