1TEST SUITE: 2 3The directory io-throttle contains the tests related to block device I/O 4bandwdith controller. 5 6More testcases are expected to be added in future. 7 8TESTS AIM: 9 10The aim of the tests is to check the block device I/O throttling functionality 11for cgroups. 12 13FILES DESCRIPTION: 14 15iobw.c 16--------------- 17Simple benchmark to generate parallel streams of direct I/O (O_DIRECT). This 18benchmark fork()s one task per stream. Each task creates a separate file in the 19current working directory, fills it with data using O_DIRECT writes and re-read 20the whole file always in O_DIRECT mode. Different timestamps are used to 21evaluate per-task I/O rate and total I/O rate (seen by the parent). 22 23myfunctions.sh 24---------- 25This file contains the functions which are common for the io-throttle tests. 26For ex. the setup and cleanup functions which do the setup for running the 27test and do the cleanup once the test finishes. The setup() function creates 28/dev/blockioctl directory and mounts cgroup filesystem on it with memory 29controller. It then creates a number(n) of groups in /dev/blockioctl. The 30cleanup function does a complete cleanup of the system. 31 32Most of the error scenarios have been taken care of for a sane cleanup of the 33system. However if cleanup fails in any case, just manually execute the 34commands written in cleanup function in myfunctions.sh. 35One of the most common causes of failed cleanup is that you have done cd into 36any of the groups in controller dir tree. 37 38run_io_throttle_test.sh 39------------------ 40This script creates different scenarios for I/O bandwidth controller testing 41and fires (n) tasks in different groups to write and read different I/O streams 42etc. It waits for the return status from tasks and reports test pass/fail 43accordingly. 44 45Makefile 46-------- 47The usual makefile for this directory 48 49PASS/FAIL CRITERION: 50================== 51The test cases are intelligent enough in deciding the pass or failure of a 52test. 53 54README: 55-------- 56This file. 57