glusterfs/tests
Anand Avati 91052d8b56 tests/fileio.rc: library for file descriptor based IO in tests
There are situations in test scripts where we want to keep open file
descriptors while performing other commands. Bash has abilities
to manage file descriptors by numbers, but the syntax is a little
brain damaging.

This library provides wrappers around it to abstract away bash's
syntax and also provides a helper function to pick a free file
descriptor on the fly.

The APIs are pretty self explanatory.

Change-Id: I82f1d1957646dd6c468d9e85c90ec30c978c7ad6
BUG: 764966
Signed-off-by: Anand Avati <avati@redhat.com>
Reviewed-on: http://review.gluster.org/4565
Reviewed-by: Amar Tumballi <amarts@redhat.com>
2013-02-21 23:26:57 -08:00
..
basic glusterfs.spec.in: resync with Fedora glusterfs.spec 2013-02-19 10:21:10 -08:00
bugs tests/fileio.rc: library for file descriptor based IO in tests 2013-02-21 23:26:57 -08:00
performance performance/open-behind: use anonymous fd for doing fstat and readv 2013-02-19 16:07:21 -08:00
utils glusterd, cli: Task id's for async tasks 2012-12-19 13:32:49 -08:00
dht.rc cluster/dht: Create linkfile with file uid/gid 2013-02-13 16:17:44 -08:00
fileio.rc tests/fileio.rc: library for file descriptor based IO in tests 2013-02-21 23:26:57 -08:00
include.rc tests: Add spaces around '=' in a string comparision in TEST primitive 2013-02-18 22:01:45 -08:00
README tests/README: add a note about usage of 'mount -t glusterfs' 2012-11-29 22:01:25 -08:00
volume.rc libglusterfs: Fix memory leaks in fd_lk_insert_and_merge 2013-02-17 17:03:40 -08:00

How to use test script framework.
=================================

- Build and install the version of glusterfs with your changes. Make
  sure the installed version is accessible from $PATH.

- To mount glusterfs, NEVER use 'mount -t glusterfs', instead use
  'glusterfs -s ' method. This is because with the patch build setup
  doesnot install the /sbin/mount.glusterfs necessary, where as the
  glusterfs binary will be accessible with $PATH, and will pick the
  right version.

- (optional) Set environment variables to specify location of
  export directories and mount points. Unless you have special
  requirements, the defaults should just work. The variables
  themselves can be found at the top of tests/include.rc. All
  of them can be overriden with environment variables.

- Execute run-tests.sh in the top level directory as root.

- If some test cases fail, you can execute the failed test case script
  directly bypassing run-tests.sh. At this time it might be
  useful to set the envrionment variable DEBUG=1 before running
  the individual test script directly by hand.

- BE WARNED THAT THE TEST CASES DELETE /var/lib/glusterd/* !!!